| Produto: | TOTVS Distribuição e Varejo |
|---|---|
| Linha de Produto: | Linha Winthor |
| Segmento: | Distribuição TOTVS Goiânia |
| Módulo: | 12 - CONTAS A RECEBER |
| Função: | PKG_RECEBIMENTOANTECIPADO |
| Requisito/Story/Issue : | DDFINAN-34622 |
Atualmente, o módulo financeiro não possui uma chamada padronizada que permita estornar, de forma única e transacional, todos os registros associados a um recebimento antecipado.
O processo deve contemplar o estorno de:
Crédito do cliente (PCCRECLI)
Movimentação financeira correspondente (PCMOVCR)
Registro de antecipação (PCPRESTANTECIPADA)
Além disso:
A operação não deve realizar validação de link de pagamento, pois o controle do recebimento antecipado é feito pelo varejo.
O estorno deve ocorrer de forma integrada, auditável e com consistência transacional (COMMIT/ROLLBACK).
A chamada deve receber os parâmetros obrigatórios:
| Parâmetro | Descrição |
|---|---|
| CODCLI | Código do cliente |
| NUMPED | Número do pedido |
| VALOR | Valor a ser estornado |
| NUMTRANSPAGADIANTADO | Identificador do adiantamento/transação |
Foi criada, na package PKG_RECEBIMENTOANTECIPADO, a nova procedure pública:
PKG_RECEBIMENTOANTECIPADO.ESTORNAR_RECEBIMENTO_ANTECIPADO
Essa procedure é agora o entrypoint oficial para estorno de recebimentos antecipados.
A rotina realiza o estorno completo do recebimento antecipado informado, envolvendo:
Estorno do crédito registrado na PCCRECLI
Estorno da movimentação financeira correspondente em PCMOVCR
Estorno do registro de antecipação na PCPRESTANTECIPADA
Para isso, a nova procedure utiliza os métodos internos já existentes dentro da própria package, mantendo toda a lógica centralizada e padronizada.
Valida os parâmetros obrigatórios.
Localiza o adiantamento pelo NUMTRANSPAGADIANTADO, considerando CODCLI e NUMPED.
Invoca internamente as rotinas já existentes para:
Estornar o crédito
Estornar o movimento financeiro
Estornar o registro de antecipação
Executa COMMIT apenas se todas as operações forem concluídas com sucesso.
Em qualquer falha, executa ROLLBACK total.
Retorna status e mensagem de execução.
Registra log detalhado da operação.
Verificação da presença dos quatro parâmetros obrigatórios
Verificação da existência do adiantamento informado
Validação do valor para impedir estorno acima do saldo/valor registrado
Ausência de validação de link (conforme regra de negócio)
|
Importante! As versões estarão disponíveis para download no CCW. https://centraldecontrole.pcinformatica.com.br/ Mantenha suas rotinas sempre atualizadas! |