Cobranças (Pagadoria)

Prepare a intenção de cobrança sem confundir pagador, recebedores e regra de distribuição.

Pré-requisitos

Uma cobrança real só deve avançar quando houver:

• contrato e unidade corretos;
• pagador identificado;
• recebedores habilitados;
• matriz válida e versionada;
• Fechamento aprovado;
• meio de pagamento e vencimento conferidos.

Preparar a cobrança

1. localize o contrato aprovado;
2. carregue a matriz vinculada;
3. escolha o tipo de cobrança;
4. associe o pagador;
5. informe valor e vencimento;
6. escolha o meio de pagamento disponível;
7. confira a distribuição esperada;
8. valide em modo seguro.

Uma cobrança não deve alterar silenciosamente a matriz aprovada.

Pagador

O pagador é a pessoa responsável pela quitação. Ele não entra automaticamente na distribuição.

Antes de emitir:

• confirme identidade e contato;
• confirme vínculo com o contrato;
• confira valor, vencimento e descrição;
• evite duplicidade da mesma obrigação.

Idempotência

Cada intenção de cobrança deve ter uma referência estável. Se a mesma solicitação precisar ser repetida, ela deve recuperar a operação anterior ou informar o estado existente, sem criar uma segunda cobrança.

Quando a intenção comercial for nova, use uma nova referência.

Modo seguro e produção

Credenciais e identificadores de homologação não devem ser reutilizados em produção.

Depois da emissão

1. preserve a referência da cobrança;
2. associe o resultado ao contrato e à matriz;
3. acompanhe mudanças de estado;
4. processe confirmações de forma idempotente;
5. encaminhe diferenças para Conciliação;
6. mantenha a evidência disponível na Governança.

Erros comuns

Relacionado

• Contratos e unidades
• Matriz de rateio
• Fechamento
• Integração financeira
• Webhooks
• Conciliação