Comandos que consume
El gateway consume dos comandos del motor de crédito, transportados como eventos por el backbone de streaming de la plataforma:
- una solicitud de margen, que pide el margen de nómina disponible de un trabajador;
- una solicitud de averbação, que pide registrar un contrato firmado con Dataprev.
Hechos que emite
El gateway emite cinco hechos de negocio:
- el margen obtenido de un trabajador;
- un resultado de averbação confirmada;
- un resultado de averbação rechazada;
- una señal de propuesta aceptada, que indica al sistema de préstamos aguas abajo que origine;
- un registro de conciliación — uno por registro de escrituração o de liquidación.
Entrega agnóstica al destino
El gateway escribe cada hecho en un outbox transaccional y relaya desde allí. No posee enrutamiento por destino: un hub de streaming aguas abajo decide qué sistema recibe cada hecho. El mismo hecho puede distribuirse a un ledger, a un almacén de conciliación o a un sistema de préstamos sin que el gateway sepa ni le importe quién lo consume.
Sin acoplamiento directo con el ledger ni con webhooks
El gateway no hace llamadas directas a Midaz y no aloja consumidores de webhook. El contacto con el prestatario fuera de la plataforma está fuera de alcance: el hecho de propuesta aceptada es el límite de traspaso, tras el cual el sistema de préstamos aguas abajo es dueño de la originación y de cualquier comunicación con el prestatario.
En el transporte
- El dinero y las tasas cruzan como cadenas decimales, nunca como coma flotante, para no perder precisión en el camino.
- Las marcas de tiempo son UTC, RFC 3339.
- Ningún CPF cruza el hecho de conciliación. Esto se garantiza por construcción: los tipos de registro de conciliación no tienen campo de CPF, el CPF presente en la fuente de escrituração se descarta en el normalizador, y las pruebas verifican que el payload serializado no contiene ningún CPF. El número de contrato es la clave de coincidencia, así que no hace falta ningún identificador personal aguas abajo. (Los hechos de margen y de propuesta aceptada sí llevan un CPF, porque cada uno se asocia a un trabajador o a una propuesta específicos.)
- El repasse de la CEF liquida por movimiento diario, no por contrato, así que la conciliación del lado bancario se basa en el identificador de la transferencia y no en el número de contrato.
Semántica de entrega
- Idempotente por sujeto inmutable. Cada registro y cada liquidación lleva un identificador inmutable; reprocesarlo es un no-op aguas abajo.
- Al menos una vez. Los eventos se entregan al menos una vez; la reentrega y los reinicios se deduplican a un no-op.
- Ramas independientes. En la conciliación, las ramas de escrituração y de repasse se procesan de forma independiente — una que falle nunca bloquea la otra.