Mudanças entre as edições de "Cadastrar endereço de entrega no fluxo de pedido"

Edição atual tal como às 15h12min de 19 de maio de 2026

Histórico de Alterações

Data	Quem	Comentários
19/05/2026	Renato Lima	Criação do documento

Necessidade

O cliente identificou a necessidade de ampliar o gerenciamento de endereços de entrega no fluxo comercial do Geosales Evo. Atualmente, o sistema disponibiliza apenas os endereços provenientes do ERP integrado, não permitindo que os usuários realizem cadastros ou manutenções diretamente na plataforma.

Diante da necessidade operacional, o cliente precisa que seja possível cadastrar, editar e excluir endereços de entrega diretamente no sistema, independentemente da integração com o ERP, garantindo maior autonomia operacional e agilidade durante o processo comercial.

Solução

Adequar o Geosales Evo para permitir o gerenciamento interno de endereços de entrega vinculados ao cadastro do cliente, complementando os endereços já disponibilizados através da integração com o ERP.

A solução deverá contemplar:

Permitir cadastro manual de novos endereços de entrega diretamente no sistema, ao incluir um pedido;
Disponibilizar uma tela de gerenciamento de endereços no cadastro do cliente;
Permitir utilização dos endereços cadastrados durante o fluxo de criação do pedido;
Manter compatibilidade com os endereços já sincronizados via ERP;
Garantir controle e padronização das informações cadastrais.

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 completo dos endereços de entrega diretamente na plataforma.

Adequações Funcionais

O sistema deverá disponibilizar uma nova estrutura de gerenciamento de endereços no cadastro do cliente, permitindo:

Inclusão manual de novos endereços de entrega;
Edição de endereços cadastrados;
Exclusão de endereços conforme regras de negócio;
Consulta/listagem dos endereços disponíveis;
Definição de endereço principal/padrão, quando aplicável;
Identificação visual dos endereços oriundos do ERP e dos cadastrados manualmente no sistema.

Adequações no Cadastro do Cliente

Será necessário incluir uma nova opção que permita consultar e realizar atualizações contendo:

Grid/listagem dos endereços cadastrados;
Ações de incluir, editar e excluir;
Informações mínimas:
Descrição do endereço;
CEP;
Logradouro;
Número;
Complemento;
Bairro;
Cidade;
Estado;
Referência;
Origem do endereço (ERP ou Sistema).

Adequações no Fluxo de Pedido

Durante a criação do pedido:

O sistema deverá apresentar todos os endereços disponíveis do cliente;
O vendedor poderá selecionar um endereço já existente;
O sistema deverá permitir cadastro rápido de endereço sem necessidade de sair do pedido, quando permitido;
Após cadastro, o endereço deverá ficar imediatamente disponível para utilização no pedido atual.

Regras de Persistência e Integração

Os endereços cadastrados manualmente deverão ser armazenados em estrutura própria do sistema;
Os endereços sincronizados via ERP deverão permanecer preservados;
O sistema deverá controlar a origem do endereço;
Alterações em endereços internos não deverão impactar diretamente os registros do ERP;

Controle de Permissões

O sistema deverá permitir configuração de permissões para:

Incluir novos endereços no fluxo de pedido;
Tela onde poderá ser feita inclusão, edição e exclusão de endereços cadastrados no Geosales Evo;

Documentos relacionados

Escopo

Escopo Incluso

Cadastro manual de endereços de entrega;
Edição de endereços;
Exclusão de endereços;
Consulta/listagem de endereços;
Integração com fluxo de pedidos;
Compatibilidade com endereços vindos do ERP.

Escopo Não Incluso

Alterações na estrutura cadastral do ERP;
Sincronização bidirecional de exclusão com ERP;
Geolocalização automática de endereços;
Validação externa de CEP/endereço;
Controle avançado de roteirização logística.

Atores

Vendedor
Supervisor Comercial
Administrador do Sistema

Pré-condições

Cliente devidamente cadastrado no sistema;
Usuário autenticado no sistema;
Usuário possuir permissão para manutenção cadastral;
Integração ERP ativa, quando aplicável.

Regras de Negócio

[RN1] - O sistema deve permitir múltiplos endereços de entrega por cliente;

[RN2] - Endereços oriundos do ERP poderão ser apenas visualizados ou seguir permissões específicas definidas pelo cliente;

[RN3] - O sistema deve validar campos obrigatórios do endereço;

[RN4] - Não será permitido excluir endereço vinculado a pedido em aberto, caso definido em regra operacional;

[RN5] - O endereço cadastrado deverá ficar imediatamente disponível para seleção em novos pedidos;

[RN6] - A visualização para inserir novo endereço no fluxo de pedido e a tela de consulta e gerenciamento, deve ser controlados pelo controle de ações.

[RN7] - Ao inserir ou editar um novo endereço, devem ser preenchidos no mínimo: Cep, Logradouro, número, bairro, cidade e estado.

[RN8] - Qualquer usuário que tiver acesso a tela que permitir inserir, editar ou excluir um endereço ligado ao cliente poderá realizar estas operações, o sistema não fará validações de quem realizou inclusão, edição ou exclusão de um endereço adicionado dentro do Geosales Evo.

[RN9] - A opção que permitirá a inclusão, edição e exclusão estará disponível apenas no portal.

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
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

@@ Linha 5: / Linha 5: @@
 ! Comentários
 |-
-|  27/03/2026  || Renato Lima || Criação do documento
+|  19/05/2026  || Renato Lima || Criação do documento
 |-
 |}
 == Necessidade ==
+O cliente identificou a necessidade de ampliar o gerenciamento de endereços de entrega no fluxo comercial do Geosales Evo. Atualmente, o sistema disponibiliza apenas os endereços provenientes do ERP integrado, não permitindo que os usuários realizem cadastros ou manutenções diretamente na plataforma.
+Diante da necessidade operacional, o cliente precisa que seja possível cadastrar, editar e excluir endereços de entrega diretamente no sistema, independentemente da integração com o ERP, garantindo maior autonomia operacional e agilidade durante o processo comercial.
 == Solução ==
+Adequar o Geosales Evo para permitir o gerenciamento interno de endereços de entrega vinculados ao cadastro do cliente, complementando os endereços já disponibilizados através da integração com o ERP.
+A solução deverá contemplar:
+* Permitir cadastro manual de novos endereços de entrega diretamente no sistema, ao incluir um pedido;
+* Disponibilizar uma tela de gerenciamento de endereços no cadastro do cliente;
+* Permitir utilização dos endereços cadastrados durante o fluxo de criação do pedido;
+* Manter compatibilidade com os endereços já sincronizados via ERP;
+* Garantir controle e padronização das informações cadastrais.
 == 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 completo dos endereços de entrega diretamente na plataforma.
+=== Adequações Funcionais ===
+O sistema deverá disponibilizar uma nova estrutura de gerenciamento de endereços no cadastro do cliente, permitindo:
+* Inclusão manual de novos endereços de entrega;
+* Edição de endereços cadastrados;
+* Exclusão de endereços conforme regras de negócio;
+* Consulta/listagem dos endereços disponíveis;
+* Definição de endereço principal/padrão, quando aplicável;
+* Identificação visual dos endereços oriundos do ERP e dos cadastrados manualmente no sistema.
+=== Adequações no Cadastro do Cliente ===
+Será necessário incluir uma nova opção que permita consultar e realizar atualizações contendo:
+* Grid/listagem dos endereços cadastrados;
+*Ações de incluir, editar e excluir;
+* Informações mínimas:
+* Descrição do endereço;
+* CEP;
+* Logradouro;
+* Número;
+* Complemento;
+* Bairro;
+* Cidade;
+* Estado;
+* Referência;
+* Origem do endereço (ERP ou Sistema).
+=== Adequações no Fluxo de Pedido ===
+Durante a criação do pedido:
+* O sistema deverá apresentar todos os endereços disponíveis do cliente;
+* O vendedor poderá selecionar um endereço já existente;
+* O sistema deverá permitir cadastro rápido de endereço sem necessidade de sair do pedido, quando permitido;
+* Após cadastro, o endereço deverá ficar imediatamente disponível para utilização no pedido atual.
+=== Regras de Persistência e Integração ===
+* Os endereços cadastrados manualmente deverão ser armazenados em estrutura própria do sistema;
+* Os endereços sincronizados via ERP deverão permanecer preservados;
+* O sistema deverá controlar a origem do endereço;
+* Alterações em endereços internos não deverão impactar diretamente os registros do ERP;
+=== Controle de Permissões ===
+O sistema deverá permitir configuração de permissões para:
+* Incluir novos endereços no fluxo de pedido;
+* Tela onde poderá ser feita inclusão, edição e exclusão de endereços cadastrados no Geosales Evo;
 == Documentos relacionados ==
@@ Linha 20: / Linha 84: @@
 === Escopo Incluso ===
+* Cadastro manual de endereços de entrega;
+*Edição de endereços;
+* Exclusão de endereços;
+* Consulta/listagem de endereços;
+* Integração com fluxo de pedidos;
+* Compatibilidade com endereços vindos do ERP.
 === Escopo Não Incluso ===
+* Alterações na estrutura cadastral do ERP;
+* Sincronização bidirecional de exclusão com ERP;
+* Geolocalização automática de endereços;
+* Validação externa de CEP/endereço;
+* Controle avançado de roteirização logística.
 == Atores ==
-* '''Administrador -'''	Responsável por cadastrar e configurar pesquisas
+* Vendedor
-* '''Usuário Operacional -'''	Responsável pela aplicação das pesquisas
+* Supervisor Comercial
-* '''Sistema -'''Responsável por validar o público-alvo e disponibilizar as pesquisas corretas
+* Administrador do Sistema
 == Pré-condições ==
+* Cliente devidamente cadastrado no sistema;
+* Usuário autenticado no sistema;
+* Usuário possuir permissão para manutenção cadastral;
+* Integração ERP ativa, quando aplicável.
 == Regras de Negócio ==
-'''[RN1] - '''
+'''[RN1] - ''' O sistema deve permitir múltiplos endereços de entrega por cliente;
+'''[RN2] - ''' Endereços oriundos do ERP poderão ser apenas visualizados ou seguir permissões específicas definidas pelo cliente;
-'''[RN2] - '''
+'''[RN3] - ''' O sistema deve validar campos obrigatórios do endereço;
-'''[RN3] - '''
+'''[RN4] - ''' Não será permitido excluir endereço vinculado a pedido em aberto, caso definido em regra operacional;
-'''[RN4] - '''
+'''[RN5] - ''' O endereço cadastrado deverá ficar imediatamente disponível para seleção em novos pedidos;
-'''[RN5] - '''
+'''[RN6] - ''' A visualização para inserir novo endereço no fluxo de pedido e a tela de consulta e gerenciamento, deve ser controlados pelo controle de ações.
-'''[RN6] - '''
+'''[RN7] - ''' Ao inserir ou editar um novo endereço, devem ser preenchidos no mínimo: Cep, Logradouro, número, bairro, cidade e estado.
-'''[RN7] - '''
+'''[RN8] - ''' Qualquer usuário que tiver acesso a tela que permitir inserir, editar ou excluir um endereço ligado ao cliente poderá realizar estas operações, o sistema não fará validações de quem realizou inclusão, edição ou exclusão de um endereço adicionado dentro do Geosales Evo.
+'''[RN9] - ''' A opção que permitirá a inclusão, edição e exclusão estará disponível apenas no portal.
 == Fluxograma ==
-[[Arquivo:Diagrama_pesquisa.jpg|800px]]
+[[Arquivo:Diagrama_cadastroendereco.jpg|1100px]]
 == Aprovação ==