Mudanças entre as edições de "Novo Relatório de pedido PDF"
| Linha 152: | Linha 152: | ||
'''[RN1] -Disponibilização por Ação''' | '''[RN1] -Disponibilização por Ação''' | ||
| + | |||
A geração do novo modelo de relatório em PDF deverá ser disponibilizada por meio de uma ação específica, permitindo ao usuário selecionar a opção para gerar o relatório no modelo personalizado. | A geração do novo modelo de relatório em PDF deverá ser disponibilizada por meio de uma ação específica, permitindo ao usuário selecionar a opção para gerar o relatório no modelo personalizado. | ||
'''[RN2] -Disponibilidade da Ação no Portal e Mobile''' | '''[RN2] -Disponibilidade da Ação no Portal e Mobile''' | ||
| + | |||
A ação para geração do novo modelo de relatório deverá estar disponível tanto no Portal GeoSales quanto no Mobile GeoSales, respeitando as particularidades de cada plataforma. | A ação para geração do novo modelo de relatório deverá estar disponível tanto no Portal GeoSales quanto no Mobile GeoSales, respeitando as particularidades de cada plataforma. | ||
'''[RN3] - Ativação da Ação''' | '''[RN3] - Ativação da Ação''' | ||
| + | |||
A nova ação deverá ser disponibilizada de forma que possa ser ativada ou desativada conforme a necessidade do cliente, evitando que o novo modelo seja apresentado obrigatoriamente para todos os clientes. | A nova ação deverá ser disponibilizada de forma que possa ser ativada ou desativada conforme a necessidade do cliente, evitando que o novo modelo seja apresentado obrigatoriamente para todos os clientes. | ||
'''[RN4] -Permissão de Utilização ''' | '''[RN4] -Permissão de Utilização ''' | ||
| + | |||
A disponibilização da ação deverá respeitar o mecanismo de controle de acesso/permissão existente no GeoSales, quando aplicável, permitindo definir quais usuários poderão utilizar a geração do novo relatório. | A disponibilização da ação deverá respeitar o mecanismo de controle de acesso/permissão existente no GeoSales, quando aplicável, permitindo definir quais usuários poderão utilizar a geração do novo relatório. | ||
'''[RN5] -Utilização dos Dados Existentes''' | '''[RN5] -Utilização dos Dados Existentes''' | ||
| + | |||
O relatório deverá utilizar exclusivamente as informações já disponíveis no pedido e nas estruturas existentes do GeoSales, não sendo necessária a criação de novos dados ou regras de negócio para composição do documento. | O relatório deverá utilizar exclusivamente as informações já disponíveis no pedido e nas estruturas existentes do GeoSales, não sendo necessária a criação de novos dados ou regras de negócio para composição do documento. | ||
'''[RN6] -Modelo Personalizado''' | '''[RN6] -Modelo Personalizado''' | ||
| + | |||
A ação deverá gerar especificamente o novo modelo de PDF solicitado pelo cliente, sem alterar ou substituir os demais modelos, relatórios ou visões de pedido já existentes no GeoSales. | A ação deverá gerar especificamente o novo modelo de PDF solicitado pelo cliente, sem alterar ou substituir os demais modelos, relatórios ou visões de pedido já existentes no GeoSales. | ||
'''[RN7] - Dados do Pedido''' | '''[RN7] - Dados do Pedido''' | ||
| + | |||
O conteúdo apresentado no PDF deverá corresponder aos dados do pedido selecionado no momento da execução da ação. | O conteúdo apresentado no PDF deverá corresponder aos dados do pedido selecionado no momento da execução da ação. | ||
'''[RN7] - Disponibilidade conforme Configuração''' | '''[RN7] - Disponibilidade conforme Configuração''' | ||
| + | |||
Quando a ação estiver desativada para o cliente ou contexto de utilização, o novo modelo de relatório não deverá ser apresentado ao usuário para geração. | Quando a ação estiver desativada para o cliente ou contexto de utilização, o novo modelo de relatório não deverá ser apresentado ao usuário para geração. | ||
Edição das 18h00min de 20 de agosto de 2026
Histórico de Alterações
| Data | Quem | Comentários |
|---|---|---|
| 19/08/2026 | Renato Lima | Criação do documento |
Necessidade
O cliente solicita a criação de um novo modelo de relatório de pedido em formato PDF, com uma apresentação específica para ser disponibilizada aos vendedores durante o processo comercial.
Embora o GeoSales já disponibilize outras visões e relatórios que contemplam as informações do pedido e atendem à necessidade de consulta dos dados, o cliente deseja contar com uma versão adicional, com layout e organização próprios, para utilização e compartilhamento pelos vendedores.
Dessa forma, trata-se de uma customização solicitada pelo cliente, voltada principalmente à padronização da apresentação das informações do pedido em um documento PDF. O objetivo não é suprir uma ausência de informação no GeoSales, uma vez que os dados necessários já estão disponíveis nas funcionalidades e visões existentes.
Solução
Desenvolver um novo modelo de relatório de pedido em PDF, seguindo o layout e a estrutura definidos pelo cliente, utilizando as informações já disponíveis no GeoSales.
O relatório deverá apresentar, de forma organizada, os principais dados do pedido, como identificação do pedido, cliente, endereço, representante, transportadora, condições comerciais, informações de frete, itens, quantidades, códigos, descrição dos produtos, preços, subtotais e total do pedido, conforme modelo de referência apresentado pelo cliente. A nova opção deverá ficar disponível para que o vendedor possa gerar e disponibilizar o PDF do pedido, proporcionando ao cliente a apresentação desejada, sem substituir ou alterar as demais visões e relatórios já existentes no GeoSales.
Por se tratar de uma necessidade específica de apresentação e utilização pelo cliente, a implementação será realizada como novo modelo de relatório, mantendo as funcionalidades atuais do sistema.
Implementação
Permitir ao vendedor gerar um relatório do pedido em formato PDF, utilizando um novo modelo de apresentação solicitado pelo cliente. O relatório deverá organizar as informações do pedido conforme o layout de referência apresentado, utilizando os dados já disponíveis no GeoSales.
Fluxo Principal
O usuário acessa um pedido no GeoSales e solicita a geração do relatório em PDF. O sistema deverá disponibilizar o novo modelo de relatório de pedido. Ao gerar o documento, o sistema deverá apresentar as informações organizadas nos seguintes blocos:
3.1. Cabeçalho e Identificação do Pedido
O relatório deverá apresentar:
- Logomarca cliente e geosales, com o nome do relatório e data em que foi emitido - Número do pedido do Geosales; - Numero do pedido no ERP, caso já tenha retornado - Data de emissão do pedido;
3.2. Dados do cliente, Endereço e Contato do Cliente
Deverão ser apresentados:
Identificação do cliente, contendo código e razão social; CNPJ do cliente. Endereço; Bairro; Cidade e UF; CEP; Telefone.
3.3. Dados Comerciais e Logísticos
O relatório deverá apresentar:
- Representante, contendo código e identificação; - Transportadora, contendo código e identificação; - Tabela de Preço: Código e descrição - Meio de pagamento - Prazo/condição de pagamento; - Transportadora - Tipo de frete.
3.4. Relação de Itens do Pedido
O relatório deverá apresentar os produtos que compõem o pedido, organizados em formato de tabela, contendo:
Quantidade; Código do produto; Descrição do produto; Preço; Subtotal do item. (Valor unitário x Qnt)
A relação deverá contemplar todos os itens do pedido, mantendo a continuidade da listagem em páginas subsequentes quando necessário.
3.5. Totalização do Pedido
Ao final da relação de produtos, o relatório deverá apresentar:
Total do pedido;
Resultado Esperado
Ao final da operação, o GeoSales deverá disponibilizar um arquivo PDF contendo o pedido no novo modelo personalizado, com todas as informações organizadas conforme a estrutura definida neste documento.
O relatório deverá preservar a apresentação dos dados de forma clara e padronizada, permitindo que o vendedor utilize o documento para disponibilização ao cliente.
A implementação deverá utilizar as informações já existentes no GeoSales, não sendo necessária a criação de novas informações ou regras de negócio para atender ao conteúdo apresentado no modelo.
Escopo
Escopo Incluso
- Criação do novo layout de relatório de pedido em PDF;
- Apresentação dos dados do pedido conforme descrito neste documento;
- Bloco de identificação do pedido;
- Bloco de dados cadastrais, endereço e contato do cliente;
- Bloco de informações comerciais e logísticas;
- Relação dos itens do pedido;
- Totalização do pedido;
- Paginação do relatório;
- Reapresentação das informações de identificação nas páginas subsequentes, quando necessário;
- Criação da ação para exibição do novo relatório;
- Disponibilização da ação no Portal GeoSales;
- Disponibilização da ação no Mobile GeoSales;
- Configuração para ativação/desativação da ação;
- Utilização dos dados já existentes no GeoSales para composição do relatório;
- Geração do arquivo em formato PDF.
Escopo Não Incluso
- Criação ou alteração de informações cadastrais de clientes, produtos ou pedidos;
- Criação de novos campos no pedido ou nas demais estruturas do GeoSales;
- Alteração das regras comerciais ou de negócio utilizadas na geração do pedido;
- Alteração dos modelos de relatórios já existentes;
- Alteração das demais visões de pedido disponíveis no Portal ou Mobile;
- Criação de novas informações que não estejam disponíveis atualmente no GeoSales;
- Alterações no processo de lançamento, aprovação ou faturamento do pedido;
- Integrações com sistemas externos para obtenção dos dados do relatório;
- Criação de um editor para que o próprio cliente possa alterar o layout do relatório.
Atores
Vendedor / Usuário do GeoSales Responsável por acessar o pedido e executar a ação de geração do novo relatório em PDF, tanto pelo Portal quanto pelo Mobile, conforme as permissões disponibilizadas.
Administrador do Cliente Responsável por definir, conforme a necessidade do cliente, a ativação ou desativação da ação de geração do novo modelo de relatório e, quando aplicável, controlar sua disponibilização aos usuários.
GeoSales – Portal Sistema responsável por disponibilizar a ação de geração do relatório e processar a solicitação realizada pelo usuário através do Portal.
GeoSales – Mobile Aplicativo responsável por disponibilizar a mesma ação de geração do relatório para os usuários que realizam o processo pelo dispositivo móvel.
Serviço de Geração do PDF Componente responsável por utilizar os dados do pedido e gerar o arquivo PDF conforme o novo modelo e layout definido pelo cliente.
Pré-condições
- O pedido deverá estar previamente cadastrado no GeoSales e possuir as informações necessárias para composição do relatório;*
- Os dados utilizados no novo modelo deverão estar disponíveis nas estruturas atuais do GeoSales;
- A ação de geração do relatório deverá estar habilitada para o cliente;
- O usuário deverá possuir acesso ao pedido e permissão para executar a ação, conforme as regras de acesso existentes no GeoSales;
- O Portal e o Mobile deverão possuir a versão necessária para disponibilização da nova ação;
- O cliente deverá fornecer e validar previamente o layout/modelo de referência que será utilizado como base para o desenvolvimento;
- A funcionalidade deverá ser validada pelo cliente em ambiente de homologação antes de sua disponibilização em produção.
Regras de Negócio
[RN1] -Disponibilização por Ação
A geração do novo modelo de relatório em PDF deverá ser disponibilizada por meio de uma ação específica, permitindo ao usuário selecionar a opção para gerar o relatório no modelo personalizado.
[RN2] -Disponibilidade da Ação no Portal e Mobile
A ação para geração do novo modelo de relatório deverá estar disponível tanto no Portal GeoSales quanto no Mobile GeoSales, respeitando as particularidades de cada plataforma.
[RN3] - Ativação da Ação
A nova ação deverá ser disponibilizada de forma que possa ser ativada ou desativada conforme a necessidade do cliente, evitando que o novo modelo seja apresentado obrigatoriamente para todos os clientes.
[RN4] -Permissão de Utilização
A disponibilização da ação deverá respeitar o mecanismo de controle de acesso/permissão existente no GeoSales, quando aplicável, permitindo definir quais usuários poderão utilizar a geração do novo relatório.
[RN5] -Utilização dos Dados Existentes
O relatório deverá utilizar exclusivamente as informações já disponíveis no pedido e nas estruturas existentes do GeoSales, não sendo necessária a criação de novos dados ou regras de negócio para composição do documento.
[RN6] -Modelo Personalizado
A ação deverá gerar especificamente o novo modelo de PDF solicitado pelo cliente, sem alterar ou substituir os demais modelos, relatórios ou visões de pedido já existentes no GeoSales.
[RN7] - Dados do Pedido
O conteúdo apresentado no PDF deverá corresponder aos dados do pedido selecionado no momento da execução da ação.
[RN7] - Disponibilidade conforme Configuração
Quando a ação estiver desativada para o cliente ou contexto de utilização, o novo modelo de relatório não deverá ser apresentado ao usuário para geração.
Fluxograma
Aprovação
Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.
GeoSales
| Setor | Aprovado Por | Data |
|---|---|---|
| Integração - GeoSales | dd/mm/aaaa |
Empresa solicitante
| Setor | Aprovado Por | Data | Assinatura |
|---|---|---|---|
| Gerente TI - Cliente | Pessoa que aprovou | 00/00/0000 | |
| Gerente de Projeto - Cliente | Pessoa que aprovou | 00/00/0000 | |
| Gerente Comercial - Cliente | Pessoa que aprovou | 00/00/0000 |