Saltar al contenido principal

Lerian ConsoleStreaming HubLenderConsignadoTracerFlowkerTED

Lerian Console v3.4.0: cambios, pausa y reanudación de suscripciones de Streaming Hub, pantallas de Lender y búsqueda en Flowker

Lerian Console v3.4.0 cambia el nombre, el destino y los tipos de evento de una suscripción de Streaming Hub, y la pausa y la reanuda. Esto requiere Streaming Hub 3.4.0. Para Lender 4.2.0, el módulo Lender añade un simulador de préstamo, garantías, registro en la registradora, números de contrato, reglas de pago, nuevos cronogramas y periodicidades, la tasa mensual fija, una retención del desembolso hasta que se firme la CCB, la cura de la PDD a la Etapa 1 y una cuenta por pagar al fondo que marcas con Mark repasse. En Consignado, un contrato que un refinanciamiento generó recibe los comandos del riel, y con Lerian Consignado 4.5.0 la reversión de un refinanciamiento viene prellenada con el contrato que generó. Una validación que una reserva del ledger escribió abre su transacción de Midaz con Open transaction. En Flowker, buscas una ejecución por su ID y filtras las configuraciones de proveedor por Provider. Los diálogos para eliminar y desactivar un proveedor nombran los workflows afectados, y una activación rechazada enlaza al workflow que es dueño de la ruta de webhook. Al activar TED JD, la Console ahora ejecuta una verificación de salud del plugin.
Consignado

Lerian Consignado 4.5.0: estado del contrato, documentos retenidos y control de suscripciones

Las páginas y la referencia de API de Consignado pasaron a Lerian Consignado 4.5.0. Cinco operaciones de API son nuevas. El estado de un contrato indica si sigue vivo, cómo llegó (averbacao, refinanciamento, renegociacao o importacao) y por qué salió. La lista de documentos retenidos muestra lo que guarda un contrato, signed_ccb y biometrics_documents_pack. Con Streaming Hub 3.4.0, tu back office también puede pausar, reanudar y editar una suscripción del tenant. La lista de comandos del riel acepta numero_contrato, y una fila de refinanciamiento o renegociación nombra los contratos que reemplazó. El gateway publica consignado.rescisao.revertida cuando una lectura de contrato en Dataprev constata que se canceló una terminación de vínculo laboral. Puede leer su licencia de un archivo firmado montado, definido en LICENSE_FILE_PATH.El bloque de contabilización ahora comprueba la tasa anual efectiva de monthly_rate contra el rango de tasa de la versión del producto de Lender, y el rango incluye sus límites. Antes, comprobaba monthly_rate por 12. Revisa las solicitudes cuya tasa queda cerca del borde del rango de un producto.
Streaming Hub

Streaming Hub v3.4.0 edición, pausa y reanudación de suscripciones

Streaming Hub v3.4.0 edita una suscripción en el lugar con PATCH /v1/subscriptions/:id: cambias el nombre, el destino, los tipos de evento y las versiones de schema. La suscripción conserva su id y su secreto de firma o la credencial de la cola. Envía el ETag de la suscripción como If-Match, y el hub rechaza una edición desactualizada con 412 subscription_changed. También pausas y reanudas una suscripción por la API y en la Consola. Una pausa cancela las entregas de la cola, y una suscripción push no recibe ningún evento que llega al hub durante la pausa, tampoco después de la reanudación. Una suscripción pull en pausa omite los eventos que aún no leyó. La lista de suscripciones muestra el estado Paused, y el Dashboard cuenta las suscripciones en pausa. En BYOC, un webhook o un broker RabbitMQ en una dirección privada funciona cuando la operación de Lerian autoriza el host, y el puerto AMQP en RabbitMQ. El hub multi-tenant rechaza un broker RabbitMQ privado. SQS y EventBridge nunca reciben una autorización.Para reintentar una edición después de un 412, lee la suscripción otra vez y envía la edición con una nueva clave X-Idempotency. Después de reanudar una suscripción pull, lee con ?after= los eventos que omitió, dentro de la retención.
Lender

Lender v4.2.0 garantías, registro en cualquier registradora y nuevos cronogramas

Lender v4.2.0 agrega 13 operaciones de API. Tú registras garantías, personales o reales, y las vinculas a contratos. Tú registras el código que cualquier registradora asignó a un contrato de crédito directo, no solo B3. Tú marcas el repase que un conjunto de contratos de consignado vendido con el riesgo transferido debe a su fondo. Tú comparas el efectivo retenido de un contrato con lo que mantiene el ledger. Una versión de tasa fija lleva la tasa como tasa mensual en fixedMonthlyRate, y la banda de tasa de toda versión está en puntos básicos anuales efectivos. Una solicitud puede pedir el sistema sac o american, pagos quincenales o semanales, y reglas de pago como un período de gracia o una cuota final mayor. También puede llevar tu propio número de contrato en clientContractNumber. Una versión puede retener la primera liberación de un contrato de crédito directo hasta que registres la CCB firmada.Lee las nuevas operaciones en la página de la API de Lender y define las opciones de cronograma en una versión cuando tus productos las necesiten.
SISBAJUD

Plugin SISBAJUD v1.3.0 conexión con Midaz y puerto de salud

Plugin SISBAJUD usa una sola conexión con Midaz para toda la instalación, definida por variables de entorno: MIDAZ_BASE_URL, opcionalmente MIDAZ_AUTH_ADDRESS con el par de cliente del ledger, y MIDAZ_CRM_BASE_URL para el CRM standalone, con el par de cliente del CRM cuando MIDAZ_AUTH_ADDRESS está definido. El plugin no guarda credencial de Midaz por institución, y la configuración de una institución muestra connectionSource env. Un cambio en una institución vale en la siguiente orden, sin reiniciar. Después de que una institución recibe su primera orden, su ledger no cambia: el plugin responde 422 SBJ-0066. Preparación, liveness y métricas responden en HEALTH_PORT, y el puerto principal conserva /health y /version.En el canal directo, un bloqueo original que cancelas antes de que corra nunca corre, muestra cancelledBy, y la cancelación responde al tribunal. Una cancelación sin nada que liberar responde CANCELLATION_FULFILLED. Una revisión que aumenta el monto de una orden se rechaza con 409 SBJ-0065.
SISBAJUD

Lerian SISBAJUD Mensageria v1.2.0 campos de decisión LGPD y origen de Cabine

La llamada LGPD resolve recibe decision, decisionReason, recordsAffected y deliveryRef, y la Mensageria rechaza con 422 una llamada que aún envía recordsEliminated, recordsRetained o tokensGenerated. Una configuración mal formada de AUTH_*, TRUSTED_PROXIES, MULTI_TENANT_ENABLED o IDP_DECLARATION_ENABLED detiene el arranque, y el log nombra la variable.Define CORS_ALLOWED_ORIGINS con el origen donde los operadores abren Lerian Cabine.
TED

Los eventos de TED Lerian traen un ce-id estable

Los eventos de TED Lerian traen un ce-id UUIDv7 derivado de la transición. Una reentrega de la misma transición repite el ce-id. La API no cambió.Deduplica por el par (ce-source, ce-id). Lee el ce-id del evento y nunca lo reconstruyas.
TED

TED Lerian publica sus permisos en el Access Manager

Al iniciar, TED Lerian puede publicar sus permisos en tu Access Manager, y el Access Manager recibe todos los permisos de TED Lerian sin carga manual. Viene desactivado. Si el servicio Identity no responde, TED Lerian inicia de todos modos y reintenta, y la verificación declaration en el cuerpo de GET /readyz muestra el resultado.Para activarlo, define IDP_DECLARATION_ENABLED como true, con IDP_HOST y el IDP_M2M_CLIENT_ID y el IDP_M2M_CLIENT_SECRET de una aplicación con el origen plugin-br-ted-lerian.
Lerian ConsoleStreaming HubPaymentsLender

Lerian Console v3.3.0: subscriptions de Streaming Hub, pago de cuentas y pantallas de Lender

Lerian Console v3.3.0 crea subscriptions de Streaming Hub en un asistente de tres pasos, para destinos webhook, pull, Amazon SQS, RabbitMQ y Amazon EventBridge. El catálogo de eventos tiene un botón Subscribe que abre el asistente con el evento elegido, y el Console define la credencial de un destino de cola. Una subscription muestra un solo estado: Delivering, Failing, Awaiting verification o Stopped by the Hub. En Payments, consultas la cuenta en su origen y después revisas y confirmas el pago. El Console avisa de un posible pago duplicado y muestra un pago no confirmado como In confirmation. Un boleto acepta un nosso número opcional, y sus estados son Registered, Not sent y Awaiting registration. En Lender, la pantalla Parked postings libera un asiento contable que quedó detenido antes de Midaz. Si confirmas que Midaz no tiene un asiento que sí tiene, Lender lo registra dos veces. También puedes archivar productos de crédito y cerrar cuotas cortas retenidas. El Console obtiene la licencia del servicio de licencias en cada inicio y la mantiene solo en memoria.Paga las cuentas con la línea digitable. El Console rechaza un código de barras de 44 dígitos. Revisa la lista Bill Payments antes de enviar un pago de nuevo.
Tracer

La entrada de uso de límite de Tracer muestra el alcance usado

Cada entrada de limitUsageDetails en la respuesta de POST /v1/validations, y en el registro de validación de una reserva del ledger, ahora muestra en scope el único objeto de alcance cuyo contador usó la transacción: el primer objeto del límite que coincide. Antes, listaba todos los objetos de alcance del límite, unidos por OR. Los registros que Tracer escribió antes conservan la lista completa.Si lees scope para encontrar el contador que usó una transacción, léelo como un único objeto de alcance, y espera la lista completa solo en registros anteriores.
Access Manager

Caradhras: archivo de licencia y preparación

Caradhras, el backend de identidad de Access Manager, puede leer su licencia de un archivo de licencia firmado que Lerian emite, definido en LICENSE_FILE_PATH. Cuando está definido, Caradhras ignora LICENSE_KEY y no llama al servicio de licencias. Con LICENSE_KEY, cada inicio busca la licencia firmada en license.lerian.io. Mientras el servicio de licencias no responde, Caradhras no está listo. Una licencia ausente o rechazada sigue deteniendo el inicio. El paso de migración de la base de datos necesita la misma licencia.Con LICENSE_KEY, mantén abierto el HTTPS de salida a https://license.lerian.io para Caradhras y para su paso de migración. Define LICENSE_KEY o LICENSE_FILE_PATH también en el paso de migración.
SPBSILOC

Lerian Cabine muestra a los operadores de STR y SILOC solo lo que pueden usar

En los workspaces STR y SILOC, Lerian Cabine ahora oculta los elementos de menú, las pantallas y las acciones que los permisos de Access Manager del operador no conceden, como ya hace en SPI. Un enlace guardado a una pantalla cerrada muestra que el operador no tiene acceso. Por ejemplo, las acciones de los casos de conciliación del STR y el control Executar de los escenarios de homologación de SILOC aparecen solo para el rol admin. La página de acceso lista los grupos que conceden cada rol en Lerian SPB y Lerian SILOC. Las páginas de SPB y de SILOC listan el permiso de cada control.Revisa que los grupos de Access Manager de tus operadores concedan los permisos de Lerian SPB y Lerian SILOC que usan.
Access Manager

Access Manager v3.20.0: archivo de licencia y preparación

Auth e Identity pueden leer su licencia de un archivo de licencia firmado que Lerian emite, definido en LICENSE_FILE_PATH. Cuando está definido, ignoran LICENSE_KEY y no llaman al servicio de licencias. Con LICENSE_KEY, guardan la licencia firmada solo en memoria, así que cada inicio la vuelve a buscar en license.lerian.io. Si el servicio de licencias no responde al iniciar, Auth e Identity siguen arriba, no listos, y reintentan en lugar de salir. /readyz responde 503 hasta que se acepta una licencia, y el puerto principal solo se abre después. Una licencia ausente o rechazada sigue deteniendo el inicio.Con LICENSE_KEY, mantén abierto el HTTPS de salida a https://license.lerian.io en todas las cargas de trabajo de Auth e Identity, y apunta las sondas de preparación a HEALTH_PORT.
TED

Licencia de TED Lerian en memoria

Con LICENSE_KEY, TED Lerian guarda la licencia firmada solo en memoria, no en PostgreSQL. Cada inicio vuelve a buscar la licencia en license.lerian.io. Si el servicio de licencias no responde, TED Lerian queda no listo y sigue reintentando hasta que responda.Con LICENSE_KEY, mantén abierto el HTTPS de salida hacia https://license.lerian.io en toda carga de trabajo de TED Lerian, incluidos los reinicios.
Lender

Lender v4.1.0: productos archivados, mesas y plan de cuentas

Lender archiva y restaura productos de préstamo: un producto archivado no origina nada nuevo, y los contratos ya escritos quedan como están. Una cotización de pago parcial puede acortar el plazo o reducir las cuotas, y el consignado mantiene la cuota. Una renegociación al 0% se acepta como concesión de reestructuración. Nuevas mesas del operador liberan un asiento que se detuvo antes de Midaz y cierran una cuota retenida con saldo corto de un contrato de consignado cedido. Una baja cierra un contrato de consignado que el rail de nómina excluyó. Revertir un pago después de que la mesa de reembolso pagó al prestatario reabre el contrato y abre una cuenta por cobrar de pago devuelto. La mesa de reembolso cubre contratos renegociados. Los planes de cuentas registran la pérdida incurrida y la provisión adicional en provisiones separadas. Las sondas y las métricas pasan al puerto de salud, y la licencia puede venir de un archivo firmado montado.Si configuraste un plan de cuentas antes de la v4.1.0, agrega el par de reglas de asiento de la pérdida incurrida antes de que se registren las provisiones de contratos en incumplimiento. El inicio rápido muestra las reglas. El job de migración de la base de datos necesita licencia. Define LICENSE_KEY o LICENSE_FILE_PATH, o la migración no inicia.
Pix

Pix BTG v1.15.0: archivo de licencia y resultado no registrado

Todo componente de Pix BTG puede cargar un archivo de licencia firmado mediante LICENSE_FILE_PATH, como alternativa a LICENSE_KEY. Consulta las variables de entorno. Si el servicio de licencias no responde al iniciar, los componentes esperan, sin quedar listos, y siguen intentando en lugar de terminar. Una nueva respuesta de idempotencia, 422 PIX-3005, indica que la primera solicitud con la clave se ejecutó, pero su resultado no se registró.Ante PIX-3005, concilia la operación original. No la reenvíes y no uses una clave nueva.
Access Manager

Access Manager rechaza un permiso de socio que ninguna solicitud puede usar

Cuando creas o cambias un socio, Access Manager rechaza un permiso que ninguna solicitud de ese socio puede usar dentro de su alcance. Esto aplica a productos que publican qué elementos de alcance llevan sus rutas, como Lender desde la v4.1.0. La respuesta es 400 IDE-1052, y su mensaje nombra el producto, el recurso y la acción.Quita ese permiso del socio o cambia su alcance.
Payments

Payments BTG v1.3.0: historial de la clave Pix

Payments guarda el historial de cada cambio de la clave Pix en la que cobran los boletos híbridos. GET /v1/admin/pix-config/history lo lista, con las claves de CPF, correo y teléfono enmascaradas. Suscribe una configuración de webhook al nuevo evento PIX_KEY_CHANGED para enterarte de cada cambio. Payments también puede leer la licencia de un archivo de licencia que Lerian emite, definido en LICENSE_FILE_PATH.Agrega PIX_KEY_CHANGED a enabledEvents si quieres seguir los cambios de clave.
Streaming Hub

Streaming Hub v3.3.0: estado de las entregas en las suscripciones

Una lectura de suscripción, la lista o una suscripción individual, devuelve last_success_at y last_failure_at. Puedes notar que un destino falla sin llamar a la lectura de salud. Para socios de Consignado, la suscripción de un originador recibe el resultado de sus propias cotizaciones de preasubasta (consignado.cotacao.resolved), y la suscripción de un fondo recibe el bloqueo de FGTS fallido de un contrato cedido a él (consignado.garantia.block_failed).Usa last_failure_at para monitorear tus destinos.
Lerian Console

Clave de licencia de Lerian Console v3.2.0

Lerian Console v3.2.0 no inicia sin una clave de licencia de Lerian en LICENSE_KEY, y su verificación de readiness responde 503 hasta que el servicio de licencias acepte la clave. Las páginas de la Console también describen los planes de cuenta en las pantallas de Fees Engine, la configuración de Tracer de un ledger, el campo Scheme de una nueva transacción, el inicio de sesión con passkey y las áreas Settings y Authorization.Antes de actualizar, define LICENSE_KEY en tu despliegue de la Console y permite HTTPS de salida desde la Console hacia license.lerian.io. Concede el permiso de lectura de usuarios a cada administrador que abra Authorization.
Consignado

Puerto de salud y suscripciones de socios de Lerian Consignado 4.4.0

Las páginas y la referencia de API de Consignado pasaron a Lerian Consignado 4.4.0. Un fondo o un originador gestiona sus propias suscripciones a eventos con su credencial de socio. Nuevos hechos anuncian la ventana de ejecución de la garantía del FGTS, un bloqueo de FGTS que falló y la desactivación o reactivación de un originador o de un fondo. Tu back office puede cerrar una exclusión por portabilidad del lado del origen que quedó estacionada. GET /v1/consignado/fundo/creditos se eliminó.Antes de actualizar, define HEALTH_PORT y apunta la sonda de readiness y la recolección de métricas a ese puerto: el puerto principal ya no sirve /readyz ni /metrics. Cambia un fondo que lee sus créditos en la ruta eliminada a GET /v1/consignado/fundos/{fundo_id}/contracts, con la credencial de socio del fondo. Las suscripciones de socios necesitan Streaming Hub 3.2.0 con STREAMING_HUB_PARTNERS_URL definido. En un despliegue single-tenant, define también SUBSCRIPTIONS_HUB_CLIENT_ID y SUBSCRIPTIONS_HUB_CLIENT_SECRET.
Pix

Devoluciones MED en Pix BTG v1.14.1

Un cash-out con X-Purpose: INSTANT_PAYMENT_REFUND a una cuenta en otra institución necesita contestedMedRootTransactionId en el cuerpo: el rootTransactionId de la recuperación de fondos impugnada en el MED. Tras quitar los espacios de los extremos, el valor tiene exactamente 32 letras, dígitos o guiones bajos. Un valor ausente responde 400 PIX-0481, y un valor mal formado responde 400 PIX-0482. Un cash-out dentro de tu institución ignora el campo.Agrega contestedMedRootTransactionId a cada cash-out INSTANT_PAYMENT_REFUND a otra institución. Para devolver un Pix recibido, usa las operaciones de devolución.
TED

Puerto de salud e ISPBs sin vínculo en TED Lerian

TED Lerian sirve /readyz y /metrics solo en el puerto de HEALTH_PORT. El puerto principal mantiene /health y /version. Una TED de cliente que llega por un ISPB sin vínculo no se acredita, y en una instalación single-tenant TED Lerian la devuelve a la institución remitente con el motivo 2. Una transferencia interna a una cuenta cerrada responde 422 TED-1021, y un crédito de operador a una cuenta cerrada responde 422 TED-0002. Una TED recibida muestra ledgerCreditId y ledgerRevertId cuando existen.Antes de actualizar, define HEALTH_PORT y apunta la sonda de readiness y la recolección de métricas a ese puerto. Vincula cada ISPB por el que tu institución recibe TEDs.
Tracer

Verificación de límite, licencia y puerto de salud de Tracer

Las páginas y la referencia de API de Tracer siguen el build más reciente de Midaz. POST /v1/validations ejecuta tus reglas y luego verifica un ALLOW contra tus límites de gasto, con el uso actual y la capacidad que ocupan las reservas retenidas. No mueve ningún contador: solo una transacción que el ledger de Midaz reserva con Tracer en el modo advisory o enforce consume un límite. Un requestId que reutilices con otro cuerpo, o en la otra ruta de validación, responde 409 con el código 0084. GET /v1/validations/{validation_id}/reservations lista las retenciones de una transacción del ledger. Las reglas pueden leer transactionAmount, y una reserva con varias cuentas de origen registra el resultado de cada origen.Antes de actualizar, define LICENSE_KEY o LICENSE_FILE_PATH: Tracer no inicia sin una licencia. Define HEALTH_PORT y apunta la sonda de readiness y la recolección de métricas a ese puerto: el puerto principal ya no sirve /readyz ni /metrics. Revisa las reglas y los límites cuyo alcance tiene un subtipo en blanco. La actualización elimina esas alternativas de alcance: una regla activa que queda sin alcance pasa a inactiva, y un límite que queda sin alcance no cuenta nada.
FlowkerLerian Console

Rutas de webhook y ejecuciones de Flowker v1.6.0

La ruta de un disparador de webhook puede terminar en un segmento {name}, como orders/{orderId}. El workflow lee el valor en _webhook.params. Un workflow es dueño de su ruta de webhook hasta que lo eliminas, así que desactivar un workflow no libera la ruta para una nueva versión. Una ejecución síncrona fallida responde 502 en todas las vistas de respuesta, y una vista passthrough ya no retransmite el error del proveedor. La lista de workflows muestra la última ejecución de cada workflow, una ejecución registra quién la inició y el paso en que se detuvo una ejecución fallida, y los resultados de una ejecución en espera se pueden leer. Se eliminó el pin por tenant de la versión de la especificación de un servicio del catálogo, junto con PUT /v1/catalog/openapi-version-pins/{service} y GET /v1/catalog/openapi-versions/{service}. En la Lerian Console, el panel de Flowker abre con lo que necesita atención, y una página Settings define la retención de las ejecuciones.Da a cada nueva versión de un workflow de webhook su propia ruta, o elimina antes el workflow anterior. Actualiza los llamadores que tratan una ejecución síncrona fallida como 200 o que leen el error del proveedor por una vista passthrough, y elimina las llamadas a las dos rutas de catálogo eliminadas.
Streaming Hub

Tenant en las entregas y pérdida por retención en Streaming Hub v3.2.0

Un Streaming Hub single-tenant atribuye cada evento a su tenant configurado y no envía identidad de tenant en las entregas: sin el header X-Lerian-Tenant-Id y sin el atributo ce-tenantid. Una lectura pull devuelve retention_loss: null, o el rango de eventos que la retención eliminó antes de que tu suscripción los leyera. Streaming Hub verifica por sí solo un webhook pendiente: la primera sonda llega cerca de un minuto después de que creas la suscripción, y el intervalo se duplica hasta una hora. Una sonda fallida ya no cambia el estado de la suscripción, y la actualización devuelve cada suscripción degraded a active, que vuelve a recibir eventos. Cuando tu webhook responde 429, Streaming Hub retiene la suscripción durante el Retry-After de tu webhook, 30 segundos cuando no envías ninguno, y como máximo una hora.Si tus consumidores leen el tenant en las entregas, usa el tenant de STREAMING_HUB_TENANT_ID. Maneja retention_loss en los consumidores pull.
ConsignadoLerian Console

Presubasta entre originadores en Lerian Consignado

Lerian Consignado 4.4.0 puede hacer una presubasta antes de la oferta. Varios originadores, y tu propia cuenta, cotizan la misma solicitud de préstamo, cada uno por un fondo. El gateway elige una cotización por la regla que configuras: ventana, criterio, fondo preferido, cierre y rotación. Reserva la capacidad de ese fondo y envía la cotización elegida a Dataprev. Defines una política y límites para cada fondo, y los fondos por los que cada originador puede cotizar. Una averbação que cita una cotización tiene que indicar el fondo de esa cotización. El hecho consignado.solicitacao.received lleva el plazo de cotización, y cada cotización termina con un hecho consignado.cotacao.resolved. En Lerian Console, las pantallas Pre-auction, Pre-auction funds y Pre-auctions, el modo de cotización del formulario Auction y el botón Funds de cada originador gestionan la presubasta.La presubasta viene desactivada. Para usarla, define CONSIGNADO_PRELEILAO_ENABLED como true, con DATAPREV_ENABLED, LEILAO_ENABLED, LEILAO_CLIENT_BID_ENABLED y CONSIGNADO_BID_RECONDUCTION_ENABLED también como true. Da a tus roles los permisos de presubasta, de mandato de fondos y de rechazo, y después guarda una configuración de presubasta.
Pix

Pix programado en Pix Lerian v1.3.0

Pix Lerian envía por sí solo un Pix programado en su fecha, con hasta tres intentos en horario de America/Sao_Paulo: de 00:00 a 07:59, de 18:00 a 19:59 y de 20:00 a 20:59. Cada componente sirve sus sondas de salud y de readiness en HEALTH_PORT. El VSync del DICT verifica cada alcance al menos cada 12 horas, y con el intervalo de escaneo predeterminado VSYNC_GATE_TTL_SEC no puede bajar de 45540. Decode QR Code responde 422 PIX-0228 para un cobro que ya no se puede pagar, y una conexión perdida con la base de datos responde 503 PIX-0062: lee el recurso antes de reintentar.
SPI

Clave HSM y códigos de resolución de QR en Lerian SPI

Las páginas y la referencia de API de Lerian SPI pasaron al build más reciente de Lerian SPI. Con BACEN_TLS_KEY_KIND=kmip, la clave privada del certificado mTLS del BACEN queda en tu HSM KMIP. Cada rechazo de la resolución del QR dinámico tiene su propio código, de SPI-0020 a SPI-0025. El evento dict_claim.received del lado donante lleva al reclamante y la cuenta a la que se movería la clave.Si ramificas en SPI-0003 para la resolución del QR, ramifica en los nuevos códigos.
TED

Reembolsos de TED OUT devuelta en TED JD v3.5.1

Una devolución que llega antes de que termine una TED OUT queda estacionada: la TED aparece en la lista de conciliación pendiente con TED_OUT_DEVOLUTION_PARKED, y el plugin envía transfer_outgoing.devolution_notified. Cuando la TED termina, un operador de tu institución reembolsa al pagador con la acción REFUND de Resolve Transfer Reconciliation. Close TED IN Reconciliation Gaps cierra las brechas abiertas de una ventana de tiempo después de que una persona revisa el extracto de JD. Las devoluciones automáticas de TEDs recibidas salen dentro de la ventana de operación de las devoluciones.Revisa el proceso de tus operadores para TEDs devueltas y tus consumidores de eventos.
SPBSILOCSPI

Finalidad del resgate en Lerian SPB y permisos de Lerian Cabine

Un resgate de la Conta PI a la cuenta de reservas recibe finalidadeLPI 1, para el movimiento propio de la institución o una transferencia a una cuenta en un liquidante en el STR, o 2, para la devolución de un aporte recibido por error. Con 2, la solicitud también lleva originalControlNumber, el número de control del STR de ese aporte. Cualquier otro valor responde 422, incluso 01 rellenado con cero. La lectura del cronograma del STR muestra si la ventana adicional está abierta. Lerian SILOC genera una alerta PARTICIPANT_EXCLUDED cuando un PAG0101 excluye a un participante y lee CORS_ALLOWED_ORIGINS para clientes de navegador, como Lerian Cabine. En el workspace SPI, Lerian Cabine oculta las acciones restringidas que los permisos de Access Manager del operador no conceden.Envía finalidadeLPI como 1 o 2 en cada resgate a la cuenta de reservas. Revisa que los grupos de Access Manager de tus operadores concedan los permisos de SPI que usan.
STA

Envíos retenidos y credenciales rechazadas en Lerian STA v1.3.0

Lerian STA mantiene en espera un archivo de salida durante una caída del STA del BACEN, una falla de conexión o una contraseña rechazada, como máximo hasta el plazo de envío de 48 horas del BACEN. La espera no gasta ninguno de los intentos del archivo, y Retry adelanta un envío retenido. Cuando el BACEN rechaza la contraseña de una credencial, Lerian STA marca la credencial como rechazada. Un operador ingresa la contraseña actual con PUT /v1/credentials/{id}/current-password o en Lerian Cabine, y los archivos retenidos salen de inmediato.
BC Correios

Eventos de Lerian BC Correios v1.1.0

Lerian BC Correios publica nueve eventos en Kafka en lerian.streaming.br-correios: para correspondencia recibida, leída, archivada y restaurada, la primera sincronización, un envío confirmado o fallido y el análisis de IA. Necesita un broker Kafka, y cada instalación atiende a una institución. La configuración lleva una versión: envía la versión que leíste como expectedVersion en cada cambio de configuración. Un guardado que otro guardado adelantó responde 409 BCC-0013.
SISBAJUD

Executor de Lerian SISBAJUD v1.2.0

El executor deja de publicar un resultado judicial después de EXECUTOR_RESULT_MAX_ATTEMPTS intentos fallidos, 12 por defecto: estaciona el resultado, registra una decisión humana y dispara una alarma. Las versiones posteriores de la misma orden esperan detrás de un resultado estacionado. Cuando Midaz no está disponible en el corte de una orden, el executor entrega la orden a una decisión humana y no envía resultado. Una orden de bloqueo con monto mínimo pasa a una decisión humana cuando el executor puede bloquear menos que ese mínimo. En una instalación single-tenant, una institución puede pasar al canal directo y enviar sus órdenes directamente al executor. El executor ya no lee ORGANIZATION_IDS.Incluye los resultados estacionados y las órdenes entregadas en el corte en tu revisión de las decisiones humanas.
Tracer

Origen de la validación y almacenamiento de la licencia en Tracer

El registro de validación de Tracer de una transacción que el ledger de Midaz reserva ahora lleva el organizationId y el ledgerId de esa transacción. Recuperar una validación y cada resultado de Listar validaciones devuelven los dos campos. Los registros de POST /v1/validations y de las solicitudes solo de reglas no llevan ninguno de los dos, y tampoco los registros escritos antes de la actualización.Usa organizationId, ledgerId y transactionId para vincular un registro con su transacción en el ledger. Con LICENSE_KEY, Tracer mantiene la licencia firmada solo en memoria y no guarda ninguna licencia en PostgreSQL. Cada reinicio obtiene la licencia del servidor de licencias de nuevo y, mientras ese servidor no responde, el Tracer reiniciado queda no listo.
Flowker

Proveedor Pix JD de Flowker v1.5.0

Flowker v1.5.0 incluye el proveedor nativo pix-jd para nodos de workflow. Lee la guía de integración para configurar el proveedor.
Access Manager

Readiness de Access Manager v3.17.0

Access Manager ofrece la readiness en un puerto de salud separado. Antes de actualizar, define HEALTH_PORT para Auth e Identity y apunta sus sondas de readiness a ese puerto.
Lender

Originación en Lender v4.0.0

Durante la originación, Lender busca o registra a cada prestatario como titular en el CRM de Midaz. Antes de actualizar, cumple los requisitos previos de Lender.
Lender

Lender en Lerian Console

El módulo Lender en Lerian Console ofrece pantallas para operaciones de crédito. Un administrador puede activarlo en Configuración, Productos. El módulo requiere Lender v4.0.0.
Midaz

Idempotencia en Midaz Go SDK v6.5.0

Midaz Go SDK ya no genera una clave de idempotencia aleatoria por defecto. Sin una clave propia, Midaz trata la creación de una transacción idéntica dentro de la ventana de idempotencia como una repetición. Define una clave distinta para cada transacción que quieras registrar.
Pix

Devoluciones en Pix BTG v1.14.0

Una solicitud de devolución en Pix BTG necesita X-Idempotency o X-Return-End-To-End. Agrega al menos uno de estos headers a las solicitudes de devolución antes de actualizar.
Pix

Readiness de Pix JD v1.6.1

Pix JD ofrece readiness y métricas en HEALTH_PORT. Antes de actualizar, apunta la sonda de readiness y la recopilación de métricas a ese puerto y define una clave global de producción en LICENSE_KEY.
Reporter

Readiness de Reporter v4.8.0

Reporter ofrece readiness en HEALTH_PORT. Antes de actualizar, define HEALTH_PORT y apunta las sondas de readiness a ese puerto.
Payments

Boletos híbridos en Payments BTG v1.2.0

Un boleto híbrido también se puede pagar por Pix. Antes de emitir uno, configura la clave Pix y la dirección del receptor.
Pix

Límite diario de Pix Automático

Lerian configura un límite diario para pagadores personas físicas con CPF a pedido por Lerian Clients. Si no se configura un límite, no se aplica ningún límite diario.
Consignado

Licencia y contabilización de portabilidad en Lerian Consignado 4.2.0

Las páginas y la referencia de la API de Consignado pasaron a Lerian Consignado 4.2.0. El gateway exige una licencia de Lerian en todos los modos de despliegue y no arranca sin ella. numero_ccb acepta como máximo 20 caracteres. La operación de registro de cesión del banco fue eliminada, y el gateway registra la cesión a partir del hecho de cesión de Lender.Una averbação por portabilidad aceptada ahora espera su documentación. Documéntala con el anexo de la CCB, como una averbação. Con el bloque de contabilización, que lista cada contrato de origen cancelado en origins[], Lender registra el contrato cuando Dataprev confirma la documentación y su registro de situación muestra exactamente esos contratos de origen. Esta contabilización requiere Lender 4.0.0 o posterior; actualiza Lender antes del gateway 4.2.0. La exclusión de la institución de origen debe ejecutarse antes, porque Dataprev rechaza una averbação anterior con la regla PT.Tu back office lee los registros de repasse retenidos en el bloque held de las expectativas de repasse y libera cada uno con POST /v1/consignado/reconciliation/held-repasses/{id}/release.El gateway publica cinco tipos de evento nuevos. consignado.refinanciamento.efetivado, consignado.refinanciamento.revertido y consignado.refinanciamento.recusado informan los resultados de un refinanciamiento. Con DATAPREV_MIGRACAO_ENABLED activado, consignado.migracao.efetivada informa un contrato que Dataprev movió a un nuevo vínculo laboral. consignado.certificate.expiring se publica antes de que venza el certificado de Dataprev.El descubrimiento de subastas y de portabilidad corre para todo tenant con custodia de Dataprev completa, y LEILAO_TENANT_ID fue eliminada. La renegociación automática fue eliminada: toda renegociación viene de tu solicitud de renegociación.Antes de actualizar, define LICENSE_KEY en toda carga de trabajo y permite HTTPS de salida a https://license.lerian.io. Actualiza Access Manager a la versión 3.14.0 o posterior antes de que un originador llame a una ruta sin id de originador. Después de que un tenant migre, no vuelvas el gateway a la 4.0.0. Activa DATAPREV_AVERBACAO_ENABLED y define AVERBACAO_ARTIFACTS_BUCKET si envías averbações por portabilidad, o la ruta responde 501.Un comando de riel cuyo resultado Dataprev deja desconocido responde 503 OUTCOME_UNKNOWN. No lo envíes de nuevo: la misma clave responde 409 RAIL_COMMAND_OUTCOME_UNRESOLVED. Lee los comandos de riel y cierra un refinanciamiento, una renegociación o una alteración de términos estacionados según lo que muestra el portal de Dataprev. Cuando un 503 DATAPREV_UNAVAILABLE diga que el comando se cerró rechazado, envíalo de nuevo con una nueva clave X-Idempotency. Una suscripción que lista tipos de evento no recibe ninguno de los cinco nuevos. Para recibirlos, crea una suscripción para todo el tenant que liste sus claves, tomadas de GET /v1/catalog, como consignado_migracao.efetivada. Si la contabilización responde 422 LOAN_PRODUCT_VERSION_UNKNOWN para una versión de producto en Lender creada antes del vínculo del gateway con tu tenant, crea una nueva versión. Si la versión se acaba de crear, espera a que llegue y vuelve a intentarlo. Un rol personalizado de Access Manager necesita rail-command-close:execute para cerrar un refinanciamiento, una renegociación o una alteración de términos estacionados y held-repasses-release:execute para liberar un repasse retenido.
Tracer

Límites de gasto de Tracer consumidos solo a través del ledger de Midaz

Solo una transacción que el ledger de Midaz reserva con Tracer en el modo advisory o enforce consume un límite de gasto. Tracer registra cada decisión de reserva como una validación con el transactionId de la transacción del ledger. GET /v1/validations y GET /v1/validations/{validation_id} devuelven ese campo, y GET /v1/validations filtra por transaction_id. Tracer ya no lee API_KEY_ENABLED_ONLY_VALIDATION.Antes de actualizar, crea en Midaz, con Tracer en el modo advisory o enforce, cada transacción cuyo gasto cuentas: POST /v1/validations no consume un límite. Si un cliente llama a POST /v1/validations o POST /v1/validations/rules-only solo con la API key mientras la autenticación por plugin está activa, dale una credencial de Access Manager. Elimina API_KEY_ENABLED_ONLY_VALIDATION de tu configuración de Tracer.Corrección del 7 de noviembre de 2026: una versión anterior de esta entrada decía que POST /v1/validations se eliminó. La ruta está disponible, y verifica tus reglas y límites sin consumirlos. Consulta la entrada de Tracer del 7 de noviembre.
SPB

Licencia y respuestas divididas del BACEN en Lerian SPB

Las páginas y la referencia de API de Lerian SPB pasaron a la build más nueva de Lerian SPB. Lerian SPB necesita una licencia en todo entorno, desarrollo incluido, y no inicia sin ella. La licencia es global: el riel no lee ningún identificador de organización. Una licencia rechazada responde 403 con un código LCS- en toda ruta bajo /v1/str, y /readyz reporta un check license. Cuando una respuesta del BACEN dividida en partes todavía no tiene una parte 30 minutos después de la primera, el riel abre un caso de conciliación PARTITIONED_MESSAGE_INCOMPLETE.Antes de actualizar, define LICENSE_KEY en toda carga de trabajo de Lerian SPB. Incluye los casos PARTITIONED_MESSAGE_INCOMPLETE en tu rutina de conciliación.
SPI

Licencia y reenvío de un Pix que no salió en Lerian SPI

Las páginas y la referencia de API de Lerian SPI pasaron a la build más nueva de Lerian SPI. Todo binario de Lerian SPI necesita una licencia para iniciar, en todo entorno, y se detiene cuando se rechaza la licencia. Un pago Pix que terminó FAILED con 503 y SPI-1001 o SPI-1004 se puede enviar de nuevo. Envía la primera solicitud de nuevo con la misma clave X-Idempotency, o envía la misma solicitud con una clave nueva y el endToEndId del pago que falló. El riel lo envía como un nuevo intento del mismo pago y publica spi_payment.initiated de nuevo. Una solicitud de aprobación acepta solo el tipo de asunto MANUAL_RESOLUTION.Antes de actualizar, define LICENSE_KEY en todo binario de Lerian SPI. Si un consumidor actúa sobre spi_payment.failed, deja que acepte un spi_payment.initiated posterior para el mismo pago.
SILOC

Licencia y conciliación del ciclo en Lerian SILOC

Las páginas y la referencia de API de Lerian SILOC pasaron a la build más nueva de Lerian SILOC. Lerian SILOC necesita una licencia en todo entorno y no inicia sin ella. Una solicitud que la licencia rechaza responde 403 con un código LCS-. GET /api/v1/siloc/cycles y GET /api/v1/siloc/cycles/{cycleId} traen la reconciliation del ciclo, y la lectura separada de la conciliación del ciclo ya no existe. GET /api/v1/siloc/ot-multilateral-results/{noticeId} devuelve el resultado multilateral que una conciliación indica en resultNoticeId. Una solicitud SLC0004 termina REFUSED cuando su respuesta SLC0004R1 trae una situación distinta de éxito. Un LTR0002 o LTR0008 en DISPATCHED cuyo ciclo LBTR terminó sin R1 queda retenido a la espera de respuesta, y dos operadores pueden cerrarlo.Antes de actualizar, define LICENSE_KEY en Lerian SILOC. Lee la conciliación de un ciclo en las lecturas del ciclo. Maneja REFUSED en tus solicitudes SLC0004.
SCR

Licencia de Lerian SCR

Las páginas y la referencia de API de Lerian SCR pasaron a la build más nueva de Lerian SCR. Lerian SCR se niega a iniciar sin una licencia Lerian, en todo entorno, y ninguna configuración desactiva esa verificación. Un check license en down hace que /readyz responda 503.Antes de actualizar, define LICENSE_KEY en Lerian SCR.
TED

Licencia de la instalación en TED Lerian

Las páginas y la referencia de API de TED Lerian pasaron a la build más nueva de TED Lerian. TED Lerian verifica una licencia para toda la instalación al iniciar y la verifica de nuevo en segundo plano. El servicio no inicia con LICENSE_KEY vacía, en ningún entorno, y se detiene cuando se rechaza la licencia. Ya no lee LICENSE_ENABLED, LICENSE_APPLICATION_ID ni ORGANIZATION_IDS.Define LICENSE_KEY en toda carga de trabajo de TED Lerian y permite HTTPS de salida hacia https://license.lerian.io. Quita LICENSE_ENABLED, LICENSE_APPLICATION_ID y ORGANIZATION_IDS.
Pix

Liquidación intra-PSP y operaciones detenidas en Pix BTG v1.13.0

Las páginas y la referencia de API de Pix BTG pasaron a la v1.13.0. Un Pix intra-PSP y su devolución se liquidan cada uno en una transacción de Midaz, sin pierna @external. El plugin verifica primero al receptor, así que un receptor denegado no genera débito. Un Pix a la propia cuenta del pagador se rechaza con PIX-0460. Cuando el resultado del débito en Midaz de un cash-out es desconocido, la llamada de procesamiento responde 201 con el cash-out en CREATED, y el plugin no envía el Pix. El desbloqueo rechaza un cash-out o una devolución inter-PSP en CREATED con 422 PIX-0470. Cada notificación de webhook al cliente trae una Idempotency-Key, y una notificación reenviada trae la misma clave.Si concilias o generas reportes a partir del ledger, lee un Pix intra-PSP como una transacción entre las dos cuentas. Para un cash-out o una devolución inter-PSP en CREATED, abre una solicitud de soporte con Lerian e indica el id de la transferencia o de la devolución. Deduplica los webhooks al cliente por Idempotency-Key.
Access Manager

Access Manager v3.15.0: inscribe un método MFA exigido durante el inicio de sesión

En Access Manager v3.15.0, cuando la organización exige un método MFA que un usuario no ha inscrito, el inicio de sesión responde AUT-0019 con un token MFA válido solo para la inscripción. El usuario configura y confirma el método con Iniciar inscripción en MFA y Confirmar inscripción en MFA y, después, completa el desafío MFA.Trata AUT-0019 en Solicitar token de acceso y en Verificar inicio de sesión MFA.
SPB

Activación de certificado y cierre por dos operadores en Lerian SPB

Las páginas y la referencia de API de Lerian SPB pasaron a la build más nueva de Lerian SPB. El riel lee el código del certificador de una activación del emisor del certificado, así que la solicitud de activación ya no lleva certifierCode, y un cuerpo que lo envía responde 422. Un certificado que rotaste antes de esta versión no tiene código del certificador registrado, y su activación responde SPB-0003. Cada día del estado de una declaración de compulsorios lleva mode, I o A. Dos operadores pueden cerrar como fallido cualquier mensaje que superó su plazo de liquidación, y no solo una transferencia, y pueden declarar un tramo LDL o LTR a partir de una respuesta del STR que el riel retuvo sin leer. El riel ahora cierra un tramo LDL o LTR que nunca envió cuando cierra su grilla del STR o termina el día.Antes de activar un certificado que rotaste antes de esta versión, rótalo de nuevo. Quita certifierCode de tus solicitudes de activación. Envía mode en cada día de una declaración de compulsorios.
SPI

Respuestas de Pix Automático y bloqueos de consulta DICT en Lerian SPI

Las solicitudes pain.014, camt.029 y camt.055 de Pix Automático de Lerian SPI aceptan solo la decisión. El rail lee los participantes y los identificadores del mensaje que registró, y cualquier otro campo recibe 422. El bloqueo de consulta DICT recibe y devuelve payerId, el CPF o CNPJ del usuario final, en lugar de payerIdHash. Al actualizar, se elimina todo bloqueo de consulta DICT.Envía solo los campos de la decisión en estas tres solicitudes. Después de actualizar, registra de nuevo cada bloqueo de consulta DICT con payerId.
SILOC

Solicitudes retenidas y ciclo LBTR en Lerian SILOC

Las páginas y la referencia de API de Lerian SILOC pasaron a la build más nueva de Lerian SILOC. Dos operadores distintos ahora pueden cerrar una solicitud saliente retenida a la espera de una respuesta que Núclea nunca envió. GET /api/v1/siloc/outbound/messages acepta held=true para enumerar esas solicitudes. Por eso una solicitud FAILED puede ser una que Núclea quizá recibió, y su evento studio.lerian.br-siloc.siloc_outbound.failed lleva el motivo. Un LTR0002 o LTR0008 para una operación cuya respuesta anterior está activa responde 409 y SILOC-0026. Un 503 y SILOC-0002 ahora significa que el comando no se ejecutó.No trates una solicitud FAILED como prueba de que nunca llegó a Núclea. Enumera las solicitudes retenidas. Pide a dos operadores que cierren una solo después de confirmar con Núclea que no responderá. Maneja SILOC-0026 en tu integración. Envía de nuevo, con la misma clave X-Idempotency, una solicitud rechazada con SILOC-0002.
TED

Errores de devolución y cierre del día en TED Lerian

Las páginas y la referencia de API de TED Lerian pasaron a la build más nueva de TED Lerian. En las dos acciones de devolución de una TED recibida, TED-1011 es un HTTP 422. Una devolución cuya respuesta del riel es desconocida (TED-1010) sigue solicitada hasta que la conciliación o la revisión manual la cierra. Cuando el ledger rechaza una reversión (TED-1001), el crédito se mantiene y la transferencia recibida pasa a revisión manual. En el cierre del día, una TED pendiente que el riel no conoce pasa a AWAITING_RECONCILIATION. Los eventos de devolución de una TED recibida traen previousStatus.Trata TED-1011 como 422 en las acciones de devolución. Después de un TED-1010 en una devolución, lee el estado de la TED antes de actuar de nuevo. Acepta AWAITING_RECONCILIATION para una TED pendiente.
Lerian ConsoleMidazReporter

Rutas de operación opcionales y redondeo de comisiones en Console v3.0.0

Las páginas de la Console pasaron a Console v3.0.0. Una ruta contable puede marcar una ruta de operación como opcional, y una transacción puede dejar una ruta opcional sin uso. La Console verifica la ruta en Go to Review y otra vez cuando envías. Un paquete de comisiones puede redondear todas las comisiones que cobra, con Midaz 4.4.0 o posterior. La mayoría de las pantallas muestra fechas y horas en la hora de Brasilia, sea cual sea la zona horaria del navegador. Las pantallas de Reporter agrupan los documentos regulatorios en Regulatory Filings: Catalog, My Regulatory Documents y Filings.Revisa tus rutas contables y marca como opcional cada ruta de operación que algunas transacciones dejan sin uso.
Reporter

Clave de licencia, calendario de informes y períodos de presentación en Reporter v4.6.0

Las páginas y la referencia de la API de Reporter pasaron a Reporter v4.6.0. Reporter no inicia sin una clave de licencia de Lerian en LICENSE_KEY. Cuando REPORT_TIMEZONE no está definida, los días de los informes y los períodos de presentación siguen America/Sao_Paulo. Cada presentación regulatoria registra su período y su tipo de remesa, original o sustitución. Un mapeo puede hacer join y calcular en cualquier lectura, leer listas y campos anidados de MongoDB y leer un conjunto de varias fuentes de datos. Puedes previsualizar una consulta de un mapeo y leer las filas de una presentación. Los filtros de informe aceptan startsWith, notStartsWith, isNull y notNull. Un filtro nin en PostgreSQL también devuelve las filas sin valor. El rol de reporter-contributor-group ahora es operator, con el mismo acceso.Antes de actualizar, define LICENSE_KEY para cada proceso de Reporter. Si tus libros cierran en UTC, define REPORT_TIMEZONE=UTC. Revisa los informes que filtran con nin en PostgreSQL. Reescribe cada mapeo guardado que usa sign, statedIn o accumulate, porque Reporter v4.6.0 no lo carga.
Tracer

Tracer en Midaz 4.4.0 verifica los valores de configuración al iniciar

En Midaz 4.4.0, Tracer no inicia cuando una variable de entorno tiene un valor que no puede leer, y el error indica el nombre de la variable. Por ejemplo, API_KEY_ENABLED=1 y AUTH_CACHE_TTL=60 impiden el inicio. Tracer también verifica los valores de STREAMING_* cuando el streaming está desactivado.Antes de actualizar, escribe cada variable booleana como true o false, y cada AUTH_TIMEOUT y AUTH_CACHE_TTL con unidad, como 60s. Variables de entorno enumera las verificaciones.
Midaz

Actualización a Midaz 4.4.0: valores de configuración y alias duplicados

En Midaz 4.4.0, el Ledger no arranca cuando una variable de entorno tiene un valor que no puede leer, y el error nombra la variable. Un booleano acepta solo true o false, un número debe ser entero y una duración necesita una unidad, como 12s. La migración de onboarding se detiene si un ledger tiene dos cuentas con el mismo alias o dos activos con el mismo código. Las cuentas y los activos eliminados no cuentan. La migración lista los duplicados, y Midaz no los fusiona ni los elimina.Antes de actualizar, revisa tus valores de entorno. Si la migración se detiene, contacta a Lerian antes de ejecutar de nuevo la actualización.
Midaz

Planes de tarifas y cobros de comisiones en Midaz 4.4.0

Las páginas de Fees y la referencia de la API del Ledger pasaron a Midaz 4.4.0. Un plan de tarifas es un conjunto de comisiones que asignas a una cuenta, con una cuota gratuita para cada comisión y mes calendario. En las transacciones /v2 que envía una cuenta con un plan activo, el plan cobra a esa cuenta en lugar de los paquetes de comisiones. Cobras las comisiones de servicio de un plan con un cobro de comisiones, y la lectura de uso devuelve las unidades de una cuenta en un mes. Un paquete de comisiones puede redondear cada comisión que cobra con rounding. Obtener los totales de saldos por clave y activo devuelve los totales disponibles y retenidos de los saldos de una clave y un activo en un ledger.Para usar los planes de tarifas, da los permisos account-plans y fee-charges de Midaz a las aplicaciones que los llaman. Usar planes de tarifas muestra cada paso.
PixTED

Relay entre cores, reclamación de cuentas y tránsito Pix en JD Courier v1.2.0

Las páginas y la referencia de la API de JD Courier pasaron a v1.2.0. El Courier reenvía un crédito o una devolución de TED, o un cash-in o una devolución de Pix, entre dos motores de tu institución. Relay entre cores da el contrato que sigue cada motor, incluido el otro core. Un motor puede reclamar sus cuentas, los CNPJ de sus cobradores de Pix Automático y el lado del cobrador de sus recurrencias. Con el tránsito Pix, los motores también envían sus llamadas Pix a JD a través del Courier. Un motor puede tener varias aplicaciones de Access Manager, una para cada producto que llama al Courier.JD llama a la dirección Pix del Courier como un socio de Access Manager de tu instalación. Configura el socio como describe Access Manager. Los operadores ya no declaran un bypass en el SPB. Variables de entorno de JD Courier lista las variables del Courier.
SISBAJUD

Custodia de claves en AWS KMS, registros de orden y roles del executor en Lerian SISBAJUD v1.1.0

Las páginas y la referencia de la API de Lerian SISBAJUD pasaron a la Mensageria v1.1.0 y al executor v1.1.0. Con AWS KMS, KMS_AWS_KEY_MODE define la custodia de las claves de cada componente. En el modo managed, el componente crea sus claves para cada institución. En el modo provided, tú creas las claves, y el componente registra cada rotación que hace el custodio de tus claves. AWS KMS en la Mensageria enumera los requisitos de la clave y los permisos de AWS.La Mensageria registra el aviso de una transferencia judicial por recibir (registro 08). Un archivo de respuesta de bloqueo lo responde con el código 01. La Mensageria estaciona las solicitudes de aclaración (registro 09) y las interrupciones de un bloqueo permanente (registro 10). Responde manualmente a una solicitud de aclaración estacionada. Después de una interrupción estacionada, nuevos créditos pueden seguir bloqueados hasta que detengas el bloqueo manualmente.El executor declara los roles viewer, operator, investigator, cross-org-reader, admin y platform-admin. Roles enumera los permisos de cada rol. Una rotación de clave puede devolver los nuevos códigos SBJ-0012, SBJ-0013 y SBJ-0014. La lista de errores los describe.
TED

TED entre cores y etiquetas de comisión en Bank Transfer v3.4.0

Las páginas y la referencia de la API de TED JD pasaron a Bank Transfer v3.4.0. Cuando tu institución opera dos cores en un ISPB, una TED entre tus dos cores pasa por el relay de JD Courier como una TED entre cores, con los tipos de transferencia CROSS_CORE y CROSS_CORE_IN. El plugin confirma la retención cuando el otro core acredita al destinatario, y la libera cuando el otro core rechaza el crédito en el primer intento. Una TED entre cores necesita la política de tenant onus.shared_ispb_gate_enabled, las variables de JD Courier y los vínculos CROSS_CORE_OUT, CROSS_CORE_IN y CROSS_CORE_RETURN_IN en el enrutamiento del ledger.En el modo de comisión native, una iniciación puede llevar una etiqueta de comisión en feeContext, y un paquete de comisiones en el ledger del pagador selecciona por ella. Una etiqueta que ningún paquete selecciona se rechaza con 422 BTF-0008. Los catálogos de eventos sumaron Eventos de TED JD, con el payload de cada evento.
SPB

Cierre de la grilla y caídas del gestor de colas en Lerian SPB

Lerian SPB reenvía un mensaje que no salió, sin límite de intentos. Tras el cierre de su grilla del STR en su día de movimiento, el riel cierra ese mensaje como FAILED sin enviarlo. Una transferencia o un movimiento informa entonces settlement.failed. El riel no cierra un mensaje LDL o LTR de esta forma. El riel marca como SENT una transferencia que un envío pudo haber entregado. Esa transferencia espera la respuesta de BACEN o que los operadores la cierren como fallida. DISPATCH_MAX_AUTO_ATTEMPTS ya no existe.Mientras la conexión al gestor de colas está caída, el riel sigue atendiendo lecturas. Rechaza cada solicitud que enviaría un nuevo mensaje STR con 503 y SPB-1001, y no almacena nada para esa solicitud. Maneja SPB-1001 en tu integración: envía la solicitud de nuevo con la misma clave X-Idempotency cuando la conexión vuelva.
SPI

Solicitudes como participante directo y archivo regulatorio en Lerian SPI

Lerian SPI envía la prueba de conectividad, la solicitud de reporte de la Conta PI, el reporte de liquidación de MED 2.0 y el registro de los responsáveis como tu participante directo. Hace lo mismo con las solicitudes de mandato y de programación de Pix Automático, sus respuestas de aceptación o rechazo y sus cancelaciones. Los cuerpos de esas solicitudes no reciben participantIspb, y un cuerpo que lo lleva recibe 422. La cancelación de programación tampoco recibe counterpartyIspb ni requestedBy. GET /api/v1/spi/responsibles devuelve los responsáveis de tu participante directo. El riel archiva cada sobre ICOM y cada solicitud y respuesta del DICT. Un usuario con el recurso br-spi-regulatory-archive lee un elemento archivado mediante GET /api/v1/spi/regulatory-archive/{itemId}. Para un Pix enviado que BACEN no respondió, la resolución manual lo declara SETTLED o REJECTED, con una aprobación que nombra ese resultado.Quita participantIspb, counterpartyIspb y requestedBy de los cuerpos de esas solicitudes. Configura las variables del archivo regulatorio para los binarios spi y dict: fuera de un entorno de desarrollo, no inician sin un bucket.
STA

Claves de idempotencia en Lerian STA v1.2.0

Las páginas y la referencia de la API de Lerian STA pasaron a Lerian STA v1.2.0. La creación de transferencias y la consulta manual entrante necesitan un header X-Idempotency. Una solicitud sin él devuelve 400 con STA-0001. Durante 7 días, una repetición con la misma clave y la misma solicitud devuelve la primera respuesta exitosa, y Lerian STA no crea la transferencia ni ejecuta la consulta de nuevo. La misma clave con una solicitud diferente devuelve 422. Lerian STA no tiene modo multi-tenant: una instalación atiende a un cliente, y Lerian STA ya no lee DEFAULT_TENANT_ID. Los eventos de Lerian STA llevan el tenant default en ce-tenantid.Antes de actualizar, envía una clave X-Idempotency con cada creación de transferencia y cada consulta manual. Mantén la misma clave cuando reintentes la misma solicitud. Si tus consumidores de eventos filtran por ce-tenantid, ajusta el filtro a default. Lerian CCS v1.0.0 envía sus lotes ACCS001 sin el header X-Idempotency, y Lerian STA v1.2.0 los rechaza. Si ejecutas Lerian CCS v1.0.0, mantén Lerian STA en v1.1.0.
SILOC

Cierre del LBTR y caídas de Núclea en Lerian SILOC

Lerian SILOC rechaza una decisión LTR0002 o LTR0008 enviada por la API a las 17h30 de Brasilia o después con 422 y SILOC-0025, y no almacena nada. Una solicitud no enviada termina en FAILED cuando se le acaba el plazo: LTR0002, LTR0008 y SLC0004 a las 17h30 de su día de movimiento, y los otros códigos cuando termina su día de movimiento. Cada solicitud FAILED publica studio.lerian.br-siloc.siloc_outbound.failed. REDIS_DB, CERT_READINESS_MIN_DAYS, SFN_CUSTODY_CACHE_ENTRIES y XSD_VALIDATOR_TIMEOUT_SEC deben contener un entero, o el servicio no arranca.Mientras el queue manager de SILOC de Núclea no es accesible, el servicio sigue en rotación. Rechaza cada nueva solicitud saliente con 503 y SILOC-0024, y no almacena nada. Maneja SILOC-0025 y el resultado FAILED en tu integración. Envía de nuevo una solicitud rechazada con SILOC-0024 con la misma clave X-Idempotency cuando la conexión vuelva.
SCR

Lerian SCR durante una caída de BACEN

Durante una caída de BACEN, Lerian SCR sigue en rotación: scr_endpoint reporta la caída, y /readyz no pasa a 503. Una consulta que nunca llegó a BACEN responde 503 con SCR-1002, y su detail nombra a BACEN. Revisa las alertas que usan el readiness de Lerian SCR para detectar una caída de BACEN.
Pix

Etiquetas de comisión, rechazos de Tracer y hosts de QR en Pix JD v1.5.0

Las páginas y la referencia de API de Pix JD pasaron a la v1.5.0. Una orden de pago puede llevar una etiqueta de comisión en feeContext, y el paquete de comisiones de Midaz que selecciona por la etiqueta fija el precio del Pix. Una etiqueta por la que ningún paquete de comisiones del ledger del pagador selecciona responde 422 PIX-0162, y no se retiene nada. Cuando tu Tracer rechaza el crédito de un Pix recibido, el Pix espera como PENDING, con pendingReason TRACER_DENIED. Un operador de tu institución puede devolverlo a su pagador, o acreditarlo cuando tu Tracer deje pasar el crédito. Cada participante directo puede publicar sus QR codes dinámicos en un host propio.Asegúrate de que tu integración acepta TRACER_DENIED en pendingReason. Para fijar el precio de Pix por etiqueta, consulta Fija el precio de un TED o Pix con un contexto de comisión. Para cambiar el host de QR de un participante, sigue Alojamiento de QR codes dinámicos.
TED

Comisiones de TED Lerian con tus paquetes de comisiones de Midaz

TED Lerian cobra comisiones solo a través de los paquetes de comisiones de Midaz de tu ledger. TED Lerian marca cada asiento con tedOperation (ted_sent, ted_internal, ted_received o ted_refund) y tedPurposeCode, para que un paquete pueda seleccionar por ellos. Un paquete que no selecciona por tedOperation también puede cobrar comisión a las TED recibidas y a los reembolsos. La cotización de comisión es una estimación, y el feeAmount de una transferencia muestra la comisión que Midaz cobró al remitente.Antes de retener cualquier importe, TED Lerian verifica la finalidad en el dominio FinlddCli del BACEN (TED-0003) y los dígitos verificadores del CPF o CNPJ del destinatario (TED-0007). Un año de feriados cargado cubre todas sus fechas, y una fecha cuyo año no está cargado recibe 503 TED-0022. Limita tus paquetes de comisiones con estas etiquetas y carga el calendario de feriados de cada año antes de que empiece.
Streaming Hub

Hechos de averbação para fondos y originadores en Streaming Hub v3.0.0

Una suscripción limitada a un fondo o a un originador puede recibir los cuatro hechos de averbação de Lerian Consignado. Un originador los recibe solo cuando originador_ref lo nombra, y un fondo solo cuando remetente_fundo_ref lo nombra.Una suscripción limitada que omite event_types los recibe sin ningún cambio en la suscripción. Una suscripción limitada que lista sus tipos de evento recibe solo los tipos que lista. Para recibir otro hecho de averbação, crea una suscripción nueva que lo liste.
Pix

Reglas del DICT y eventos de negocio en Pix BTG v1.12.0

Las páginas y la referencia de la API de Pix BTG pasaron a la v1.12.0. La creación de clave y la creación de reclamación rechazan una cuenta de nómina (SLRY) con PIX-0129. Un número de cuenta puede tener de 1 a 20 letras mayúsculas o dígitos. Cuando el dígito verificador es una letra, el DICT recibe ese dígito como 0. El donante puede cancelar una reclamación con el motivo COURT_ORDER.Los informes de infracción y las transacciones del grafo de rastreo llevan transactionDepth. Una recuperación de fondos acepta un maxHops de 1 a 2, y el grafo de rastreo no usa sus parámetros de consulta.Pix BTG puede publicar eventos de negocio en despliegues BYOC. Están desactivados por defecto. Para activarlos, define las variables en Eventos de negocio.Antes de actualizar, deja de enviar un maxHops mayor que 2 y no registres claves Pix para cuentas de nómina. Mantén el número de cuenta original en el CRM.
Access Manager

Inicio de sesión con passkey en Access Manager v3.14.0

Las páginas de Access Manager y las referencias de las API de Auth e Identity pasaron a Access Manager v3.14.0. Cuando tu organización activa el inicio de sesión con passkey, una persona puede iniciar sesión con una passkey en lugar de una contraseña. Un inicio de sesión con passkey no pide un segundo factor. Mientras la opción está activada, Auth rechaza el inicio de sesión con contraseña de una persona que tiene una passkey con 403 AUT-1019. Las passkeys y el SSO se excluyen.Cada persona agrega y quita su propia passkey con la API de Identity. En un despliegue BYOC, define MFA_SECRET en Auth antes de activar las passkeys. Lee Passkeys para ver las llamadas, los permisos y los requisitos de despliegue.
TED

Devoluciones y créditos al cliente en Bank Transfer v3.3.0

Las páginas y la referencia de la API de TED JD pasaron a Bank Transfer v3.3.0. Return a Transfer devuelve una TED IN completada al banco pagador, o revierte un P2P completado. La solicitud necesita el permiso transfers:return. Una devolución envía solo sus propios eventos de webhook.El plugin también acredita al destinatario en siete créditos al cliente que el banco pagador envía como otros mensajes STR. Cada uno tiene su propio tipo de transferencia, de TED_IN_STR0005 a TED_IN_STR0051, y su propio vínculo en el enrutamiento del ledger. Una TED OUT que JD todavía responde como pendiente después de 24 horas en conciliación espera a un operador, con la retención mantenida. Con la política de tenant fees.refund_on_devolucao en true, el reembolso de una devolución total de una TED OUT completada también devuelve la comisión al remitente. Antes de actualizar, agrega un vínculo en el enrutamiento del ledger para cada tipo de crédito al cliente que recibes, y acepta los nuevos tipos de transferencia y eventos de devolución en tu integración.
Pix

Créditos en espera y clientes de indirectos en Pix JD v1.4.0

Las páginas y la referencia de la API de Pix JD pasaron a la v1.4.0. Cuando el ledger rechaza el crédito de un Pix recibido porque el saldo de destino no acepta créditos, el Pix espera como PENDING, con pendingReason BALANCE_NOT_RECEIVING. Un operador puede acreditar ese Pix o devolverlo a su pagador. Una lista muestra los débitos de Pix Automático que esperan, con su pendingReason. Para rechazar una reclamación de posesión, envía fraudDeclared como true. Con JOBS_CLAIM_RECEIVED_POLL_ENABLED, OUTBOX_ENABLED y STREAMING_ENABLED en true, Pix JD emite key.claim-received cuando otro participante reclama una clave que tienes.Una solicitud a través de un participante indirecto declara al cliente y no nombra ninguna cuenta tuya: payer en un pago, X-Payer-Document en la consulta de clave y en la decodificación de QR, y recipient en un código QR dinámico. La devolución de un Pix que llegó a la posición de un participante indirecto necesita su indirectId, o responde 422 PIX-0135. Una devolución que nombra a un participante indirecto que no recibió el Pix original responde 404 PIX-0147. Un ISPB tiene 8 letras mayúsculas o dígitos, y la lista de errores añadió los códigos de PIX-0151 a PIX-0160.Antes de actualizar, sigue los pasos para la 1.4.0 en la página de variables de entorno. En un despliegue self-hosted donde Pix JD no publica su declaración de permisos, dale a los roles de Pix el permiso parked-credits (acción post). Actualiza fuera del intervalo de 00:00 a 08:00, hora de Brasilia. Una aplicación existente de JD con el origen jd-consultores sigue funcionando. Para una nueva integración directa, dale a JD su credencial.
Access Manager

Credenciales de servicio y roles declarados en Access Manager v3.13.1

Las páginas de Access Manager y las referencias de las API de Auth e Identity pasaron a Access Manager v3.13.1. En un despliegue single-tenant, una persona emite la aplicación con la que un servicio de Lerian inicia sesión mediante Emitir una credencial de servicio. Crear una aplicación rechaza source con 400.Un producto de Lerian puede declarar sus propios roles y permisos. Identity rechaza con 422 agregar o quitar un rol en un permiso declarado, o un grupo en un rol declarado. La Console lista un rol declarado como Custom. Para cambiar quién tiene ese acceso, agrega o quita personas en el rol del producto o en un grupo que tiene el rol.Identity responde a un token ausente con 401 AUT-0006, a un token inválido con 401 AUT-0007 y a un permiso denegado con 403 AUT-1020. Cuando la verificación de autorización no responde a tiempo, Identity responde 504 AUT-1021. Quita source de tus solicitudes de Crear una aplicación y actualiza el manejo de errores de tu integración.
SPB

Certificado SFN y estados de liquidación en Lerian SPB

Lerian SPB usa un certificado SFN, en PROCESS_CERT_PATH. Su clave privada firma cada mensaje STR saliente y descifra los mensajes entrantes que BACEN cifra para este certificado. SPB_SIGNER_KIND define la custodia de esa clave. Las variables CERT_PATH, KEY_PATH, OUTBOX_POSTGRES_MAX_OPEN_CONNS y OUTBOX_POSTGRES_MAX_IDLE_CONNS dejaron de existir, igual que el archivo metadata.json. El valor predeterminado de STR_MQ_CIPHER_SPEC es ECDHE_RSA_AES_256_CBC_SHA384.Después de que el STR liquida una devolución, el crédito devuelto termina en RETURNED. Un redescuento convertido termina en CONVERTED, y un movimiento de dinero electrónico puede terminar en CANCELLED. La conversión de un redescuento informa dos hechos settlement.*, y el hecho del pago tiene un settlementId que termina en -PGTO. El hecho settlement.failed también informa una transferencia que un operador cierra como fallida. Los avisos LTR0003R2 y LTR0006R2 no tienen hecho settlement.*.Antes de actualizar, define PROCESS_CERT_PATH y la custodia de su clave. En un HSM, permite la firma y el descifrado en esta clave. Define STR_MQ_CIPHER_SPEC con la CipherSpec de tu canal STR_MQ_CHANNEL. Haz que tu consumidor del ledger registre los avisos LTR0003R2 y LTR0006R2 a partir de los hechos spb.ldl.* y maneje los nuevos estados finales.
SPI

Operaciones atascadas y catálogo 5.13.2 en Lerian SPI

La referencia de la API de SPI quitó las operaciones de evaluación, de solicitud y de ejecución de la recuperación de una operación. Una operación que necesita atención aparece en la lista de operaciones atascadas con las acciones que acepta, y la resolución manual necesita una aprobación APPROVED. Cuando BACEN no responde a un Pix enviado dentro de su plazo, la acción RECONCILE_WITH_BACEN le pide a BACEN el movimiento del pago. Cuando la respuesta camt.054 de BACEN informa el pago como liquidado o rechazado, el riel completa o rechaza el pago.El valor predeterminado de BACEN_SPI_CATALOGUE_VERSION es 5.13.2. Un BACEN_SPI_XSD_DIR que defines debe contener los schemas de esa versión. Un valor de variable que no es válido para su tipo, como yes en un interruptor, detiene el arranque. Mueve tus llamadas de recuperación a las acciones de operaciones atascadas. Si defines BACEN_SPI_XSD_DIR, pon en él los schemas de la 5.13.2.
SILOC

Frames aparcados y TLS de MQ en Lerian SILOC

Lerian SILOC aparca en su base de datos un frame que rechazó más de MQ_BACKOUT_THRESHOLD veces, y MQ_BACKOUT_QUEUE dejó de existir. El feed de cuarentena devuelve los bytes del frame en frame y deja de devolver un frame después de que lo resuelves. El servicio no arranca cuando PostgreSQL no responde en un plazo de 10 segundos.La nueva variable MQ_CIPHER_SPEC define el cipher spec del canal MQ, con el valor predeterminado ECDHE_RSA_AES_256_CBC_SHA384. La nueva variable MQ_CERT_LABEL nombra el certificado que el servicio presenta en el canal.Antes de actualizar, quita MQ_BACKOUT_QUEUE y define MQ_CIPHER_SPEC con el cipher spec de tu canal de conexión de servidor. Con REDIS_TLS=true, asegúrate de que tu servidor Redis acepta TLS. Si el sistema operativo no confía en la autoridad certificadora de tu servidor Redis, define esa autoridad en REDIS_CA_CERT.
Consignado

Credenciales de socio y resultados de renegociación en Lerian Consignado 4.0.0

Las páginas y la referencia de la API de Consignado pasaron a Lerian Consignado 4.0.0. Un fondo o un originador puede llamar a sus propias rutas con una credencial de socio de Access Manager, y la referencia de la API añadió esas operaciones. Puedes reactivar un fondo o un originador. Una carga completa de un nuevo certificado y de un nuevo cliente OAuth mediante PUT /v1/credentials/dataprev termina una revocación de las credenciales de Dataprev. La lectura del estado de la portabilidad es POST /v1/consignado/portabilidade/efetivacoes, con los filtros en el cuerpo, y la referencia de la API quitó la lectura de uso.El resultado de una renegociación publica consignado.renegociacao.efetivada o consignado.renegociacao.recusada. El hecho consignado.exclusao.rejected tiene la versión de schema 1.1.0. Una exclusión de portabilidad del lado de origen que no tuvo respuesta publica consignado.portabilidade.rejeitada con reason_code GW-M005-NAO-EXECUTADO. Una averbação con el bloque de booking responde RATE_OUTSIDE_PRODUCT_RANGE cuando su monthly_rate por 12 queda fuera del rango de tasa anual de la versión de producto de Lender que nombra. Una averbação con un número de contrato que ya es un contrato en el gateway responde CONTRACT_ALREADY_REGISTERED.La publicación de permisos en el arranque exige Access Manager 3.13.0 o posterior. Esto reemplaza la indicación de Access Manager 3.12.0 en la entrada del 26 de octubre de 2026 sobre Consignado. Actualiza Access Manager antes de actualizar el gateway. Lee el estado de la portabilidad con POST y deja de llamar a la lectura de uso. Lee ce-schemaversion antes de decodificar consignado.exclusao.rejected. Después de GW-M005-NAO-EXECUTADO, envía la exclusión de nuevo con una nueva clave.
TED

Resultados de la TED recibida en TED Lerian

Una TED recibida para una cuenta de la institución termina en RECORDED, no acredita a ningún cliente y publica incoming_transfer.recorded. Una cuenta es de la propia institución cuando el documento de su titular en el CRM de Midaz es el CNPJ de la organización a la que está vinculado el ISPB. TED Lerian devuelve una TED para una cuenta de cliente cuyo closingDate en el CRM de Midaz es hoy o anterior, con el motivo oficial 1 (cuenta cerrada). Cuando una consulta al CRM de Midaz falla o no da una respuesta clara, la TED va a revisión manual.Los vínculos de ISPB aceptan solo la organización y el ledger donde esta instalación acredita las TEDs recibidas, y rechazan cualquier otro con 422 TED-0002. Sin un horario de corte, la ventana de operación sigue el horario oficial del STR. Revisa cómo tu sistema maneja RECORDED e incoming_transfer.recorded.
SCR

Respuestas tardías de BACEN en Lerian SCR

Cuando BACEN responde después de que una consulta ya respondió SCR-1004, Lerian SCR igual escribe esa respuesta en su caché de resultados. Un acierto completo en la caché evita la llamada a BACEN y la tarifa. El servicio no arranca cuando Postgres no responde en un plazo de 10 segundos. Revisa cómo tu integración reintenta una consulta después de SCR-1004.
SLCSILOCSPB

Recorridos de los rieles nativos y el evento de liquidación de SPB

En los recorridos de SLC, SILOC y STR de Diagramas de integración, Lerian publica un crédito del ciclo de tarjetas, la devolución de un depósito excedente y un crédito LTR0005R2 como el evento de Lerian SPB spb.ldl.third-party-settlement-received. Tu institución envía el depósito del ciclo de tarjetas (LDL0022) por su propia conexión con el STR y recibe ahí la respuesta LDL0022R1. La disputa SLC0002, los archivos ASLC del domicilio, la DDA0101, el ROC y los pasos de la registradora de recibibles ocurren entre tu institución y la infraestructura, fuera de Lerian.Para los créditos liquidados y devueltos, esta entrada reemplaza la entrada del 15 de octubre de 2026 sobre SLC. Revisa tus suscripciones y runbooks operativos con los recorridos revisados.
DocumentationPixTED

Recorridos de Pix y de TED

La sección Rieles nativos de Diagramas de integración añadió recorridos de Pix Lerian sobre Lerian SPI. Son Enviar y recibir Pix, Cobrar con un código QR dinámico, Devolver un Pix recibido, Autorizar y pagar con Pix Automático, y Reportar un fraude y recuperar fondos. La sección también añadió recorridos de TED Lerian sobre Lerian SPB: Enviar y recibir TED, y Cancelar o devolver una TED. El índice de mensajes lista los códigos de mensaje de estos recorridos.
MidazLerian Console

Página Fee Debts del módulo Midaz

Las páginas de Fees Engine del módulo Midaz añadieron una guía de Fee Debts. Muestra cómo filtrar las deudas de comisión de un ledger por saldo y por estado, y qué significa cada columna. La acción Collect se aplica a todas las deudas abiertas de un saldo. Midaz las liquida de la más antigua a la más reciente, hasta el saldo disponible. Midaz no cobra comisión sobre un cobro, y no puedes revertirlo. Para definir un monto máximo, usa la API de cobro con maxAmount.
Reporter

Grupos de acceso de Reporter

La página ¿Qué es Reporter? lista los tres grupos de acceso que Reporter declara en Access Manager. El grupo reporter-viewer-group lee. El grupo reporter-contributor-group lee, crea y cambia. El grupo reporter-editor-group también elimina y aprueba una presentación regulatoria. El grupo de administradores de Access Manager, admin-group, tiene el mismo acceso que reporter-editor-group. Revisa el grupo de cada usuario de Reporter.
Documentation

Catálogo de eventos y host de Try It

El resumen de streaming de eventos lista Pix Lerian y TED Lerian, con sus páginas de eventos y las rutas de sus manifiestos de streaming. El Try It de las referencias de las API de TED JD, Payments BTG, Pix BTG y BC Correios usa un host de ejemplo. Reemplázalo con la URL que recibes en el onboarding del entorno.
MidazTracer

Los productos de Lerian son de código cerrado

Desde el 21 de octubre de 2026, todo producto de Lerian es de código cerrado. El modelo Community de Midaz dejó de existir. Midaz y Tracer se instalan desde sus imágenes públicas en Docker Hub. Si instalas Midaz o Tracer desde su código fuente, pasa a las imágenes de Docker Hub. Para soporte, usa el Lerian Support Portal.
MidazTracer

Rechazos de autenticación y de tenant en Midaz 4.3.0

En Midaz 4.3.0, un token ausente o inválido responde AUT-0006 o AUT-0007, no 0042. Un permiso denegado responde AUT-1020, no 0043. Cuando el Access Manager no decide, la respuesta es AUT-0033, no 0525. En modo multi-tenant, la resolución del tenant rechaza con códigos como TENANT_SUSPENDED y TENANT_MANAGER_UNAVAILABLE.Midaz mantiene 0042, 0043 y 0525 solo para un rechazo que no lleva código. Si tu integración decide según esos tres códigos, decide según el status HTTP o según los códigos nuevos.
MidazTracer

Actualización y eliminación de cuentas en Midaz 4.3.0

En Midaz 4.3.0, el Ledger publica los mensajes de auditoría de transacción solo cuando AUDIT_LOG_ENABLED es true. El /readyz del Ledger verifica RabbitMQ a través de su API de administración con las credenciales de RABBITMQ_DEFAULT_USER y responde 503 cuando esa verificación falla. Cada clave de comisión que agregas a un paquete debe seguir ^[a-z][a-zA-Z0-9]*$.Antes de actualizar, define AUDIT_LOG_ENABLED=true si consumes los mensajes de auditoría. Dale también al usuario RABBITMQ_DEFAULT_USER acceso a la API de administración. Actualiza Tracer y después todos los Ledgers antes de que tu integración envíe scheme u optionalOperationRoutes. Mientras corre un Ledger 4.3.0, no hagas el rollback de Tracer a una versión anterior a 4.3.0.Cada reserva que el Ledger envía a Tracer lleva el segmento y el portafolio de la cuenta de origen, y el esquema de la transacción. Los límites y las reglas de Tracer con alcance por segmento, portafolio o esquema se aplican a estas reservas. En modo enforce, pueden denegar la transacción. Antes de actualizar, revisa esos límites y reglas.Cuando eliminas una cuenta, Midaz también archiva sus Cuentas Alias y quita su alias de los paquetes de comisiones y de facturación. Midaz quita cada comisión que acredita el alias. Desactiva un paquete de comisiones que queda sin comisiones y un paquete de facturación que debita o acredita el alias. Antes de eliminar una cuenta, registra su fecha de cierre en su Cuenta Alias. Para mantener una comisión que asienta en el alias, apúntala antes a otra cuenta.
TED

Licencia y conclusión de TED OUT en Bank Transfer v3.2.0

Las páginas y la referencia de la API de TED JD pasaron a Bank Transfer v3.2.0. En v3.2.0, cada entorno necesita LICENSE_KEY y ORGANIZATION_IDS. IS_DEVELOPMENT selecciona el servicio de licencias de desarrollo, y LICENSE_SERVICE_ADDRESS dejó de existir.TED OUT envía transfer.completed cuando se liquida y también envía transfer.rejected cuando el STR rechaza la liquidación. A partir de v3.2.0, usa transfer.completed como la señal de conclusión de TED OUT, en lugar de la indicación de la entrada del 24 de agosto de 2026. Antes de actualizar, define las dos variables de licencia en cada entorno. Confirma también que ENVIRONMENT_NAME o ENV_NAME es production, staging, uat, development, local o test.
Pix

Solo nombres de campo en inglés en Pix JD v1.3.0

Las páginas y la referencia de la API de Pix JD pasaron a v1.3.0. En v1.3.0, un campo que tenía un nombre en inglés y un nombre obsoleto en portugués mantiene solo su nombre en inglés. Un cuerpo de solicitud con el nombre en portugués responde 400 PIX-0061, y la API ignora un parámetro de consulta con ese nombre. El registro de una clave aleatoria necesita X-Idempotency. Antes de actualizar, sigue los pasos para la 1.3.0 en la página de variables de entorno.
Pix

ID end-to-end en Pix Lerian v1.1.0

Las páginas y la referencia de la API de Pix Lerian pasaron a v1.1.0. Pix Lerian es la interfaz que conecta Midaz con Lerian SPI a través de su adaptador de conectividad Lerian.En un pago por clave o por QR Code, Pix Lerian fija el ID end-to-end cuando inicias la transferencia, y el procesamiento lo reutiliza. El procesamiento rechaza X-End-To-End-Id en estos pagos con 400 PIX-0300. Un endToEndId que envías debe contener tu ISPB en los caracteres 2 a 9. X-Idempotency es la clave de idempotencia. Antes de actualizar, deja de enviar X-End-To-End-Id al procesar un pago por clave o por QR Code.
SPB

Eventos y depósitos LDL0022 de Lerian SPB

Lerian SPB publica todas las familias de eventos en el backbone de streaming y no envía webhooks. Una devolución (STR0010) devuelve un crédito TED que recibiste y termina en su propio settlement.settled o settlement.failed. El evento settlement.returned dejó de existir. Las liquidaciones LDL, los depósitos LDL0022, el pago LTR0004 y los avisos LDL y LTR0005R2 no solicitados no tienen hecho settlement.*. Una solicitud de depósito LDL0022 indica solo advisoryId. El riel toma el monto, el lado y el período del aviso, y rechaza un cuerpo con cualquier otro miembro.Antes de actualizar, mueve cada consumidor de webhook al backbone de streaming. Haz que tu consumidor del ledger registre esas operaciones a partir de los hechos spb.ldl.*. Envía solo advisoryId en una solicitud de depósito LDL0022. Define LDL_ADVISORY_CONSUMER_ENABLED como true o false, porque el servicio no inicia cuando la variable no está definida.
SPI

Devoluciones entrantes y campos obligatorios en Lerian SPI

Lerian SPI retiene una devolución entrante y la anuncia en spi.payment.return_received, con su returnId. Tu cliente autoriza o rechaza la devolución por ese returnId. Una devolución autorizada se liquida solo cuando el SPI la confirma, y el riel rechaza una devolución que ninguna decisión concluye dentro de su ventana.Un rechazo FRAD de un Pix entrante sale como FRAD solo cuando tu cliente lo marca como la decisión de su sistema antifraude. De lo contrario, sale como DS04. Una orden de pago necesita acceptedAt, el instante en que tu sistema recibió la confirmación del pagador. Una recuperación de fondos necesita userComplaintAt, el instante en que tu canal de atención registró la reclamación del pagador. Un perfil de recebedor de BR Code necesita ispbParticipante, el ISPB de un participante para el que el riel liquida. Sin estos campos, el riel responde 422.Con un endpoint BACEN SPI https, define BACEN_SPI_SIGNING_CERT_FILE. Con el backend file, el predeterminado de BACEN_SPI_SIGNER_KIND, define también BACEN_SPI_SIGNING_KEY_FILE. La referencia de la API de DICT eliminó el bloqueo judicial y el desbloqueo de una clave, la limpieza de claves huérfanas y la conciliación bajo demanda. Esta entrada reemplaza la entrada del 6 de octubre de 2026 sobre SPI. Envía estos campos, decide cada devolución entrante y actualiza el manejo de errores de tu integración.
SILOC

Interruptores y liquidación de ciclo en Lerian SILOC

Lerian SILOC no arranca a menos que OT_REPLAY_ENABLED, STATUS_REPLAY_ENABLED, RECONCILE_ENABLED, LDL_FACT_CONSUMER_ENABLED y CARD_COMMAND_CONSUMER_ENABLED sean cada uno true o false. Con RECONCILE_ENABLED=true, liquida un ciclo OT solo cuando el resultado multilateral GEN0015 de la câmara coincide con la obligación. La obligación también necesita su prueba del STR, y su período de depósito necesita su PAG0103. La referencia de la API eliminó la recepción de ROC y añadió la lectura de los resultados multilaterales de la câmara. Define los cinco interruptores antes de actualizar.
SCR

Instalación e idempotencia en Lerian SCR

Una instalación de Lerian SCR atiende a una institución. Un reintento mientras la primera solicitud todavía se ejecuta responde 409 SCR-0006, así que envíala de nuevo después de Retry-After. Una respuesta con X-Idempotency-Fenced: true retiene su clave, y un reintento con esa clave responde 422 SCR-0005 sin ejecutarse. SCR-1003, SCR-1004 y SCR-9001 indican si la solicitud llegó a BACEN. Ejecuta una instalación para cada institución y actualiza el manejo de errores de tu integración.
Consignado

Rechazos y plazo de la documentación en Consignado

Un número de contrato tiene de 2 a 15 letras o dígitos en la averbação, el refinanciamiento, la renegociación y la portabilidad entrante. Cuando Dataprev rechaza la documentación, el anexo de CCB responde 422 con los códigos de Dataprev en upstream, y el contrato vuelve a esperar su documentación. Envía la documentación corregida con una nueva clave X-Idempotency o excluye el contrato. La lectura de la averbação muestra documentation_due_at y documentation_overdue. DEFAULT_TENANT_ID y DATAPREV_RECONCILIATION_TENANT_ID dejaron de existir, y solo un despliegue multi-tenant lee LEILAO_TENANT_ID. Actualizar un gateway single-tenant (MULTI_TENANT_ENABLED=false) exige una limpieza en la versión actual y una base de datos nueva. Contacta al soporte de Lerian antes de actualizarlo.Con la configuración predeterminada, el gateway publica su manifiesto de permisos en Access Manager durante el arranque, y una publicación fallida detiene el arranque. La publicación exige Access Manager 3.12.0 o posterior, así que actualiza Access Manager antes de actualizar el gateway. Con un servicio de identidad multi-tenant, define IDP_DECLARATION_ENABLED como false, porque rechaza la publicación.
Streaming Hub
Toma cada clave de event_types del campo eventKey de GET /v1/catalog: el hub puede rechazar una clave que el catálogo no lista en la schema major de la suscripción, con 422 unknown_event_type. Una suscripción nueva también acepta un mapa opcional event_majors, que define la schema major por tipo de evento.Un job de entrega tiene como máximo ocho intentos, y un intento que empieza 24 horas o más después de que el hub recibió el evento es el último. El dashboard rechaza un período que empieza antes del historial que el hub todavía guarda y devuelve coverage_start. Los conteos de salud de la suscripción cubren el intervalo de window_start a snapshot_at.
Midaz

Transacciones en Midaz 4.3.0

Las páginas de Midaz y la referencia de la API del Ledger pasaron a Midaz 4.3.0. Una transacción /v2 acepta un scheme opcional que nombra su esquema de pago, por ejemplo PIX o CARD. En /v2, una ruta contable puede vincular rutas de operación opcionales en optionalOperationRoutes. Una transacción de bloqueo o de desbloqueo no se puede revertir, y una reversión responde 0539.
Tracer

Esquemas de pago y validación solo por reglas en Tracer

Las páginas y la referencia de la API de Tracer pasaron a Midaz 4.3.0. Tracer acepta scheme como un campo abierto de 1 a 50 caracteres: A-Z, 0-9, _ y -. Una validación solo por reglas decide únicamente por las reglas y no verifica ni cuenta ningún límite de gasto. El endpoint de uso del límite informa el período actual, y cada cifra de uso incluye la capacidad que retienen las reservas del ledger aún no confirmadas. Un maxAmount de 0 deniega cada transacción de su alcance.
Lerian Console

Páginas de Lerian Console v2.16.0

Las páginas de Console cambiaron para coincidir con Lerian Console v2.16.0. En Payments, el ledger viene del encabezado de Console, y eliges la cuenta debitada por su alias o por su ID completo. Boletos emite un boleto a la vez. Las páginas de Fees añadieron la pantalla Fee Debts, que necesita Midaz 4.2.0 o posterior, y los campos Metadata selector y Deferrable de un paquete. Un límite de Tracer recibe su Reset Time (UTC) cuando lo creas y puedes eliminar una ruta contable.
Pix

Verificación de fraude y desbloqueo de devoluciones en Pix BTG v1.11.0

Las páginas y la referencia de la API de Pix BTG pasaron al plugin v1.11.0. Las páginas añadieron la verificación de fraude en Pix entrantes y en devoluciones entrantes, donde el plugin consulta un endpoint de decisión que tú operas. La verificación está desactivada por defecto, y ANTIFRAUD_HOOK_ENABLED la activa. Las páginas de devoluciones describen el desbloqueo de devoluciones en PENDING y de devoluciones de cash-out en CREATED. La referencia de la API añadió Complete a charge.
TED

TED Lerian

La sección Interfaces tiene una guía de TED Lerian. TED Lerian es la interfaz que conecta Midaz con Lerian SPB. Envía TEDs, hace transferencias internas, recibe TEDs, devuelve un TED recibido y cancela un TED. Midaz registra el dinero. Las páginas Eventos e integración con el ledger y Operar Lerian SPB salieron de la sección TED Lerian y pasaron a la sección SPB (TED) de Rieles Brasil. La Referencia de API agregó TED Lerian y su lista de errores.
Tracer

Campo de tipo de transacción de Tracer obsoleto

En Midaz 4.3.0, transactionType es el nombre obsoleto del scheme de Tracer. Todavía funciona en solicitudes, alcances de reglas y de límites, expresiones CEL y eventos. Los filtros de listado de reglas, límites y eventos de auditoría aceptan transaction_type como el nombre obsoleto de scheme. Usa scheme en tu integración, en las reglas y en los límites.
TED

ENV_NAME de Bank Transfer obsoleto

En Bank Transfer v3.2.0, ENVIRONMENT_NAME reemplaza a ENV_NAME, que todavía funciona como su nombre obsoleto. El servicio no arranca cuando las dos variables nombran entornos distintos. Define ENVIRONMENT_NAME y quita ENV_NAME.
Consignado

Averbação en dos pasos en Consignado

En Lerian Consignado, la averbação ejecuta solo el Manual 003 de Dataprev, requiere nome_trabalhador y no lleva ningún documento. Cuando Dataprev la acepta, la operación responde attachment_pending y el gateway publica consignado.averbacao.accepted. Envía la CCB firmada y la evidencia de firma al anexo de CCB, bajo su propia clave X-Idempotency, dentro de los 7 días que permite el Manual 004.El anexo de CCB ya no ejecuta una averbação. Antes de que Dataprev acepte la averbação, el anexo responde 409 AVERBACAO_NOT_ACCEPTED. Un contrato recibe una sola documentación aceptada. Un paquete distinto responde 409 AVERBACAO_DOCUMENTATION_CONFLICT mientras el primero está aceptado o en camino a Dataprev. La documentación lleva el data_hora_assinatura, el instante en que el trabajador firmó, y la averbação rechaza ese campo.El evento consignado.averbacao.confirmed ahora sigue a la aceptación de la documentación por Dataprev. El saldo devedor que el gateway informa a Dataprev por el Manual 015 ahora empieza cuando Dataprev acepta la averbação, ya no cuando acepta la documentación. La referencia de la API añadió GET y PATCH /v1/consignado/contracts/{numero_contrato}/registro-b3 para el código de instrumento B3 de un contrato con averbação confirmada, y el PATCH publica consignado.registro_b3.registered.Para desistir de un contrato que espera documentos, envía su exclusión. Los documentos enviados después responden 409 AVERBACAO_EXCLUDED, salvo que Dataprev rechace la exclusión. Si la documentación ya está registrada o en camino a Dataprev, la exclusión responde 409 EXCLUSION_DOCUMENTATION_UNDERWAY. Mientras la averbação esté en attachment_pending, envía de nuevo la misma documentación al anexo de CCB y excluye el contrato cuando la averbação esté en confirmed.Las fallas de Dataprev responden 503 DATAPREV_UNAVAILABLE o 504 DATAPREV_TIMEOUT en lugar de CLT-0008, y una lectura de Dataprev con datos inutilizables responde 502 DATAPREV_INVALID_RESPONSE. Las fallas de Tenant Manager, Access Manager y Streaming Hub también responden 503 o 504 con códigos propios, como TENANT_MANAGER_UNAVAILABLE, AUT-0033 y STREAMING_HUB_TIMEOUT. Después de 504 DATAPREV_TIMEOUT, reintenta un comando con la misma clave y nunca con una clave nueva, porque puede haber llegado a Dataprev. La respuesta a la subasta de portabilidad es la excepción, como explica su referencia.Una clave reutilizada en otra solicitud responde 422 IDEMPOTENCY_KEY_REUSE, así que envía una clave nueva. Una respuesta del riel que el gateway no pudo registrar responde 503 OUTCOME_UNKNOWN, así que reintenta con la misma clave. La averbação rechaza fechas y condiciones de contabilización inconsistentes con 422 antes de llamar a Dataprev.Tres códigos 409 reemplazan RAIL_COMMAND_CLAIM_CONFLICT en algunos casos. Un comando distinto con la misma clave responde RAIL_COMMAND_PAYLOAD_MISMATCH, y un reintento de un comando rechazado responde RAIL_COMMAND_ALREADY_REFUSED. Un reintento sin resultado conocido responde RAIL_COMMAND_OUTCOME_UNRESOLVED, así que consulta los comandos del riel y no envíes el comando con una clave nueva.Los rechazos de fondo, de oferta y de plazo de portabilidad responden códigos 422 propios en lugar de CLT-0006, como FUNDO_NOT_REGISTERED, BID_NO_PROPOSTA_LEFT y PORTABILIDADE_WINDOW_EXPIRED.La cesión de un crédito que Dataprev todavía no respondió responde 409 CESSAO_CREDIT_PENDING, y CESSAO_CREDIT_NOT_ACCEPTED ahora significa que Dataprev rechazó el crédito. La lectura de créditos cedidos lista cada crédito con numero_contrato y omite credit_key y id_solicitacao para un contrato sin oferta.Las variables de entorno añadieron IDP_DECLARATION_ENABLED, y OUTBOX_RETENTION_PUBLISHED_HOURS ahora tiene 1 como valor predeterminado. DATAPREV_RECONCILIATION_CNPJS dejó de existir, porque la conciliación del repasse ahora lee todos los empleadores. Envía la averbação sin documentos y los documentos por el anexo de CCB, no contabilices ni desembolses un contrato a partir de consignado.averbacao.accepted y actualiza el manejo de errores de tu integración. Haz este cambio junto con la actualización, porque v3.7.1 todavía exige la CCB firmada en la averbação.
Payments

Consulta del pagador de Payments BTG v1.0.2

Las páginas de Payments BTG pasaron a v1.0.2. Los pagos de facturas y DARF ahora leen el pagador desde endpoints de CRM que atiende MIDAZ_LEDGER_URL en /v2, y MIDAZ_CRM_URL ya no configura esa consulta. Antes de actualizar, confirma que la URL del ledger de Midaz atiende endpoints de CRM en /v2.
STA

Lerian STA v1.1.0

Las páginas de Lerian STA pasaron a Lerian STA v1.1.0. Lerian STA v1.1.0 puede leer su licencia de un archivo de licencia firmado que emite Lerian. Configura la ruta del archivo en LICENSE_FILE_PATH. Con un archivo de licencia, Lerian STA verifica la licencia localmente y no llama al servicio de licencias. Cuando LICENSE_FILE_PATH está configurada, Lerian STA ignora LICENSE_KEY. Cada entorno necesita LICENSE_FILE_PATH o LICENSE_KEY, y ORGANIZATION_IDS.
SRC

Lerian SRC

La pestaña Rieles Brasil y la Referencia de API agregaron Lerian SRC. Lerian SRC envía consultas de restricción a BC Protege+ de BACEN antes de que tu institución abra una cuenta o cambie la titularidad de una relación existente. Registra el veredicto de BACEN para cada consulta y mantiene una pista de evidencias.
SISBAJUD

Lerian SISBAJUD en dos componentes

Las páginas de Lerian SISBAJUD pasaron a dos versiones: la Lerian SISBAJUD Mensageria v1.0.0 y el Lerian SISBAJUD executor v1.0.0. La Mensageria recibe las órdenes como archivos a través de Lerian STA y escribe los archivos de respuesta. El executor ejecuta las órdenes en Midaz y necesita su propia base de datos PostgreSQL. Cada componente tiene sus propias variables de entorno: consulta las páginas de la Mensageria y del executor. La referencia de la API tiene una sección para cada componente, y las URL de las operaciones cambiaron. Antes de pasar a estas versiones, registra cada institución en los dos componentes con el mismo institutionId y enabled en true.
BC Correios

Lerian BC Correios

La pestaña Rieles Brasil y la Referencia de API agregaron Lerian BC Correios. Lerian BC Correios recoge de BACEN los correos de BC Correio de tu institución, los almacena con un registro de auditoría y envía mensajes a los departamentos de BACEN.
Platform

Lifecycle Management a través del agente BYOC de Lerian

Lifecycle Management pasó del dashboard de Lifecycle al agente BYOC de Lerian, y Lerian retiró el dashboard. Lerian instala, actualiza, hace rollback y elimina productos en tu clúster a través del agente, cuando lo solicitas. Para usar Lifecycle Management, pide al soporte de Lerian la credencial del agente y la dirección del plano de control. Luego, instala el agente con su chart.
Access Manager

Guía de inicio de Access Manager

La guía del ciclo de vida de Access Manager ya no trata la disponibilidad de PostgreSQL, Valkey o Caradhras como requisito para iniciar el servicio. Confirma la preparación con las comprobaciones de estado antes de activar el control de acceso en un producto.
SLC

Eventos de clearing de SLC en los diagramas de integración

Los diagramas de integración de SLC ahora identifican los eventos de vista previa de posiciones, créditos liquidados y créditos devueltos. Revisa tus suscripciones y runbooks operativos con los recorridos actualizados.
Midaz

Modelo de cuentas y saldos de Midaz

La guía de cuentas y saldos de Midaz ahora distingue las cuentas separadas de un cliente de varios saldos dentro de una sola cuenta. Revisa el modelo de cuentas y los controles en el nivel de saldo con la guía actual.
Payments

Variables de licencia de Payments BTG v1.0.1

Las páginas de Payments BTG pasaron a la versión v1.0.1, que valida su licencia cuando inicia. En v1.0.1, cada pod, incluido el worker, necesita LICENSE_KEY y ORGANIZATION_IDS en todos los entornos. El valor de ORGANIZATION_IDS es global o una lista de UUID de organizaciones en minúsculas, separados por comas. Un rechazo de licencia lleva un código LCS. Las operaciones de la API no cambiaron. Antes de actualizar, define las dos variables en cada pod y abre la regla de salida que describe License Manager.
TED

Comisiones deducibles en TED OUT en Bank Transfer v3.1.0

Bank Transfer v3.1.0 rechaza un TED OUT con 422 BTF-3002 cuando el paquete de comisiones que coincide con él tiene una comisión con isDeductibleFrom: true. El rechazo se aplica en el modo native y en el modo legacy con BTF_FEE_ENABLED=true. En TED OUT y P2P, el totalAmount es el monto que Bank Transfer debita del remitente, y los límites de uso cuentan ese monto. Las lecturas de transferencias llevan organizationId y ledgerId, List Transfers acepta un filtro ledgerId, y la referencia de la API añadió 422 BTF-2004 y BTF-2005. Bank Transfer pide a Midaz que cree un índice de metadatos de transacción, lo que necesita el permiso settings post de Midaz en los dos modos de comisión. Antes de actualizar, confirma que ningún paquete de plugin-fees con el que puede coincidir un TED OUT tenga una comisión con isDeductibleFrom: true.
Pix

Nombres de campo en inglés y consulta de clave en Pix JD v1.2.4

Las páginas y la referencia de la API de Pix JD pasaron a la v1.2.4, en la que la consulta de clave acepta un indirectId opcional para un pago que pasa por un participante indirecto. Pix JD añade nombres en inglés para algunos campos de MED 2.0, Pix Automático y la consulta de clave. Cuando un campo tiene un nombre en inglés, el nombre en portugués sigue funcionando y está obsoleto, y dos valores diferentes para un campo responden 400 PIX-0148. Dos rutas de MED tienen paths en inglés que requieren el mismo permiso que las rutas en portugués. Como indica la página de variables de entorno, el riel ya no lee MULTI_TENANT_ALLOW_INSECURE_HTTP a partir de la 1.2.1. En modo multi-tenant con un Tenant Manager en http://, define ALLOW_INSECURE_TLS=true en la API y en el worker antes de esa actualización, o el servicio no inicia.
Lerian Console

Páginas de Lerian Console v2.13.0

Las páginas de la Console pasaron a corresponder a Lerian Console v2.13.0, y Versiones de los productos lista la versión de producto que necesitan algunas pantallas. Cuando un producto ejecuta una versión anterior, un aviso como Requires Bank Transfer 3.1.0 or later reemplaza esa parte de la pantalla. El módulo Tracer abre en su dashboard con Tracer 4.1.0 o posterior, y la Console ya no lee NEXT_PUBLIC_TRACER_DASHBOARD_ENABLED. En Bank Transfer, la lista Transfers y la tarjeta Recent Transfers muestran las transferencias del ledger seleccionado. En TED Out y P2P, Total muestra el monto debitado del remitente, y la configuración de Fee Policy aplica solo en el modo de comisión legacy. Una nueva página describe Environments, la pantalla que lista los entornos en los que tienes una cuenta y permite elegir tu entorno predeterminado.
Access Manager

Access Manager v3.11.1 y socios

Las páginas y las referencias de las API Auth e Identity de Access Manager pasaron a Access Manager v3.11.1. La referencia de Auth añadió las operaciones de descubrimiento e inicio de SSO, y la referencia de Identity añadió las operaciones de socios, de catálogo de ámbito y de tenants propios. Las guías de socios volvieron, con una visión general, una guía de la Console y una guía de la API. Puedes dar permisos a un socio solo en un producto que acepta socios, y la visión general indica cómo encontrar esos productos en tu despliegue. Una solicitud para eliminar un grupo que tiene miembros o subgrupos ahora responde 409 con IDE-1058 o IDE-1059. La lista de errores también añadió AUT-0033, AUT-1011, AUT-1012, IDE-0064, IDE-0065 y IDE-0066, y la página de aprovisionamiento automático de Tenant Manager salió del sitio.
MidazTracer

Midaz v4.2.2

Las páginas de Midaz y las referencias de la API de Ledger y Tracer pasaron a Midaz v4.2.2. Las operaciones de la API no cambiaron.
TED

Modo de comisión de Bank Transfer v3.1.0

Bank Transfer v3.1.0, el plugin de TED JD, puede cobrar comisiones mediante el Fees Engine de Midaz. MIDAZ_FEE_MODE elige legacy (plugin-fees, /v1) o native (Midaz, /v2), y el auto predeterminado elige native en Midaz 4.1.0 o posterior. Con auto, si tus paquetes de comisiones todavía están en plugin-fees, las transferencias quedan sin comisión en cuanto Midaz ejecute la 4.1.0 o posterior. native necesita los permisos de Midaz packages get y estimates post, un native explícito también necesita organizations get, y BTF_FEE_ENABLED se aplica solo a legacy. Define MIDAZ_FEE_MODE=legacy antes de actualizar y luego mueve tus paquetes como describe la guía de migración. Pasa a native solo cuando cada pod de Bank Transfer ejecute la 3.1.0 o posterior y los paquetes existan en Midaz.
Matcher

Header de idempotencia y confirmación automática en Matcher v5.0.0

Las páginas y la referencia de la API de Matcher pasaron a Matcher v5.0.0, donde una coincidencia DATE_LAG va a revisión y la política de duplicados predeterminada es FLAG_AS_EXCEPTION. Matcher v5.0.0 lee una clave de idempotencia solo del header X-Idempotency y no usa una clave en Idempotency-Key o X-Idempotency-Key. Envía las claves de idempotencia en X-Idempotency y revisa las coincidencias que tu proceso espera confirmar de forma automática.
Access Manager

Código de MFA y socios en Access Manager v3.10.0

En Access Manager v3.10.0, un usuario que desactiva MFA en su propia cuenta debe enviar un código. Las páginas de socios y las operaciones de socios salieron del sitio. Si tu aplicación permite que los usuarios desactiven MFA o eliminen un método en su propia cuenta, obtén el código y envíalo en la solicitud.
Pix

Pix JD v1.2.0

Las páginas y la referencia de la API de Pix JD pasaron a la versión v1.2.0 del plugin, que añade una validación de cuenta asíncrona para JD. En v1.2.0, una ruta reclama en JD Courier las recurrencias de Pix Automático. Antes de la actualización, sigue el paso a la 1.2.0 en la página de variables de entorno.
CCS

Variables de licencia de CCS

La página de variables de entorno de CCS cambió LICENSE_KEY y ORGANIZATION_IDS de obligatorias en producción a obligatorias en todos los entornos. Define las dos variables en todos los entornos, incluido el de desarrollo.
Payments

Sacador avalista y búsqueda de pagos en Payments BTG

La referencia de la API de Payments BTG quitó el sacador avalista de la emisión de boletos, y una solicitud que envía un sacador avalista responde 400 PBP-0001. La página Boletos y pago de facturas añadió cómo encontrar un pago por su Idempotency-Key cuando una solicitud de creación termina sin el id del pago. Quita el sacador avalista de tus solicitudes de boleto y, después de un error, envía la solicitud de nuevo con el mismo Idempotency-Key antes de buscar el pago.
PixTED

Activación de rieles en JD Courier v1.1.0

Las páginas y la referencia de la API de JD Courier pasaron a v1.1.0 y añadieron la activación y la suspensión de un riel. En v1.1.0, el Courier no entrega a los motores ningún mensaje de un riel hasta que un operador activa el riel. Activa cada riel como describe la página de despliegue.
MatcherLerian Console

Módulo Matcher de Lerian Console

Las páginas de la interfaz de Matcher pasaron a describir el módulo Matcher de Lerian Console v2.12.0.
Lerian Console

Páginas de Lerian Console v2.12.0

Las páginas de la Console pasaron a corresponder a Lerian Console v2.12.0. En v2.12.0, abres Authorization desde la barra lateral de Settings o desde el menú de engranaje, y la lista de aplicaciones tiene una columna Description. La página Productos añadió Matcher.
Documentation

Recorridos en Diagramas de integración

La pestaña Diagramas de integración tenía cuatro secciones: Productos Lerian, Rieles nativos, Interfaces de socios e Infraestructuras de mercado. Rieles nativos traía los recorridos de SLC, SILOC y STR para crédito con garantía y liquidación diaria, con una columna de Lerian que muestra el endpoint o el evento de cada paso entre tu institución y Lerian. Un índice de mensajes lista cada código y sus recorridos. En las páginas de rieles, los manuales oficiales prevalecen sobre los diagramas.
Documentation

Organización de las pestañas y Diagramas de integración

El sitio reagrupó sus pestañas y quitó la pestaña Soluciones y sus páginas. Plataforma pasó a ser una sección de Productos Lerian, e Interfaces pasó a ser una sección de Rieles Brasil, sin cambios en las direcciones de sus páginas. El sitio añadió una pestaña Diagramas de integración antes de Referencia de API.
TracerMidaz

Las reservas de Tracer usan solo gRPC en Midaz 4.2.0

En Midaz 4.2.0, el Ledger llega a Tracer para las reservas solo por gRPC, en el puerto 4021 de forma predeterminada. Las operaciones REST de reserva salieron de la referencia de la API de Tracer. Despliega Tracer antes que el Ledger y no regreses Tracer a una versión anterior a la 4.2.0 mientras se ejecute un Ledger 4.2.0.
Pix

Configuración y actualización de Pix JD v1.0.0

Las páginas de Pix JD pasaron a la versión v1.0.0 del plugin. En v1.0.0, la organización, el ledger, el activo y la cuenta de compensación de Midaz vienen del binding del systemplane y de dos claves tenant_policy/midaz.*, y los pagos y las devoluciones requieren X-Idempotency. Sigue los nuevos pasos de actualización: escribe primero las claves tenant_policy/midaz.* y después elimina las variables de identidad MIDAZ_* retiradas.
Payments

Flujo y consulta del pago de facturas en Payments BTG

Las páginas de Payments BTG añadieron los pasos de un pago de factura: el ledger reserva los fondos antes de que BTG reciba el pago. Un resultado desconocido responde 202 con el estado UNCONFIRMED, la referencia añadió una operación de consulta de factura y la lista de errores añadió siete códigos y quitó PBP-0209. No envíes de nuevo un pago UNCONFIRMED con un nuevo Idempotency-Key y define CONSULT_AUDIT_HMAC_KEY: un pod que atiende la API de pagos no arranca sin ella.
TED

Formato de error de TED JD v3.0.1

En TED JD v3.0.1, cada error es un documento de problema RFC 9457 en application/problem+json, y un código de JD SPB está en upstream.code. Actualiza el manejo de errores de tu integración.
SISBAJUD

Variables de licencia de SISBAJUD v1.2.0

Lerian SISBAJUD v1.2.0 requiere LICENSE_KEY y ORGANIZATION_IDS en todos los entornos. Define las dos variables.
Access Manager

Nombre del entorno en el chart de Access Manager

La página de Helm de Access Manager añadió el nombre del entorno. El valor predeterminado del chart es development. Para cualquier entorno distinto de development, staging o local, expón Caradhras por https con un certificado de una autoridad de certificación pública. Luego apunta Auth e Identity a esa dirección https.
Streaming Hub

Rechazos de Streaming Hub v2.3.0

En Streaming Hub v2.3.0, un rechazo 401 o 403 es un documento de problema con el código unauthorized o forbidden. El hub responde 503 cuando Access Manager no devuelve un veredicto. Actualiza el manejo de errores de tu integración.
Lerian Console

Páginas de Lerian Console v2.6.0

Las páginas de la Console pasaron a corresponder a Lerian Console v2.6.0. La actualización añadió páginas para las instituciones de Reporter, las operaciones de TED IN, las rutas contables de TED JD y las devoluciones de Pix BTG, y cubrió los parámetros de reporte y el estado Partial failure. La actualización eliminó las páginas de Console de BC Correios. La Console muestra el client secret de una aplicación una vez, cuando creas la aplicación. Guárdalo en ese momento.
PixTED

JD Courier

La pestaña Interfaces y la Referencia de API añadieron JD Courier. JD Courier permite que dos o más motores de core bancario compartan un canal JD y un ISPB en SPB (TED) y en Pix. Se ejecuta en BYOC y en Lerian Cloud.
Midaz

Deuda de comisión en Midaz 4.2.0

En Midaz 4.2.0, la parte no pagada de una comisión diferible en una transacción directa /v2 puede convertirse en una deuda de comisión que los créditos /v2 siguientes liquidan, de la más antigua a la más reciente. La deuda de comisión está desactivada de forma predeterminada, y Valkey debe persistir sus claves.
Access Manager

Referencia de la API de Identity de Access Manager

La referencia de la API de Identity perdió las operaciones de socios, de catálogo de alcances y de tenants del usuario. La lista de errores de Access Manager añadió IDE-0038.
Consignado

Consignado v3.7.0

La referencia de la API de Consignado añadió una operación que lee el cadastro guardado con una averbação, y la referencia de eventos pasó a corresponder a lo que emite v3.7.0. En Lerian Consignado v3.7.0, el saldo devedor enviado a Dataprev es el valor presente de las cuotas impagas.
SPI

Variables de entorno de SPI

La página de variables de entorno de SPI quitó BACEN_SPI_SIGNING_KEY_FILE.
Para novedades más antiguas, explora el archivo completo por año en la sección Archivado.