Mudanças entre as edições de "Cadastro e inserção de observações padrão"
| (23 revisões intermediárias pelo mesmo usuário não estão sendo mostradas) | |||
| Linha 6: | Linha 6: | ||
|- | |- | ||
| 22/05/2026 || Renato Lima || Criação do documento | | 22/05/2026 || Renato Lima || Criação do documento | ||
| + | |- | ||
| + | | 09/09/2026 || Renato Lima || Adicionar ao cadastro a opção do cliente | ||
|- | |- | ||
|} | |} | ||
| Linha 15: | Linha 17: | ||
Diante deste cenário, o cliente necessita de uma funcionalidade que permita cadastrar modelos de observações padrão e reutilizá-los de forma prática no fluxo de pedidos, mantendo a possibilidade de personalização conforme a necessidade de cada negociação. | Diante deste cenário, o cliente necessita de uma funcionalidade que permita cadastrar modelos de observações padrão e reutilizá-los de forma prática no fluxo de pedidos, mantendo a possibilidade de personalização conforme a necessidade de cada negociação. | ||
| + | |||
| + | ===Necessidade — complemento=== | ||
| + | |||
| + | O cliente identificou também a necessidade de permitir que as observações padrão sejam direcionadas a clientes específicos. Dessa forma, determinados textos poderão ser utilizados exclusivamente em pedidos de um determinado cliente, enquanto observações sem vínculo com cliente permanecerão disponíveis para utilização de forma geral. | ||
| + | |||
| + | Essa flexibilização permitirá maior personalização das informações utilizadas no processo de pedidos, mantendo a possibilidade de utilização de modelos comuns a todos os clientes. | ||
== Solução == | == Solução == | ||
| Linha 31: | Linha 39: | ||
* Possibilidade de edição e complementação do texto após inserção; | * Possibilidade de edição e complementação do texto após inserção; | ||
* Controle de acesso através do Controle de Ação. | * Controle de acesso através do Controle de Ação. | ||
| + | |||
| + | ===Solução — complemento=== | ||
| + | |||
| + | O cadastro de observações padrão deverá permitir que o usuário informe, de forma opcional, o cliente ao qual a observação estará vinculada. | ||
| + | |||
| + | O cadastro passará a contemplar, além das informações já previstas: | ||
| + | |||
| + | * Título da observação; | ||
| + | * Texto padrão da observação; | ||
| + | * Tipo da observação — Frete, Pedido ou Nota Fiscal; | ||
| + | * Cliente — informação opcional. | ||
| + | |||
| + | Quando um cliente for informado no cadastro, a observação será considerada específica daquele cliente e deverá ser disponibilizada somente quando o pedido estiver sendo realizado para o cliente vinculado. | ||
| + | |||
| + | Quando nenhum cliente for informado, a observação será considerada genérica e poderá ser disponibilizada para utilização em pedidos de todos os clientes. | ||
== Implementação == | == Implementação == | ||
| Linha 56: | Linha 79: | ||
* Tipo da observação; | * Tipo da observação; | ||
* Texto padrão da observação. | * Texto padrão da observação. | ||
| + | |||
| + | ====Adequações no Cadastro de Observações - Complemento ==== | ||
| + | |||
| + | O cadastro deverá ser ajustado para permitir a vinculação opcional de um cliente. | ||
| + | |||
| + | Informações mínimas: | ||
| + | |||
| + | * Título; | ||
| + | * Tipo da observação; | ||
| + | * Texto padrão; | ||
| + | * Cliente — opcional. | ||
| + | |||
| + | O campo '''Cliente''' deverá permitir a pesquisa e seleção de um cliente cadastrado no sistema. | ||
=== Adequações no Fluxo de Pedido === | === Adequações no Fluxo de Pedido === | ||
| Linha 69: | Linha 105: | ||
* Após a inserção, o usuário poderá editar e complementar o texto conforme necessidade operacional; | * Após a inserção, o usuário poderá editar e complementar o texto conforme necessidade operacional; | ||
* O texto final deverá ser salvo normalmente junto ao pedido. | * O texto final deverá ser salvo normalmente junto ao pedido. | ||
| + | |||
| + | |||
| + | ==== Adequações no Fluxo de Pedido — complemento ==== | ||
| + | |||
| + | Durante a seleção de uma observação padrão no fluxo de pedido, o sistema deverá considerar o cliente informado no pedido para determinar quais modelos estarão disponíveis. | ||
| + | |||
| + | O comportamento deverá seguir as seguintes regras: | ||
| + | |||
| + | '''1.''' O usuário acessa a aba de observações do pedido. | ||
| + | |||
| + | '''2.''' Seleciona o tipo da observação. | ||
| + | |||
| + | '''3.''' O sistema identifica o cliente do pedido. | ||
| + | |||
| + | '''4.''' O sistema deverá apresentar: | ||
| + | * Observações padrão sem cliente vinculado, disponíveis para todos os clientes; | ||
| + | * Observações padrão vinculadas especificamente ao cliente do pedido. | ||
| + | |||
| + | '''5.''' Observações vinculadas a outros clientes não deverão ser apresentadas. | ||
| + | |||
| + | '''6.''' O usuário seleciona o modelo desejado. | ||
| + | |||
| + | '''7.''' O sistema insere o texto no campo de observação. | ||
| + | |||
| + | '''8.''' O usuário poderá editar ou complementar o texto antes de salvar o pedido. | ||
=== Controle de Permissões === | === Controle de Permissões === | ||
| Linha 91: | Linha 152: | ||
* Edição manual do texto após inserção; | * Edição manual do texto após inserção; | ||
* Controle de acesso por permissão. | * Controle de acesso por permissão. | ||
| + | |||
| + | ==== Escopo Incluso — complemento ==== | ||
| + | * Inclusão do campo Cliente no cadastro de observações padrão; | ||
| + | * Possibilidade de cadastrar observações gerais; | ||
| + | * Possibilidade de cadastrar observações específicas por cliente; | ||
| + | * Filtro das observações conforme o cliente do pedido; | ||
| + | * Disponibilização das observações gerais e específicas do cliente no fluxo de pedido. | ||
=== Escopo Não Incluso === | === Escopo Não Incluso === | ||
| − | Versionamento de observações padrão; | + | * Versionamento de observações padrão; |
| − | Histórico de utilização das observações; | + | * Histórico de utilização das observações; |
| − | Inclusão automática de observações sem interação do usuário; | + | * Inclusão automática de observações sem interação do usuário; |
| − | Compartilhamento de observações entre bases distintas; | + | * Compartilhamento de observações entre bases distintas; |
| − | Sincronização com ERP. | + | * Sincronização com ERP. |
== Atores == | == Atores == | ||
| − | Vendedor | + | * Vendedor |
| − | Supervisor Comercial | + | * Supervisor Comercial |
| − | Administrador do Sistema | + | * Administrador do Sistema |
== Pré-condições == | == Pré-condições == | ||
| − | Usuário autenticado no sistema; | + | * Usuário autenticado no sistema; |
| − | Usuário possuir permissão para utilização da funcionalidade; | + | * Usuário possuir permissão para utilização da funcionalidade; |
| − | Pedido estar em inclusão ou edição; | + | * Pedido estar em inclusão ou edição; |
| − | Existir ao menos uma observação padrão cadastrada para utilização. | + | * Existir ao menos uma observação padrão cadastrada para utilização. |
== Regras de Negócio == | == Regras de Negócio == | ||
| Linha 117: | Linha 185: | ||
'''[RN3] -''' O sistema deverá permitir apenas os seguintes tipos: | '''[RN3] -''' O sistema deverá permitir apenas os seguintes tipos: | ||
| − | Frete; | + | * Frete; |
| − | Pedido; | + | * Pedido; |
| − | Nota Fiscal; | + | * Nota Fiscal; |
'''[RN4] -''' A visualização da funcionalidade deverá ser controlada através do Controle de Ação; | '''[RN4] -''' A visualização da funcionalidade deverá ser controlada através do Controle de Ação; | ||
| Linha 131: | Linha 199: | ||
'''[RN8] -''' O cadastro da observação deverá possuir no mínimo: | '''[RN8] -''' O cadastro da observação deverá possuir no mínimo: | ||
| − | Título; | + | * Título; |
| − | Tipo; | + | * Tipo; |
| − | Texto da observação; | + | * Texto da observação; |
'''[RN9] -''' A funcionalidade estará disponível apenas no portal. | '''[RN9] -''' A funcionalidade estará disponível apenas no portal. | ||
| + | |||
| + | === Regras de Negócio - Complemento === | ||
| + | '''[RN10] -''' O vínculo da observação com um cliente deverá ser opcional. | ||
| + | |||
| + | '''[RN11] -''' Quando a observação possuir um cliente vinculado, ela deverá ser disponibilizada exclusivamente para pedidos do cliente informado no cadastro. | ||
| + | |||
| + | '''[RN12] -''' Quando a observação não possuir cliente vinculado, ela deverá ser considerada uma observação geral e poderá ser utilizada para qualquer cliente. | ||
| + | |||
| + | '''[RN13] -''' No fluxo de pedido, o sistema deverá considerar o cliente selecionado no pedido para filtrar as observações padrão disponíveis. | ||
| + | |||
| + | '''[RN14] -''' O sistema deverá apresentar conjuntamente as observações gerais e as observações específicas vinculadas ao cliente do pedido. | ||
| + | |||
| + | '''[RN15] -''' Observações vinculadas a outros clientes não deverão ser disponibilizadas para seleção no pedido. | ||
| + | |||
| + | '''[RN16] -''' A alteração do texto da observação no pedido não deverá alterar o modelo padrão cadastrado, independentemente de a observação ser geral ou específica de um cliente. | ||
== Fluxograma == | == Fluxograma == | ||
| − | [[Arquivo: | + | |
| + | <!-- | ||
| + | [[Arquivo:Diagrama_cadastro_observacao.png|1100px]] | ||
| + | |||
| + | |||
| + | ==== Fluxograma - Complemento ==== --> | ||
| + | |||
| + | |||
| + | [[Arquivo:Mermaid-diagram.png|1150px]] | ||
== Aprovação == | == Aprovação == | ||
Edição atual tal como às 13h16min de 9 de setembro de 2026
Histórico de Alterações
| Data | Quem | Comentários |
|---|---|---|
| 22/05/2026 | Renato Lima | Criação do documento |
| 09/09/2026 | Renato Lima | Adicionar ao cadastro a opção do cliente |
Necessidade
O cliente apresentou a necessidade de otimizar o processo de preenchimento das observações utilizadas no fluxo comercial do GeoSales Evo. Atualmente, ao copiar um pedido, as observações não são reaproveitadas, exigindo que os usuários realizem o preenchimento manual dos textos em cada novo pedido.
Durante o levantamento, foi identificado que muitas observações seguem um padrão operacional, principalmente relacionadas a informações de frete, pedido e nota fiscal, gerando retrabalho operacional e aumentando o risco de inconsistências nas informações registradas.
Diante deste cenário, o cliente necessita de uma funcionalidade que permita cadastrar modelos de observações padrão e reutilizá-los de forma prática no fluxo de pedidos, mantendo a possibilidade de personalização conforme a necessidade de cada negociação.
Necessidade — complemento
O cliente identificou também a necessidade de permitir que as observações padrão sejam direcionadas a clientes específicos. Dessa forma, determinados textos poderão ser utilizados exclusivamente em pedidos de um determinado cliente, enquanto observações sem vínculo com cliente permanecerão disponíveis para utilização de forma geral.
Essa flexibilização permitirá maior personalização das informações utilizadas no processo de pedidos, mantendo a possibilidade de utilização de modelos comuns a todos os clientes.
Solução
Adequar o GeoSales Evo para permitir o cadastro e utilização de observações padrão no fluxo de pedidos.
A solução deverá contemplar:
- Cadastro de modelos de observação padrão;
- Definição do tipo da observação:
- Frete;
- Pedido;
- Nota Fiscal;
- Seleção de observações padrão diretamente no fluxo do pedido;
- Inserção automática do texto no campo correspondente;
- Possibilidade de edição e complementação do texto após inserção;
- Controle de acesso através do Controle de Ação.
Solução — complemento
O cadastro de observações padrão deverá permitir que o usuário informe, de forma opcional, o cliente ao qual a observação estará vinculada.
O cadastro passará a contemplar, além das informações já previstas:
- Título da observação;
- Texto padrão da observação;
- Tipo da observação — Frete, Pedido ou Nota Fiscal;
- Cliente — informação opcional.
Quando um cliente for informado no cadastro, a observação será considerada específica daquele cliente e deverá ser disponibilizada somente quando o pedido estiver sendo realizado para o cliente vinculado.
Quando nenhum cliente for informado, a observação será considerada genérica e poderá ser disponibilizada para utilização em pedidos de todos os clientes.
Implementação
A implementação da funcionalidade deverá contemplar adequações estruturais, funcionais e visuais no GeoSales Evo, permitindo que os usuários realizem o gerenciamento e utilização de observações padrão diretamente na plataforma.
Adequações Funcionais
O sistema deverá disponibilizar uma nova estrutura de gerenciamento de observações padrão, permitindo:
- Inclusão de novas observações padrão;
- Edição de observações cadastradas;
- Exclusão de observações;
- Consulta/listagem das observações cadastradas;
- Definição do tipo da observação;
- Identificação visual do tipo da observação cadastrada.
Adequações no Cadastro de Observações
Será necessário incluir uma nova tela contendo:
- Grid/listagem das observações cadastradas;
- Ações de incluir, editar e excluir;
- Informações mínimas:
- Título da observação;
- Tipo da observação;
- Texto padrão da observação.
Adequações no Cadastro de Observações - Complemento
O cadastro deverá ser ajustado para permitir a vinculação opcional de um cliente.
Informações mínimas:
- Título;
- Tipo da observação;
- Texto padrão;
- Cliente — opcional.
O campo Cliente deverá permitir a pesquisa e seleção de um cliente cadastrado no sistema.
Adequações no Fluxo de Pedido
Durante a inclusão ou edição do pedido:
- O sistema deverá disponibilizar uma opção para inserção de observações padrão;
- A funcionalidade deverá ser controlada através do Controle de Ação;
- O usuário poderá selecionar o tipo da observação;
- O sistema deverá listar apenas os modelos cadastrados para o tipo selecionado;
- O usuário poderá selecionar o modelo desejado;
- O sistema deverá inserir automaticamente o texto no campo correspondente;
- Após a inserção, o usuário poderá editar e complementar o texto conforme necessidade operacional;
- O texto final deverá ser salvo normalmente junto ao pedido.
Adequações no Fluxo de Pedido — complemento
Durante a seleção de uma observação padrão no fluxo de pedido, o sistema deverá considerar o cliente informado no pedido para determinar quais modelos estarão disponíveis.
O comportamento deverá seguir as seguintes regras:
1. O usuário acessa a aba de observações do pedido.
2. Seleciona o tipo da observação.
3. O sistema identifica o cliente do pedido.
4. O sistema deverá apresentar:
- Observações padrão sem cliente vinculado, disponíveis para todos os clientes;
- Observações padrão vinculadas especificamente ao cliente do pedido.
5. Observações vinculadas a outros clientes não deverão ser apresentadas.
6. O usuário seleciona o modelo desejado.
7. O sistema insere o texto no campo de observação.
8. O usuário poderá editar ou complementar o texto antes de salvar o pedido.
Controle de Permissões
O sistema deverá permitir configuração de permissões para:
- Visualizar funcionalidade de observações padrão;
- Inserir observações padrão no pedido;
- Cadastro manual de observações padrão;
- Edição de observações;
- Exclusão de observações.
Documentos relacionados
Escopo
Escopo Incluso
- Cadastro de observações padrão;
- Definição do tipo da observação;
- Consulta/listagem das observações;
- Inclusão de observação padrão no fluxo de pedido;
- Edição manual do texto após inserção;
- Controle de acesso por permissão.
Escopo Incluso — complemento
- Inclusão do campo Cliente no cadastro de observações padrão;
- Possibilidade de cadastrar observações gerais;
- Possibilidade de cadastrar observações específicas por cliente;
- Filtro das observações conforme o cliente do pedido;
- Disponibilização das observações gerais e específicas do cliente no fluxo de pedido.
Escopo Não Incluso
- Versionamento de observações padrão;
- Histórico de utilização das observações;
- Inclusão automática de observações sem interação do usuário;
- Compartilhamento de observações entre bases distintas;
- Sincronização com ERP.
Atores
- Vendedor
- Supervisor Comercial
- Administrador do Sistema
Pré-condições
- Usuário autenticado no sistema;
- Usuário possuir permissão para utilização da funcionalidade;
- Pedido estar em inclusão ou edição;
- Existir ao menos uma observação padrão cadastrada para utilização.
Regras de Negócio
[RN1] - O sistema deverá permitir cadastro de múltiplas observações padrão;
[RN2] - Cada observação deverá possuir apenas um tipo vinculado;
[RN3] - O sistema deverá permitir apenas os seguintes tipos:
- Frete;
- Pedido;
- Nota Fiscal;
[RN4] - A visualização da funcionalidade deverá ser controlada através do Controle de Ação;
[RN5] - O sistema deverá listar apenas observações compatíveis com o tipo selecionado;
[RN6] - Após inserção da observação no pedido, o usuário poderá editar livremente o conteúdo;
[RN7] - Alterações realizadas no pedido não deverão impactar o cadastro padrão da observação;
[RN8] - O cadastro da observação deverá possuir no mínimo:
- Título;
- Tipo;
- Texto da observação;
[RN9] - A funcionalidade estará disponível apenas no portal.
Regras de Negócio - Complemento
[RN10] - O vínculo da observação com um cliente deverá ser opcional.
[RN11] - Quando a observação possuir um cliente vinculado, ela deverá ser disponibilizada exclusivamente para pedidos do cliente informado no cadastro.
[RN12] - Quando a observação não possuir cliente vinculado, ela deverá ser considerada uma observação geral e poderá ser utilizada para qualquer cliente.
[RN13] - No fluxo de pedido, o sistema deverá considerar o cliente selecionado no pedido para filtrar as observações padrão disponíveis.
[RN14] - O sistema deverá apresentar conjuntamente as observações gerais e as observações específicas vinculadas ao cliente do pedido.
[RN15] - Observações vinculadas a outros clientes não deverão ser disponibilizadas para seleção no pedido.
[RN16] - A alteração do texto da observação no pedido não deverá alterar o modelo padrão cadastrado, independentemente de a observação ser geral ou específica de um cliente.
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 |