Adicionar novos campos ao cadastro de prospect
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, 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. 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
Regras de Negócio
Cadastro de Prospect (Campos Fiscais + Regras de Entrega)
[RN1] – Inclusão obrigatória 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.
[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
Não informado (opcional, caso definido pela CONTRATANTE)
[RN3] – Campo “Laudo” com tipo definido
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.
[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.
[RN5] – Integração obrigatória com o Protheus
Os campos Laudo e Simples Nacional deverão ser enviados na integração com o Protheus, 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 Protheus estejam consistentes com o cadastro do Prospect no sistema de origem, evitando divergências.
Regras de Negócio — 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
Calendário
Hora Inicial
Hora Final
Regra de Entrega
(Os demais campos podem ser obrigatórios conforme decisão do negócio.)
[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] – Identificação do tipo de entrega
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.
[RN13] – Agendamento como indicador
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
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).
[RN18] – Dados sempre atualizados para integração
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.
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.
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 |