Partes (Originador / Deudor / Inversor)

Requisitos previos de acceso

• Permiso (módulo): viewCredits (listar/visualizar). Aprobar/rechazar KYC usa el mismo permiso de gestión de crédito del tenant.
• 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 Partes registra y administra los participantes del crédito tokenizado: Originadores, Inversores y Deudores. Cada parte lleva un documento (CPF/CNPJ), dirección, estado de KYC, estado de cuenta BaaS y atributos de riesgo (score, límite de crédito, incumplimientos) que alimentan las Políticas de Crédito.

Use esta pantalla para revisar y aprobar/rechazar partes después del KYC, antes de que puedan originar, invertir o figurar como deudor en una operación.

Requisitos previos

• Permiso: viewCredits registrado para el rol del operador (permiso doble — enum CPM en el backend + módulo dinámico en la BD).
• Licencia/Feature: CREDIT_INVESTMENTS habilitada. Si está deshabilitada, el grupo no aparece en el menú.
• Dependencias de otras pantallas: ninguna; sin embargo, las partes deben existir y estar aprobadas antes de usarse en Negocios/Deals.

Paso a paso

1. Acceda al menú Crédito Tokenizado → Partes.
2. Filtre por Tipo (Originador / Inversor / Deudor / Todos) y Estado.
3. Use la búsqueda para localizar por nombre/documento.
4. Abra la parte (fila o ⋮ → Visualizar) para revisar KYC, dirección y atributos de riesgo.
5. Para partes pendientes, use ⋮ → Aprobar o ⋮ → Rechazar (con confirmación).

Filtros y columnas

Filtro/Columna	Qué muestra	Origen del dato
Nombre	Razón social / nombre de la parte	Party.name
Tipo	ORIGINATOR, INVESTOR o DEBTOR	Party.type (filtro typeFilter)
Documento	CPF/CNPJ	Party.documentNumber + documentType
Estado	PENDING_KYC, KYC_APPROVED, KYC_REJECTED, ACTIVE, SUSPENDED, PENDING_APPROVAL, APPROVED, REJECTED	Party.status (filtro statusFilter)
Estado KYC	Resultado del KYC de la parte	Party.kycStatus
Cuenta BaaS	Situación de la cuenta bancaria asociada	Party.baasAccountStatus
Creado el	Fecha de registro	Party.createdAt

Atributos de riesgo visibles en el detalle (no en la lista, pero usados por las Políticas): riskScore, creditLimit, usedCredit, kycScore, defaultCount, totalDeals, totalVolume, riskRating.

Acciones y modales

• Visualizar: abre los detalles de la parte (credit-parties/view/:id).
• Editar: abre el formulario (credit-parties/edit/:id).
• Crear: registra una nueva parte (credit-parties/create).
• Aprobar: approveParty(id) tras confirmación (bottom-sheet) — habilita la parte para operar.
• Rechazar: rejectParty(id) tras confirmación — bloquea la parte.

Aprobar/rechazar partes puede activar step-up (contraseña + MFA, X-Step-Up-Token, ventana de 5 min) según el entorno — reconfirmación de identidad, no aprobación de 4 ojos.

Reglas de negocio / consideraciones

Atención

• El estado determina el uso. Originador/inversor solo pueden participar en una operación si están aprobados; el desembolso al originador requiere cuenta BaaS activa y estado compatible.
• Los atributos de riesgo alimentan las Políticas. riskScore, defaultCount, creditLimit/usedCredit son leídos por las Políticas de ámbito PARTY en la aprobación de deals/cuentas por cobrar — manténgalos actualizados.
• Deudor (DEBTOR) es quien paga el Cobro; regístrelo correctamente para que el vínculo cuenta por cobrar→cobro funcione.

• Valores financieros: creditLimit, usedCredit y totalVolume representan montos tratados como BigNumber en el backend — no redondee al definir límites.
• Estado APPROVED: las operaciones financieras posteriores requieren que la parte tenga estado aprobado.

Pantallas relacionadas

• Negocios / Deals
• Cuentas por Cobrar
• Políticas de Crédito
• Crédito Tokenizado (índice del grupo)