> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Noviembre de 2026 > Actualizaciones de documentación publicadas en noviembre de 2026, agrupadas por acción requerida del cliente. Esta página agrupa las novedades por la acción que requieren. Los filtros de producto muestran solo las áreas que afectan tu integración. Consulta [Novedades](https://docs.lerian.studio/es/news/news.md) para ver las definiciones de impacto. ## Acción requerida *** **13 de noviembre de 2026** ### [Las sondas y las métricas de TED JD v3.6.0 pasan al puerto de health](https://docs.lerian.studio/es/interfaces/ted-jd/ted-environment-variables.md) TED JD v3.6.0 sirve la sonda de preparación, la sonda de vida y las métricas de Prometheus en el puerto de health, que defines con `HEALTH_PORT`. De las sondas, el puerto de la API conserva solo `/health` y `/version`, y se abre únicamente después de que se acepta la licencia. `BTF_METRICS_PROMETHEUS_ADDRESS` ya no se lee: con `BTF_METRICS_PROMETHEUS_ENABLED`, `/metrics` está en el puerto de health. TED JD también puede funcionar con un archivo de licencia firmado que montas con `LICENSE_FILE_PATH`, sin llamar al servicio de licencias. Si el servicio de licencias no responde al arrancar, TED JD sigue activo, no listo, y reintenta. **Acción requerida:** define `HEALTH_PORT` y apunta a él la sonda de preparación, la sonda de vida o la recolección de métricas que configuraste a mano, con `/readyz` para la preparación y `/health` para la vida. Una sonda de preparación en el puerto 8080 para `/readyz` deja el pod no listo. Una sonda de vida que siga en el puerto 8080 para `/health/live` también falla, y el kubelet reinicia el pod. Mantén el puerto de health accesible solo desde la red del clúster. **11 de noviembre de 2026** ### [Los eventos de Reporter pasan al Streaming Hub](https://docs.lerian.studio/es/products/reporter/reporter-events.md) Desde Reporter 4.10.0, RabbitMQ lleva solo la cola interna de informes. Reporter publica todo evento de negocio en Kafka, y lo recibes por una suscripción del Streaming Hub. El exchange de eventos y `RABBITMQ_REPORT_EVENTS_EXCHANGE` dejan de existir. El `ce-id` de todo evento de Reporter pasa a ser también un UUIDv7 derivado del hecho, incluidos `deadline.delivered`, `deadline.delivery_reverted`, `deadline.due`, `deadline.generation_failed`, `regulatory.filing_approved` y `regulatory.version_adopted`. El manifiesto de eventos también pasó de `GET /v1/streaming/events` a `GET /v1/streaming/manifest`, la ruta que lee el Streaming Hub. Un cliente que llama a la ruta antigua recibe 404. **Acción requerida:** crea una suscripción del Streaming Hub antes de actualizar a Reporter 4.10.0 y mantén activo el consumidor del exchange de eventos de Reporter hasta que termine la actualización. El Hub entrega eventos de Reporter desde la 4.10.0, y un consumidor vinculado al exchange deja de recibir eventos tras la actualización. Deduplica por el id de evento del Hub (`X-Lerian-Event-Id` en webhook, `ceId` en pull) y lee el id del evento en lugar de reconstruirlo. **10 de noviembre de 2026** ### [Lerian Console v3.3.0: subscriptions de Streaming Hub, pago de cuentas y pantallas de Lender](https://docs.lerian.studio/es/platform/streaming-hub/streaming-hub-in-lerian-console.md) 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. **10 de noviembre de 2026** ### [La entrada de uso de límite de Tracer muestra el alcance usado](https://docs.lerian.studio/es/products/tracer/spending-limits.md) 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. **10 de noviembre de 2026** ### [Caradhras: archivo de licencia y preparación](https://docs.lerian.studio/es/platform/access-manager/what-is-caradhras.md) 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. **9 de noviembre de 2026** ### [Access Manager v3.20.0: archivo de licencia y preparación](https://docs.lerian.studio/es/platform/access-manager/access-manager-environment-variables.md) 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`. **8 de noviembre de 2026** ### [Licencia de TED Lerian en memoria](https://docs.lerian.studio/es/interfaces/ted-lerian/ted-lerian-environment-variables.md) 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. **8 de noviembre de 2026** ### [Lender v4.1.0: productos archivados, mesas y plan de cuentas](https://docs.lerian.studio/es/products/lender/define-a-loan-product.md#archive-a-product) 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](https://docs.lerian.studio/es/products/lender/lender-quick-start.md) 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. **8 de noviembre de 2026** ### [Pix BTG v1.15.0: archivo de licencia y resultado no registrado](https://docs.lerian.studio/es/reference/interfaces/pix-btg/indirect-pix-error-list.md) 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](https://docs.lerian.studio/es/interfaces/pix-btg/indirect-pix-environment-variables.md). 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. **8 de noviembre de 2026** ### [Access Manager rechaza un permiso de socio que ninguna solicitud puede usar](https://docs.lerian.studio/es/platform/access-manager/features/partners/overview) 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. **7 de noviembre de 2026** ### [Clave de licencia de Lerian Console v3.2.0](https://docs.lerian.studio/es/platform/console/console-environment-variables.md) 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. **7 de noviembre de 2026** ### [Puerto de salud y suscripciones de socios de Lerian Consignado 4.4.0](https://docs.lerian.studio/es/rails/consignado/how-consignado-works.md) 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`. **7 de noviembre de 2026** ### [Devoluciones MED en Pix BTG v1.14.1](https://docs.lerian.studio/es/interfaces/pix-btg/indirect-pix-med-2-funds-recovery.md) 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. **7 de noviembre de 2026** ### [Puerto de salud e ISPBs sin vínculo en TED Lerian](https://docs.lerian.studio/es/interfaces/ted-lerian/ted-lerian-environment-variables.md) 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. **7 de noviembre de 2026** ### [Verificación de límite, licencia y puerto de salud de Tracer](https://docs.lerian.studio/es/products/tracer/integration-guide.md) 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. **7 de noviembre de 2026** ### [Rutas de webhook y ejecuciones de Flowker v1.6.0](https://docs.lerian.studio/es/products/flowker/configuring-a-webhook-trigger.md) 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. **7 de noviembre de 2026** ### [Tenant en las entregas y pérdida por retención en Streaming Hub v3.2.0](https://docs.lerian.studio/es/platform/streaming-hub/consuming-events.md) 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. **4 de noviembre de 2026** ### [Readiness de Access Manager v3.17.0](https://docs.lerian.studio/es/platform/access-manager/access-manager-environment-variables.md) 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. **4 de noviembre de 2026** ### [Originación en Lender v4.0.0](https://docs.lerian.studio/es/products/lender/configuration-and-deploy.md) 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](https://docs.lerian.studio/es/products/lender/lender-prerequisites.md). **4 de noviembre de 2026** ### [Idempotencia en Midaz Go SDK v6.5.0](https://docs.lerian.studio/es/products/midaz/midaz-sdk-go.md) 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. **4 de noviembre de 2026** ### [Devoluciones en Pix BTG v1.14.0](https://docs.lerian.studio/es/interfaces/pix-btg/indirect-pix-refund-operations.md) 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. **4 de noviembre de 2026** ### [Readiness de Pix JD v1.6.1](https://docs.lerian.studio/es/interfaces/pix-jd/pix-jd-environment-variables.md) 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`. **4 de noviembre de 2026** ### [Readiness de Reporter v4.8.0](https://docs.lerian.studio/es/products/reporter/reporter-environment-variables.md) Reporter ofrece readiness en `HEALTH_PORT`. Antes de actualizar, define `HEALTH_PORT` y apunta las sondas de readiness a ese puerto. **3 de noviembre de 2026** ### [Licencia y contabilización de portabilidad en Lerian Consignado 4.2.0](https://docs.lerian.studio/es/rails/consignado/how-consignado-works.md) 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](https://docs.lerian.studio/es/platform/licensing/license-manager.md) 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](https://docs.lerian.studio/es/reference/rails/consignado/averbar-consignado-portabilidade.md) aceptada ahora espera su documentación. Documéntala con el [anexo de la CCB](https://docs.lerian.studio/es/reference/rails/consignado/attach-consignado-ccb.md), 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](https://docs.lerian.studio/es/reference/rails/consignado/list-consignado-rail-commands.md) 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. **3 de noviembre de 2026** ### [Límites de gasto de Tracer consumidos solo a través del ledger de Midaz](https://docs.lerian.studio/es/products/tracer/integration-guide.md) 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. **2 de noviembre de 2026** ### [Licencia y respuestas divididas del BACEN en Lerian SPB](https://docs.lerian.studio/es/rails/spb/spb-environment-variables.md) 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. **2 de noviembre de 2026** ### [Licencia y reenvío de un Pix que no salió en Lerian SPI](https://docs.lerian.studio/es/rails/spi/how-spi-works.md) 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. **2 de noviembre de 2026** ### [Licencia y conciliación del ciclo en Lerian SILOC](https://docs.lerian.studio/es/rails/siloc/siloc-operations.md) 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`. **2 de noviembre de 2026** ### [Licencia de Lerian SCR](https://docs.lerian.studio/es/rails/scr/scr-environment-variables.md) 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. **2 de noviembre de 2026** ### [Licencia de la instalación en TED Lerian](https://docs.lerian.studio/es/interfaces/ted-lerian/ted-lerian-environment-variables.md) 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`. **2 de noviembre de 2026** ### [Liquidación intra-PSP y operaciones detenidas en Pix BTG v1.13.0](https://docs.lerian.studio/es/interfaces/pix-btg/indirect-pix-intra-psp.md) 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`. **1 de noviembre de 2026** ### [Activación de certificado y cierre por dos operadores en Lerian SPB](https://docs.lerian.studio/es/rails/spb/spb-operations.md) 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. **1 de noviembre de 2026** ### [Respuestas de Pix Automático y bloqueos de consulta DICT en Lerian SPI](https://docs.lerian.studio/es/rails/spi/how-spi-works.md) 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`. **1 de noviembre de 2026** ### [Solicitudes retenidas y ciclo LBTR en Lerian SILOC](https://docs.lerian.studio/es/rails/siloc/how-siloc-works.md) 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`. **1 de noviembre de 2026** ### [Errores de devolución y cierre del día en TED Lerian](https://docs.lerian.studio/es/reference/interfaces/ted-lerian/ted-lerian-error-list.md) 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. ## Revisión recomendada *** **13 de noviembre de 2026** ### [TED Lerian verifica transferencias con tu socio antifraude](https://docs.lerian.studio/es/interfaces/ted-lerian/ted-lerian-antifraud.md) TED Lerian ahora puede consultar a tu socio antifraude sobre TED enviados, transferencias internas y TED recibidos antes de que el dinero se mueva. Cada verificación viene desactivada por defecto, y la activas para cada flujo en la configuración de runtime. Cuando el socio pide una revisión, una transferencia enviada espera en el nuevo estado `FRAUD_ANALYSIS`. El socio la decide mediante una nueva operación de la API, y puedes cancelarla mientras espera. Cuando termina el plazo de la revisión, TED Lerian la rechaza. En una transferencia interna, un rechazo del ledger en la retención del pagador también la rechaza. Un TED recibido que el socio pide revisar espera en revisión manual. Cuando el socio rechaza un TED recibido, TED Lerian lo devuelve al remitente con el motivo `9`. Las lecturas de transferencia y los eventos muestran la respuesta del socio como `fraudCheck`, y un nuevo evento `transfer.fraud_analysis` marca el inicio de una revisión. Cuando Tracer niega un TED en el ledger, TED Lerian lo rechaza con `TED-1001` y libera el límite de uso. Un vínculo de ISPB ahora puede apuntar a cualquier ledger de tu organización, y TED Lerian ya no lee `SYSTEMPLANE_ENABLED` ni `MIDAZ_LEDGER_ID`. Antes de activar una, lee la página y trata `FRAUD_ANALYSIS` en cualquier código que lea los estados de transferencia. **13 de noviembre de 2026** ### [Tracer no verifica las transacciones de tarifa que Midaz registra por sí solo](https://docs.lerian.studio/es/products/tracer/integration-guide.md) Una transacción de tarifa que Midaz registra por sí solo, como el cobro de una comisión de servicio de un plan de tarifas, no hace llamada a Tracer. Tus reglas y tus límites de gasto no la ven. Comprueba que tus límites de gasto no esperen esas transacciones de tarifa en sus contadores. **13 de noviembre de 2026** ### [Lerian Consignado 4.6.0: recibos y un registro de fondos por tenant](https://docs.lerian.studio/es/rails/consignado/how-consignado-works.md) Las páginas y la referencia de API de Consignado pasaron a Lerian Consignado 4.6.0. El gateway puede generar un recibo en PDF de cada averbação confirmada y servirlo como el documento `averbacao_receipt`, junto a la CCB firmada. El job viene apagado: enciéndelo con `CONSIGNADO_AVERBACAO_RECEIPT_ENABLED`. La confirmación de desembolso puede llevar un recibo en PDF del pago, y `GET /v1/consignado/disbursement-confirmations/{confirmation_id}/receipt` lo devuelve. Cada tenant ahora lee un solo registro de fondos: los fondos registrados en el gateway (el valor por defecto) o los fondos que Lender publica, definido con `FUND_REGISTRY_OWNER_BY_TENANT`. Con el registro del gateway, una averbação que nombra un fondo que solo Lender publica responde `FUNDO_NOT_REGISTERED`. Un tenant cuyo registro pertenece a Lender rechaza la escritura de fondos con `409` `FUNDO_REGISTRY_OWNED_BY_CORE`. [El estado de un contrato](https://docs.lerian.studio/es/reference/rails/consignado/get-whether-a-consignado-contract-is-still-alive-under-the-tenant.md) informa que un contrato que una renegociación reemplazó salió (`renegociacao`). Hechos nuevos: `consignado.refinanciamento_externo.revertido` y `dataprev_success_code` en los resultados de renegociación y refinanciamiento. La lectura de suscripciones muestra la salud de la entrega. `GET /v1/consignado/rail-commands` ya no filtra por `numero_contrato`. Para hallar un comando del riel detenido en `outcome_unknown` y su id, pagina la lista con `command` y `status` y elige la fila cuyo `numero_contrato` coincide. Revisa toda llamada que lista comandos del riel por número de contrato. **13 de noviembre de 2026** ### [Payments BTG v1.4.0: socios](https://docs.lerian.studio/es/platform/access-manager/features/partners/payments-btg.md) Payments BTG v1.4.0 acepta socios de Access Manager. Puedes dar a un cliente tuyo una credencial propia de Payments, limitada a una sola organización de Midaz, que él nombra en el header `X-Organization-Id`. El socio emite, lee y cancela boletos, paga cuentas y DARF, y lee los dashboards de esa organización. Nunca alcanza las rutas administrativas ni la cancelación de un pago. Para usarlo, sigue [Socios en Payments BTG](https://docs.lerian.studio/es/platform/access-manager/features/partners/payments-btg.md): la página muestra los pasos y los rechazos que recibe el socio. **13 de noviembre de 2026** ### [Lerian Console v3.5.0: aperturas de contrato, ciclo de vida del fondo y deshacer en el constructor](https://docs.lerian.studio/es/products/lender/console/credit.md) Lerian Console v3.5.0 añade **Contract openings** en Crédito. Validas un lote de contratos que ya están en curso en una fecha de corte, convertidos de otro sistema o adquiridos de un cedente, y luego lo cargas desde un archivo JSON. Cargar exige el rol admin. Puedes suspender, reactivar y cerrar fondos cesionarios, y leer los contratos candidatos de un fondo. La mesa de cesión lista las cuotas que un prestatario pagó antes de una venta directa y que se deben al fondo. Paga al fondo fuera de Lender y usa **Mark settled** en cada una. También lista las cuotas cerradas en la mesa, y **End collection** declara que terminó el cobro del resto dado de baja de una. El módulo Consignado añade una tarjeta **Contract documents** con la CCB firmada y sus correcciones. Las pantallas de crédito añaden solicitudes de flujo libre, el día del dinero de una CCB y el índice y las fijaciones de un contrato posfijado. El constructor de workflows de Flowker añade **Undo** y **Redo**. El diálogo de generación de Reporter dice qué hacer a continuación para una presentación original o de sustitución. Da el rol admin a quien carga aperturas de contrato. Cerrar un fondo es permanente, así que usa **Suspend fund** para pausar uno. **13 de noviembre de 2026** ### [Lender v4.3.0 aperturas de contrato, fijación del CDI y ciclo de vida del fondo](https://docs.lerian.studio/es/products/lender/brazil-regulatory-pack.md) Lender v4.3.0 carga contratos que ya están en curso en una fecha de corte: tú compruebas un lote con una ejecución de prueba y luego cargas hasta 500 contratos. Cada contrato abre con el número de la CCB original, el flujo restante, los saldos y el estado regulatorio. Un contrato indexado al CDI entra por esa carga: Lender fija cada cuota cerrada en el CDI publicado, reparte la diferencia entre las cuotas restantes y emite `loan_schedule.index_fixed`. Una solicitud puede llevar su propio fin de devengo para cada cuota cuando su versión admite `freeFlow`. Un contrato de crédito directo puede venderse a un fondo cuando su versión admite cesión. Un fondo tiene un estado, `active`, `suspended` o `closed`, lo editas por ID, y registrar un identificador fiscal que el tenant ya tiene se rechaza con `409` `LENDER-1510`. Lender puede emitir la CCB de un contrato directo liberado que no tiene CCB firmada, cuando su primera liberación fue el valor aprobado completo y su cronograma no cambió, y `moneyDay` define el día en que se mueve el dinero. La mesa puede declarar el fin del cobro de una cuota retenida que ella cerró. La vista previa del cronograma recibe la tasa mensual en `monthlyInterestRate`, y el descriptor de crédito muestra la tasa anual efectiva en `annualRate`. Lee los lotes de apertura de contratos en el paquete regulatorio de Brasil antes de cargar un lote y define `admitsAssignment` en una versión cuando sus contratos vayan a un fondo. **11 de noviembre de 2026** ### [Lerian Console v3.4.0: cambios, pausa y reanudación de suscripciones de Streaming Hub, pantallas de Lender y búsqueda en Flowker](https://docs.lerian.studio/es/platform/streaming-hub/streaming-hub-in-lerian-console.md) 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. **11 de noviembre de 2026** ### [Lerian Consignado 4.5.0: estado del contrato, documentos retenidos y control de suscripciones](https://docs.lerian.studio/es/rails/consignado/how-consignado-works.md) 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](https://docs.lerian.studio/es/reference/rails/consignado/get-whether-a-consignado-contract-is-still-alive-under-the-tenant.md) indica si sigue vivo, cómo llegó (`averbacao`, `refinanciamento`, `renegociacao` o `importacao`) y por qué salió. [La lista de documentos retenidos](https://docs.lerian.studio/es/reference/rails/consignado/list-a-consignado-contracts-retained-artifacts.md) 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. **11 de noviembre de 2026** ### [Streaming Hub v3.4.0 edición, pausa y reanudación de suscripciones](https://docs.lerian.studio/es/platform/streaming-hub/managing-subscriptions.md#editing-a-subscription) 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. **11 de noviembre de 2026** ### [Lender v4.2.0 garantías, registro en cualquier registradora y nuevos cronogramas](https://docs.lerian.studio/es/products/lender/lender-rest-api.md) 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. **11 de noviembre de 2026** ### [Plugin SISBAJUD v1.3.0 conexión con Midaz y puerto de salud](https://docs.lerian.studio/es/interfaces/plugin-sisbajud/plugin-sisbajud-environment-variables.md) 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`. **11 de noviembre de 2026** ### [Lerian SISBAJUD Mensageria v1.2.0 campos de decisión LGPD y origen de Cabine](https://docs.lerian.studio/es/rails/sisbajud/sisbajud-environment-variables.md) 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. **11 de noviembre de 2026** ### [Los eventos de TED Lerian traen un `ce-id` estable](https://docs.lerian.studio/es/interfaces/ted-lerian/ted-lerian-events) 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. **10 de noviembre de 2026** ### [TED Lerian publica sus permisos en el Access Manager](https://docs.lerian.studio/es/interfaces/ted-lerian/ted-lerian-environment-variables.md) 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`. **9 de noviembre de 2026** ### [Lerian Cabine muestra a los operadores de STR y SILOC solo lo que pueden usar](https://docs.lerian.studio/es/rails/cabine/cabine-access-and-roles.md#roles-on-lerian-spb-and-lerian-siloc) 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](https://docs.lerian.studio/es/rails/spb/spb-cabine.md#permissions-by-control) y de [SILOC](https://docs.lerian.studio/es/rails/siloc/siloc-cabine.md#permissions-by-control) 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. **8 de noviembre de 2026** ### [Payments BTG v1.3.0: historial de la clave Pix](https://docs.lerian.studio/es/interfaces/payments-btg/boleto-and-bill-payment.md) 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. **8 de noviembre de 2026** ### [Streaming Hub v3.3.0: estado de las entregas en las suscripciones](https://docs.lerian.studio/es/platform/streaming-hub/managing-subscriptions.md) 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. **7 de noviembre de 2026** ### [Presubasta entre originadores en Lerian Consignado](https://docs.lerian.studio/es/rails/consignado/how-consignado-works.md#pre-auction-between-originadores) 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. **7 de noviembre de 2026** ### [Pix programado en Pix Lerian v1.3.0](https://docs.lerian.studio/es/interfaces/pix-lerian/pix-lerian-spi.md) 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. **7 de noviembre de 2026** ### [Clave HSM y códigos de resolución de QR en Lerian SPI](https://docs.lerian.studio/es/rails/spi/spi-environment-variables.md) 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. **7 de noviembre de 2026** ### [Reembolsos de TED OUT devuelta en TED JD v3.5.1](https://docs.lerian.studio/es/interfaces/ted-jd/ted-out.md) 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. **7 de noviembre de 2026** ### [Finalidad del resgate en Lerian SPB y permisos de Lerian Cabine](https://docs.lerian.studio/es/rails/spb/how-spb-works.md) 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. **7 de noviembre de 2026** ### [Envíos retenidos y credenciales rechazadas en Lerian STA v1.3.0](https://docs.lerian.studio/es/rails/sta/how-sta-works.md) 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. **7 de noviembre de 2026** ### [Eventos de Lerian BC Correios v1.1.0](https://docs.lerian.studio/es/reference/events/bc-correios.md) 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`. **7 de noviembre de 2026** ### [Executor de Lerian SISBAJUD v1.2.0](https://docs.lerian.studio/es/interfaces/plugin-sisbajud/plugin-sisbajud-how-it-works.md) 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. **7 de noviembre de 2026** ### [Origen de la validación y almacenamiento de la licencia en Tracer](https://docs.lerian.studio/es/products/tracer/reviewing-a-denied-transaction.md) 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. **4 de noviembre de 2026** ### [Proveedor Pix JD de Flowker v1.5.0](https://docs.lerian.studio/es/products/flowker/integration-guide.md) 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. **4 de noviembre de 2026** ### [Lender en Lerian Console](https://docs.lerian.studio/es/products/lender/console/lender-module.md) 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. **4 de noviembre de 2026** ### [Boletos híbridos en Payments BTG v1.2.0](https://docs.lerian.studio/es/interfaces/payments-btg/boleto-and-bill-payment.md) 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. **4 de noviembre de 2026** ### [Límite diario de Pix Automático](https://docs.lerian.studio/es/interfaces/pix-lerian/pix-lerian-pix-automatico.md) Lerian configura un límite diario para pagadores personas físicas con CPF a pedido por [Lerian Clients](https://clients.lerian.studio). Si no se configura un límite, no se aplica ningún límite diario. **1 de noviembre de 2026** ### [Access Manager v3.15.0: inscribe un método MFA exigido durante el inicio de sesión](https://docs.lerian.studio/es/platform/access-manager/features/mfa/api.md#enroll-a-required-method) 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](https://docs.lerian.studio/es/reference/platform/access-manager/start-enrolling-a-required-mfa-factor.md) y [Confirmar inscripción en MFA](https://docs.lerian.studio/es/reference/platform/access-manager/confirm-an-mfa-enrollment-and-continue-the-login.md) y, después, completa el desafío MFA. Trata `AUT-0019` en Solicitar token de acceso y en Verificar inicio de sesión MFA. **1 de noviembre de 2026** ### [Rutas de operación opcionales y redondeo de comisiones en Console v3.0.0](https://docs.lerian.studio/es/products/midaz/console/managing-accounting-routes#required-and-optional-operation-routes) 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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.