| Produto: |
|
|---|---|
| Linha de Produto: |
|
| Segmento: |
|
| Módulo: |
|
| Função: | Forma de Pagamento |
| País: | Brasil |
| Ticket: | |
| Requisito/Story/Issue (informe o requisito relacionado) : |
Para permitir um controle mais flexível dos processos de recebimento, identificou-se a necessidade de parametrizar quais formas de pagamento são consideradas "Recebimento Antecipado". Atualmente, essa definição não existe ou não é controlada dinamicamente por integrações.
A demanda é criar um novo parâmetro, recebimento_antecipado, no cadastro de Formas de Pagamento. O principal objetivo é que este campo possa ser preenchido e atualizado por serviços de integração de dados, sem sobrescrever o valor existente caso a informação não venha no payload da integração.
Visão Negocial Esta implementação permite que sistemas externos (ERPs ou outros backoffices) ditem o comportamento de uma forma de pagamento no que tange ao recebimento antecipado.
Com o novo parâmetro recebimento_antecipado, o sistema ganha a flexibilidade de:
Identificar via integração se uma forma de pagamento (como PIX, Cartão, etc.) deve ser tratada como recebimento antecipado.
Manter o valor atual (seja ele nulo, verdadeiro ou falso) caso a integração não especifique um novo valor, evitando perdas de configuração.
Isso descentraliza a configuração e a torna mais dinâmica, alinhando-se à jornada de Recebimento Antecipado (conforme documentação TDN).
Visão Técnica Para atender ao requisito, a principal alteração foi a adição de uma nova coluna na tabela de formas de pagamento.
Alteração no Banco de Dados (Migration) Foi criada a migration CriacaoRecebimentoAntecipadoPagamentoForma para adicionar a coluna recebimento_antecipado na tabela de formas de pagamento.
A coluna é do tipo boolean
A coluna é nullable (permite nulos), para que o valor padrão seja null na criação de novos registros.
Atualização da Entidade e DTO A entidade PagamentoForma foi atualizada para incluir a nova propriedade
Valor Padrão: Conforme o critério de aceite, qualquer nova forma de pagamento criada diretamente no sistema (sem passar pela integração) terá o campo recebimento_antecipado com o valor null.