API HTTP
La API cubre las credenciales del tenant, el margen y los datos del trabajador, las subastas y las ofertas, el registro, los documentos, y el desembolso. También cubre las correcciones de contrato, el ciclo de vida del contrato, la portabilidad en ambas direcciones, el refinanciamiento, la renegociación, y las garantías. Las operaciones restantes cubren la conciliación, los fondos, las cesiones, el uso, el throughput, y las suscripciones de entrega. Empieza con obtener el margen del trabajador, y luego usa la navegación de la Referencia de la API para encontrar las demás familias de operaciones. Cada página de operación proviene del contrato OpenAPIdevelop.
Comandos de Lender consumidos
El gateway lee un único flujo de comandos de aplicación y despacha según el source y la clave de evento de CloudEvent. La selección se hace por clave, nunca por nombre de topic. El gateway pone en cuarentena una clave que no maneja en su propia dead-letter queue, en lugar de omitirla.
Averbação no es un comando de Lender en
develop. Envíala a través de la operación HTTP autenticada.
Hechos de negocio declarados y operacionales
El contrato de runtime contiene 25 definiciones de hechos de negocio, y cada una de ellas tiene un sitio de emisión de producción identificado endevelop. No existe un interruptor por hecho. El conjunto de hechos publicados es una proyección del catálogo de runtime. Un despliegue o bien emite un hecho, o bien no ejecuta el flujo que lo produce.
La configuración decide qué emite un despliegue, nunca el hecho. El descubrimiento de portabilidad entrante está desactivado por defecto. El hecho consignado.portability_proposal.received aparece solo donde ese flujo está habilitado. Hace commit de forma atómica junto con su marcador duradero cuando el poller programado de descubrimiento de portabilidad encuentra una oferta activa. Lo mismo aplica para cualquier comando del riel que un despliegue no ejecute. Los hechos operacionales cubren:
- solicitudes de subasta y propuestas de portabilidad entrante
- margen, empleo, e informes de ausencia
- aceptación de propuesta, registro de contrato (
consignado.contract.registered, incluida la evidencia del artefacto CCB firmado), desembolso, y disponibilidad de corrección - averbação, exclusión, redirección, y resultados de portabilidad del lado de origen
- conciliación, excepciones de repasse, y calendarios
- fondos, cesión, y cambios de throughput
Flujos de aplicación
Con el contrato v3 de lib-streaming:- los hechos van a
lerian.streaming.consignado-gw - el gateway lee los comandos de Lender desde
lerian.streaming.lender.commands - los tipos de hecho usan
studio.lerian.consignado-gw.<resource>.<event> - los tipos de comando usan
studio.lerian.lender.<resource>.<event>
Suscripciones de entrega
Usa la API de suscripciones para registrar un destino HTTPS, inspeccionarlo, rotar su secreto de firma, probar la entrega, o revocarlo. Trata el secreto de firma como de solo escritura. Una prueba exitosa demuestra la entrega al endpoint configurado. No cambia la semántica de al menos una vez de los eventos de negocio.Contrato de confiabilidad
- Los hechos de negocio entran en un outbox transaccional antes de la publicación.
- La entrega es al menos una vez.
- Deduplica por
(ce-source, ce-id). - Los valores monetarios viajan como cadenas decimales, nunca como punto flotante binario.
- Los campos del payload usan
snake_case. Las marcas de tiempo usan UTC RFC 3339. - Un identificador de negocio requerido faltante es terminal y va a la DLQ del consumidor en lugar de a Dataprev.