GeoSales - Contribuições do(a) usuário(a) [pt-br]

Desconto Hierarquia com Agrupamento por Tabela de Preço, Produto e Validade

2026-06-17T17:43:00Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 15/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Possui a necessidade de ampliar a flexibilidade na aplicação de descontos comerciais, permitindo a criação de um novo tipo de desconto agrupado por tabela de preço e produto, com controle de validade por período de vigência.

Atualmente, o sistema contempla a funcionalidade de desconto por hierarquia, porém este modelo não atende integralmente ao cenário desejado, onde é necessário um nível adicional de segmentação e controle, possibilitando a definição de políticas comerciais mais específicas e aderentes às estratégias de precificação da empresa.

Dessa forma, torna-se necessária a implementação de uma nova modalidade de desconto que permita maior granularidade na concessão de descontos, mantendo a compatibilidade com as regras e processos já existentes no sistema.

== Solução ==
Será desenvolvida uma nova modalidade de desconto baseada na combinação de Tabela de Preço e Produto, utilizando como referência a estrutura já existente de desconto por hierarquia.

A solução contemplará:

Cadastro de descontos vinculados a uma tabela de preço específica;
Associação dos descontos a produtos específicos;
Definição de período de vigência através de data inicial e data final;
Reaproveitamento da estrutura operacional do desconto por hierarquia;
Aplicação automática durante o cálculo dos descontos do pedido;
Respeito às validações, restrições e comportamentos já existentes no mecanismo atual de descontos;
Consideração das regras de priorização já definidas pelo sistema para determinação do desconto aplicável.

== Implementação ==
Será implementada uma nova opção de Desconto por Tabela de Preço e Produto na funcionalidade de desconto hierarquia, com o objetivo de proporcionar maior flexibilidade na definição de políticas comerciais e permitir uma segmentação mais granular na concessão de descontos.

A solução será construída utilizando como referência a estrutura já existente de Desconto por Hierarquia, aproveitando seus mecanismos de validação, processamento e aplicação, de forma a manter a consistência operacional do sistema e minimizar impactos nos processos atualmente em uso.

A nova funcionalidade permitirá o cadastro de descontos vinculados simultaneamente a uma tabela de preço e a um produto específico, possibilitando a definição de um percentual de desconto e seu respectivo período de vigência, através de data inicial e data final.

Durante o processo de formação do pedido, o sistema realizará automaticamente a consulta dos descontos cadastrados e vigentes para a combinação de tabela de preço e produto selecionada, aplicando o desconto conforme as regras de cálculo e priorização já existentes no GeoSales.

Todas as validações, restrições e comportamentos atualmente utilizados no modelo de desconto por hierarquia serão preservados, garantindo que a nova modalidade de desconto opere de forma integrada ao processo comercial já estabelecido, sem comprometer a padronização das regras de negócio existentes.

A implementação contemplará os ajustes necessários nas estruturas de cadastro, consultas e processamento dos descontos, permitindo que o novo tipo de desconto seja administrado pelos usuários autorizados e considerado automaticamente pelo sistema durante a inclusão e manutenção dos pedidos.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Criação de estrutura para cadastro de desconto por tabela de preço e produto;
* Inclusão de campos para controle de vigência do desconto;
* Desenvolvimento das regras de consulta e validação durante a digitação do pedido;
* Integração com o motor de cálculo de descontos existente;
* Reutilização das regras e comportamentos já implementados para desconto hierárquico;
* Ajustes de telas e processos necessários para manutenção dos novos registros;
* Testes unitários e integrados da funcionalidade.

=== Escopo Não Incluso ===
* Alterações nas regras de prioridade atualmente existentes;
* Criação de novos tipos de descontos além do descrito neste documento;
* Alterações em processos de integração com sistemas terceiros;
* Desenvolvimento de relatórios gerenciais específicos;
* Revisão ou remodelagem da política comercial da CONTRATANTE.

== Atores ==
'''Administrador Comercial -''' Responsável por cadastrar, alterar, consultar e inativar os descontos por tabela de preço e produto.

'''Gestor Comercial -''' Responsável por definir as políticas comerciais e validar as configurações dos descontos cadastrados.

'''Vendedor -'''Usuário que realiza a inclusão de pedidos e terá os descontos aplicados automaticamente conforme as configurações vigentes.

'''Sistema GeoSales -'''Responsável por validar, consultar e aplicar automaticamente os descontos configurados durante o processo de formação do pedido.

== Pré-condições ==
* O usuário deverá possuir permissão de acesso ao cadastro de descontos.
* A tabela de preço deverá estar previamente cadastrada e ativa no sistema.
* O produto deverá estar previamente cadastrado e ativo no sistema.
* O percentual de desconto deverá estar dentro dos limites definidos pelas regras comerciais da empresa.
* O período de vigência informado deverá possuir data inicial e data final válidas.
* O pedido deverá possuir uma tabela de preço associada para que o desconto possa ser identificado e aplicado.
* As parametrizações relacionadas ao cálculo de descontos deverão estar devidamente configuradas no ambiente.

== Regras de Negócio ==

'''[RN1] - ''' '''Cadastro do Desconto'''

O sistema deverá permitir o cadastro de descontos vinculados obrigatoriamente a uma combinação de Tabela de Preço e Produto.

'''[RN2] - ''' '''Vigência do Desconto'''

Todo desconto cadastrado deverá possuir uma Data Inicial e uma Data Final de vigência. O desconto somente poderá ser considerado para aplicação quando a data do pedido estiver compreendida dentro do período informado.

'''[RN3] - ''' '''Validação de Período'''

O sistema não deverá permitir o cadastro de registros onde a Data Final seja inferior à Data Inicial.

'''[RN4] - ''' '''Produto Válido'''

O desconto somente poderá ser associado a produtos ativos e devidamente cadastrados no sistema.

'''[RN5] - ''' '''Tabela de Preço Válida'''

O desconto somente poderá ser associado a tabelas de preço ativas e devidamente cadastradas no sistema.

'''[RN6] - ''' '''Aplicação Automática'''

Durante a inclusão ou manutenção do pedido, o sistema deverá consultar automaticamente os descontos vigentes cadastrados para a combinação de tabela de preço e produto do item.

'''[RN7] - ''' '''Respeito às Regras Existentes'''

A nova modalidade de desconto deverá utilizar as mesmas validações, restrições e comportamentos já existentes na funcionalidade de Desconto por Hierarquia.

'''[RN8] - ''' '''Controle de Permissão'''

Somente usuários com permissão para manutenção de descontos poderão incluir, alterar, consultar ou excluir registros de desconto por tabela de preço e produto.

'''[RN9] - ''' '''Consideração da Vigência'''

Descontos com vigência expirada ou ainda não iniciada não deverão ser considerados durante o cálculo do pedido.

'''[RN10] - ''' '''Aplicação por Item'''

A validação e aplicação do desconto deverão ocorrer individualmente para cada item do pedido, considerando o produto e a tabela de preço utilizados no respectivo item.

'''[RN11] - ''' '''Priorização de Descontos'''

Quando existirem múltiplas regras de desconto elegíveis para um mesmo item, o sistema deverá respeitar as regras de priorização já implementadas no GeoSales.

'''[RN12] - ''' '''Atualização Imediata'''

Após o cadastro, alteração ou exclusão de um desconto, as novas informações deverão ser consideradas nas próximas inclusões e recálculos de pedidos, sem necessidade de intervenção manual adicional.

'''[RN13] - ''' '''Integridade dos Dados'''

O sistema deverá garantir a integridade dos vínculos entre desconto, produto e tabela de preço, impedindo referências a registros inexistentes ou inativos.

'''[RN14] - ''' '''Compatibilidade com Funcionalidades Existentes'''

A implementação não deverá alterar o comportamento das funcionalidades atualmente existentes de desconto por hierarquia, mantendo a compatibilidade com as regras já homologadas e em produção.

== Fluxograma ==
[[Arquivo:Diagrama_sem_nome.drawio.png|1100px]]

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Desconto Hierarquia com Agrupamento por Tabela de Preço, Produto e Validade

2026-06-16T11:41:00Z

Renatolima: /* Escopo */

Desconto Hierarquia com Agrupamento por Tabela de Preço, Produto e Validade

2026-06-15T19:30:21Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 15/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Possui a necessidade de ampliar a flexibilidade na aplicação de descontos comerciais, permitindo a criação de um novo tipo de desconto agrupado por tabela de preço e produto, com controle de validade por período de vigência.

Atualmente, o sistema contempla a funcionalidade de desconto por hierarquia, porém este modelo não atende integralmente ao cenário desejado, onde é necessário um nível adicional de segmentação e controle, possibilitando a definição de políticas comerciais mais específicas e aderentes às estratégias de precificação da empresa.

Dessa forma, torna-se necessária a implementação de uma nova modalidade de desconto que permita maior granularidade na concessão de descontos, mantendo a compatibilidade com as regras e processos já existentes no sistema.

== Solução ==
Será desenvolvida uma nova modalidade de desconto baseada na combinação de Tabela de Preço e Produto, utilizando como referência a estrutura já existente de desconto por hierarquia.

A solução contemplará:

Cadastro de descontos vinculados a uma tabela de preço específica;
Associação dos descontos a produtos específicos;
Definição de período de vigência através de data inicial e data final;
Reaproveitamento da estrutura operacional do desconto por hierarquia;
Aplicação automática durante o cálculo dos descontos do pedido;
Respeito às validações, restrições e comportamentos já existentes no mecanismo atual de descontos;
Consideração das regras de priorização já definidas pelo sistema para determinação do desconto aplicável.

== Implementação ==
Será implementada uma nova opção de Desconto por Tabela de Preço e Produto na funcionalidade de desconto hierarquia, com o objetivo de proporcionar maior flexibilidade na definição de políticas comerciais e permitir uma segmentação mais granular na concessão de descontos.

A solução será construída utilizando como referência a estrutura já existente de Desconto por Hierarquia, aproveitando seus mecanismos de validação, processamento e aplicação, de forma a manter a consistência operacional do sistema e minimizar impactos nos processos atualmente em uso.

A nova funcionalidade permitirá o cadastro de descontos vinculados simultaneamente a uma tabela de preço e a um produto específico, possibilitando a definição de um percentual de desconto e seu respectivo período de vigência, através de data inicial e data final.

Durante o processo de formação do pedido, o sistema realizará automaticamente a consulta dos descontos cadastrados e vigentes para a combinação de tabela de preço e produto selecionada, aplicando o desconto conforme as regras de cálculo e priorização já existentes no GeoSales.

Todas as validações, restrições e comportamentos atualmente utilizados no modelo de desconto por hierarquia serão preservados, garantindo que a nova modalidade de desconto opere de forma integrada ao processo comercial já estabelecido, sem comprometer a padronização das regras de negócio existentes.

A implementação contemplará os ajustes necessários nas estruturas de cadastro, consultas e processamento dos descontos, permitindo que o novo tipo de desconto seja administrado pelos usuários autorizados e considerado automaticamente pelo sistema durante a inclusão e manutenção dos pedidos.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
Criação de estrutura para cadastro de desconto por tabela de preço e produto;
Inclusão de campos para controle de vigência do desconto;
Desenvolvimento das regras de consulta e validação durante a digitação do pedido;
Integração com o motor de cálculo de descontos existente;
Reutilização das regras e comportamentos já implementados para desconto hierárquico;
Ajustes de telas e processos necessários para manutenção dos novos registros;
Testes unitários e integrados da funcionalidade.

=== Escopo Não Incluso ===
Alterações nas regras de prioridade atualmente existentes;
Criação de novos tipos de descontos além do descrito neste documento;
Alterações em processos de integração com sistemas terceiros;
Desenvolvimento de relatórios gerenciais específicos;
Revisão ou remodelagem da política comercial da CONTRATANTE.

== Atores ==
'''Administrador Comercial -''' Responsável por cadastrar, alterar, consultar e inativar os descontos por tabela de preço e produto.

'''Gestor Comercial -''' Responsável por definir as políticas comerciais e validar as configurações dos descontos cadastrados.

'''Vendedor -'''Usuário que realiza a inclusão de pedidos e terá os descontos aplicados automaticamente conforme as configurações vigentes.

'''Sistema GeoSales -'''Responsável por validar, consultar e aplicar automaticamente os descontos configurados durante o processo de formação do pedido.

== Pré-condições ==
* O usuário deverá possuir permissão de acesso ao cadastro de descontos.
* A tabela de preço deverá estar previamente cadastrada e ativa no sistema.
* O produto deverá estar previamente cadastrado e ativo no sistema.
* O percentual de desconto deverá estar dentro dos limites definidos pelas regras comerciais da empresa.
* O período de vigência informado deverá possuir data inicial e data final válidas.
* O pedido deverá possuir uma tabela de preço associada para que o desconto possa ser identificado e aplicado.
* As parametrizações relacionadas ao cálculo de descontos deverão estar devidamente configuradas no ambiente.

== Regras de Negócio ==

'''[RN1] - ''' '''Cadastro do Desconto'''

O sistema deverá permitir o cadastro de descontos vinculados obrigatoriamente a uma combinação de Tabela de Preço e Produto.

'''[RN2] - ''' '''Vigência do Desconto'''

Todo desconto cadastrado deverá possuir uma Data Inicial e uma Data Final de vigência. O desconto somente poderá ser considerado para aplicação quando a data do pedido estiver compreendida dentro do período informado.

'''[RN3] - ''' '''Validação de Período'''

O sistema não deverá permitir o cadastro de registros onde a Data Final seja inferior à Data Inicial.

'''[RN4] - ''' '''Produto Válido'''

O desconto somente poderá ser associado a produtos ativos e devidamente cadastrados no sistema.

'''[RN5] - ''' '''Tabela de Preço Válida'''

O desconto somente poderá ser associado a tabelas de preço ativas e devidamente cadastradas no sistema.

'''[RN6] - ''' '''Aplicação Automática'''

Durante a inclusão ou manutenção do pedido, o sistema deverá consultar automaticamente os descontos vigentes cadastrados para a combinação de tabela de preço e produto do item.

'''[RN7] - ''' '''Respeito às Regras Existentes'''

A nova modalidade de desconto deverá utilizar as mesmas validações, restrições e comportamentos já existentes na funcionalidade de Desconto por Hierarquia.

'''[RN8] - ''' '''Controle de Permissão'''

Somente usuários com permissão para manutenção de descontos poderão incluir, alterar, consultar ou excluir registros de desconto por tabela de preço e produto.

'''[RN9] - ''' '''Consideração da Vigência'''

Descontos com vigência expirada ou ainda não iniciada não deverão ser considerados durante o cálculo do pedido.

'''[RN10] - ''' '''Aplicação por Item'''

A validação e aplicação do desconto deverão ocorrer individualmente para cada item do pedido, considerando o produto e a tabela de preço utilizados no respectivo item.

'''[RN11] - ''' '''Priorização de Descontos'''

Quando existirem múltiplas regras de desconto elegíveis para um mesmo item, o sistema deverá respeitar as regras de priorização já implementadas no GeoSales.

'''[RN12] - ''' '''Atualização Imediata'''

Após o cadastro, alteração ou exclusão de um desconto, as novas informações deverão ser consideradas nas próximas inclusões e recálculos de pedidos, sem necessidade de intervenção manual adicional.

'''[RN13] - ''' '''Integridade dos Dados'''

O sistema deverá garantir a integridade dos vínculos entre desconto, produto e tabela de preço, impedindo referências a registros inexistentes ou inativos.

'''[RN14] - ''' '''Compatibilidade com Funcionalidades Existentes'''

A implementação não deverá alterar o comportamento das funcionalidades atualmente existentes de desconto por hierarquia, mantendo a compatibilidade com as regras já homologadas e em produção.

== Fluxograma ==
[[Arquivo:Diagrama_sem_nome.drawio.png|1100px]]

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Desconto Hierarquia com Agrupamento por Tabela de Preço, Produto e Validade

2026-06-15T19:30:07Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 15/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Possui a necessidade de ampliar a flexibilidade na aplicação de descontos comerciais, permitindo a criação de um novo tipo de desconto agrupado por tabela de preço e produto, com controle de validade por período de vigência.

Atualmente, o sistema contempla a funcionalidade de desconto por hierarquia, porém este modelo não atende integralmente ao cenário desejado, onde é necessário um nível adicional de segmentação e controle, possibilitando a definição de políticas comerciais mais específicas e aderentes às estratégias de precificação da empresa.

Dessa forma, torna-se necessária a implementação de uma nova modalidade de desconto que permita maior granularidade na concessão de descontos, mantendo a compatibilidade com as regras e processos já existentes no sistema.

== Solução ==
Será desenvolvida uma nova modalidade de desconto baseada na combinação de Tabela de Preço e Produto, utilizando como referência a estrutura já existente de desconto por hierarquia.

A solução contemplará:

Cadastro de descontos vinculados a uma tabela de preço específica;
Associação dos descontos a produtos específicos;
Definição de período de vigência através de data inicial e data final;
Reaproveitamento da estrutura operacional do desconto por hierarquia;
Aplicação automática durante o cálculo dos descontos do pedido;
Respeito às validações, restrições e comportamentos já existentes no mecanismo atual de descontos;
Consideração das regras de priorização já definidas pelo sistema para determinação do desconto aplicável.

== Implementação ==
Será implementada uma nova opção de Desconto por Tabela de Preço e Produto na funcionalidade de desconto hierarquia, com o objetivo de proporcionar maior flexibilidade na definição de políticas comerciais e permitir uma segmentação mais granular na concessão de descontos.

A solução será construída utilizando como referência a estrutura já existente de Desconto por Hierarquia, aproveitando seus mecanismos de validação, processamento e aplicação, de forma a manter a consistência operacional do sistema e minimizar impactos nos processos atualmente em uso.

A nova funcionalidade permitirá o cadastro de descontos vinculados simultaneamente a uma tabela de preço e a um produto específico, possibilitando a definição de um percentual de desconto e seu respectivo período de vigência, através de data inicial e data final.

Durante o processo de formação do pedido, o sistema realizará automaticamente a consulta dos descontos cadastrados e vigentes para a combinação de tabela de preço e produto selecionada, aplicando o desconto conforme as regras de cálculo e priorização já existentes no GeoSales.

Todas as validações, restrições e comportamentos atualmente utilizados no modelo de desconto por hierarquia serão preservados, garantindo que a nova modalidade de desconto opere de forma integrada ao processo comercial já estabelecido, sem comprometer a padronização das regras de negócio existentes.

A implementação contemplará os ajustes necessários nas estruturas de cadastro, consultas e processamento dos descontos, permitindo que o novo tipo de desconto seja administrado pelos usuários autorizados e considerado automaticamente pelo sistema durante a inclusão e manutenção dos pedidos.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
Criação de estrutura para cadastro de desconto por tabela de preço e produto;
Inclusão de campos para controle de vigência do desconto;
Desenvolvimento das regras de consulta e validação durante a digitação do pedido;
Integração com o motor de cálculo de descontos existente;
Reutilização das regras e comportamentos já implementados para desconto hierárquico;
Ajustes de telas e processos necessários para manutenção dos novos registros;
Testes unitários e integrados da funcionalidade.

=== Escopo Não Incluso ===
Alterações nas regras de prioridade atualmente existentes;
Criação de novos tipos de descontos além do descrito neste documento;
Alterações em processos de integração com sistemas terceiros;
Desenvolvimento de relatórios gerenciais específicos;
Revisão ou remodelagem da política comercial da CONTRATANTE.

== Atores ==
'''Administrador Comercial -''' Responsável por cadastrar, alterar, consultar e inativar os descontos por tabela de preço e produto.

'''Gestor Comercial -''' Responsável por definir as políticas comerciais e validar as configurações dos descontos cadastrados.

'''Vendedor -'''Usuário que realiza a inclusão de pedidos e terá os descontos aplicados automaticamente conforme as configurações vigentes.

'''Sistema GeoSales -'''Responsável por validar, consultar e aplicar automaticamente os descontos configurados durante o processo de formação do pedido.

== Pré-condições ==
* O usuário deverá possuir permissão de acesso ao cadastro de descontos.
* A tabela de preço deverá estar previamente cadastrada e ativa no sistema.
* O produto deverá estar previamente cadastrado e ativo no sistema.
* O percentual de desconto deverá estar dentro dos limites definidos pelas regras comerciais da empresa.
* O período de vigência informado deverá possuir data inicial e data final válidas.
* O pedido deverá possuir uma tabela de preço associada para que o desconto possa ser identificado e aplicado.
* As parametrizações relacionadas ao cálculo de descontos deverão estar devidamente configuradas no ambiente.

== Regras de Negócio ==

'''[RN1] - ''' '''Cadastro do Desconto'''

O sistema deverá permitir o cadastro de descontos vinculados obrigatoriamente a uma combinação de Tabela de Preço e Produto.

'''[RN2] - ''' '''Vigência do Desconto'''

Todo desconto cadastrado deverá possuir uma Data Inicial e uma Data Final de vigência. O desconto somente poderá ser considerado para aplicação quando a data do pedido estiver compreendida dentro do período informado.

'''[RN3] - ''' '''Validação de Período'''

O sistema não deverá permitir o cadastro de registros onde a Data Final seja inferior à Data Inicial.

'''[RN4] - ''' '''Produto Válido'''

O desconto somente poderá ser associado a produtos ativos e devidamente cadastrados no sistema.

'''[RN5] - ''' '''Tabela de Preço Válida'''

O desconto somente poderá ser associado a tabelas de preço ativas e devidamente cadastradas no sistema.

'''[RN6] - ''' '''Aplicação Automática'''

Durante a inclusão ou manutenção do pedido, o sistema deverá consultar automaticamente os descontos vigentes cadastrados para a combinação de tabela de preço e produto do item.

'''[RN7] - ''' '''Respeito às Regras Existentes'''

A nova modalidade de desconto deverá utilizar as mesmas validações, restrições e comportamentos já existentes na funcionalidade de Desconto por Hierarquia.

'''[RN8] - ''' '''Controle de Permissão'''

Somente usuários com permissão para manutenção de descontos poderão incluir, alterar, consultar ou excluir registros de desconto por tabela de preço e produto.

'''[RN9] - ''' '''Consideração da Vigência'''

Descontos com vigência expirada ou ainda não iniciada não deverão ser considerados durante o cálculo do pedido.

'''[RN10] - ''' '''Aplicação por Item'''

A validação e aplicação do desconto deverão ocorrer individualmente para cada item do pedido, considerando o produto e a tabela de preço utilizados no respectivo item.

'''[RN11] - ''' '''Priorização de Descontos'''

Quando existirem múltiplas regras de desconto elegíveis para um mesmo item, o sistema deverá respeitar as regras de priorização já implementadas no GeoSales.

'''[RN12] - ''' '''Atualização Imediata'''

Após o cadastro, alteração ou exclusão de um desconto, as novas informações deverão ser consideradas nas próximas inclusões e recálculos de pedidos, sem necessidade de intervenção manual adicional.

'''[RN13] - ''' '''Integridade dos Dados'''

O sistema deverá garantir a integridade dos vínculos entre desconto, produto e tabela de preço, impedindo referências a registros inexistentes ou inativos.

'''[RN14] - ''' '''Compatibilidade com Funcionalidades Existentes'''

A implementação não deverá alterar o comportamento das funcionalidades atualmente existentes de desconto por hierarquia, mantendo a compatibilidade com as regras já homologadas e em produção.

== Fluxograma ==
[[Arquivo:Diagrama_sem_nome.drawio.png|1200px]]

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Desconto Hierarquia com Agrupamento por Tabela de Preço, Produto e Validade

2026-06-15T19:29:56Z

Renatolima: /* Fluxograma */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 15/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Possui a necessidade de ampliar a flexibilidade na aplicação de descontos comerciais, permitindo a criação de um novo tipo de desconto agrupado por tabela de preço e produto, com controle de validade por período de vigência.

Atualmente, o sistema contempla a funcionalidade de desconto por hierarquia, porém este modelo não atende integralmente ao cenário desejado, onde é necessário um nível adicional de segmentação e controle, possibilitando a definição de políticas comerciais mais específicas e aderentes às estratégias de precificação da empresa.

Dessa forma, torna-se necessária a implementação de uma nova modalidade de desconto que permita maior granularidade na concessão de descontos, mantendo a compatibilidade com as regras e processos já existentes no sistema.

== Solução ==
Será desenvolvida uma nova modalidade de desconto baseada na combinação de Tabela de Preço e Produto, utilizando como referência a estrutura já existente de desconto por hierarquia.

A solução contemplará:

Cadastro de descontos vinculados a uma tabela de preço específica;
Associação dos descontos a produtos específicos;
Definição de período de vigência através de data inicial e data final;
Reaproveitamento da estrutura operacional do desconto por hierarquia;
Aplicação automática durante o cálculo dos descontos do pedido;
Respeito às validações, restrições e comportamentos já existentes no mecanismo atual de descontos;
Consideração das regras de priorização já definidas pelo sistema para determinação do desconto aplicável.

== Implementação ==
Será implementada uma nova opção de Desconto por Tabela de Preço e Produto na funcionalidade de desconto hierarquia, com o objetivo de proporcionar maior flexibilidade na definição de políticas comerciais e permitir uma segmentação mais granular na concessão de descontos.

A solução será construída utilizando como referência a estrutura já existente de Desconto por Hierarquia, aproveitando seus mecanismos de validação, processamento e aplicação, de forma a manter a consistência operacional do sistema e minimizar impactos nos processos atualmente em uso.

A nova funcionalidade permitirá o cadastro de descontos vinculados simultaneamente a uma tabela de preço e a um produto específico, possibilitando a definição de um percentual de desconto e seu respectivo período de vigência, através de data inicial e data final.

Durante o processo de formação do pedido, o sistema realizará automaticamente a consulta dos descontos cadastrados e vigentes para a combinação de tabela de preço e produto selecionada, aplicando o desconto conforme as regras de cálculo e priorização já existentes no GeoSales.

Todas as validações, restrições e comportamentos atualmente utilizados no modelo de desconto por hierarquia serão preservados, garantindo que a nova modalidade de desconto opere de forma integrada ao processo comercial já estabelecido, sem comprometer a padronização das regras de negócio existentes.

A implementação contemplará os ajustes necessários nas estruturas de cadastro, consultas e processamento dos descontos, permitindo que o novo tipo de desconto seja administrado pelos usuários autorizados e considerado automaticamente pelo sistema durante a inclusão e manutenção dos pedidos.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
Criação de estrutura para cadastro de desconto por tabela de preço e produto;
Inclusão de campos para controle de vigência do desconto;
Desenvolvimento das regras de consulta e validação durante a digitação do pedido;
Integração com o motor de cálculo de descontos existente;
Reutilização das regras e comportamentos já implementados para desconto hierárquico;
Ajustes de telas e processos necessários para manutenção dos novos registros;
Testes unitários e integrados da funcionalidade.

=== Escopo Não Incluso ===
Alterações nas regras de prioridade atualmente existentes;
Criação de novos tipos de descontos além do descrito neste documento;
Alterações em processos de integração com sistemas terceiros;
Desenvolvimento de relatórios gerenciais específicos;
Revisão ou remodelagem da política comercial da CONTRATANTE.

== Atores ==
'''Administrador Comercial -''' Responsável por cadastrar, alterar, consultar e inativar os descontos por tabela de preço e produto.

'''Gestor Comercial -''' Responsável por definir as políticas comerciais e validar as configurações dos descontos cadastrados.

'''Vendedor -'''Usuário que realiza a inclusão de pedidos e terá os descontos aplicados automaticamente conforme as configurações vigentes.

'''Sistema GeoSales -'''Responsável por validar, consultar e aplicar automaticamente os descontos configurados durante o processo de formação do pedido.

== Pré-condições ==
* O usuário deverá possuir permissão de acesso ao cadastro de descontos.
* A tabela de preço deverá estar previamente cadastrada e ativa no sistema.
* O produto deverá estar previamente cadastrado e ativo no sistema.
* O percentual de desconto deverá estar dentro dos limites definidos pelas regras comerciais da empresa.
* O período de vigência informado deverá possuir data inicial e data final válidas.
* O pedido deverá possuir uma tabela de preço associada para que o desconto possa ser identificado e aplicado.
* As parametrizações relacionadas ao cálculo de descontos deverão estar devidamente configuradas no ambiente.

== Regras de Negócio ==

'''[RN1] - ''' '''Cadastro do Desconto'''

O sistema deverá permitir o cadastro de descontos vinculados obrigatoriamente a uma combinação de Tabela de Preço e Produto.

'''[RN2] - ''' '''Vigência do Desconto'''

Todo desconto cadastrado deverá possuir uma Data Inicial e uma Data Final de vigência. O desconto somente poderá ser considerado para aplicação quando a data do pedido estiver compreendida dentro do período informado.

'''[RN3] - ''' '''Validação de Período'''

O sistema não deverá permitir o cadastro de registros onde a Data Final seja inferior à Data Inicial.

'''[RN4] - ''' '''Produto Válido'''

O desconto somente poderá ser associado a produtos ativos e devidamente cadastrados no sistema.

'''[RN5] - ''' '''Tabela de Preço Válida'''

O desconto somente poderá ser associado a tabelas de preço ativas e devidamente cadastradas no sistema.

'''[RN6] - ''' '''Aplicação Automática'''

Durante a inclusão ou manutenção do pedido, o sistema deverá consultar automaticamente os descontos vigentes cadastrados para a combinação de tabela de preço e produto do item.

'''[RN7] - ''' '''Respeito às Regras Existentes'''

A nova modalidade de desconto deverá utilizar as mesmas validações, restrições e comportamentos já existentes na funcionalidade de Desconto por Hierarquia.

'''[RN8] - ''' '''Controle de Permissão'''

Somente usuários com permissão para manutenção de descontos poderão incluir, alterar, consultar ou excluir registros de desconto por tabela de preço e produto.

'''[RN9] - ''' '''Consideração da Vigência'''

Descontos com vigência expirada ou ainda não iniciada não deverão ser considerados durante o cálculo do pedido.

'''[RN10] - ''' '''Aplicação por Item'''

A validação e aplicação do desconto deverão ocorrer individualmente para cada item do pedido, considerando o produto e a tabela de preço utilizados no respectivo item.

'''[RN11] - ''' '''Priorização de Descontos'''

Quando existirem múltiplas regras de desconto elegíveis para um mesmo item, o sistema deverá respeitar as regras de priorização já implementadas no GeoSales.

'''[RN12] - ''' '''Atualização Imediata'''

Após o cadastro, alteração ou exclusão de um desconto, as novas informações deverão ser consideradas nas próximas inclusões e recálculos de pedidos, sem necessidade de intervenção manual adicional.

'''[RN13] - ''' '''Integridade dos Dados'''

O sistema deverá garantir a integridade dos vínculos entre desconto, produto e tabela de preço, impedindo referências a registros inexistentes ou inativos.

'''[RN14] - ''' '''Compatibilidade com Funcionalidades Existentes'''

A implementação não deverá alterar o comportamento das funcionalidades atualmente existentes de desconto por hierarquia, mantendo a compatibilidade com as regras já homologadas e em produção.

== Fluxograma ==
[[Arquivo:Diagrama_sem_nome.drawio.png|600px]]

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Arquivo:Diagrama sem nome.drawio.png

2026-06-15T19:29:40Z

Renatolima:

Desconto Hierarquia com Agrupamento por Tabela de Preço, Produto e Validade

2026-06-15T19:22:01Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 15/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Possui a necessidade de ampliar a flexibilidade na aplicação de descontos comerciais, permitindo a criação de um novo tipo de desconto agrupado por tabela de preço e produto, com controle de validade por período de vigência.

Atualmente, o sistema contempla a funcionalidade de desconto por hierarquia, porém este modelo não atende integralmente ao cenário desejado, onde é necessário um nível adicional de segmentação e controle, possibilitando a definição de políticas comerciais mais específicas e aderentes às estratégias de precificação da empresa.

Dessa forma, torna-se necessária a implementação de uma nova modalidade de desconto que permita maior granularidade na concessão de descontos, mantendo a compatibilidade com as regras e processos já existentes no sistema.

== Solução ==
Será desenvolvida uma nova modalidade de desconto baseada na combinação de Tabela de Preço e Produto, utilizando como referência a estrutura já existente de desconto por hierarquia.

A solução contemplará:

Cadastro de descontos vinculados a uma tabela de preço específica;
Associação dos descontos a produtos específicos;
Definição de período de vigência através de data inicial e data final;
Reaproveitamento da estrutura operacional do desconto por hierarquia;
Aplicação automática durante o cálculo dos descontos do pedido;
Respeito às validações, restrições e comportamentos já existentes no mecanismo atual de descontos;
Consideração das regras de priorização já definidas pelo sistema para determinação do desconto aplicável.

== Implementação ==
Será implementada uma nova opção de Desconto por Tabela de Preço e Produto na funcionalidade de desconto hierarquia, com o objetivo de proporcionar maior flexibilidade na definição de políticas comerciais e permitir uma segmentação mais granular na concessão de descontos.

A solução será construída utilizando como referência a estrutura já existente de Desconto por Hierarquia, aproveitando seus mecanismos de validação, processamento e aplicação, de forma a manter a consistência operacional do sistema e minimizar impactos nos processos atualmente em uso.

A nova funcionalidade permitirá o cadastro de descontos vinculados simultaneamente a uma tabela de preço e a um produto específico, possibilitando a definição de um percentual de desconto e seu respectivo período de vigência, através de data inicial e data final.

Durante o processo de formação do pedido, o sistema realizará automaticamente a consulta dos descontos cadastrados e vigentes para a combinação de tabela de preço e produto selecionada, aplicando o desconto conforme as regras de cálculo e priorização já existentes no GeoSales.

Todas as validações, restrições e comportamentos atualmente utilizados no modelo de desconto por hierarquia serão preservados, garantindo que a nova modalidade de desconto opere de forma integrada ao processo comercial já estabelecido, sem comprometer a padronização das regras de negócio existentes.

A implementação contemplará os ajustes necessários nas estruturas de cadastro, consultas e processamento dos descontos, permitindo que o novo tipo de desconto seja administrado pelos usuários autorizados e considerado automaticamente pelo sistema durante a inclusão e manutenção dos pedidos.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
Criação de estrutura para cadastro de desconto por tabela de preço e produto;
Inclusão de campos para controle de vigência do desconto;
Desenvolvimento das regras de consulta e validação durante a digitação do pedido;
Integração com o motor de cálculo de descontos existente;
Reutilização das regras e comportamentos já implementados para desconto hierárquico;
Ajustes de telas e processos necessários para manutenção dos novos registros;
Testes unitários e integrados da funcionalidade.

=== Escopo Não Incluso ===
Alterações nas regras de prioridade atualmente existentes;
Criação de novos tipos de descontos além do descrito neste documento;
Alterações em processos de integração com sistemas terceiros;
Desenvolvimento de relatórios gerenciais específicos;
Revisão ou remodelagem da política comercial da CONTRATANTE.

== Atores ==
'''Administrador Comercial -''' Responsável por cadastrar, alterar, consultar e inativar os descontos por tabela de preço e produto.

'''Gestor Comercial -''' Responsável por definir as políticas comerciais e validar as configurações dos descontos cadastrados.

'''Vendedor -'''Usuário que realiza a inclusão de pedidos e terá os descontos aplicados automaticamente conforme as configurações vigentes.

'''Sistema GeoSales -'''Responsável por validar, consultar e aplicar automaticamente os descontos configurados durante o processo de formação do pedido.

== Pré-condições ==
* O usuário deverá possuir permissão de acesso ao cadastro de descontos.
* A tabela de preço deverá estar previamente cadastrada e ativa no sistema.
* O produto deverá estar previamente cadastrado e ativo no sistema.
* O percentual de desconto deverá estar dentro dos limites definidos pelas regras comerciais da empresa.
* O período de vigência informado deverá possuir data inicial e data final válidas.
* O pedido deverá possuir uma tabela de preço associada para que o desconto possa ser identificado e aplicado.
* As parametrizações relacionadas ao cálculo de descontos deverão estar devidamente configuradas no ambiente.

== Regras de Negócio ==

'''[RN1] - ''' '''Cadastro do Desconto'''

O sistema deverá permitir o cadastro de descontos vinculados obrigatoriamente a uma combinação de Tabela de Preço e Produto.

'''[RN2] - ''' '''Vigência do Desconto'''

Todo desconto cadastrado deverá possuir uma Data Inicial e uma Data Final de vigência. O desconto somente poderá ser considerado para aplicação quando a data do pedido estiver compreendida dentro do período informado.

'''[RN3] - ''' '''Validação de Período'''

O sistema não deverá permitir o cadastro de registros onde a Data Final seja inferior à Data Inicial.

'''[RN4] - ''' '''Produto Válido'''

O desconto somente poderá ser associado a produtos ativos e devidamente cadastrados no sistema.

'''[RN5] - ''' '''Tabela de Preço Válida'''

O desconto somente poderá ser associado a tabelas de preço ativas e devidamente cadastradas no sistema.

'''[RN6] - ''' '''Aplicação Automática'''

Durante a inclusão ou manutenção do pedido, o sistema deverá consultar automaticamente os descontos vigentes cadastrados para a combinação de tabela de preço e produto do item.

'''[RN7] - ''' '''Respeito às Regras Existentes'''

A nova modalidade de desconto deverá utilizar as mesmas validações, restrições e comportamentos já existentes na funcionalidade de Desconto por Hierarquia.

'''[RN8] - ''' '''Controle de Permissão'''

Somente usuários com permissão para manutenção de descontos poderão incluir, alterar, consultar ou excluir registros de desconto por tabela de preço e produto.

'''[RN9] - ''' '''Consideração da Vigência'''

Descontos com vigência expirada ou ainda não iniciada não deverão ser considerados durante o cálculo do pedido.

'''[RN10] - ''' '''Aplicação por Item'''

A validação e aplicação do desconto deverão ocorrer individualmente para cada item do pedido, considerando o produto e a tabela de preço utilizados no respectivo item.

'''[RN11] - ''' '''Priorização de Descontos'''

Quando existirem múltiplas regras de desconto elegíveis para um mesmo item, o sistema deverá respeitar as regras de priorização já implementadas no GeoSales.

'''[RN12] - ''' '''Atualização Imediata'''

Após o cadastro, alteração ou exclusão de um desconto, as novas informações deverão ser consideradas nas próximas inclusões e recálculos de pedidos, sem necessidade de intervenção manual adicional.

'''[RN13] - ''' '''Integridade dos Dados'''

O sistema deverá garantir a integridade dos vínculos entre desconto, produto e tabela de preço, impedindo referências a registros inexistentes ou inativos.

'''[RN14] - ''' '''Compatibilidade com Funcionalidades Existentes'''

A implementação não deverá alterar o comportamento das funcionalidades atualmente existentes de desconto por hierarquia, mantendo a compatibilidade com as regras já homologadas e em produçã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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Desconto Hierarquia com Agrupamento por Tabela de Preço, Produto e Validade

2026-06-15T19:17:04Z

Renatolima: /* Implementação */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 15/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Possui a necessidade de ampliar a flexibilidade na aplicação de descontos comerciais, permitindo a criação de um novo tipo de desconto agrupado por tabela de preço e produto, com controle de validade por período de vigência.

Atualmente, o sistema contempla a funcionalidade de desconto por hierarquia, porém este modelo não atende integralmente ao cenário desejado, onde é necessário um nível adicional de segmentação e controle, possibilitando a definição de políticas comerciais mais específicas e aderentes às estratégias de precificação da empresa.

Dessa forma, torna-se necessária a implementação de uma nova modalidade de desconto que permita maior granularidade na concessão de descontos, mantendo a compatibilidade com as regras e processos já existentes no sistema.

== Solução ==
Será desenvolvida uma nova modalidade de desconto baseada na combinação de Tabela de Preço e Produto, utilizando como referência a estrutura já existente de desconto por hierarquia.

A solução contemplará:

Cadastro de descontos vinculados a uma tabela de preço específica;
Associação dos descontos a produtos específicos;
Definição de período de vigência através de data inicial e data final;
Reaproveitamento da estrutura operacional do desconto por hierarquia;
Aplicação automática durante o cálculo dos descontos do pedido;
Respeito às validações, restrições e comportamentos já existentes no mecanismo atual de descontos;
Consideração das regras de priorização já definidas pelo sistema para determinação do desconto aplicável.

== Implementação ==
Será implementada uma nova opção de Desconto por Tabela de Preço e Produto na funcionalidade de desconto hierarquia, com o objetivo de proporcionar maior flexibilidade na definição de políticas comerciais e permitir uma segmentação mais granular na concessão de descontos.

A solução será construída utilizando como referência a estrutura já existente de Desconto por Hierarquia, aproveitando seus mecanismos de validação, processamento e aplicação, de forma a manter a consistência operacional do sistema e minimizar impactos nos processos atualmente em uso.

A nova funcionalidade permitirá o cadastro de descontos vinculados simultaneamente a uma tabela de preço e a um produto específico, possibilitando a definição de um percentual de desconto e seu respectivo período de vigência, através de data inicial e data final.

Durante o processo de formação do pedido, o sistema realizará automaticamente a consulta dos descontos cadastrados e vigentes para a combinação de tabela de preço e produto selecionada, aplicando o desconto conforme as regras de cálculo e priorização já existentes no GeoSales.

Todas as validações, restrições e comportamentos atualmente utilizados no modelo de desconto por hierarquia serão preservados, garantindo que a nova modalidade de desconto opere de forma integrada ao processo comercial já estabelecido, sem comprometer a padronização das regras de negócio existentes.

A implementação contemplará os ajustes necessários nas estruturas de cadastro, consultas e processamento dos descontos, permitindo que o novo tipo de desconto seja administrado pelos usuários autorizados e considerado automaticamente pelo sistema durante a inclusão e manutenção dos pedidos.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
Criação de estrutura para cadastro de desconto por tabela de preço e produto;
Inclusão de campos para controle de vigência do desconto;
Desenvolvimento das regras de consulta e validação durante a digitação do pedido;
Integração com o motor de cálculo de descontos existente;
Reutilização das regras e comportamentos já implementados para desconto hierárquico;
Ajustes de telas e processos necessários para manutenção dos novos registros;
Testes unitários e integrados da funcionalidade.

=== Escopo Não Incluso ===
Alterações nas regras de prioridade atualmente existentes;
Criação de novos tipos de descontos além do descrito neste documento;
Alterações em processos de integração com sistemas terceiros;
Desenvolvimento de relatórios gerenciais específicos;
Revisão ou remodelagem da política comercial da CONTRATANTE.

== Atores ==
'''Administrador Comercial -''' Responsável por cadastrar, alterar, consultar e inativar os descontos por tabela de preço e produto.

'''Gestor Comercial -''' Responsável por definir as políticas comerciais e validar as configurações dos descontos cadastrados.

'''Vendedor -'''Usuário que realiza a inclusão de pedidos e terá os descontos aplicados automaticamente conforme as configurações vigentes.

'''Sistema GeoSales -'''Responsável por validar, consultar e aplicar automaticamente os descontos configurados durante o processo de formação do pedido.

== Pré-condições ==
* O usuário deverá possuir permissão de acesso ao cadastro de descontos.
* A tabela de preço deverá estar previamente cadastrada e ativa no sistema.
* O produto deverá estar previamente cadastrado e ativo no sistema.
* O percentual de desconto deverá estar dentro dos limites definidos pelas regras comerciais da empresa.
* O período de vigência informado deverá possuir data inicial e data final válidas.
* O pedido deverá possuir uma tabela de preço associada para que o desconto possa ser identificado e aplicado.
* As parametrizações relacionadas ao cálculo de descontos deverão estar devidamente configuradas no ambiente.

== Regras de Negócio ==

'''[RN1] - '''

'''[RN2] - '''

'''[RN3] - '''

'''[RN4] - '''

'''[RN5] - '''

'''[RN6] - '''

'''[RN7] - '''

'''[RN8] - '''

'''[RN9] - '''

'''[RN10] - '''

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Desconto Hierarquia com Agrupamento por Tabela de Preço, Produto e Validade

2026-06-15T19:13:23Z

Renatolima: /* Necessidade */

Desconto Hierarquia com Agrupamento por Tabela de Preço, Produto e Validade

2026-06-15T19:12:01Z

Renatolima: /* Pré-condições */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 15/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE possui a necessidade de ampliar a flexibilidade na aplicação de descontos comerciais, permitindo a criação de um novo tipo de desconto agrupado por tabela de preço e produto, com controle de validade por período de vigência.

Atualmente, o sistema contempla a funcionalidade de desconto por hierarquia, porém este modelo não atende integralmente ao cenário desejado, onde é necessário um nível adicional de segmentação e controle, possibilitando a definição de políticas comerciais mais específicas e aderentes às estratégias de precificação da empresa.

Dessa forma, torna-se necessária a implementação de uma nova modalidade de desconto que permita maior granularidade na concessão de descontos, mantendo a compatibilidade com as regras e processos já existentes no sistema.

== Solução ==
Será desenvolvida uma nova modalidade de desconto baseada na combinação de Tabela de Preço e Produto, utilizando como referência a estrutura já existente de desconto por hierarquia.

A solução contemplará:

Cadastro de descontos vinculados a uma tabela de preço específica;
Associação dos descontos a produtos específicos;
Definição de período de vigência através de data inicial e data final;
Reaproveitamento da estrutura operacional do desconto por hierarquia;
Aplicação automática durante o cálculo dos descontos do pedido;
Respeito às validações, restrições e comportamentos já existentes no mecanismo atual de descontos;
Consideração das regras de priorização já definidas pelo sistema para determinação do desconto aplicável.

== Implementação ==
== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
Criação de estrutura para cadastro de desconto por tabela de preço e produto;
Inclusão de campos para controle de vigência do desconto;
Desenvolvimento das regras de consulta e validação durante a digitação do pedido;
Integração com o motor de cálculo de descontos existente;
Reutilização das regras e comportamentos já implementados para desconto hierárquico;
Ajustes de telas e processos necessários para manutenção dos novos registros;
Testes unitários e integrados da funcionalidade.

=== Escopo Não Incluso ===
Alterações nas regras de prioridade atualmente existentes;
Criação de novos tipos de descontos além do descrito neste documento;
Alterações em processos de integração com sistemas terceiros;
Desenvolvimento de relatórios gerenciais específicos;
Revisão ou remodelagem da política comercial da CONTRATANTE.

== Atores ==
'''Administrador Comercial -''' Responsável por cadastrar, alterar, consultar e inativar os descontos por tabela de preço e produto.

'''Gestor Comercial -''' Responsável por definir as políticas comerciais e validar as configurações dos descontos cadastrados.

'''Vendedor -'''Usuário que realiza a inclusão de pedidos e terá os descontos aplicados automaticamente conforme as configurações vigentes.

'''Sistema GeoSales -'''Responsável por validar, consultar e aplicar automaticamente os descontos configurados durante o processo de formação do pedido.

== Pré-condições ==
* O usuário deverá possuir permissão de acesso ao cadastro de descontos.
* A tabela de preço deverá estar previamente cadastrada e ativa no sistema.
* O produto deverá estar previamente cadastrado e ativo no sistema.
* O percentual de desconto deverá estar dentro dos limites definidos pelas regras comerciais da empresa.
* O período de vigência informado deverá possuir data inicial e data final válidas.
* O pedido deverá possuir uma tabela de preço associada para que o desconto possa ser identificado e aplicado.
* As parametrizações relacionadas ao cálculo de descontos deverão estar devidamente configuradas no ambiente.

== Regras de Negócio ==

'''[RN1] - '''

'''[RN2] - '''

'''[RN3] - '''

'''[RN4] - '''

'''[RN5] - '''

'''[RN6] - '''

'''[RN7] - '''

'''[RN8] - '''

'''[RN9] - '''

'''[RN10] - '''

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Desconto Hierarquia com Agrupamento por Tabela de Preço, Produto e Validade

2026-06-15T19:10:54Z

Renatolima: /* Atores */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 15/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE possui a necessidade de ampliar a flexibilidade na aplicação de descontos comerciais, permitindo a criação de um novo tipo de desconto agrupado por tabela de preço e produto, com controle de validade por período de vigência.

Atualmente, o sistema contempla a funcionalidade de desconto por hierarquia, porém este modelo não atende integralmente ao cenário desejado, onde é necessário um nível adicional de segmentação e controle, possibilitando a definição de políticas comerciais mais específicas e aderentes às estratégias de precificação da empresa.

Dessa forma, torna-se necessária a implementação de uma nova modalidade de desconto que permita maior granularidade na concessão de descontos, mantendo a compatibilidade com as regras e processos já existentes no sistema.

== Solução ==
Será desenvolvida uma nova modalidade de desconto baseada na combinação de Tabela de Preço e Produto, utilizando como referência a estrutura já existente de desconto por hierarquia.

A solução contemplará:

Cadastro de descontos vinculados a uma tabela de preço específica;
Associação dos descontos a produtos específicos;
Definição de período de vigência através de data inicial e data final;
Reaproveitamento da estrutura operacional do desconto por hierarquia;
Aplicação automática durante o cálculo dos descontos do pedido;
Respeito às validações, restrições e comportamentos já existentes no mecanismo atual de descontos;
Consideração das regras de priorização já definidas pelo sistema para determinação do desconto aplicável.

== Implementação ==
== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
Criação de estrutura para cadastro de desconto por tabela de preço e produto;
Inclusão de campos para controle de vigência do desconto;
Desenvolvimento das regras de consulta e validação durante a digitação do pedido;
Integração com o motor de cálculo de descontos existente;
Reutilização das regras e comportamentos já implementados para desconto hierárquico;
Ajustes de telas e processos necessários para manutenção dos novos registros;
Testes unitários e integrados da funcionalidade.

=== Escopo Não Incluso ===
Alterações nas regras de prioridade atualmente existentes;
Criação de novos tipos de descontos além do descrito neste documento;
Alterações em processos de integração com sistemas terceiros;
Desenvolvimento de relatórios gerenciais específicos;
Revisão ou remodelagem da política comercial da CONTRATANTE.

== Atores ==
'''Administrador Comercial -''' Responsável por cadastrar, alterar, consultar e inativar os descontos por tabela de preço e produto.

'''Gestor Comercial -''' Responsável por definir as políticas comerciais e validar as configurações dos descontos cadastrados.

'''Vendedor -'''Usuário que realiza a inclusão de pedidos e terá os descontos aplicados automaticamente conforme as configurações vigentes.

'''Sistema GeoSales -'''Responsável por validar, consultar e aplicar automaticamente os descontos configurados durante o processo de formação do pedido.

== Pré-condições ==

== Regras de Negócio ==

'''[RN1] - '''

'''[RN2] - '''

'''[RN3] - '''

'''[RN4] - '''

'''[RN5] - '''

'''[RN6] - '''

'''[RN7] - '''

'''[RN8] - '''

'''[RN9] - '''

'''[RN10] - '''

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Desconto Hierarquia com Agrupamento por Tabela de Preço, Produto e Validade

2026-06-15T19:09:43Z

Renatolima: /* Escopo Não Incluso */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 15/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
A CONTRATANTE possui a necessidade de ampliar a flexibilidade na aplicação de descontos comerciais, permitindo a criação de um novo tipo de desconto agrupado por tabela de preço e produto, com controle de validade por período de vigência.

Atualmente, o sistema contempla a funcionalidade de desconto por hierarquia, porém este modelo não atende integralmente ao cenário desejado, onde é necessário um nível adicional de segmentação e controle, possibilitando a definição de políticas comerciais mais específicas e aderentes às estratégias de precificação da empresa.

Dessa forma, torna-se necessária a implementação de uma nova modalidade de desconto que permita maior granularidade na concessão de descontos, mantendo a compatibilidade com as regras e processos já existentes no sistema.

== Solução ==
Será desenvolvida uma nova modalidade de desconto baseada na combinação de Tabela de Preço e Produto, utilizando como referência a estrutura já existente de desconto por hierarquia.

A solução contemplará:

Cadastro de descontos vinculados a uma tabela de preço específica;
Associação dos descontos a produtos específicos;
Definição de período de vigência através de data inicial e data final;
Reaproveitamento da estrutura operacional do desconto por hierarquia;
Aplicação automática durante o cálculo dos descontos do pedido;
Respeito às validações, restrições e comportamentos já existentes no mecanismo atual de descontos;
Consideração das regras de priorização já definidas pelo sistema para determinação do desconto aplicável.

== Implementação ==
== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
Criação de estrutura para cadastro de desconto por tabela de preço e produto;
Inclusão de campos para controle de vigência do desconto;
Desenvolvimento das regras de consulta e validação durante a digitação do pedido;
Integração com o motor de cálculo de descontos existente;
Reutilização das regras e comportamentos já implementados para desconto hierárquico;
Ajustes de telas e processos necessários para manutenção dos novos registros;
Testes unitários e integrados da funcionalidade.

=== Escopo Não Incluso ===
Alterações nas regras de prioridade atualmente existentes;
Criação de novos tipos de descontos além do descrito neste documento;
Alterações em processos de integração com sistemas terceiros;
Desenvolvimento de relatórios gerenciais específicos;
Revisão ou remodelagem da política comercial da CONTRATANTE.

== Atores ==

== Pré-condições ==

== Regras de Negócio ==

'''[RN1] - '''

'''[RN2] - '''

'''[RN3] - '''

'''[RN4] - '''

'''[RN5] - '''

'''[RN6] - '''

'''[RN7] - '''

'''[RN8] - '''

'''[RN9] - '''

'''[RN10] - '''

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Desconto Hierarquia com Agrupamento por Tabela de Preço, Produto e Validade

2026-06-15T19:09:36Z

Renatolima: /* Escopo Incluso */

Desconto Hierarquia com Agrupamento por Tabela de Preço, Produto e Validade

2026-06-15T19:09:25Z

Renatolima: /* Solução */

Desconto Hierarquia com Agrupamento por Tabela de Preço, Produto e Validade

2026-06-15T19:08:53Z

Renatolima: /* Necessidade */

Desconto Hierarquia com Agrupamento por Tabela de Preço, Produto e Validade

2026-06-15T18:05:30Z

Renatolima: Criou página com '== Histórico de Alterações == {| class="wikitable" ! Data ! Quem ! Comentários |- | 15/06/2026 || Renato Lima || Criação do documento |- |} == Necessidade == == S...'

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 15/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==

== Solução ==
== Implementação ==
== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
=== Escopo Não Incluso ===

== Atores ==

== Pré-condições ==

== Regras de Negócio ==

'''[RN1] - '''

'''[RN2] - '''

'''[RN3] - '''

'''[RN4] - '''

'''[RN5] - '''

'''[RN6] - '''

'''[RN7] - '''

'''[RN8] - '''

'''[RN9] - '''

'''[RN10] - '''

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Projeto/Da Terrinha

2026-06-15T18:04:16Z

Renatolima:

[[Aplicar desconto por tabela de preço e Produto]]

[[Leitura de arquivo xls, com múltiplo clientes e pedidos]]

[[Desconto Hierarquia com Agrupamento por Tabela de Preço, Produto e Validade]]

Ativar a opção de armazém para seleção no fluxo de pedido

2026-06-11T15:19:58Z

Renatolima: /* Regras de Integração */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Necessita que, no momento da inclusão de um pedido, o vendedor possa definir a organização de venda e que o sistema identifique automaticamente os armazéns (estoques) vinculados a essa organização, disponibilizando apenas os estoques permitidos para seleção.
Para atender a essa necessidade, será necessário realizar a atualização das tabelas de vínculo com estoque, bem como integrar uma nova tabela responsável pelo relacionamento entre estoques e organizações de venda. Dessa forma, o vendedor terá maior controle e assertividade no direcionamento do estoque durante o processo de venda.

== Solução ==
Para viabilizar o direcionamento do pedido ao estoque correto no momento da venda, serão realizados ajustes nas tabelas relacionadas às informações de estoque, além da integração da nova tabela de vínculo entre estoques e organizações de venda.

Com essa implementação, o sistema passará a disponibilizar ao vendedor apenas os estoques relacionados à organização de venda selecionada no pedido, garantindo maior controle operacional e consistência nas informações enviadas durante a integração e processamento do pedido.

== Implementação ==

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Inclusão do campo Estoque no cabeçalho do pedido.
* Integração da tabela de relacionamento entre Organização de Venda e Estoque.
* Atualização das integrações relacionadas às informações de estoque.
* Consulta automática dos estoques vinculados à Organização de Venda selecionada.
* Exibição apenas dos estoques permitidos para a Organização de Venda escolhida.
* Validação para impedir a seleção de estoques não vinculados.
* Limpeza automática do estoque selecionado quando houver alteração da Organização de Venda.
* Persistência das informações de Organização de Venda e Estoque no pedido.
* Disponibilização dessas informações para os processos de integração e faturamento.
* Tratamento de mensagens de validação quando não existirem estoques vinculados.

=== Escopo Não Incluso ===
* Criação de novas regras de alocação automática de estoque.
* Alterações nos processos de faturamento, separação, expedição ou logística.
* Controle de saldo de estoque em tempo real.
* Implementação de transferência de estoque entre filiais.
* Cadastro e manutenção manual dos vínculos entre Organização de Venda e Estoque dentro do GeoSales.
* Alterações em regras comerciais, políticas de preço ou condições de pagamento.
* Desenvolvimento de relatórios específicos relacionados à utilização dos estoques por Organização de Venda.
* Ajustes em integrações não relacionadas às informações de Organização de Venda e Estoque.

== Atores ==

* '''Vendedor-''' Responsável por cadastrar pedidos.
* '''Sistema Geosales -''' Responsável pelo gerenciamentos dos dados integrados.
* '''Integração ERP -'''Responsável por trazer os dados do ERP para o Geosales.

== Pré-condições ==
* O usuário deve estar autenticado no sistema.
* As Organizações de Venda devem estar cadastradas e ativas.
* Os Estoques (Armazéns) devem estar cadastrados e ativos.
* Deve existir vínculo entre Organização de Venda e Estoque através da tabela de relacionamento.
* O vendedor deve possuir permissão para inclusão de pedidos.

== Regras de Negócio ==

'''[RN1] - ''' A seleção da Organização de Venda será obrigatória no cabeçalho do pedido, precisa ativar a ação para exibir o campo no cabeçalho do pedido.

'''[RN2] - ''' Somente estoques vinculados à Organização de Venda selecionada poderão ser apresentados para escolha.

'''[RN3] - ''' Estoques inativos não poderão ser exibidos para seleção.

'''[RN4] - ''' O pedido somente poderá ser gravado caso exista um estoque válido associado à Organização de Venda.

'''[RN5] - ''' A relação entre Organização de Venda e Estoque será mantida através da nova tabela de vínculo disponibilizada pela integração.

'''[RN6] - ''' As informações de Organização de Venda e Estoque deverão ser enviadas durante a integração do pedido para os sistemas corporativos.

== Regras de Integração ==

'''[RI1] - ''' Deve popular a tabela ORGANIZACAO_VENDA_ESTOQUE

'''[RI2] - ''' A vinculação de organização de venda e estoque fica na tabela NNR (Locais de Estoque/Armazéns) do Protheus.

'''[RI3] - ''' Na tabela NNR (Locais de Estoque/Armazéns) do Protheus deve ser checado o campo NNR_INTGEO = 1=Sim / 2=Nao, caso esteja sim, a vinculação deve vir para o Protheus.

'''[RI4] - ''' O armazém selecionado no cabeçalho do pedido deve ser enviado para ERP.

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Ativar a opção de armazém para seleção no fluxo de pedido

2026-06-11T14:44:58Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Necessita que, no momento da inclusão de um pedido, o vendedor possa definir a organização de venda e que o sistema identifique automaticamente os armazéns (estoques) vinculados a essa organização, disponibilizando apenas os estoques permitidos para seleção.
Para atender a essa necessidade, será necessário realizar a atualização das tabelas de vínculo com estoque, bem como integrar uma nova tabela responsável pelo relacionamento entre estoques e organizações de venda. Dessa forma, o vendedor terá maior controle e assertividade no direcionamento do estoque durante o processo de venda.

== Solução ==
Para viabilizar o direcionamento do pedido ao estoque correto no momento da venda, serão realizados ajustes nas tabelas relacionadas às informações de estoque, além da integração da nova tabela de vínculo entre estoques e organizações de venda.

Com essa implementação, o sistema passará a disponibilizar ao vendedor apenas os estoques relacionados à organização de venda selecionada no pedido, garantindo maior controle operacional e consistência nas informações enviadas durante a integração e processamento do pedido.

== Implementação ==

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Inclusão do campo Estoque no cabeçalho do pedido.
* Integração da tabela de relacionamento entre Organização de Venda e Estoque.
* Atualização das integrações relacionadas às informações de estoque.
* Consulta automática dos estoques vinculados à Organização de Venda selecionada.
* Exibição apenas dos estoques permitidos para a Organização de Venda escolhida.
* Validação para impedir a seleção de estoques não vinculados.
* Limpeza automática do estoque selecionado quando houver alteração da Organização de Venda.
* Persistência das informações de Organização de Venda e Estoque no pedido.
* Disponibilização dessas informações para os processos de integração e faturamento.
* Tratamento de mensagens de validação quando não existirem estoques vinculados.

=== Escopo Não Incluso ===
* Criação de novas regras de alocação automática de estoque.
* Alterações nos processos de faturamento, separação, expedição ou logística.
* Controle de saldo de estoque em tempo real.
* Implementação de transferência de estoque entre filiais.
* Cadastro e manutenção manual dos vínculos entre Organização de Venda e Estoque dentro do GeoSales.
* Alterações em regras comerciais, políticas de preço ou condições de pagamento.
* Desenvolvimento de relatórios específicos relacionados à utilização dos estoques por Organização de Venda.
* Ajustes em integrações não relacionadas às informações de Organização de Venda e Estoque.

== Atores ==

* '''Vendedor-''' Responsável por cadastrar pedidos.
* '''Sistema Geosales -''' Responsável pelo gerenciamentos dos dados integrados.
* '''Integração ERP -'''Responsável por trazer os dados do ERP para o Geosales.

== Pré-condições ==
* O usuário deve estar autenticado no sistema.
* As Organizações de Venda devem estar cadastradas e ativas.
* Os Estoques (Armazéns) devem estar cadastrados e ativos.
* Deve existir vínculo entre Organização de Venda e Estoque através da tabela de relacionamento.
* O vendedor deve possuir permissão para inclusão de pedidos.

== Regras de Negócio ==

'''[RN1] - ''' A seleção da Organização de Venda será obrigatória no cabeçalho do pedido, precisa ativar a ação para exibir o campo no cabeçalho do pedido.

'''[RN2] - ''' Somente estoques vinculados à Organização de Venda selecionada poderão ser apresentados para escolha.

'''[RN3] - ''' Estoques inativos não poderão ser exibidos para seleção.

'''[RN4] - ''' O pedido somente poderá ser gravado caso exista um estoque válido associado à Organização de Venda.

'''[RN5] - ''' A relação entre Organização de Venda e Estoque será mantida através da nova tabela de vínculo disponibilizada pela integração.

'''[RN6] - ''' As informações de Organização de Venda e Estoque deverão ser enviadas durante a integração do pedido para os sistemas corporativos.

== Regras de Integração ==

'''[RI1] - ''' Deve popular a tabela ORGANIZACAO_VENDA_ESTOQUE

'''[RI2] - '''

'''[RI3] - '''

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Ativar a opção de armazém para seleção no fluxo de pedido

2026-06-11T14:32:19Z

Renatolima: /* Regras de Integração */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Necessita que, no momento da inclusão de um pedido, o vendedor possa definir a organização de venda e que o sistema identifique automaticamente os armazéns (estoques) vinculados a essa organização, disponibilizando apenas os estoques permitidos para seleção.
Para atender a essa necessidade, será necessário realizar a atualização das tabelas de vínculo com estoque, bem como integrar uma nova tabela responsável pelo relacionamento entre estoques e organizações de venda. Dessa forma, o vendedor terá maior controle e assertividade no direcionamento do estoque durante o processo de venda.

== Solução ==
Para viabilizar o direcionamento do pedido ao estoque correto no momento da venda, serão realizados ajustes nas tabelas relacionadas às informações de estoque, além da integração da nova tabela de vínculo entre estoques e organizações de venda.

Com essa implementação, o sistema passará a disponibilizar ao vendedor apenas os estoques relacionados à organização de venda selecionada no pedido, garantindo maior controle operacional e consistência nas informações enviadas durante a integração e processamento do pedido.

== Implementação ==

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Inclusão do campo Estoque no cabeçalho do pedido.
* Integração da tabela de relacionamento entre Organização de Venda e Estoque.
* Atualização das integrações relacionadas às informações de estoque.
* Consulta automática dos estoques vinculados à Organização de Venda selecionada.
* Exibição apenas dos estoques permitidos para a Organização de Venda escolhida.
* Validação para impedir a seleção de estoques não vinculados.
* Limpeza automática do estoque selecionado quando houver alteração da Organização de Venda.
* Persistência das informações de Organização de Venda e Estoque no pedido.
* Disponibilização dessas informações para os processos de integração e faturamento.
* Tratamento de mensagens de validação quando não existirem estoques vinculados.

=== Escopo Não Incluso ===
* Criação de novas regras de alocação automática de estoque.
* Alterações nos processos de faturamento, separação, expedição ou logística.
* Controle de saldo de estoque em tempo real.
* Implementação de transferência de estoque entre filiais.
* Cadastro e manutenção manual dos vínculos entre Organização de Venda e Estoque dentro do GeoSales.
* Alterações em regras comerciais, políticas de preço ou condições de pagamento.
* Desenvolvimento de relatórios específicos relacionados à utilização dos estoques por Organização de Venda.
* Ajustes em integrações não relacionadas às informações de Organização de Venda e Estoque.

== Atores ==

* '''Vendedor-''' Responsável por cadastrar pedidos.
* '''Sistema Geosales -''' Responsável pelo gerenciamentos dos dados integrados.
* '''Integração ERP -'''Responsável por trazer os dados do ERP para o Geosales.

== Pré-condições ==
* O usuário deve estar autenticado no sistema.
* As Organizações de Venda devem estar cadastradas e ativas.
* Os Estoques (Armazéns) devem estar cadastrados e ativos.
* Deve existir vínculo entre Organização de Venda e Estoque através da tabela de relacionamento.
* O vendedor deve possuir permissão para inclusão de pedidos.

== Regras de Negócio ==

'''[RN1] - ''' A seleção da Organização de Venda será obrigatória no cabeçalho do pedido.

'''[RN2] - ''' Somente estoques vinculados à Organização de Venda selecionada poderão ser apresentados para escolha.

'''[RN3] - ''' Estoques inativos não poderão ser exibidos para seleção.

'''[RN4] - ''' O pedido somente poderá ser gravado caso exista um estoque válido associado à Organização de Venda.

'''[RN5] - ''' A relação entre Organização de Venda e Estoque será mantida através da nova tabela de vínculo disponibilizada pela integração.

'''[RN6] - ''' As informações de Organização de Venda e Estoque deverão ser enviadas durante a integração do pedido para os sistemas corporativos.

== Regras de Integração ==

'''[RI1] - ''' Deve popular a tabela ORGANIZACAO_VENDA_ESTOQUE

'''[RI2] - '''

'''[RI3] - '''

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Ativar a opção de armazém para seleção no fluxo de pedido

2026-06-11T14:11:43Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Necessita que, no momento da inclusão de um pedido, o vendedor possa definir a organização de venda e que o sistema identifique automaticamente os armazéns (estoques) vinculados a essa organização, disponibilizando apenas os estoques permitidos para seleção.
Para atender a essa necessidade, será necessário realizar a atualização das tabelas de vínculo com estoque, bem como integrar uma nova tabela responsável pelo relacionamento entre estoques e organizações de venda. Dessa forma, o vendedor terá maior controle e assertividade no direcionamento do estoque durante o processo de venda.

== Solução ==
Para viabilizar o direcionamento do pedido ao estoque correto no momento da venda, serão realizados ajustes nas tabelas relacionadas às informações de estoque, além da integração da nova tabela de vínculo entre estoques e organizações de venda.

Com essa implementação, o sistema passará a disponibilizar ao vendedor apenas os estoques relacionados à organização de venda selecionada no pedido, garantindo maior controle operacional e consistência nas informações enviadas durante a integração e processamento do pedido.

== Implementação ==

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Inclusão do campo Estoque no cabeçalho do pedido.
* Integração da tabela de relacionamento entre Organização de Venda e Estoque.
* Atualização das integrações relacionadas às informações de estoque.
* Consulta automática dos estoques vinculados à Organização de Venda selecionada.
* Exibição apenas dos estoques permitidos para a Organização de Venda escolhida.
* Validação para impedir a seleção de estoques não vinculados.
* Limpeza automática do estoque selecionado quando houver alteração da Organização de Venda.
* Persistência das informações de Organização de Venda e Estoque no pedido.
* Disponibilização dessas informações para os processos de integração e faturamento.
* Tratamento de mensagens de validação quando não existirem estoques vinculados.

=== Escopo Não Incluso ===
* Criação de novas regras de alocação automática de estoque.
* Alterações nos processos de faturamento, separação, expedição ou logística.
* Controle de saldo de estoque em tempo real.
* Implementação de transferência de estoque entre filiais.
* Cadastro e manutenção manual dos vínculos entre Organização de Venda e Estoque dentro do GeoSales.
* Alterações em regras comerciais, políticas de preço ou condições de pagamento.
* Desenvolvimento de relatórios específicos relacionados à utilização dos estoques por Organização de Venda.
* Ajustes em integrações não relacionadas às informações de Organização de Venda e Estoque.

== Atores ==

* '''Vendedor-''' Responsável por cadastrar pedidos.
* '''Sistema Geosales -''' Responsável pelo gerenciamentos dos dados integrados.
* '''Integração ERP -'''Responsável por trazer os dados do ERP para o Geosales.

== Pré-condições ==
* O usuário deve estar autenticado no sistema.
* As Organizações de Venda devem estar cadastradas e ativas.
* Os Estoques (Armazéns) devem estar cadastrados e ativos.
* Deve existir vínculo entre Organização de Venda e Estoque através da tabela de relacionamento.
* O vendedor deve possuir permissão para inclusão de pedidos.

== Regras de Negócio ==

'''[RN1] - ''' A seleção da Organização de Venda será obrigatória no cabeçalho do pedido.

'''[RN2] - ''' Somente estoques vinculados à Organização de Venda selecionada poderão ser apresentados para escolha.

'''[RN3] - ''' Estoques inativos não poderão ser exibidos para seleção.

'''[RN4] - ''' O pedido somente poderá ser gravado caso exista um estoque válido associado à Organização de Venda.

'''[RN5] - ''' A relação entre Organização de Venda e Estoque será mantida através da nova tabela de vínculo disponibilizada pela integração.

'''[RN6] - ''' As informações de Organização de Venda e Estoque deverão ser enviadas durante a integração do pedido para os sistemas corporativos.

== Regras de Integração ==

'''[RI1] - '''

'''[RI2] - '''

'''[RI3] - '''

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Ativar a opção de armazém para seleção no fluxo de pedido

2026-06-11T14:10:59Z

Renatolima: /* Escopo Não Incluso */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Necessita que, no momento da inclusão de um pedido, o vendedor possa definir a organização de venda e que o sistema identifique automaticamente os armazéns (estoques) vinculados a essa organização, disponibilizando apenas os estoques permitidos para seleção.
Para atender a essa necessidade, será necessário realizar a atualização das tabelas de vínculo com estoque, bem como integrar uma nova tabela responsável pelo relacionamento entre estoques e organizações de venda. Dessa forma, o vendedor terá maior controle e assertividade no direcionamento do estoque durante o processo de venda.

== Solução ==
Para viabilizar o direcionamento do pedido ao estoque correto no momento da venda, serão realizados ajustes nas tabelas relacionadas às informações de estoque, além da integração da nova tabela de vínculo entre estoques e organizações de venda.

Com essa implementação, o sistema passará a disponibilizar ao vendedor apenas os estoques relacionados à organização de venda selecionada no pedido, garantindo maior controle operacional e consistência nas informações enviadas durante a integração e processamento do pedido.

== Implementação ==

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Inclusão do campo Estoque no cabeçalho do pedido.
* Integração da tabela de relacionamento entre Organização de Venda e Estoque.
* Atualização das integrações relacionadas às informações de estoque.
* Consulta automática dos estoques vinculados à Organização de Venda selecionada.
* Exibição apenas dos estoques permitidos para a Organização de Venda escolhida.
* Validação para impedir a seleção de estoques não vinculados.
* Limpeza automática do estoque selecionado quando houver alteração da Organização de Venda.
* Persistência das informações de Organização de Venda e Estoque no pedido.
* Disponibilização dessas informações para os processos de integração e faturamento.
* Tratamento de mensagens de validação quando não existirem estoques vinculados.

=== Escopo Não Incluso ===
* Criação de novas regras de alocação automática de estoque.
* Alterações nos processos de faturamento, separação, expedição ou logística.
* Controle de saldo de estoque em tempo real.
* Implementação de transferência de estoque entre filiais.
* Cadastro e manutenção manual dos vínculos entre Organização de Venda e Estoque dentro do GeoSales.
* Alterações em regras comerciais, políticas de preço ou condições de pagamento.
* Desenvolvimento de relatórios específicos relacionados à utilização dos estoques por Organização de Venda.
* Ajustes em integrações não relacionadas às informações de Organização de Venda e Estoque.

== Atores ==

* '''Vendedor-''' Responsável por cadastrar pedidos.
* '''Sistema Geosales -''' Responsável pelo gerenciamentos dos dados integrados.
* '''Integração ERP -'''Responsável por trazer os dados do ERP para o Geosales.

== Pré-condições ==
* O usuário deve estar autenticado no sistema.
* As Organizações de Venda devem estar cadastradas e ativas.
* Os Estoques (Armazéns) devem estar cadastrados e ativos.
* Deve existir vínculo entre Organização de Venda e Estoque através da tabela de relacionamento.
* O vendedor deve possuir permissão para inclusão de pedidos.

== Regras de Negócio ==

'''[RN1] - ''' A seleção da Organização de Venda será obrigatória no cabeçalho do pedido.

'''[RN2] - ''' Somente estoques vinculados à Organização de Venda selecionada poderão ser apresentados para escolha.

'''[RN3] - ''' Estoques inativos não poderão ser exibidos para seleção.

'''[RN4] - ''' O pedido somente poderá ser gravado caso exista um estoque válido associado à Organização de Venda.

'''[RN5] - ''' A relação entre Organização de Venda e Estoque será mantida através da nova tabela de vínculo disponibilizada pela integração.

'''[RN6] - ''' As informações de Organização de Venda e Estoque deverão ser enviadas durante a integração do pedido para os sistemas corporativos.

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Ativar a opção de armazém para seleção no fluxo de pedido

2026-06-11T14:08:58Z

Renatolima: /* Escopo Incluso */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Necessita que, no momento da inclusão de um pedido, o vendedor possa definir a organização de venda e que o sistema identifique automaticamente os armazéns (estoques) vinculados a essa organização, disponibilizando apenas os estoques permitidos para seleção.
Para atender a essa necessidade, será necessário realizar a atualização das tabelas de vínculo com estoque, bem como integrar uma nova tabela responsável pelo relacionamento entre estoques e organizações de venda. Dessa forma, o vendedor terá maior controle e assertividade no direcionamento do estoque durante o processo de venda.

== Solução ==
Para viabilizar o direcionamento do pedido ao estoque correto no momento da venda, serão realizados ajustes nas tabelas relacionadas às informações de estoque, além da integração da nova tabela de vínculo entre estoques e organizações de venda.

Com essa implementação, o sistema passará a disponibilizar ao vendedor apenas os estoques relacionados à organização de venda selecionada no pedido, garantindo maior controle operacional e consistência nas informações enviadas durante a integração e processamento do pedido.

== Implementação ==

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
* Inclusão do campo Estoque no cabeçalho do pedido.
* Integração da tabela de relacionamento entre Organização de Venda e Estoque.
* Atualização das integrações relacionadas às informações de estoque.
* Consulta automática dos estoques vinculados à Organização de Venda selecionada.
* Exibição apenas dos estoques permitidos para a Organização de Venda escolhida.
* Validação para impedir a seleção de estoques não vinculados.
* Limpeza automática do estoque selecionado quando houver alteração da Organização de Venda.
* Persistência das informações de Organização de Venda e Estoque no pedido.
* Disponibilização dessas informações para os processos de integração e faturamento.
* Tratamento de mensagens de validação quando não existirem estoques vinculados.

=== Escopo Não Incluso ===

== Atores ==

* '''Vendedor-''' Responsável por cadastrar pedidos.
* '''Sistema Geosales -''' Responsável pelo gerenciamentos dos dados integrados.
* '''Integração ERP -'''Responsável por trazer os dados do ERP para o Geosales.

== Pré-condições ==
* O usuário deve estar autenticado no sistema.
* As Organizações de Venda devem estar cadastradas e ativas.
* Os Estoques (Armazéns) devem estar cadastrados e ativos.
* Deve existir vínculo entre Organização de Venda e Estoque através da tabela de relacionamento.
* O vendedor deve possuir permissão para inclusão de pedidos.

== Regras de Negócio ==

'''[RN1] - ''' A seleção da Organização de Venda será obrigatória no cabeçalho do pedido.

'''[RN2] - ''' Somente estoques vinculados à Organização de Venda selecionada poderão ser apresentados para escolha.

'''[RN3] - ''' Estoques inativos não poderão ser exibidos para seleção.

'''[RN4] - ''' O pedido somente poderá ser gravado caso exista um estoque válido associado à Organização de Venda.

'''[RN5] - ''' A relação entre Organização de Venda e Estoque será mantida através da nova tabela de vínculo disponibilizada pela integração.

'''[RN6] - ''' As informações de Organização de Venda e Estoque deverão ser enviadas durante a integração do pedido para os sistemas corporativos.

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Ativar a opção de armazém para seleção no fluxo de pedido

2026-06-11T14:06:12Z

Renatolima: /* Regras de Negócio */

Ativar a opção de armazém para seleção no fluxo de pedido

2026-06-11T14:03:59Z

Renatolima: /* Pré-condições */

Ativar a opção de armazém para seleção no fluxo de pedido

2026-06-11T14:03:18Z

Renatolima: /* Atores */

Ativar a opção de armazém para seleção no fluxo de pedido

2026-06-11T13:59:43Z

Renatolima: /* Necessidade */

Ativar a opção de armazém para seleção no fluxo de pedido

2026-06-11T13:59:00Z

Renatolima: /* Solução */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O Contratante necessita que, no momento da inclusão de um pedido, o vendedor possa definir a organização de venda e que o sistema identifique automaticamente os armazéns (estoques) vinculados a essa organização, disponibilizando apenas os estoques permitidos para seleção.
Para atender a essa necessidade, será necessário realizar a atualização das tabelas de vínculo com estoque, bem como integrar uma nova tabela responsável pelo relacionamento entre estoques e organizações de venda. Dessa forma, o vendedor terá maior controle e assertividade no direcionamento do estoque durante o processo de venda.

== Solução ==
Para viabilizar o direcionamento do pedido ao estoque correto no momento da venda, serão realizados ajustes nas tabelas relacionadas às informações de estoque, além da integração da nova tabela de vínculo entre estoques e organizações de venda.

Com essa implementação, o sistema passará a disponibilizar ao vendedor apenas os estoques relacionados à organização de venda selecionada no pedido, garantindo maior controle operacional e consistência nas informações enviadas durante a integração e processamento do pedido.

== Implementação ==

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===

=== Escopo Não Incluso ===

== Atores ==

* '''Administrador -''' Responsável por cadastrar e configurar pesquisas
* '''Usuário Operacional -''' Responsável pela aplicação das pesquisas
* '''Sistema -'''Responsável por validar o público-alvo e disponibilizar as pesquisas corretas

== Pré-condições ==

== Regras de Negócio ==

'''[RN1] - '''

'''[RN2] - '''

'''[RN3] - '''

'''[RN4] - '''

'''[RN5] - '''

'''[RN6] - '''

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Ativar a opção de armazém para seleção no fluxo de pedido

2026-06-11T13:58:41Z

Renatolima: /* Necessidade */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
O Contratante necessita que, no momento da inclusão de um pedido, o vendedor possa definir a organização de venda e que o sistema identifique automaticamente os armazéns (estoques) vinculados a essa organização, disponibilizando apenas os estoques permitidos para seleção.
Para atender a essa necessidade, será necessário realizar a atualização das tabelas de vínculo com estoque, bem como integrar uma nova tabela responsável pelo relacionamento entre estoques e organizações de venda. Dessa forma, o vendedor terá maior controle e assertividade no direcionamento do estoque durante o processo de venda.

== Solução ==

== Implementação ==

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===

=== Escopo Não Incluso ===

== Atores ==

* '''Administrador -''' Responsável por cadastrar e configurar pesquisas
* '''Usuário Operacional -''' Responsável pela aplicação das pesquisas
* '''Sistema -'''Responsável por validar o público-alvo e disponibilizar as pesquisas corretas

== Pré-condições ==

== Regras de Negócio ==

'''[RN1] - '''

'''[RN2] - '''

'''[RN3] - '''

'''[RN4] - '''

'''[RN5] - '''

'''[RN6] - '''

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Ativar a opção de armazém para seleção no fluxo de pedido

2026-06-11T13:53:48Z

Renatolima: Criou página com '== Histórico de Alterações == {| class="wikitable" ! Data ! Quem ! Comentários |- | 11/06/2026 || Renato Lima || Criação do documento |- |} == Necessidade == == S...'

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 11/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==

== Solução ==

== Implementação ==

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===

=== Escopo Não Incluso ===

== Atores ==

* '''Administrador -''' Responsável por cadastrar e configurar pesquisas
* '''Usuário Operacional -''' Responsável pela aplicação das pesquisas
* '''Sistema -'''Responsável por validar o público-alvo e disponibilizar as pesquisas corretas

== Pré-condições ==

== Regras de Negócio ==

'''[RN1] - '''

'''[RN2] - '''

'''[RN3] - '''

'''[RN4] - '''

'''[RN5] - '''

'''[RN6] - '''

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Projeto/Icofort

2026-06-11T13:51:58Z

Renatolima:

* [[ Frete FOB por estado ]]
* [[ Frete por cidade ]]
* [[ Tabela de preco, Cliente X UF X Segmento ]]
* [[ Integração de cliente inativo ]]
* [[ Aprimoramento da Qualificação de Prospect por Segmento e Subsegmento ]]
* [[ Integração das regras de Lead Time de Entrega ]]
* [[ Aprovação de Cadastros de Prospect antes do Envio ao ERP ]]
* [[ Adicionar a informação de limite de crédito e saldo de limite na busca de cliente]]
* [[ Adicionar ao acessar os dados do cliente as informações de Segmentação]]
* [[ Adicionar um campo Laudo e popular o campo Simples Nacional a partir de informação do ERP]]
* [[ Exportar relatório de Título que é apresentado em tela para Excel]]
* [[ Adicionar novos campos no relatório de múltiplos pedidos]]
* [[ Card cliente prospect Pendente]]
* [[ Ativar item de bonificação em um pedido de venda]]
* [[ Adicionar novos campos ao cadastro de prospect]]
* [[ Apresentar no cadastro de cliente prospect as datas de cadastro, efetivação e aprovação]]
* [[ Parametrização de Aplicação de Pesquisas por Tipo de Público (Clientes e Prospects]]
* [[ Ativar a opção de armazém para seleção no fluxo de pedido]]

Criar mecanismos para priorizar oportunidades com maior potencial de conversão

2026-06-08T19:38:39Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 08/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==

== Solução ==
== Implementação ==
== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
=== Escopo Não Incluso ===

== Atores ==

== Pré-condições ==

== Regras de Negócio ==

'''[RN1] - '''

'''[RN2] - '''

'''[RN3] - '''

'''[RN4] - '''

'''[RN5] - '''

'''[RN6] - '''

'''[RN7] - '''

'''[RN8] - '''

'''[RN9] - '''

'''[RN10] - '''

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Criar mecanismos para priorizar oportunidades com maior potencial de conversão

2026-06-08T19:38:09Z

Renatolima: /* Histórico de Alterações */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 08/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==

== Solução ==
== Implementação ==
== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
=== Escopo Não Incluso ===

== Atores ==

== Pré-condições ==

== Regras de Negócio ==

'''[RN1] - '''

'''[RN2] - '''
'''[RN3] - '''
'''[RN4] - '''
'''[RN5] - '''
'''[RN6] - '''
'''[RN7] - '''
'''[RN8] - '''
'''[RN9] - '''

'''[RN10] - '''
== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Criar mecanismos para priorizar oportunidades com maior potencial de conversão

2026-06-08T19:37:46Z

Renatolima: Criou página com '== Histórico de Alterações == {| class="wikitable" ! Data ! Quem ! Comentários |- | 27/03/2026 || Renato Lima || Criação do documento |- |} == Necessidade == == S...'

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 27/03/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==

== Solução ==
== Implementação ==
== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
=== Escopo Não Incluso ===

== Atores ==

== Pré-condições ==

== Regras de Negócio ==

'''[RN1] - '''

'''[RN2] - '''
'''[RN3] - '''
'''[RN4] - '''
'''[RN5] - '''
'''[RN6] - '''
'''[RN7] - '''
'''[RN8] - '''
'''[RN9] - '''

'''[RN10] - '''
== 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Projeto/CRM

2026-06-08T19:34:39Z

Renatolima:

* [[ Adição de Notas no Força de Vendas]]

* [[ Alterações cadastrado de eventos]]

* [[ Acesso a agenda na mesa do cliente]]

* [[ Criação da fase dos pedidos web e mobile]]

* [[ Cadastrar Contato de Cliente]]

* [[ Atendimento ao Cliente Força de Vendas CRM]]

* [[ Criar mecanismos para priorizar oportunidades com maior potencial de conversão]]

Documento Unificado Funcionalidade de despesas

2026-06-01T18:55:05Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Criação e evolução de um módulo de controle de despesas corporativas no sistema GeoSales.O objetivo é permitir que os colaboradores realizem a prestação de contas de suas viagens e atividades externas de forma organizada, garantindo uma visão panorâmica dos gastos tanto para os usuários quanto para seus respectivos gestores.

== Solução ==
Desenvolvimento de uma funcionalidade dividida em etapas e perfis de acesso, onde é possível cadastrar, consultar, auditar e aprovar gastos corporativos (como diárias de hotel, almoço, combustível e pedágio). O sistema deve adaptar seu fluxo com base em parâmetros de configuração da empresa (exigindo ou não uma etapa prévia de estimativa/previsão de gastos pelo gestor).

== Implementação ==
A solução é estruturada sob a lógica da configuração ativa ou inativa da diretriz ID_DESPESA_PENDENTE e da análise baseada na ID_EXIBIR_ANALISE_DESPESA.

Dependendo do cenário:

● Com parametrização de previsão desativada: O fluxo é simplificado. O usuário realiza
diretamente o cadastro do cabeçalho da despesa e inclui os itens de despesa realizada,
anexando os comprovantes sem a necessidade de uma aprovação de orçamento prévio.

● Com parametrização de previsão ativa: O fluxo funciona em três fases distintas:

1. O usuário (ou gestor) realiza o cadastro do cabeçalho identificando o período e o
colaborador.

2. O gestor define a Despesa Prevista (estipulando o valor orçado e a margem de
excedente permitida em porcentagem). A despesa precisa ser salva e finalizada
pelo gestor para ficar disponível.

3. O usuário responsável pelo consumo preenche a Despesa Realizada, limitando-se
aos valores previamente acordados mais a margem configurada.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
● Formulário dinâmico de Cabeçalho de Despesa contendo campos para Descrição/Título, Data Inicial (Calendário), Data Final (Calendário) e seleção de
Usuário/Gestor dependente de hierarquia.

● Módulo de Despesa Prevista com seleção de Tipo de Despesa, Valor Previsto e Porcentagem de Excedente.

● Módulo de Despesa Realizada contendo descrição do item, tipo, data de emissão, valor utilizado, número da nota fiscal, campo de observações e upload de anexos de imagem.

● Tela de listagem e filtros de pesquisa avançados (por Título, Autor e Status como 'Autorizado', 'Não Autorizado' e 'Aguardando autorização').

● Permissão para anexar múltiplas fotos ou arquivos de imagem para o mesmo comprovante de nota fiscal.

● Painel visual com semáforos de status indicando o ciclo de vida da prestação de contas: Aberta, Solicitada, Análise e Aprovada.

=== Escopo Não Incluso ===
● Integração com sistemas externos de ERP contábil ou emissão direta de notas fiscais eletrônicas (NF-e/NFS-e).

● Mecanismo automatizado de transações bancárias, transferências via PIX ou pagamentos diretos de reembolsos a partir do sistema.

● Tratamento de moedas estrangeiras ou conversões cambiais automáticas.

== Atores ==
'''Usuário (Colaborador / Supervisor) -''' Responsável por iniciar o cabeçalho das despesas corporativas e, após a liberação, inserir os detalhes práticos dos gastos executados (valores, datas, números de notas fiscais e imagens de comprovantes).

'''Gestor / Superior ''' - Responsável por avaliar as solicitações, cadastrar a estimativa de custos (previsão) permitida, definir as margens de tolerância para gastos adicionais (excedentes) e conceder a autorização final ou recusa do reembolso.

== Pré-condições ==

== Regras de Negócio ==

'''[RN1] - Imutabilidade após Finalização: '''

Uma vez que a despesa (seja ela de previsão ou realizada) for finalizada pelo usuário ou gestor, ela é travada pelo sistema e não poderá sofrer nenhum tipo de edição ou modificação.

'''[RN2] - Exclusão de Rascunhos:'''

Despesas e itens que se encontrem sob a situação "Salvo" (não finalizadas) poderão ser livremente excluídos ou corrigidos pelo seu respectivo criador.

'''[RN3] - Visibilidade Hierárquica:'''

O gestor ou supervisor imediato possui autoridade e visibilidade completa para acompanhar e inspecionar todas as despesas vinculadas aos usuários de sua linha de subordinação, independente se estão salvas como rascunho ou formalmente finalizadas.

'''[RN4] - Condição para Aprovação:'''

Uma despesa só estará elegível para análise e aprovação formal do gestor se tiver sido previamente finalizada pelo colaborador responsável pelo consumo.

'''[RN5] - Bloqueio de Edição de Cabeçalho:'''

Para despesas iniciadas pelo usuário que estejam salvas em modo de rascunho, o sistema permite apenas a manipulação e inserção de novos itens de despesa, bloqueando alterações nos campos principais do cabeçalho.

'''[RN6] - Emissão de relatório:'''

Deve ser possível emitir relatório em Pdf e excel com as seguintes informações:

'''Cabeçalho do relatório'''

* Código da Despesa: [CD_DESPESA] (Gerado automaticamente pelo sistema)
* Título da Despesa: [DS_TITULO_DESPESA] (Ex: "Visita ao Cliente X")
* Colaborador (Autor): Nome do usuário responsável pelo consumo
* Gestor Autorizador: Nome do gestor responsável pela aprovação
* Período: [DATA_INICIAL] até [DATA_FINAL] Situação Atual: (Aberta / Solicitada / Em Análise / Aprovada)
* Data de Extração: Data e hora em que o relatório foi gerado.

'''Detalhamento por Tipo de Despesa'''
* Tipo de Despesa - Tipo da despesa selecionada
* Descrição - Descrição inserida ao criar a despesa
* Data da emissão - Data que foi informado ao realizar o cadastro
* Valor - Valor da despesa informado pelo usuario
* Nota fiscal - Número do cupom fiscal
* Observação - Observação colocada ao cadastrar
* Foto - No caso pode ser apresentado a imagem ou o link para abertura da imagem para visualização.

'''[RN7] - Cadastro da despesas:'''

O cadastro deve ser possível ser realizado no APP e 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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Documento Unificado Funcionalidade de despesas

2026-06-01T18:53:51Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Criação e evolução de um módulo de controle de despesas corporativas no sistema GeoSales.O objetivo é permitir que os colaboradores realizem a prestação de contas de suas viagens e atividades externas de forma organizada, garantindo uma visão panorâmica dos gastos tanto para os usuários quanto para seus respectivos gestores.

== Solução ==
Desenvolvimento de uma funcionalidade dividida em etapas e perfis de acesso, onde é possível cadastrar, consultar, auditar e aprovar gastos corporativos (como diárias de hotel, almoço, combustível e pedágio). O sistema deve adaptar seu fluxo com base em parâmetros de configuração da empresa (exigindo ou não uma etapa prévia de estimativa/previsão de gastos pelo gestor).

== Implementação ==
A solução é estruturada sob a lógica da configuração ativa ou inativa da diretriz ID_DESPESA_PENDENTE e da análise baseada na ID_EXIBIR_ANALISE_DESPESA.

Dependendo do cenário:

● Com parametrização de previsão desativada: O fluxo é simplificado. O usuário realiza
diretamente o cadastro do cabeçalho da despesa e inclui os itens de despesa realizada,
anexando os comprovantes sem a necessidade de uma aprovação de orçamento prévio.

● Com parametrização de previsão ativa: O fluxo funciona em três fases distintas:

1. O usuário (ou gestor) realiza o cadastro do cabeçalho identificando o período e o
colaborador.

2. O gestor define a Despesa Prevista (estipulando o valor orçado e a margem de
excedente permitida em porcentagem). A despesa precisa ser salva e finalizada
pelo gestor para ficar disponível.

3. O usuário responsável pelo consumo preenche a Despesa Realizada, limitando-se
aos valores previamente acordados mais a margem configurada.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
● Formulário dinâmico de Cabeçalho de Despesa contendo campos para Descrição/Título, Data Inicial (Calendário), Data Final (Calendário) e seleção de
Usuário/Gestor dependente de hierarquia.

● Módulo de Despesa Prevista com seleção de Tipo de Despesa, Valor Previsto e Porcentagem de Excedente.

● Módulo de Despesa Realizada contendo descrição do item, tipo, data de emissão, valor utilizado, número da nota fiscal, campo de observações e upload de anexos de imagem.

● Tela de listagem e filtros de pesquisa avançados (por Título, Autor e Status como 'Autorizado', 'Não Autorizado' e 'Aguardando autorização').

● Permissão para anexar múltiplas fotos ou arquivos de imagem para o mesmo comprovante de nota fiscal.

● Painel visual com semáforos de status indicando o ciclo de vida da prestação de contas: Aberta, Solicitada, Análise e Aprovada.

=== Escopo Não Incluso ===
● Integração com sistemas externos de ERP contábil ou emissão direta de notas fiscais eletrônicas (NF-e/NFS-e).

● Mecanismo automatizado de transações bancárias, transferências via PIX ou pagamentos diretos de reembolsos a partir do sistema.

● Tratamento de moedas estrangeiras ou conversões cambiais automáticas.

== Atores ==
'''Usuário (Colaborador / Supervisor) -''' Responsável por iniciar o cabeçalho das despesas corporativas e, após a liberação, inserir os detalhes práticos dos gastos executados (valores, datas, números de notas fiscais e imagens de comprovantes).

'''Gestor / Superior ''' - Responsável por avaliar as solicitações, cadastrar a estimativa de custos (previsão) permitida, definir as margens de tolerância para gastos adicionais (excedentes) e conceder a autorização final ou recusa do reembolso.

== Pré-condições ==

== Regras de Negócio ==

'''[RN1] - Imutabilidade após Finalização: '''

Uma vez que a despesa (seja ela de previsão ou realizada) for finalizada pelo usuário ou gestor, ela é travada pelo sistema e não poderá sofrer nenhum tipo de edição ou modificação.

'''[RN2] - Exclusão de Rascunhos:'''

Despesas e itens que se encontrem sob a situação "Salvo" (não finalizadas) poderão ser livremente excluídos ou corrigidos pelo seu respectivo criador.

'''[RN3] - Visibilidade Hierárquica:'''

O gestor ou supervisor imediato possui autoridade e visibilidade completa para acompanhar e inspecionar todas as despesas vinculadas aos usuários de sua linha de subordinação, independente se estão salvas como rascunho ou formalmente finalizadas.

'''[RN4] - Condição para Aprovação:'''

Uma despesa só estará elegível para análise e aprovação formal do gestor se tiver sido previamente finalizada pelo colaborador responsável pelo consumo.

'''[RN5] - Bloqueio de Edição de Cabeçalho:'''

Para despesas iniciadas pelo usuário que estejam salvas em modo de rascunho, o sistema permite apenas a manipulação e inserção de novos itens de despesa, bloqueando alterações nos campos principais do cabeçalho.

'''[RN6] - Emissão de relatório:'''

Deve ser possível emitir relatório em Pdf e excel com as seguintes informações:

'''Cabeçalho do relatório'''

* Código da Despesa: [CD_DESPESA] (Gerado automaticamente pelo sistema)
* Título da Despesa: [DS_TITULO_DESPESA] (Ex: "Visita ao Cliente X")
* Colaborador (Autor): Nome do usuário responsável pelo consumo
* Gestor Autorizador: Nome do gestor responsável pela aprovação
* Período: [DATA_INICIAL] até [DATA_FINAL] Situação Atual: (Aberta / Solicitada / Em Análise / Aprovada)
* Data de Extração: Data e hora em que o relatório foi gerado.

'''Detalhamento por Tipo de Despesa'''
* Tipo de Despesa - Tipo da despesa selecionada
* Descrição - Descrição inserida ao criar a despesa
* Data da emissão - Data que foi informado ao realizar o cadastro
* Valor - Valor da despesa informado pelo usuario
* Nota fiscal - Número do cupom fiscal
* Observação - Observação colocada ao cadastrar
* Foto - No caso pode ser apresentado a imagem ou o link para abertura da imagem para visualizaçã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 ===

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Documento Unificado Funcionalidade de despesas

2026-06-01T18:44:37Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Criação e evolução de um módulo de controle de despesas corporativas no sistema GeoSales.O objetivo é permitir que os colaboradores realizem a prestação de contas de suas viagens e atividades externas de forma organizada, garantindo uma visão panorâmica dos gastos tanto para os usuários quanto para seus respectivos gestores.

== Solução ==
Desenvolvimento de uma funcionalidade dividida em etapas e perfis de acesso, onde é possível cadastrar, consultar, auditar e aprovar gastos corporativos (como diárias de hotel, almoço, combustível e pedágio). O sistema deve adaptar seu fluxo com base em parâmetros de configuração da empresa (exigindo ou não uma etapa prévia de estimativa/previsão de gastos pelo gestor).

== Implementação ==
A solução é estruturada sob a lógica da configuração ativa ou inativa da diretriz ID_DESPESA_PENDENTE e da análise baseada na ID_EXIBIR_ANALISE_DESPESA.

Dependendo do cenário:

● Com parametrização de previsão desativada: O fluxo é simplificado. O usuário realiza
diretamente o cadastro do cabeçalho da despesa e inclui os itens de despesa realizada,
anexando os comprovantes sem a necessidade de uma aprovação de orçamento prévio.

● Com parametrização de previsão ativa: O fluxo funciona em três fases distintas:

1. O usuário (ou gestor) realiza o cadastro do cabeçalho identificando o período e o
colaborador.

2. O gestor define a Despesa Prevista (estipulando o valor orçado e a margem de
excedente permitida em porcentagem). A despesa precisa ser salva e finalizada
pelo gestor para ficar disponível.

3. O usuário responsável pelo consumo preenche a Despesa Realizada, limitando-se
aos valores previamente acordados mais a margem configurada.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
● Formulário dinâmico de Cabeçalho de Despesa contendo campos para Descrição/Título, Data Inicial (Calendário), Data Final (Calendário) e seleção de
Usuário/Gestor dependente de hierarquia.

● Módulo de Despesa Prevista com seleção de Tipo de Despesa, Valor Previsto e Porcentagem de Excedente.

● Módulo de Despesa Realizada contendo descrição do item, tipo, data de emissão, valor utilizado, número da nota fiscal, campo de observações e upload de anexos de imagem.

● Tela de listagem e filtros de pesquisa avançados (por Título, Autor e Status como 'Autorizado', 'Não Autorizado' e 'Aguardando autorização').

● Permissão para anexar múltiplas fotos ou arquivos de imagem para o mesmo comprovante de nota fiscal.

● Painel visual com semáforos de status indicando o ciclo de vida da prestação de contas: Aberta, Solicitada, Análise e Aprovada.

=== Escopo Não Incluso ===
● Integração com sistemas externos de ERP contábil ou emissão direta de notas fiscais eletrônicas (NF-e/NFS-e).

● Mecanismo automatizado de transações bancárias, transferências via PIX ou pagamentos diretos de reembolsos a partir do sistema.

● Tratamento de moedas estrangeiras ou conversões cambiais automáticas.

== Atores ==
'''Usuário (Colaborador / Supervisor) -''' Responsável por iniciar o cabeçalho das despesas corporativas e, após a liberação, inserir os detalhes práticos dos gastos executados (valores, datas, números de notas fiscais e imagens de comprovantes).

'''Gestor / Superior ''' - Responsável por avaliar as solicitações, cadastrar a estimativa de custos (previsão) permitida, definir as margens de tolerância para gastos adicionais (excedentes) e conceder a autorização final ou recusa do reembolso.

== Pré-condições ==

== Regras de Negócio ==

'''[RN1] - Imutabilidade após Finalização: '''

Uma vez que a despesa (seja ela de previsão ou realizada) for finalizada pelo usuário ou gestor, ela é travada pelo sistema e não poderá sofrer nenhum tipo de edição ou modificação.

'''[RN2] - Exclusão de Rascunhos:'''

Despesas e itens que se encontrem sob a situação "Salvo" (não finalizadas) poderão ser livremente excluídos ou corrigidos pelo seu respectivo criador.

'''[RN3] - Visibilidade Hierárquica:'''

O gestor ou supervisor imediato possui autoridade e visibilidade completa para acompanhar e inspecionar todas as despesas vinculadas aos usuários de sua linha de subordinação, independente se estão salvas como rascunho ou formalmente finalizadas.

'''[RN4] - Condição para Aprovação:'''

Uma despesa só estará elegível para análise e aprovação formal do gestor se tiver sido previamente finalizada pelo colaborador responsável pelo consumo.

'''[RN5] - Bloqueio de Edição de Cabeçalho:'''

Para despesas iniciadas pelo usuário que estejam salvas em modo de rascunho, o sistema permite apenas a manipulação e inserção de novos itens de despesa, bloqueando alterações nos campos principais do cabeçalho.

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Documento Unificado Funcionalidade de despesas

2026-06-01T18:44:27Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Criação e evolução de um módulo de controle de despesas corporativas no sistema GeoSales.O objetivo é permitir que os colaboradores realizem a prestação de contas de suas viagens e atividades externas de forma organizada, garantindo uma visão panorâmica dos gastos tanto para os usuários quanto para seus respectivos gestores.

== Solução ==
Desenvolvimento de uma funcionalidade dividida em etapas e perfis de acesso, onde é possível cadastrar, consultar, auditar e aprovar gastos corporativos (como diárias de hotel, almoço, combustível e pedágio). O sistema deve adaptar seu fluxo com base em parâmetros de configuração da empresa (exigindo ou não uma etapa prévia de estimativa/previsão de gastos pelo gestor).

== Implementação ==
A solução é estruturada sob a lógica da configuração ativa ou inativa da diretriz ID_DESPESA_PENDENTE e da análise baseada na ID_EXIBIR_ANALISE_DESPESA.

Dependendo do cenário:

● Com parametrização de previsão desativada: O fluxo é simplificado. O usuário realiza
diretamente o cadastro do cabeçalho da despesa e inclui os itens de despesa realizada,
anexando os comprovantes sem a necessidade de uma aprovação de orçamento prévio.

● Com parametrização de previsão ativa: O fluxo funciona em três fases distintas:

1. O usuário (ou gestor) realiza o cadastro do cabeçalho identificando o período e o
colaborador.

2. O gestor define a Despesa Prevista (estipulando o valor orçado e a margem de
excedente permitida em porcentagem). A despesa precisa ser salva e finalizada
pelo gestor para ficar disponível.

3. O usuário responsável pelo consumo preenche a Despesa Realizada, limitando-se
aos valores previamente acordados mais a margem configurada.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
● Formulário dinâmico de Cabeçalho de Despesa contendo campos para Descrição/Título, Data Inicial (Calendário), Data Final (Calendário) e seleção de
Usuário/Gestor dependente de hierarquia.

● Módulo de Despesa Prevista com seleção de Tipo de Despesa, Valor Previsto e Porcentagem de Excedente.

● Módulo de Despesa Realizada contendo descrição do item, tipo, data de emissão, valor utilizado, número da nota fiscal, campo de observações e upload de anexos de imagem.

● Tela de listagem e filtros de pesquisa avançados (por Título, Autor e Status como 'Autorizado', 'Não Autorizado' e 'Aguardando autorização').

● Permissão para anexar múltiplas fotos ou arquivos de imagem para o mesmo comprovante de nota fiscal.

● Painel visual com semáforos de status indicando o ciclo de vida da prestação de contas: Aberta, Solicitada, Análise e Aprovada.

=== Escopo Não Incluso ===
● Integração com sistemas externos de ERP contábil ou emissão direta de notas fiscais eletrônicas (NF-e/NFS-e).

● Mecanismo automatizado de transações bancárias, transferências via PIX ou pagamentos diretos de reembolsos a partir do sistema.

● Tratamento de moedas estrangeiras ou conversões cambiais automáticas.

== Atores ==
'''Usuário (Colaborador / Supervisor) -''' Responsável por iniciar o cabeçalho das despesas corporativas e, após a liberação, inserir os detalhes práticos dos gastos executados (valores, datas, números de notas fiscais e imagens de comprovantes).

'''Gestor / Superior ''' - Responsável por avaliar as solicitações, cadastrar a estimativa de custos (previsão) permitida, definir as margens de tolerância para gastos adicionais (excedentes) e conceder a autorização final ou recusa do reembolso.

== Pré-condições ==

== Regras de Negócio ==

'''[RN1] - Imutabilidade após Finalização: '''

Uma vez que a despesa (seja ela de previsão ou realizada) for finalizada pelo usuário ou gestor, ela é travada pelo sistema e não poderá sofrer nenhum tipo de edição ou modificação.

'''[RN2] - Exclusão de Rascunhos:'''

Despesas e itens que se encontrem sob a situação "Salvo" (não finalizadas) poderão ser livremente excluídos ou corrigidos pelo seu respectivo criador.

'''[RN3] - Visibilidade Hierárquica:'''

O gestor ou supervisor imediato possui autoridade e visibilidade completa para acompanhar e inspecionar todas as despesas vinculadas aos usuários de sua linha de subordinação, independente se estão salvas como rascunho ou formalmente finalizadas.

'''[RN4] - Condição para Aprovação:'''

Uma despesa só estará elegível para análise e aprovação formal do gestor se tiver sido previamente finalizada pelo colaborador responsável pelo consumo.

'''[RN5] - Bloqueio de Edição de Cabeçalho:'''

Para despesas iniciadas pelo usuário que estejam salvas em modo de rascunho, o sistema permite apenas a manipulação e inserção de novos itens de despesa, bloqueando alterações nos campos principais do cabeçalho.

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Documento Unificado Funcionalidade de despesas

2026-06-01T18:40:00Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Criação e evolução de um módulo de controle de despesas corporativas no sistema GeoSales.O objetivo é permitir que os colaboradores realizem a prestação de contas de suas viagens e atividades externas de forma organizada, garantindo uma visão panorâmica dos gastos tanto para os usuários quanto para seus respectivos gestores.

== Solução ==
Desenvolvimento de uma funcionalidade dividida em etapas e perfis de acesso, onde é possível cadastrar, consultar, auditar e aprovar gastos corporativos (como diárias de hotel, almoço, combustível e pedágio). O sistema deve adaptar seu fluxo com base em parâmetros de configuração da empresa (exigindo ou não uma etapa prévia de estimativa/previsão de gastos pelo gestor).

== Implementação ==
A solução é estruturada sob a lógica da configuração ativa ou inativa da diretriz ID_DESPESA_PENDENTE e da análise baseada na ID_EXIBIR_ANALISE_DESPESA.

Dependendo do cenário:

● Com parametrização de previsão desativada: O fluxo é simplificado. O usuário realiza
diretamente o cadastro do cabeçalho da despesa e inclui os itens de despesa realizada,
anexando os comprovantes sem a necessidade de uma aprovação de orçamento prévio.

● Com parametrização de previsão ativa: O fluxo funciona em três fases distintas:

1. O usuário (ou gestor) realiza o cadastro do cabeçalho identificando o período e o
colaborador.

2. O gestor define a Despesa Prevista (estipulando o valor orçado e a margem de
excedente permitida em porcentagem). A despesa precisa ser salva e finalizada
pelo gestor para ficar disponível.

3. O usuário responsável pelo consumo preenche a Despesa Realizada, limitando-se
aos valores previamente acordados mais a margem configurada.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
● Formulário dinâmico de Cabeçalho de Despesa contendo campos para Descrição/Título, Data Inicial (Calendário), Data Final (Calendário) e seleção de
Usuário/Gestor dependente de hierarquia.

● Módulo de Despesa Prevista com seleção de Tipo de Despesa, Valor Previsto e Porcentagem de Excedente.

● Módulo de Despesa Realizada contendo descrição do item, tipo, data de emissão, valor utilizado, número da nota fiscal, campo de observações e upload de anexos de imagem.

● Tela de listagem e filtros de pesquisa avançados (por Título, Autor e Status como 'Autorizado', 'Não Autorizado' e 'Aguardando autorização').

● Permissão para anexar múltiplas fotos ou arquivos de imagem para o mesmo comprovante de nota fiscal.

● Painel visual com semáforos de status indicando o ciclo de vida da prestação de contas: Aberta, Solicitada, Análise e Aprovada.

=== Escopo Não Incluso ===
● Integração com sistemas externos de ERP contábil ou emissão direta de notas fiscais eletrônicas (NF-e/NFS-e).

● Mecanismo automatizado de transações bancárias, transferências via PIX ou pagamentos diretos de reembolsos a partir do sistema.

● Tratamento de moedas estrangeiras ou conversões cambiais automáticas.

== Atores ==
'''Usuário (Colaborador / Supervisor) -''' Responsável por iniciar o cabeçalho das despesas corporativas e, após a liberação, inserir os detalhes práticos dos gastos executados (valores, datas, números de notas fiscais e imagens de comprovantes).

'''Gestor / Superior ''' - Responsável por avaliar as solicitações, cadastrar a estimativa de custos (previsão) permitida, definir as margens de tolerância para gastos adicionais (excedentes) e conceder a autorização final ou recusa do reembolso.

== Pré-condições ==

== Regras de Negócio ==

'''[RN1] - Imutabilidade após Finalização: '''

Uma vez que a despesa (seja ela de previsão ou realizada) for finalizada pelo usuário ou gestor, ela é travada pelo sistema e não poderá sofrer nenhum tipo de edição ou modificação.

'''[RN2] - '''

'''[RN3] - '''

'''[RN4] - '''

'''[RN5] - '''

'''[RN6] - '''

'''[RN7] - '''

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Documento Unificado Funcionalidade de despesas

2026-06-01T18:39:52Z

Renatolima: /* Regras de Negócio */

== Histórico de Alterações ==
{| class="wikitable"
! Data
! Quem
! Comentários
|-
| 01/06/2026 || Renato Lima || Criação do documento
|-
|}

== Necessidade ==
Criação e evolução de um módulo de controle de despesas corporativas no sistema GeoSales.O objetivo é permitir que os colaboradores realizem a prestação de contas de suas viagens e atividades externas de forma organizada, garantindo uma visão panorâmica dos gastos tanto para os usuários quanto para seus respectivos gestores.

== Solução ==
Desenvolvimento de uma funcionalidade dividida em etapas e perfis de acesso, onde é possível cadastrar, consultar, auditar e aprovar gastos corporativos (como diárias de hotel, almoço, combustível e pedágio). O sistema deve adaptar seu fluxo com base em parâmetros de configuração da empresa (exigindo ou não uma etapa prévia de estimativa/previsão de gastos pelo gestor).

== Implementação ==
A solução é estruturada sob a lógica da configuração ativa ou inativa da diretriz ID_DESPESA_PENDENTE e da análise baseada na ID_EXIBIR_ANALISE_DESPESA.

Dependendo do cenário:

● Com parametrização de previsão desativada: O fluxo é simplificado. O usuário realiza
diretamente o cadastro do cabeçalho da despesa e inclui os itens de despesa realizada,
anexando os comprovantes sem a necessidade de uma aprovação de orçamento prévio.

● Com parametrização de previsão ativa: O fluxo funciona em três fases distintas:

1. O usuário (ou gestor) realiza o cadastro do cabeçalho identificando o período e o
colaborador.

2. O gestor define a Despesa Prevista (estipulando o valor orçado e a margem de
excedente permitida em porcentagem). A despesa precisa ser salva e finalizada
pelo gestor para ficar disponível.

3. O usuário responsável pelo consumo preenche a Despesa Realizada, limitando-se
aos valores previamente acordados mais a margem configurada.

== Documentos relacionados ==

== Escopo ==

=== Escopo Incluso ===
● Formulário dinâmico de Cabeçalho de Despesa contendo campos para Descrição/Título, Data Inicial (Calendário), Data Final (Calendário) e seleção de
Usuário/Gestor dependente de hierarquia.

● Módulo de Despesa Prevista com seleção de Tipo de Despesa, Valor Previsto e Porcentagem de Excedente.

● Módulo de Despesa Realizada contendo descrição do item, tipo, data de emissão, valor utilizado, número da nota fiscal, campo de observações e upload de anexos de imagem.

● Tela de listagem e filtros de pesquisa avançados (por Título, Autor e Status como 'Autorizado', 'Não Autorizado' e 'Aguardando autorização').

● Permissão para anexar múltiplas fotos ou arquivos de imagem para o mesmo comprovante de nota fiscal.

● Painel visual com semáforos de status indicando o ciclo de vida da prestação de contas: Aberta, Solicitada, Análise e Aprovada.

=== Escopo Não Incluso ===
● Integração com sistemas externos de ERP contábil ou emissão direta de notas fiscais eletrônicas (NF-e/NFS-e).

● Mecanismo automatizado de transações bancárias, transferências via PIX ou pagamentos diretos de reembolsos a partir do sistema.

● Tratamento de moedas estrangeiras ou conversões cambiais automáticas.

== Atores ==
'''Usuário (Colaborador / Supervisor) -''' Responsável por iniciar o cabeçalho das despesas corporativas e, após a liberação, inserir os detalhes práticos dos gastos executados (valores, datas, números de notas fiscais e imagens de comprovantes).

'''Gestor / Superior ''' - Responsável por avaliar as solicitações, cadastrar a estimativa de custos (previsão) permitida, definir as margens de tolerância para gastos adicionais (excedentes) e conceder a autorização final ou recusa do reembolso.

== Pré-condições ==

== Regras de Negócio ==

'''[RN1] - Imutabilidade após Finalização: '''
Uma vez que a despesa (seja ela de previsão ou realizada) for finalizada pelo usuário ou gestor, ela é travada pelo sistema e não poderá sofrer nenhum tipo de edição ou modificação.

'''[RN2] - '''

'''[RN3] - '''

'''[RN4] - '''

'''[RN5] - '''

'''[RN6] - '''

'''[RN7] - '''

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

{| class="wikitable"
! Setor
! Aprovado Por
! Data

|-
| Integração - GeoSales || || dd/mm/aaaa
|-
|}

=== Empresa solicitante ===

{| class="wikitable"
! 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 ||
|-
|}

Documento Unificado Funcionalidade de despesas

2026-06-01T18:39:05Z

Renatolima: /* Atores */

Documento Unificado Funcionalidade de despesas

2026-06-01T18:38:07Z

Renatolima: /* Atores */

Documento Unificado Funcionalidade de despesas

2026-06-01T18:37:56Z

Renatolima: /* Atores */

Documento Unificado Funcionalidade de despesas

2026-06-01T18:37:10Z

Renatolima: /* Escopo Não Incluso */

Documento Unificado Funcionalidade de despesas

2026-06-01T18:36:37Z

Renatolima: /* Escopo Incluso */

Documento Unificado Funcionalidade de despesas

2026-06-01T18:35:55Z

Renatolima: /* Escopo Incluso */

Documento Unificado Funcionalidade de despesas

2026-06-01T18:35:24Z

Renatolima: /* Implementação */

Documento Unificado Funcionalidade de despesas

2026-06-01T18:34:43Z

Renatolima: /* Solução */

Documento Unificado Funcionalidade de despesas

2026-06-01T18:34:15Z

Renatolima: /* Necessidade */