Mudanças entre as edições de "Condições de Pagamento"

Edição das 20h17min de 12 de maio de 2021

Histórico de Alterações

Data	Quem	Comentários
07/05/2021	João Ramon	Criação do documento

Necessidade

Existem tabelas dedicadas a Condições de pagamento no Banco de Dados da GeoSales, mas estas tabelas não podem ser parametrizadas pelo cliente, porque não há interface criada na plataforma GeoSales para esta funcão. Tal funcionalidade necessita ser implementada dentro da plataforma, a fim de que o usuário consiga fazer essas parametrizações.

Solução

Criação de um CRUD para possibilitar as parametrizações de Condição de pagamento, utilizando a tabela homônima, contendo os campos 'Código da condição de Pagamento', 'Descrição da condição de Pagamento', 'quantidade de dias total', 'percentual de desconto', descrição de dias das parcelas', 'descrição do percentual de parcelas', 'numero do preço', 'quantidade de prazo médio', 'percentual de juros' e 'Código da condição de Pagamento de Referência'. O usuário deverá, por meio destes campos, criar, editar ou excluir os meios de pagamento que ele julgar necessários dentro da plataforma, utilizando as tabelas já fornecida no Banco de dados.

Implementação

A tabela CONDICAO_PAGAMENTO possui os seguintes parametros:

Column_name	Type	Lenght	Nullable
CD_COND_PGTO	int	4	no
DS_COND_PGTO	varchar	40	no
QT_DIAS_TOTAL	int	4	no
PR_DESCONTO	decimal	9	no
DS_DIAS_PARCELAS	varchar	50	yes
DS_PR_PARCELAS	varchar	50	yes
NR_PRECO	int	4	yes
QT_PRAZO_MEDIO	int	4	yes
PR_JUROS	decimal	9	yes
CD_COND_PGTO_REFERENCIA	varchar	30	yes

A interface do cliente com a plataforma se dará por meio de um CRUD, que será alocado no módulo 'Cenário de Vendas'.

A sequência operacional do CRUD seguirá conforme o modelo abaixo:

A tela de CRUD deverá possuir botão de pesquisa, a fim de que o usuário possa procurar por acessos existentes. Ao listar todos os cadastros, deverá ser possível ao usuário editar os cadastros existentes, além de ter a opção de deixar tais cadastros ativos ou não. Esta função será parametrizada por meio da criação de uma coluna chamada ID_ATIVO na tabela CONDICAO_PAGAMENTO.

Após a inserção dos dados, um código de condição de pagamento será gerado. Dependendo da origem do dado (inserção de dados via plataforma GeoSales ou por meio de integração), será utilizado um sinal para diferenciar a origem do codigo. Portanto, para o dado originado pelo ERP, o código será gerado com sinal positivo (ou sem sinal aparente), e dados originados pelo usuário dentro da plataforma (tabela CONDICAO_PAGAMENTO, coluna CD_COND_PGTO) deverão ser apresentados com sinal negativo.

Cenários

1. Criação de uma Nova Condição de Pagamento

Visto que Acesso o Portal GeoSales EVO
E seleciono o módulo Cenários de Vendas
E seleciono a aba Condições de Pagamento
Então será acessado o CRUD de Condições de Pagamento
Quando selecionar o botão 'criar'
Surgirá a tela de cadastro com os campos para preenchimento conforme tabela CONDICAO_PAGAMENTO
Então preencho os campos
E seleciono o botão Finalizar.
O processo estará concluído e a condição de pagamento já estará disponível.

2. Criação de uma Nova Condição de Pagamento (com repetição de cadastro)

Visto que Acesso o Portal GeoSales EVO
E seleciono o módulo Cenários de Vendas
E seleciono a aba Condições de Pagamento
Então será acessado o CRUD de Condição de Pagamento
Quando selecionar o botão 'criar'
Surgirá a tela de cadastro com os campos para preenchimento conforme tabela CONDICAO_PAGAMENTO
Então preencho os campos
E seleciono o botão Finalizar.
Existe um meio de pagamento já cadastrado, com os mesmos parâmetros apontados neste novo registro;
O portal informará ao usuário que tal parametrização já existe, e não permitirá que o cadastro seja realizado.

3. Edição de uma Condição de Pagamento existente

Visto que Acesso o Portal GeoSales EVO
E seleciono o módulo Cenários de Vendas
E seleciono a aba Condições de Pagamento
Então será acessado o CRUD de Condições de Pagamento
Quando selecionar o botão 'pesquisar'
Surgirá a lista de Condições de pagamento já cadastrados anteriormente
Então seleciono um cadastro existente
E seleciono o botão editar.
Na tela de edição posso mudar os campos de parametrização que são necessários
E salvo as minhas alterações.
Então O processo estará concluído e a condição de pagamento já estará com as modificações salvas.

4. Edição de um Meio de Pagamento existente (com repetição de cadastro)

Visto que Acesso o Portal GeoSales EVO;
E seleciono o módulo Cenários de Vendas;
E seleciono a aba Condições de Pagamento;
Então será acessado o CRUD de Condições de Pagamento;
Quando selecionar o botão 'pesquisar';
Surgirá a lista de Condições de pagamento já cadastrados anteriormente;
Então seleciono um cadastro existente;
E seleciono o botão editar;
Na tela de edição posso mudar os campos de descrição do meio de pagamento e código do meio de pagamento referencia;
Existe uma condição de pagamento já cadastrada, com os mesmos parâmetros apontados nesta nova edição;
O portal informará ao usuário que tal parametrização já existe, e ele não poderá efetuar este cadastro.

5. Edição de um Meio de Pagamento importado via Integração

Visto que Acesso o Portal GeoSales EVO
E seleciono o módulo Cenários de Vendas
E seleciono a aba Condições de Pagamento
Então será acessado o CRUD de Condições de Pagamento
Quando selecionar o botão 'pesquisar'
Surgirá a lista de Condições de pagamento já cadastrados anteriormente
Então seleciono um cadastro existente
A opção selecionada é um cadastro importado do ERP, logo não estará disponível para edição.

Protótipos

Regras de Negócios

[RN1] - Não poderá ser possível o cadastro de uma mesma entrada com descrição de meio de pagamento diferentes, mas com codigo de meio de pagamento e codigo de meio de pagamento referencia iguais. Essa rotina será considerada como duplicidade de cadastro.

[RN2] - Não deverá haver sobreposição de cadastros, e sim edição deste cadastro. Caso o usuário tente cadastrar o mesmo cenário mais de uma vez, a plataforma irá alertar informando que já existe uma regra, e que essa regra poderá ser sobreposta;

[RN3] - Essa funcionalidade será desenvolvida exclusivamente no GeoSales EVO.

Aprovação

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

GeoSales

Setor	Aprovado Por	Data
Desenvolvimento - GeoSales	Pessoa que aprovou	00/00/0000
Integração - GeoSales	Pessoa que aprovou	00/00/0000
Configurações - GeoSales	Pessoa que aprovou	00/00/0000

Empresa solicitante

Setor	Aprovado Por	Data
Gerente TI - Cliente	Pessoa que aprovou	00/00/0000
Gerente de Projeto - Cliente	Pessoa que aprovou	00/00/0000
Gerente Comercial - Cliente	Pessoa que aprovou	00/00/0000

@@ Linha 60: / Linha 60: @@
 == Cenários ==
-=== 1. Criação de um Novo Meio de Pagamento ===
+=== 1. Criação de uma Nova Condição de Pagamento ===
 *Visto que Acesso o Portal GeoSales EVO
 *E seleciono o módulo Cenários de Vendas
-*E seleciono a aba Meios de Pagamento
+*E seleciono a aba Condições de Pagamento
-*Então será acessado o CRUD de Meio de Pagamento
+*Então será acessado o CRUD de Condições de Pagamento
 *Quando selecionar o botão 'criar'
-*Surgirá a tela de cadastro com três campos para preenchimento
+*Surgirá a tela de cadastro com os campos para preenchimento conforme tabela CONDICAO_PAGAMENTO
 *Então preencho os campos
 *E seleciono o botão Finalizar.
-*O processo estará concluído e o meio de pagamento já estará disponível.
+*O processo estará concluído e a condição de pagamento já estará disponível.
-=== 2. Criação de um Novo Meio de Pagamento (com sobreposição de dados) ===
+=== 2. Criação de uma Nova Condição de Pagamento (com repetição de cadastro) ===
 *Visto que Acesso o Portal GeoSales EVO
 *E seleciono o módulo Cenários de Vendas
-*E seleciono a aba Meios de Pagamento
+*E seleciono a aba Condições de Pagamento
-*Então será acessado o CRUD de Meio de Pagamento
+*Então será acessado o CRUD de Condição de Pagamento
 *Quando selecionar o botão 'criar'
-*Surgirá a tela de cadastro com três campos para preenchimento
+*Surgirá a tela de cadastro com os campos para preenchimento conforme tabela CONDICAO_PAGAMENTO
 *Então preencho os campos
 *E seleciono o botão Finalizar.
-*Existe um meio de pagamento já cadastrado, com os mesmos parâmetros apontados nesta nova edição;
+*Existe um meio de pagamento já cadastrado, com os mesmos parâmetros apontados neste novo registro;
-*O portal informará ao usuário que tal parametrização já existe, e ele deverá optar por cancelar a solicitação atual, OU
+*O portal informará ao usuário que tal parametrização já existe, e não permitirá que o cadastro seja realizado.
-*Salvar a solicitação atual, sobrepondo o cadastro já existente;
-*O usuário seleciona salvar a solicitação atual;
-*O cadastro atual será salvo, excluindo o cadastro anterior com as mesmas parametrizações;
-*Então O processo estará concluído e o meio de pagamento já estará com as modificações salvas.
-=== 3. Edição de um Meio de Pagamento existente ===
+=== 3. Edição de uma Condição de Pagamento existente ===
 *Visto que Acesso o Portal GeoSales EVO
 *E seleciono o módulo Cenários de Vendas
-*E seleciono a aba Meios de Pagamento
+*E seleciono a aba Condições de Pagamento
-*Então será acessado o CRUD de Meio de Pagamento
+*Então será acessado o CRUD de Condições de Pagamento
 *Quando selecionar o botão 'pesquisar'
-*Surgirá a lista de meios de pagamento já cadastrados anteriormente
+*Surgirá a lista de Condições de pagamento já cadastrados anteriormente
 *Então seleciono um cadastro existente
 *E seleciono o botão editar.
-*Na tela de edição posso mudar os campos de codigo do meio de pagamento, descrição do meio de pagamento e código do meio de pagamento referencia;
+*Na tela de edição posso mudar os campos de parametrização que são necessários
 *E salvo as minhas alterações.
-*Então O processo estará concluído e o meio de pagamento já estará com as modificações salvas.
+*Então O processo estará concluído e a condição de pagamento já estará com as modificações salvas.
-=== 4. Edição de um Meio de Pagamento existente (com sobreposição de dados) ===
+=== 4. Edição de um Meio de Pagamento existente (com repetição de cadastro) ===
 *Visto que Acesso o Portal GeoSales EVO;
 *E seleciono o módulo Cenários de Vendas;
-*E seleciono a aba Meios de Pagamento;
+*E seleciono a aba Condições de Pagamento;
-*Então será acessado o CRUD de Meio de Pagamento;
+*Então será acessado o CRUD de Condições de Pagamento;
 *Quando selecionar o botão 'pesquisar';
-*Surgirá a lista de meios de pagamento já cadastrados anteriormente;
+*Surgirá a lista de Condições de pagamento já cadastrados anteriormente;
 *Então seleciono um cadastro existente;
 *E seleciono o botão editar;
-*Na tela de edição posso mudar os campos de código do meio de pagamento, descrição do meio de pagamento e código do meio de pagamento referencia;
+*Na tela de edição posso mudar os campos de descrição do meio de pagamento e código do meio de pagamento referencia;
-*Existe um meio de pagamento já cadastrado, com os mesmos parâmetros apontados nesta nova edição;
+*Existe uma condição de pagamento já cadastrada, com os mesmos parâmetros apontados nesta nova edição;
-*O portal informará ao usuário que tal parametrização já existe, e ele deverá optar por cancelar a solicitação atual, OU
+*O portal informará ao usuário que tal parametrização já existe, e ele não poderá efetuar este cadastro.
-*Salvar a solicitação atual, sobrepondo o cadastro já existente;
-*O usuário seleciona salvar a solicitação atual;
-*O cadastro atual será salvo, excluindo o cadastro anterior com as mesmas parametrizações;
-*Então O processo estará concluído e o meio de pagamento já estará com as modificações salvas.
-=== 5. Exclusão de um Meio de Pagamento existente===
+=== 5. Edição de um Meio de Pagamento importado via Integração ===
 *Visto que Acesso o Portal GeoSales EVO
 *E seleciono o módulo Cenários de Vendas
-*E seleciono a aba Meios de Pagamento
+*E seleciono a aba Condições de Pagamento
-*Então será acessado o CRUD de Meio de Pagamento
+*Então será acessado o CRUD de Condições de Pagamento
 *Quando selecionar o botão 'pesquisar'
-*Surgirá a lista de meios de pagamento já cadastrados anteriormente
+*Surgirá a lista de Condições de pagamento já cadastrados anteriormente
 *Então seleciono um cadastro existente
-*E seleciono o botão 'excluir'.
+*A opção selecionada é um cadastro importado do ERP, logo não estará disponível para edição.
-*Surgirá um pop-up perguntando se o usuário deseja realmente excluir a entrada existente.
-*O usuário seleciona 'sim'.
-*Então a entrada selecionada será excluída
-*O processo estará concluído e o meio de pagamento não existirá mais no banco de dados.
 == Protótipos ==