Superficies de comando y lectura
Usa la API HTTP autenticada para los comandos y consultas del cliente. La API separa los comandos de las lecturas. Cada operación del cliente requiere una acción de autorización y se ejecuta en el tenant de quien llama. Sigue los requisitos de idempotencia de la operación. Los reintentos después de timeouts son normales y deben reutilizar la misma identidad de negocio. Que una operación esté montada no es prueba de que un despliegue específico tenga conectado su adaptador de Dataprev. Una integración de riel no disponible devuelve501 Not Implemented para esa solicitud, en lugar de desaparecer de la API. La operación de capacidades informa qué familias de operaciones alcanza tu despliegue. Registrar el código de instrumento de B3 de un contrato confirmado no llama a Dataprev, así que no depende de ningún interruptor del riel.
El flujo de comandos de Lender permanece disponible para los comandos de integración admitidos. No es un reemplazo de la superficie HTTP completa. Consulta Eventos de Consignado.
Workers programados
El gateway ejecuta su trabajo en segundo plano como bucles programados. Comparten ejecución inicial retrasada, escalonamiento estable por réplica, aislamiento de panics, y cierre ordenado. Todos los bucles, excepto la vía rápida de subastas, también hacen pasadas sin solapamiento con jitter positivo.
La vía rápida de subastas, Limpieza de payload de ofertas y Testigo de propuesta leen su cadencia a través de Systemplane y surten efecto en el siguiente retraso. Los otros bucles toman su cadencia de la configuración de entorno y necesitan un reinicio para cambiar.
Recuperación de averbação y Recuperación de comandos del riel existen porque un comando del riel puede dejar su resultado sin establecer: el proceso murió a mitad de la llamada, o el riel nunca respondió. Convergen ese estado contra el propio registro del riel en lugar de perderlo. Reconducción de ofertas reenvía una oferta cuya respuesta del riel se perdió, con su número de propuesta original. Cada reenvío usa el presupuesto de riel del tenant. Los tres bucles están desactivados por defecto. Habilita los dos bucles de recuperación en cualquier despliegue que envíe averbações o comandos del riel.
Cuando Dataprev rechaza la documentación, la solicitud responde
422 con los códigos de Dataprev en upstream, y el contrato vuelve a attachment_pending. Envía la documentación corregida bajo una clave X-Idempotency nueva, o excluye el contrato. Cuando la llamada termina sin veredicto, como un timeout, un 5xx de Dataprev o un recibo inutilizable, la solicitud responde 503 o 504. El contrato también vuelve a attachment_pending: envía de nuevo la misma documentación, bajo la misma clave o una nueva. La lectura de la averbação muestra en last_documentation_close el intento más reciente que Dataprev no aceptó.
Un anexo de CCB interrumpido a mitad de la llamada permanece en attachment_invoking hasta su attachment_invocation_deadline_at. Después de ese instante, la siguiente documentación o exclusión del contrato toma la llamada. Una vez que el gateway registra la documentación de un contrato, su exclusión responde 409 EXCLUSION_DOCUMENTATION_UNDERWAY hasta que el contrato quede confirmed, incluso mientras muestra attachment_pending. En ese estado, envía la misma documentación de nuevo para completarla.
Una vez al mes, Dataprev cierra por el cambio de competencia y rechaza las solicitudes. Cuatro bucles se pausan para ese tenant cuando uno de ellos encuentra ese rechazo. Son el descubrimiento de subastas, la vía rápida de subastas, el descubrimiento de portabilidad y la reconducción de ofertas. La pausa dura 5 minutos, después 15, después 30 por cada rechazo posterior. La recuperación de averbação, la recuperación de comandos del riel y la conciliación no esperan esa pausa. Cada una de sus pasadas deja de llamar a Dataprev ante el rechazo y vuelve a intentarlo en la siguiente pasada.
Las solicitudes del cliente siguen llegando a Dataprev y reciben su rechazo. El informe de jobs programados muestra paused_until para un bucle pausado. En Lerian Cloud, el gateway publica consignado.rail.paused una vez por cambio de competencia y consignado.rail.resumed cuando Dataprev vuelve a responder.
Ventanas del riel
Los valores por defecto y las restricciones del riel incluyen:- una ventana de validez de subasta de préstamo de 24 horas que Dataprev proporciona y que el gateway no configura
- una ventana retrospectiva de solicitud de portabilidad de 72 horas
- 20 días corridos desde la exclusión de origen para registrar una portabilidad entrante, cuando la solicitud indica la fecha de la exclusión
- 7 días hábiles para revertir un refinanciamiento
- 7 días después de una averbação para enviar su documentación por el anexo de CCB. Encuentra las averbações que siguen esperando con
GET /v1/consignado/averbacao-operations?status=attachment_pending, y leedocumentation_due_atydocumentation_overdueen cada una. Una averbação cuya exclusión pediste también sigue enattachment_pending. Su documentación recibe409 AVERBACAO_EXCLUDED, salvo que Dataprev haya rechazado la exclusión. Antes de enviarla, consultaGET /v1/consignado/contracts/{numero_contrato}/exclusioncon la credencial propia del tenant. Una credencial de fondo o de originador no puede consultarlo. - una ventana de descubrimiento de subastas de 48 horas, con una tolerancia de desfase de reloj de cinco minutos
Throughput y ritmo
El tráfico de Dataprev se controla con un ritmo por tenant. La API de throughput define la tasa del tenant, de 0 a 25 solicitudes por segundo, y ningún ajuste eleva ese tope. Un tenant sin tasa almacenada opera a 3 solicitudes por segundo. Un valor almacenado de0 pausa el tráfico del riel para ese tenant.
Seguridad de la conciliación
Las lecturas de contabilidad y de repasse son independientes. Una fuente que falla no debe suprimir a la otra. Los repasses esperados pueden emitir tres estados:consignado.repasse.overdue: el movimiento esperado está atrasadoconsignado.repasse.resolved: el movimiento llegó después de una alarma de atrasoconsignado.repasse.unobserved: el gateway actualmente no puede probar presencia ni ausencia
fresh.
Credenciales y artefactos
Rota el certificado del tenant, el secreto de OAuth, el código de solicitante, y la URL del portal a través de la API de credenciales. Las variables de archivo de certificado local son un fallback de desarrollo, no un sustituto de la custodia por tenant en despliegues gestionados. Cuando Dataprev rechaza las credenciales de cliente OAuth del tenant, las operaciones que llegan a Dataprev responden409 DATAPREV_CREDENTIAL_REJECTED. La averbação y el anexo de CCB responden ese código antes de reservar nada. La exclusión no: responde con la operación detenida en outcome_unknown. Un comando que responde códigos RAIL_COMMAND_* responde 409 y también queda detenido en outcome_unknown. Una ejecución de garantía de FGTS y una oferta también responden 409 y quedan detenidas en unknown.
Corrige las credenciales, y las lecturas vuelven a funcionar. Envía de nuevo una averbação o un anexo de CCB rechazado con la misma clave. Para reanudar una oferta detenida, envíala de nuevo con la misma clave. Cualquier otra escritura detenida no se ejecuta de nuevo con su clave: contacta a Lerian con el número del contrato. Para un tenant revocado, las operaciones del riel y las cargas parciales de credenciales responden 409 DATAPREV_CREDENTIAL_REVOKED. Una carga completa de un nuevo certificado y de un nuevo cliente de OAuth termina la revocación.
Registrar una URL base de portal del trabajador es opcional, para el tenant y para cada originador. Consulta Descubrir subastas y enviar propuestas para el orden en que el gateway selecciona un portal.
Los artefactos CCB y del riel usan el almacén de objetos configurado. Mantén el bucket privado y entrega el contenido solo a través de la operación de artefactos autenticada.
La averbação no lleva ningún documento, y un cuerpo de 1 MiB o más recibe 413. El anexo de CCB acepta una CCB firmada y, después de una averbação con el bloque de contabilización, un paquete de biometría. El texto en base64 de cada uno tiene hasta 8 MiB. Una importación de contrato que lleva esos documentos sigue los mismos límites. Una corrección de contrato acepta un recurso corregido cuyo texto en base64 tiene hasta 8 MiB.