Configuración de credenciales
Un tenant opera solo tras registrar dos credenciales por el plano de control del gateway:
- un certificado de cliente ICP-Brasil A1 (certificado y clave en PEM), validado antes de guardarse;
- un secreto OAuth2 de client-credentials.
Obtención de margen
Cuando el motor de crédito necesita el margen de nómina de un trabajador, emite un comando de solicitud de margen. El gateway consulta a Dataprev el margen disponible del trabajador y su remuneración disponible, y emite un hecho que lleva ese margen, asociado a la solicitud de origen.
Averbação
Para registrar un contrato firmado, el motor de crédito emite un comando de solicitud de averbação. El gateway registra el contrato con Dataprev y emite uno de dos hechos:
- un hecho de averbação confirmada que lleva el código de éxito del propio riel — relayado, nunca fijado en código; o
- un hecho de averbação rechazada que lleva el código de error y el mensaje del riel.
Subasta de préstamos (leilão)
Las solicitudes de préstamo de los trabajadores (solicitações) abren cada una una subasta de 24 horas. Un poller de descubrimiento lista estas solicitudes página por página. Por cada solicitud que aún no ha visto, el gateway dispersa la subasta de forma concurrente a un conjunto configurado de gestores de ofertas externos, recoge sus ofertas y selecciona la oferta de menor CET anual — los empates se resuelven por la cuota más baja, y una oferta cuyo CET no puede parsearse nunca puede ganar. Luego envía la oferta ganadora. Un segundo poller, de detección de ganador, observa las propuestas enviadas. Cuando una propuesta alcanza un estado de aceptación, el gateway emite un hecho de propuesta aceptada para que el sistema de préstamos aguas abajo pueda originar el préstamo.
Conciliación
Con una cadencia configurable, un poller de conciliación barre una ventana deslizante de competências de nómina. Por cada competência lee dos fuentes independientes — los registros de escrituração por contrato y los registros de repasse D+2 de la CEF que liquidan las cuotas pagadas — los normaliza y emite un hecho de conciliación por registro. Las dos ramas son independientes: una falla al leer una nunca bloquea la otra.