Cobranças de Crédito

Pré-requisitos de acesso

• Permissão (módulo): viewCredits (listar/visualizar). Cancelar cobrança exige creditConfigManage.
• Licença/Feature: CREDIT_INVESTMENTS habilitada na licença do tenant (Vault).
• Contêiner do menu: TOKENIZAÇÃO → grupo Crédito Tokenizado

O que é / quando usar

A tela de Cobranças acompanha os instrumentos de pagamento (PIX, Boleto ou PIX+Boleto) emitidos contra o sacado/devedor para liquidar as parcelas de um recebível. Cada cobrança tem um código de referência, valor, vencimento e status de pagamento, e pode carregar o EMV do PIX e a linha digitável/URL do boleto.

Use esta tela para monitorar o que foi pago, parcialmente pago, vencido ou expirado, ver os detalhes de cada cobrança e cancelar cobranças que não devem mais ser pagas (desde que ainda não pagas).

Pré-condições

• Permissão: viewCredits para ver; creditConfigManage para cancelar (permissão dupla — enum CPM + módulo dinâmico no DB).
• Licença/Feature: CREDIT_INVESTMENTS habilitada. Sem ela o grupo nem aparece no menu.
• Dependências de outras telas: a cobrança nasce de uma parcela de Recebível; o sacado deve estar cadastrado em Partes.

Passo a passo

1. Acesse o menu Crédito Tokenizado → Cobranças.
2. Filtre por Status (Todos / Criada / Enviada / Paga / Expirada / Cancelada).
3. Use ⋮ → Visualizar para abrir os detalhes (EMV PIX, linha do boleto, histórico).
4. Para cancelar, use ⋮ → Cancelar (somente se não estiver paga/parcialmente paga/cancelada).

Filtros e colunas

Filtro/Coluna	O que mostra	Origem do dado
Código de referência	Identificador da cobrança	Charge.referenceCode
Originador	Cedente associado	Charge.originatorId
Valor	Montante a cobrar	Charge.amount (BigNumber)
Vencimento	Data limite de pagamento	Charge.dueDate
Status	CREATED, SENT, PAID, PARTIALLY_PAID, OVERDUE, EXPIRED, CANCELLED	Charge.status (filtro statusFilter)
Criado em	Data de emissão	Charge.createdAt

Campos visíveis no detalhe: tipo (PIX/BOLETO/PIX_BOLETO), paidAmount/paidAt, pixEmv, boletoLine/boletoUrl, e os campos de confirmação manual (paymentMethod, paymentReference, manualConfirmation, confirmedBy, confirmationNotes).

Ações e modais

• Visualizar detalhes: abre o diálogo de detalhes (ChargeDetailsDialog) com os dados de pagamento e o recebível enriquecido vinculado.
• Cancelar: cancelCharge(id) após confirmação (bottom-sheet). Só é exibida quando o status não é PAID, PARTIALLY_PAID nem CANCELLED, e exige creditConfigManage.

Cancelar cobrança pode disparar step-up (senha + MFA, X-Step-Up-Token) conforme o ambiente.

Regras de negócio / cuidados

Atenção

• Não se cancela cobrança paga. O botão Cancelar fica oculto para PAID/PARTIALLY_PAID; ajustes de pagamento já recebido não passam por esta tela.
• Confirmação manual existe. Quando o pagamento chega por fora do PIX/Boleto automático, os campos de confirmação manual (confirmedBy, confirmationNotes) registram quem e por quê — útil em conciliação.
• Disputas se abrem a partir da cobrança. Cada cobrança pode ter Disputas vinculadas pelo chargeId.

• Valores financeiros: amount e paidAmount são BigNumber no backend; pagamentos parciais somam até o total — não arredonde ao conferir saldo devedor.

Telas relacionadas

• Recebíveis
• Partes (sacado)
• Disputas
• Crédito Tokenizado (índice do grupo)