Documentação

Español

Português
English

Español

Português
English

Appearance

Cuentas por Cobrar ​

Requisitos previos de acceso

  • Permiso (módulo): viewCredits (listar/visualizar y operar el ciclo de la cuenta por cobrar).
  • 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 Cuentas por Cobrar gestiona los títulos (facturas, pagarés, contratos) que respaldan las operaciones de crédito. Cada cuenta por cobrar pertenece a un originador, opcionalmente a un librado/deudor, y tiene un tipo de cuenta por cobrar (que define los campos obligatorios). Es el activo base que, una vez aprobado, es cedido/anticipado dentro de un Deal.

Use esta pantalla para revisar cuentas por cobrar, adjuntar/verificar documentos (NFe, contratos), generar cuotas (installments) y mover cada cuenta por cobrar a través de su ciclo: borrador → enviado → aprobado/rechazado.

Requisitos previos ​

  • Permiso: viewCredits (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 de otras pantallas: el originador (y el librado, si lo hay) deben existir en Partes; el tipo de cuenta por cobrar debe estar registrado en Tipos de Cuenta por Cobrar — se carga para resolver la etiqueta en la lista.

Paso a paso ​

  1. Acceda al menú Crédito Tokenizado → Cuentas por Cobrar.
  2. Filtre por Estado y use la búsqueda.
  3. Abra una cuenta por cobrar (fila o ⋮ → Visualizar).
  4. Use ⋮ → Documentos para adjuntar/ver la NFe y demás archivos.
  5. Use ⋮ → Cuotas para generar/visualizar el fraccionamiento (installments) a partir del importe bruto.
  6. Para una cuenta por cobrar en borrador, use ⋮ → Enviar para aprobación; luego Aprobar o Rechazar.

Filtros y columnas ​

Filtro/ColumnaQué muestraOrigen del dato
Referencia externaIdentificador del título en el sistema de origenReceivable.externalReference
Tipo de cuenta por cobrarCategoría (resuelta al nombre mediante mapa)Receivable.receivableTypeId → Tipos de Cuenta por Cobrar
OriginadorCedente del títuloReceivable.originatorId
Importe brutoValor nominalReceivable.grossAmount (BigNumber)
Importe netoValor tras descuentosReceivable.netAmount
VencimientoFecha de vencimiento del títuloReceivable.dueDate
EstadoDRAFT, PENDING_APPROVAL, APPROVED, REJECTED, CANCELLED, DISCOUNTED, SETTLED, DEFAULTReceivable.status (filtro statusFilter)
Creado enFecha de registroReceivable.createdAt

Acciones y modales ​

  • Visualizar / Editar / Crear: rutas credit-receivables/view|edit|create.
  • Documentos: abre el diálogo de documentos (ReceivableDocumentsDialog) para adjuntar/listar archivos (NFe, contrato) vinculados por receivableId.
  • Cuotas (installments): abre el diálogo de cuotas (ReceivableInstallmentsDialog), que distribuye el grossAmount en cuotas; cada cuota se convierte en la base para un futuro Cobro.
  • Enviar para aprobación: submitReceivableForApproval(id) — mueve de DRAFT a PENDING_APPROVAL. En caso de error, se muestra el mensaje del backend (p. ej.: campos obligatorios del tipo faltantes).
  • Aprobar / Rechazar: approveReceivable(id) / rejectReceivable(id) tras confirmación — disparan la evaluación de las Políticas con alcance RECEIVABLE.

Aprobar/rechazar/enviar pueden disparar step-up (contraseña + MFA, X-Step-Up-Token) según el entorno — reconfirmación de identidad, no aprobación de 4 ojos.

Reglas de negocio / consideraciones ​

Atención

  • El tipo define los campos obligatorios. El envío puede fallar si el Tipo de Cuenta por Cobrar exige campos no completados — el mensaje de error proviene del backend.
  • Las políticas de RECEIVABLE se ejecutan en la aprobación. P. ej.: "NFe no validada" puede forzar revisión manual o rechazo (ver ejemplos en Políticas).
  • Las cuotas alimentan los cobros. El fraccionamiento generado aquí es el origen de los Cobros PIX/Boleto enviados al librado.
  • Valores financieros: grossAmount/netAmount y los valores de cuota son BigNumber en el backend — la suma de las cuotas debe coincidir con el importe bruto; no redondee.

Ejemplos ​

Escenario 1 — Cuenta por cobrar NFe enviada y aprobada
  1. Crear cuenta por cobrar con tipo "Duplicata NFe", originador, referencia externa e importe bruto.
  2. ⋮ → Documentos → adjuntar el XML/PDF de la NFe.
  3. ⋮ → Enviar para aprobación → el estado pasa a PENDING_APPROVAL.
  4. ⋮ → Aprobar → las Políticas de RECEIVABLE se ejecutan; si pasan, la cuenta por cobrar pasa a APPROVED y queda elegible para entrar en un Deal.
Escenario 2 — Fraccionar una cuenta por cobrar antes de cobrar
  1. Abra la cuenta por cobrar aprobada.
  2. ⋮ → Cuotas → distribuya el importe bruto en N cuotas con vencimientos.
  3. Cada cuota generada se convierte en la base para un Cobro al librado en la pantalla de Cobros.
Escenario 3 — Cuenta por cobrar bloqueada por política
  1. Enviar cuenta por cobrar sin validación fiscal.
  2. En la aprobación, la Política "NFe no validada" (alcance RECEIVABLE, acción Revisión Manual) impide la autoaprobación y envía el elemento para análisis humano.

Pantallas relacionadas ​