Mudanças entre as edições de "Adicionar novos campos ao cadastro de prospect"

De GeoSales
Ir para navegação Ir para pesquisar
 
(19 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 15: Linha 15:
  
 
== Solução ==
 
== Solução ==
−
Para atender a essa necessidade, a CONTRATADA irá customizar o cadastro de Prospect, contemplando a inclusão dos campos “Laudo” e “Simples Nacional”, com a devida modelagem, validação e integração com o Protheus, garantindo a sincronização e a confiabilidade dos dados entre os sistemas.
+
Para atender a essa necessidade, iremos customizar o cadastro de Prospect, contemplando a '''inclusão dos campos “Laudo” e “Simples Nacional”,''' com a devida modelagem, validação e integração com o ERP, garantindo a sincronização e a confiabilidade dos dados entre os sistemas.
−
Adicionalmente, será criada uma nova aba de Regras de Entrega no cadastro de Prospect, permitindo o registro e manutenção das informações logísticas de forma estruturada e centralizada. Nessa aba, poderão ser cadastrados dados como Grupo de Veículos, Calendário, Hora Inicial e Hora Final, Regra de Entrega, indicador de Paletização, Agendamento e Shelf Life.
+
Adicionalmente, será '''criada uma nova aba de Regras de Entrega no cadastro de Prospect''', permitindo o registro e manutenção das informações logísticas de forma estruturada e centralizada. Nessa aba, poderão ser '''cadastrados dados como Grupo de Veículos, Calendário, Hora Inicial e Hora Final, Regra de Entrega, indicador de Paletização, Agendamento e Shelf Life.'''
  
−
A solução proporcionará a CONTRATANTE maior padronização das informações, redução de erros operacionais, melhor planejamento logístico e suporte aos processos comerciais e fiscais, assegurando que os dados do Prospect estejam completos, atualizados e disponíveis para utilização nos fluxos operacionais e integrações com o Protheus
+
A solução proporcionará a maior padronização das informações, redução de erros operacionais, melhor planejamento logístico e suporte aos processos comerciais e fiscais, assegurando que os dados do Prospect estejam completos, atualizados e disponíveis para utilização nos fluxos operacionais e integrações com o Protheus
  
 
== Regras de Negócio ==
 
== Regras de Negócio ==
Linha 24: Linha 24:
 
===Cadastro de Prospect (Campos Fiscais + Regras de Entrega)===
 
===Cadastro de Prospect (Campos Fiscais + Regras de Entrega)===
  
−
'''[RN1] – Inclusão obrigatória dos novos campos no cadastro'''
+
'''[RN1] – Inclusão dos novos campos no cadastro'''
  
−
O cadastro de Prospect deverá conter os novos campos “Laudo” e “Simples Nacional”, disponíveis para consulta e manutenção conforme permissão do usuário.
+
O cadastro de Prospect deverá conter os novos campos '''“Laudo”''' e '''“Simples Nacional”''' na aba dados do cliente no bloco de dados informações adicionais, disponíveis para consulta e manutenção conforme permissão do usuário e devem permitir a configuração de campos obrigatórios ou não.
  
 
'''[RN2] – Campo “Simples Nacional” com domínio controlado'''
 
'''[RN2] – Campo “Simples Nacional” com domínio controlado'''
  
−
O campo Simples Nacional deverá possuir domínio controlado, permitindo apenas valores pré-definidos, como por exemplo:
+
O campo '''Simples Nacional''' deverá possuir domínio controlado, permitindo apenas valores pré-definidos, como por exemplo:
  
−
Sim
+
- Sim
  
−
Não
+
- Não
  
−
Não informado (opcional, caso definido pela CONTRATANTE)
+
'''[RN3] – Campo “Laudo” com tipo definido'''
 +
 
 +
O campo '''Laudo''' deverá possuir domínio controlado, permitindo apenas valores pré-definidos, como por exemplo:
  
−
'''[RN3] – Campo “Laudo” com tipo definido'''
+
- Sim
  
−
O campo Laudo deverá ser implementado conforme definição técnica acordada (ex.: texto, número, código ou indicador), garantindo compatibilidade com o Protheus.
+
- Não
  
 
'''[RN4] – Validação de preenchimento conforme regra fiscal'''
 
'''[RN4] – Validação de preenchimento conforme regra fiscal'''
  
−
Caso existam regras fiscais internas (Protheus ou política da CONTRATANTE) que exijam Laudo e/ou Simples Nacional, o sistema deverá validar o preenchimento antes de permitir salvar o Prospect.
+
Caso existam regras fiscais internas que exijam Laudo e/ou Simples Nacional, o sistema deverá permitir ao usuário definir estes campos com o preenchimento obrigatório ou não antes de permitir salvar o Prospect.
  
−
'''[RN5] – Integração obrigatória com o Protheus'''
+
'''[RN5] – Integração obrigatória com o ERP'''
  
−
Os campos Laudo e Simples Nacional deverão ser enviados na integração com o Protheus, garantindo sincronização entre os sistemas.
+
Os campos Laudo e Simples Nacional deverão ser enviados na integração com o ERP, garantindo sincronização entre os sistemas.
  
 
'''[RN6] – Sincronização e consistência de dados'''
 
'''[RN6] – Sincronização e consistência de dados'''
  
−
Após integração, o sistema deverá garantir que os dados gravados no Protheus estejam consistentes com o cadastro do Prospect no sistema de origem, evitando divergências.
+
Após integração, o sistema deverá garantir que os dados gravados no ERP estejam consistentes com o cadastro do Prospect no sistema de origem, evitando divergências.
  
−
Regras de Negócio — Aba “Regras de Entrega” no Prospect
+
===Aba “Regras de Entrega” no Prospect===
  
 
'''[RN7] – Disponibilização da aba no cadastro do Prospect'''
 
'''[RN7] – Disponibilização da aba no cadastro do Prospect'''
Linha 64: Linha 66:
 
Cada regra cadastrada deverá conter, no mínimo:
 
Cada regra cadastrada deverá conter, no mínimo:
  
−
Grupo de Veículos
+
'''- Grupo de Veículos:''' Deve vir do ERP e o campo deve ser de seleção:
−
 
 
−
Calendário
 
  
−
Hora Inicial
+
'''- Calendário:''' Deve vir do ERP e o campo deve ser de seleção;
  
−
Hora Final
+
'''- Hora Inicial:''' Campo no formato de horas que permite selecionar um horário
  
−
Regra de Entrega
+
'''- Hora Final:''' Campo no formato de horas que permite selecionar um horário
  
−
(Os demais campos podem ser obrigatórios conforme decisão do negócio.)
+
'''- Regra de Entrega:''' O campo deve conter dois valores Regra ou Exceção;
  
 
'''[RN9] – Validação de horário'''
 
'''[RN9] – Validação de horário'''
Linha 84: Linha 84:
 
O sistema deverá permitir o cadastro de mais de uma Regra de Entrega por Prospect, para suportar cenários com múltiplas janelas, grupos de veículos ou calendários diferentes.
 
O sistema deverá permitir o cadastro de mais de uma Regra de Entrega por Prospect, para suportar cenários com múltiplas janelas, grupos de veículos ou calendários diferentes.
  
−
'''[RN11] – Identificação do tipo de entrega'''
+
'''[RN11] – Paletização como indicador'''
−
 
 
−
O campo Regra de Entrega deverá permitir seleção ou descrição estruturada conforme padrão definido (ex.: “Entrega Normal”, “Entrega Agendada”, “Somente em dias úteis”, etc.).
 
−
 
 
−
'''[RN12] – Paletização como indicador'''
 
  
 
O campo Paletizado deverá ser um indicador (Sim/Não) para representar se o Prospect exige entrega paletizada.
 
O campo Paletizado deverá ser um indicador (Sim/Não) para representar se o Prospect exige entrega paletizada.
  
−
'''[RN13] – Agendamento como indicador'''
+
'''[RN12] – Agendamento como indicador'''
  
 
O campo Agendamento deverá ser um indicador (Sim/Não) para representar se o Prospect exige agendamento prévio para recebimento.
 
O campo Agendamento deverá ser um indicador (Sim/Não) para representar se o Prospect exige agendamento prévio para recebimento.
  
−
'''[RN14] – Shelf Life com validação numérica'''
+
'''[RN13] – Shelf Life com validação numérica'''
−
 
 
−
O campo Shelf Life deverá aceitar apenas valores numéricos (ex.: em dias), não permitindo caracteres inválidos.
 
−
 
 
−
'''[RN15] – Controle de permissões'''
 
−
 
 
−
A inclusão, edição e exclusão das Regras de Entrega deverão respeitar permissões de perfil (ex.: usuários sem permissão poderão apenas consultar).
 
−
 
 
−
'''[RN16] – Rastreabilidade das alterações'''
 
−
 
 
−
O sistema deverá manter registro de auditoria (quando aplicável no padrão do sistema), contemplando ao menos:
 
−
 
 
−
Usuário responsável pela alteração
 
−
 
 
−
Data/Hora
 
−
 
 
−
Tipo de alteração (inclusão/edição/exclusão)
 
−
 
 
−
Regras de Negócio — Uso das informações no processo
 
−
 
 
−
'''[RN17] – Consulta centralizada'''
 
  
−
As Regras de Entrega cadastradas deverão ficar disponíveis para consulta durante os fluxos operacionais e comerciais que utilizam Prospect (ex.: criação de pedido, validações logísticas, análise de entrega).
+
O campo Shelf Life deverá aceitar apenas valores numéricos (ex.:porcentagem), não permitindo caracteres inválidos.
  
−
'''[RN18] – Dados sempre atualizados para integração'''
+
'''[RN14] – Controle de Obrigatoriedade'''
  
−
Sempre que houver alteração nos campos fiscais ou nas regras de entrega, o sistema deverá garantir que a versão mais atual seja considerada para integração e para uso operacional.
+
Todos os campos da nova aba, sua obrigatoriedade devem permitir torna-los o preenchimento obrigatório através da tabela campo Contexto.
  
 
== Regras de Integração ==
 
== Regras de Integração ==
  
  
−
'''[RI1] - ''' Ajustar a integração de pedido, afim de tratar o tipo de operação do item, já que em um pedido pode ter itens de venda e itens de bonificação.
+
'''[RI1] - ''' Todos os novos campos devem ser integrados ao ERP, para que o cadastro deste novos clientes possam ser integrados de forma completa.
  
 
== Aprovação ==
 
== Aprovação ==

Edição atual tal como às 12h09min de 16 de fevereiro de 2026

Histórico de Alterações

Data Quem Comentários
13/02/2026 Renato Lima Criação do documento

Necessidade

A necessidade de customizar o cadastro de Prospect, visando atender suas demandas fiscais, operacionais e logísticas, bem como garantir maior consistência das informações integradas ao ERP Protheus. Atualmente, o cadastro não contempla dados que para a CONTRATANTE são essenciais para o correto enquadramento tributário e para o controle das condições de entrega, o que pode gerar retrabalho, inconsistências de informação e falhas nos processos comerciais e logísticos.

Dessa forma, viu que era necessário ampliar o cadastro de Prospect com a inclusão dos campos “Laudo” e “Simples Nacional”, assegurando a integração dessas informações com o Protheus. Além disso, há a necessidade de centralizar e padronizar as Regras de Entrega associadas ao Prospect, permitindo o registro estruturado de informações como grupo de veículos, calendário, horários, regras operacionais, paletização, agendamento e shelf life, de modo a facilitar a consulta, o planejamento e a correta execução das entregas.

Solução

Para atender a essa necessidade, iremos customizar o cadastro de Prospect, contemplando a inclusão dos campos “Laudo” e “Simples Nacional”, com a devida modelagem, validação e integração com o ERP, garantindo a sincronização e a confiabilidade dos dados entre os sistemas. Adicionalmente, será criada uma nova aba de Regras de Entrega no cadastro de Prospect, permitindo o registro e manutenção das informações logísticas de forma estruturada e centralizada. Nessa aba, poderão ser cadastrados dados como Grupo de Veículos, Calendário, Hora Inicial e Hora Final, Regra de Entrega, indicador de Paletização, Agendamento e Shelf Life.

A solução proporcionará a maior padronização das informações, redução de erros operacionais, melhor planejamento logístico e suporte aos processos comerciais e fiscais, assegurando que os dados do Prospect estejam completos, atualizados e disponíveis para utilização nos fluxos operacionais e integrações com o Protheus

Regras de Negócio

Cadastro de Prospect (Campos Fiscais + Regras de Entrega)

[RN1] – Inclusão dos novos campos no cadastro

O cadastro de Prospect deverá conter os novos campos “Laudo” e “Simples Nacional” na aba dados do cliente no bloco de dados informações adicionais, disponíveis para consulta e manutenção conforme permissão do usuário e devem permitir a configuração de campos obrigatórios ou não.

[RN2] – Campo “Simples Nacional” com domínio controlado

O campo Simples Nacional deverá possuir domínio controlado, permitindo apenas valores pré-definidos, como por exemplo:

- Sim

- Não

[RN3] – Campo “Laudo” com tipo definido

O campo Laudo deverá possuir domínio controlado, permitindo apenas valores pré-definidos, como por exemplo:

- Sim

- Não

[RN4] – Validação de preenchimento conforme regra fiscal

Caso existam regras fiscais internas que exijam Laudo e/ou Simples Nacional, o sistema deverá permitir ao usuário definir estes campos com o preenchimento obrigatório ou não antes de permitir salvar o Prospect.

[RN5] – Integração obrigatória com o ERP

Os campos Laudo e Simples Nacional deverão ser enviados na integração com o ERP, garantindo sincronização entre os sistemas.

[RN6] – Sincronização e consistência de dados

Após integração, o sistema deverá garantir que os dados gravados no ERP estejam consistentes com o cadastro do Prospect no sistema de origem, evitando divergências.

Aba “Regras de Entrega” no Prospect

[RN7] – Disponibilização da aba no cadastro do Prospect

O cadastro de Prospect deverá conter uma aba chamada “Regras de Entrega”, onde serão registradas informações logísticas do Prospect.

[RN8] – Estrutura mínima de campos obrigatórios na regra

Cada regra cadastrada deverá conter, no mínimo:

- Grupo de Veículos: Deve vir do ERP e o campo deve ser de seleção:

- Calendário: Deve vir do ERP e o campo deve ser de seleção;

- Hora Inicial: Campo no formato de horas que permite selecionar um horário

- Hora Final: Campo no formato de horas que permite selecionar um horário

- Regra de Entrega: O campo deve conter dois valores Regra ou Exceção;

[RN9] – Validação de horário

O sistema deverá validar que a Hora Inicial seja menor que a Hora Final, não permitindo salvar registros inválidos.

[RN10] – Permitir múltiplas regras por Prospect

O sistema deverá permitir o cadastro de mais de uma Regra de Entrega por Prospect, para suportar cenários com múltiplas janelas, grupos de veículos ou calendários diferentes.

[RN11] – Paletização como indicador

O campo Paletizado deverá ser um indicador (Sim/Não) para representar se o Prospect exige entrega paletizada.

[RN12] – Agendamento como indicador

O campo Agendamento deverá ser um indicador (Sim/Não) para representar se o Prospect exige agendamento prévio para recebimento.

[RN13] – Shelf Life com validação numérica

O campo Shelf Life deverá aceitar apenas valores numéricos (ex.:porcentagem), não permitindo caracteres inválidos.

[RN14] – Controle de Obrigatoriedade

Todos os campos da nova aba, sua obrigatoriedade devem permitir torna-los o preenchimento obrigatório através da tabela campo Contexto.

Regras de Integração

[RI1] - Todos os novos campos devem ser integrados ao ERP, para que o cadastro deste novos clientes possam ser integrados de forma completa.

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
Disponível em “http://wiki.geosales.com.br:8000/index.php?title=Adicionar_novos_campos_ao_cadastro_de_prospect&oldid=18639”