Antes de empezar
- Usa una identidad de Lender autorizada para las operaciones de cesión. El servicio deriva el tenant de esa identidad validada. No suministras un tenant en una solicitud.
- Registra el fondo receptor antes de crear un conjunto. El registro guarda los datos del administrador, la tasa de cesión, los límites de elegibilidad, el modo del término, el modo de documento y el layout usado para el archivo de oferta. El registro de un fondo lo guarda, y un
fundTaxIdque el tenant ya tiene se rechaza con409(LENDER-1510).PUT /api/v1/assignment/funds/{fundId}edita un fondo por su ID y reemplaza todos los campos, así que cada llamada indica todos los campos: los límites de concentración (nullno registra ninguno), si una cuenta por cobrar con una mora abierta o con registro suspendido se corta, el límite de cortes repetidos y el modo de elegibilidad (full,prefilteronone). El fondo también puede definir una tolerancia de pago y las ventanas del detector de huérfanos. - Trata cada hecho externo como evidencia. Enviar un archivo, recibir una remessa, firmar un término, pagar, transferir y aceptar son hechos separados con controles separados.
El flujo de la cesión
1
Registra el fondo
Registra el fondo de cesión y edita su registro por ID cuando deba cambiar. Después de que el fondo tiene su primer conjunto,
fundTaxId queda fijo (LENDER-1511). PUT /api/v1/assignment/funds/{fundId}/status mueve un fondo entre activo, suspendido y cerrado: activo y suspendido se alternan, cualquiera de los dos cierra, y cerrado es definitivo (LENDER-1509). Solo un fondo activo arma un conjunto nuevo (LENDER-1508). Los conjuntos ya armados y la lista de candidatos no cambian. Su configuración aporta la tasa de cesión y las reglas de concentración y de cortes repetidos que se usan cuando Lender evalúa un conjunto. Los ajustes de documento del fondo receptor también determinan la ruta de documento posterior.2
Revisa las cuentas por cobrar elegibles
Lee el pool de candidatas con ámbito del fondo. Lender evalúa cada candidata contra la configuración del fondo y el contexto de la cesión, y devuelve un veredicto de elegibilidad en lugar de descartar en silencio las cuentas por cobrar no elegibles. Cuando no puede leer una fuente obligatoria, informa esa condición en lugar de tratar la restricción como satisfecha.
3
Arma y puntúa un conjunto en borrador
Crea un borrador con las cuentas por cobrar que seleccionaste. Lender congela la composición del conjunto y los ajustes del fondo que necesita para ese recorrido. Puntúa el borrador contra la regla del fondo antes de la aprobación. Un conjunto no aprobado se puede volver a puntuar.
4
Aprueba el conjunto
La aprobación vuelve a leer el estado relevante de las cuentas por cobrar antes de registrar la decisión. Una cuenta por cobrar que cambió desde el armado puede salir del conjunto, o Lender puede volver a valorarla. Revisa el resultado de la aprobación, y no supongas que el borrador sobrevive sin cambios.
5
Cancela un conjunto que no puede continuar
POST /api/v1/assignment/sets/{setId}/discard cancela una composición no vendida y libera sus cuentas por cobrar de vuelta al pool cedible. Preserva el conjunto, su evidencia y su registro de auditoría. No deshace una venta. Lender rechaza la llamada cuando el conjunto está aceptado, vendido o pagado en parte, o tiene una transferencia presentada en el registro.6
Intercambia los archivos del fondo
Obtén el archivo de oferta solo después de la aprobación, luego registra que lo enviaste. Cuando el layout del fondo es una plantilla de Reporter,
POST /api/v1/assignment/sets/{setId}/offer-file/generation inicia la generación, y GET /api/v1/assignment/sets/{setId}/offer-file responde 409 hasta que el archivo esté listo. Un fondo con layout integrado descarga el archivo directamente. Generar nunca registra la oferta como enviada. Ingiere la remessa del administrador del fondo contra ese mismo lote. Debe ser un archivo lerian-remessa-v2 que da un veredicto a cada cuenta por cobrar del conjunto. Otro layout responde 409 (LENDER-0520), y un archivo que deja una cuenta por cobrar sin veredicto responde 409 (LENDER-1507). El ingest también puede traer source, el archivo original del fondo, con custodyRef, fundObjectKey y originalDigest. Lender toma el digest tal como se declara y no lo verifica. El detalle del conjunto devuelve la fuente como remessaSource. Lender concilia el archivo con la composición ofertada y registra el resultado.7
Registra los hechos de finalización
Registra el término de endoso y los hechos de pago, transferencia y aceptación observados externamente, a medida que ocurren. Un hecho
paid indica el amountPaid (LENDER-0510). Cuando ese monto, neto de los reembolsos de la mesa, difiere de los precios congelados más allá de la tolerancia del fondo, Lender retiene la aceptación y abre un caso fund_payment_divergence (LENDER-0511). Una vez aceptada una línea, un paid que indica otro monto responde 409 (LENDER-0515), y un lote solo se acepta cuando toda línea está pagada (LENDER-0516). Lender impone la transición de ciclo de vida de cada hecho. Lender solo retira una cuenta por cobrar aceptada de la ruta de tenencia activa cuando el procesamiento de aceptación exigido tiene éxito.Documentos y excepciones
Lender puede producir un dossier de la cuenta por cobrar a partir de los hechos que guarda. La primera materialización congela la instantánea de evidencia que se usa para ese dossier, así que una recuperación posterior representa la misma evidencia registrada. El recorrido también puede generar casos de excepción. Esos casos incluyen un corte repetido, un conflicto o divergencia de remessa, una cuenta por cobrar que no se puede valorar, una baja contable que no se puede contabilizar y un elemento de integración atascado. Resuelve esos casos mediante el flujo de excepciones de la cesión, que ofrece las acciones accept-payment, delivered-outside, remove-line y resend además de resolve. No sustituyas un hecho de ciclo de vida por la resolución que falta. Para un contrato consignado cedido,
GET /api/v1/internal/br/consignado/retained-installments lista las cuotas retenidas cuyo efectivo de nómina o de agente llegó a la mesa por debajo de lo que deben. POST /api/v1/internal/br/consignado/retained-installments/{id}/close aplica el efectivo de la mesa a la cuota y contabiliza el resto como pérdida de crédito del cliente. Lender rechaza el cierre con LENDER-1600 a LENDER-1604 y no escribe nada.
Para un contrato consignado cedido con transferencia de riesgo (art. 28), la nómina que sigue llegando se asienta al llegar como caja y como monto por pagar al fondo. GET /api/v1/internal/br/consignado/fund-payable lee lo que sigue abierto, que es lo máximo que puede indicar el próximo repasse. POST /api/v1/internal/br/consignado/fund-payable/repasses marca el repasse que pagaste al fondo. Exige X-Idempotency, asienta un registro por cada llegada que paga, de la más antigua a la más nueva, con la fecha del repasse, y rechaza un monto superior al pasivo abierto (LENDER-1609). El plan del producto necesita el par de paso para esto: consulta Mapea tu plan de cuentas. Sin el par, Lender rechaza la aceptación de la venta.
Una versión con terms.admitsAssignment: true pone en el pool del fondo los contratos de crédito directo que valora, una vez registrada su CCB firmada. Cuando un prestatario paga una cuota comprada entre la aprobación y la aceptación de una venta así, el efectivo se debe al fondo. GET /api/v1/internal/br/consignado/direct-fund-payables lista un monto por pagar por cada cuota pagada. Después de que tu mesa paga al fondo fuera de Lender, POST /api/v1/internal/br/consignado/direct-fund-payables/{id}/settle marca el monto por pagar como liquidado y registra el repasse una vez. Exige X-Idempotency. Lender responde LENDER-1614 para un monto por pagar desconocido y LENDER-1615 para uno ya liquidado.
GET /api/v1/internal/br/consignado/retained-installments?state=deskClosed lista las cuotas que la mesa ya cerró, con los montos que el cierre registró, closedAt y, una vez declarado, collectionEndedAt. POST /api/v1/internal/br/consignado/retained-installments/{id}/collection-end declara, una vez, que terminó el cobro del resto que el cierre dio de baja (Res. CMN 4.966 art. 49 par. 1). Exige X-Idempotency. Lender responde LENDER-1612 para una cuota nunca cerrada desde la mesa y LENDER-1613 para una segunda declaración con otra clave. El control del cierre sale de la contabilidad el día en que una tarea diaria encuentra la declaración y 5 años completos desde el cierre.
Salvaguardas operativas
- Un conjunto no es una cesión completada. Borrador, elegibilidad, aprobación, entrega de la oferta, remessa, término, pago, transferencia y aceptación son pasos distintos del ciclo de vida.
- Los cambios del fondo no reescriben un conjunto que ya está en curso. Lender congela la configuración relevante del fondo en el armado del conjunto.
- La aprobación es defensiva a propósito. Valida el estado actual de las cuentas por cobrar antes de que un fondo reciba una oferta.
- La aceptación es sensible a la vía del dinero. Si Lender no puede completar su procesamiento obligatorio, rechaza la aceptación en lugar de marcar la cuenta por cobrar como vendida.
Próximos pasos
API REST de Lender
Empieza por la API del servicio y la referencia de operaciones generada.
Contabilidad y corridas de devengo
Mira cómo Lender mantiene el trabajo contable durable separado de las solicitudes en línea.