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:
| Campo | Valor |
|---|---|
| CODROTINA | 522 |
| TABELA | PCCOB |
| COLUNA | COBANTECIPADA |
| TIPOVALOR | A |
| VALORALFA | Novo valor (S ou N) |
| VALORALFAANT | Valor anterior |
| OBSERVACOES | Antigo: (valor anterior), Novo: (novo valor) |
| DEMAIS CAMPOS | Incluindo data, usuário, máquina, etc |
Validações antes de gravar alteração:
Se houver pedidos não faturados ou cancelados (
PCPEDC.POSICAOin 'L', 'M', 'B', 'P'), o sistema bloqueará a gravação.Se houver contas a receber em aberto (
PCPRESTcomDTPAG 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.QUITAPCPRESTValor 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.CODBCOCOBANTECIPADATipo: 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.CODMOEDACOBANTECIPADATipo: 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
As versões estarão disponíveis para download no CCW. Mantenha suas rotinas sempre atualizadas!IMPORTANTE!

