Cobros de Crédito

Requisitos previos de acceso

• Permiso (módulo): viewCredits (listar/visualizar). Cancelar un cobro requiere creditConfigManage.
• Licencia/Feature: CREDIT_INVESTMENTS habilitada en la licencia del tenant (Vault).
• Contenedor del menú: TOKENIZACIÓN → grupo Crédito Tokenizado

Qué es / cuándo usar

La pantalla de Cobros hace seguimiento de los instrumentos de pago (PIX, Boleto o PIX+Boleto) emitidos contra el librado/deudor para liquidar las cuotas de una cuenta por cobrar. Cada cobro tiene un código de referencia, monto, fecha de vencimiento y estado de pago, y puede incluir el EMV del PIX y la línea/URL del boleto.

Use esta pantalla para monitorear lo que fue pagado, parcialmente pagado, vencido o expirado, ver los detalles de cada cobro y cancelar cobros que ya no deben ser pagados (siempre que aún no estén pagados).

Requisitos previos

• Permiso: viewCredits para ver; creditConfigManage para cancelar (permiso doble — enum CPM + módulo dinámico en la BD).
• Licencia/Feature: CREDIT_INVESTMENTS habilitada. Sin ella el grupo ni siquiera aparece en el menú.
• Dependencias con otras pantallas: el cobro nace de una cuota de una Cuenta por Cobrar; el librado debe estar registrado en Partes.

Paso a paso

1. Acceda al menú Crédito Tokenizado → Cobros.
2. Filtre por Estado (Todos / Creado / Enviado / Pagado / Expirado / Cancelado).
3. Use ⋮ → Visualizar para abrir los detalles (EMV PIX, línea del boleto, historial).
4. Para cancelar, use ⋮ → Cancelar (solo si el cobro no está pagado/parcialmente pagado/cancelado).

Filtros y columnas

Filtro/Columna	Qué muestra	Origen del dato
Código de referencia	Identificador del cobro	Charge.referenceCode
Originador	Cedente asociado	Charge.originatorId
Monto	Importe a cobrar	Charge.amount (BigNumber)
Vencimiento	Fecha límite de pago	Charge.dueDate
Estado	CREATED, SENT, PAID, PARTIALLY_PAID, OVERDUE, EXPIRED, CANCELLED	Charge.status (filtro statusFilter)
Creado el	Fecha de emisión	Charge.createdAt

Campos visibles en el detalle: tipo (PIX/BOLETO/PIX_BOLETO), paidAmount/paidAt, pixEmv, boletoLine/boletoUrl, y los campos de confirmación manual (paymentMethod, paymentReference, manualConfirmation, confirmedBy, confirmationNotes).

Acciones y modales

• Visualizar detalles: abre el diálogo de detalles (ChargeDetailsDialog) con los datos de pago y la cuenta por cobrar enriquecida vinculada.
• Cancelar: cancelCharge(id) tras confirmación (bottom-sheet). Solo se muestra cuando el estado no es PAID, PARTIALLY_PAID ni CANCELLED, y requiere creditConfigManage.

Cancelar un cobro puede disparar step-up (contraseña + MFA, X-Step-Up-Token) según el entorno.

Reglas de negocio / advertencias

Atención

• No se cancela un cobro pagado. El botón Cancelar queda oculto para PAID/PARTIALLY_PAID; los ajustes de pagos ya recibidos no se gestionan en esta pantalla.
• Existe confirmación manual. Cuando el pago llega fuera del flujo automático PIX/Boleto, los campos de confirmación manual (confirmedBy, confirmationNotes) registran quién y por qué — útil en la conciliación.
• Las disputas se abren desde el cobro. Cada cobro puede tener Disputas vinculadas por chargeId.

• Valores financieros: amount y paidAmount son BigNumber en el backend; los pagos parciales se acumulan hasta el total — no redondee al verificar el saldo deudor.

Pantallas relacionadas

• Cuentas por Cobrar
• Partes (librado)
• Disputas
• Crédito Tokenizado (índice del grupo)