Elige quién emite la CCB
Una versión de producto declara
terms.creditInstrumentMode cuando la creas. El valor es lender_emitted (el predeterminado) o client_issued. Una versión nunca cambia, así que otro emisor exige una versión nueva.
Lender emite la CCB
1
Publica una plantilla de documento
El producto necesita una plantilla publicada antes de que Lender emita. Crea un borrador con
POST /api/v1/loan-products/{productId}/document-templates y publícalo. Publicar una versión nueva reemplaza la activa. Sin plantilla activa, la emisión responde LENDER-0616.2
Aprueba la solicitud y emite antes de la liberación
Lender solo emite para una solicitud
approved. Una solicitud que ya fue desembolsada responde LENDER-0602, así que emite entre la aprobación y la liberación.3
Emite la CCB
POST /api/v1/loan-applications/{applicationId}/credit-instruments recibe idempotencyKey en el cuerpo, no en un encabezado, y un bloque parties con los nombres y documentos del emisor y del acreedor, los lugares de emisión y de pago y cualquier otro campo que declare la plantilla. La misma clave devuelve la misma CCB, con X-Idempotency-Replayed: true. La misma clave con otro bloque parties se rechaza.4
Lista y descarga
GET .../credit-instruments lista las emisiones, de la más nueva a la más antigua. Una emisión anterior trae supersededByInstrumentId. El bloque issuance dice si la solicitud puede tener una CCB emitida ahora (canEmit) y, cuando no puede, el código con que respondería la emisión (refusalCode). GET .../credit-instruments/{instrumentId}/download devuelve el PDF que guarda Lender.Tu institución emite la CCB
En una versión
client_issued, Lender no emite la CCB. POST .../credit-instruments responde LENDER-0601, y la lista muestra canEmit: false con el mismo refusalCode. Genera el documento y recoge la firma por tu cuenta, y luego registra la CCB firmada. Guarda el digest del documento tal como estaba antes de la firma: el registro se rechaza con LENDER-0608 cuando falta originalDocumentDigest o cuando se envía creditInstrumentId, que indica una CCB emitida por Lender.
Registra la CCB firmada
Registra la CCB firmada cuando las partes hayan firmado, en una solicitud
approved o disbursed, en los dos modos. POST /api/v1/loan-applications/{applicationId}/signed-credit-instrument recibe:
Esta ruta no recibe el encabezado
X-Idempotency. Enviar de nuevo el mismo documento devuelve el registro más nuevo, con X-Idempotency-Replayed: true, e ignora cualquier metadato que difiera en el reenvío: no actualiza el registro.
Reemplaza la CCB firmada
Un documento distinto se rechaza con
LENDER-0604, salvo que sea un reemplazo. Para reemplazar, lee el registro más nuevo y envía el documento nuevo con supersedes igual al id de ese registro y un replacementReason de una línea, de hasta 500 caracteres. Los dos van juntos. El registro reemplazado permanece en el historial, y vale el más nuevo.
Un documento que ya pertenece a un registro anterior no puede volver como reemplazo: Lender responde LENDER-0613. Para volver a ese contenido, envía un archivo nuevo, como una nueva exportación, cuyos bytes sean distintos.
Lee y descarga
GET /api/v1/loan-applications/{applicationId}/signed-credit-instrument devuelve el registro más nuevo. custodian dice quién guarda el PDF: lender o integrator. GET .../signed-credit-instrument/download entrega el PDF que guarda Lender. Para un registro cuyo custodian es integrator, responde LENDER-0614: el PDF queda con el integrador, y el signedDocumentDigest de la lectura verifica sus bytes.
Rechazos
La página de referencia de cada operación lista sus otros rechazos: las páginas de emisión, de registro, de lectura y de descarga, y las de creación y de publicación de la plantilla.
En la consola
La consola muestra la CCB de cada solicitud en Credit instruments: consulta Credit instruments.
Próximos pasos
Origina un préstamo
Lleva una solicitud desde el envío hasta la liberación.