Páginas filhas
  • DDFINAN-29591 - DT - 522 - Criação de flag "pagamento antecipado" e "quita prestação no faturamento"

01. DADOS GERAIS

Produto:

TOTVS Distribuição e Varejo

Linha de Produto:

Linha Winthor

Segmento:

Distribuição

Função:522 - CADASTRAR TIPO DE COBRANÇA
País:Brasil
Requisito/Story/Issue:DDFINAN-29591

02. SITUAÇÃO/REQUISITO

Para melhorar o controle financeiro e de faturamento no ERP Winthor, foi identificada a necessidade de criar um indicador (flag) para identificar quando uma cobrança será do tipo "Pagamento Antecipado".

Essa funcionalidade permitirá que o sistema aplique regras específicas de bloqueio de pedidos e quitação automática de contas a receber, conforme definido pelo cliente.

A demanda também inclui controles para evitar alterações em cobranças que já tenham pedidos em andamento ou contas a receber abertas, garantindo a integridade das informações.

03. SOLUÇÃO

A solução foi implementada na rotina 522 – Cadastrar Tipo de Cobrança, com os seguintes detalhes:

1. Criação da Flag "Pagamento Antecipado"

  • Local: Aba "Dados cadastrais" da rotina 522.

  • Campo vinculado: PCCOB.COBANTECIPADA (conforme dependência da issue DDFINAN-29590).

  • Valor default: 'N' (desmarcado).

  • Hint (ajuda ao usuário):

"Ao marcar esse campo, essa cobrança será considerada como 'pagamento antecipado' e, desta forma, os pedidos colocados nela serão bloqueados por padrão, somente sendo possível liberar após o pagamento. (Não afeta pedidos já inseridos no sistema com essa cobrança)"

Restrições: Não será permitido marcar essa flag junto com os tipos de cobrança:

  • Boleto Bancário

  • BolePix

  • Cartão de Crédito

  • Carteira Digital

Log de Alterações (pclogalteracaodados): Ao alterar essa flag, os seguintes dados serão registrados:

CampoValor
CODROTINA522
TABELAPCCOB
COLUNACOBANTECIPADA
TIPOVALORA
VALORALFANovo valor (S ou N)
VALORALFAANTValor anterior
OBSERVACOESAntigo: (valor anterior), Novo: (novo valor)
DEMAIS CAMPOSIncluindo data, usuário, máquina, etc

Validações antes de gravar alteração:

  • Se houver pedidos não faturados ou cancelados (PCPEDC.POSICAO in 'L', 'M', 'B', 'P'), o sistema bloqueará a gravação.

  • Se houver contas a receber em aberto (PCPREST com DTPAG IS NULL), o sistema também bloqueará a gravação.

2. Nova Aba: "Pagamento Antecipado"

Essa aba será habilitada apenas quando o campo "Pagamento antecipado" estiver marcado.

2.1 Flag: "Quita prestação ao faturar"

  • Campo: PCCOB.QUITAPCPREST

  • Valor default: 'N' (desmarcado)

  • Hint:

"Ao marcar esse campo, o contas a receber será quitado automaticamente. (Não afeta pedidos já inseridos no sistema com essa cobrança)"

Regras adicionais:

  • Se o usuário desmarcar a flag "Pagamento antecipado", a flag "Quita prestação ao faturar" também será automaticamente desmarcada.

  • Será registrado log na pclogalteracaodados com todos os campos de rastreio.

Validações antes de gravar alteração:
Mesma regra de bloqueio já descrita acima.


2.2 Campo: "Banco para baixa"

  • Campo: PCCOB.CODBCOCOBANTECIPADA

  • Tipo: Pesquisa (trazendo bancos da PCBANCO, semelhante ao campo da PCBOLEPIX).

  • Habilitação:
    Somente habilitado se a flag "Quita prestação ao faturar" estiver como SIM.

Regras adicionais:

  • Ao desmarcar "Quita prestação ao faturar", o campo "Banco para baixa" será automaticamente limpo.

  • Alterações também serão registradas na pclogalteracaodados.


2.3 Campo: "Moeda para baixa"

  • Campo: PCCOB.CODMOEDACOBANTECIPADA

  • Tipo: Pesquisa (listando moedas da PCMOEDA, igual ao campo de moeda já existente na aba Dados cadastrais).

  • Habilitação:
    Somente habilitado se a flag "Quita prestação ao faturar" estiver como SIM.

Regras adicionais:

  • Ao desmarcar "Quita prestação ao faturar", o campo "Moeda para baixa" será automaticamente limpo.

  • Alterações também serão registradas na pclogalteracaodados.

Para utilizar a implementação, atualize a rotina 522 para a versão informada abaixo ou superior.

Versão mínima: A funcionalidade estará disponível a partir da versão 37.0.2.78.

Tabelas impactadas:

  • PCCOB (dados de cobrança)
  • PCLOGALTERACAODADOS (controle de alterações)

Validações de segurança: A gravação só será permitida quando não houver pedidos em andamento e nenhuma conta a receber em aberto na cobrança.

04. DEMAIS INFORMAÇÕES


IMPORTANTE!

As versões estarão disponíveis para download no CCW. Mantenha suas rotinas sempre atualizadas!