> ## 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. # Novembro de 2026 > Atualizações da documentação publicadas em novembro de 2026, agrupadas pela ação necessária do cliente. Esta página agrupa as atualizações pela ação que elas exigem. Os filtros de produto mostram apenas as áreas que afetam sua integração. Veja [Novidades](https://docs.lerian.studio/pt/news/news.md) para as definições de impacto. ## Ação necessária *** **4 de novembro de 2026** ### [Readiness do Access Manager v3.17.0](https://docs.lerian.studio/pt/platform/access-manager/access-manager-environment-variables.md) O Access Manager disponibiliza a readiness em uma porta de saúde separada. Antes de atualizar, defina `HEALTH_PORT` para Auth e Identity e aponte as sondas de readiness para essa porta. **4 de novembro de 2026** ### [Originação no Lender v4.0.0](https://docs.lerian.studio/pt/products/lender/configuration-and-deploy.md) Durante a originação, o Lender encontra ou cadastra cada tomador como titular no CRM do Midaz. Antes de atualizar, cumpra os [pré-requisitos do Lender](https://docs.lerian.studio/pt/products/lender/lender-prerequisites.md). **4 de novembro de 2026** ### [Idempotência no Midaz Go SDK v6.5.0](https://docs.lerian.studio/pt/products/midaz/midaz-sdk-go.md) O Midaz Go SDK não gera mais uma chave de idempotência aleatória por padrão. Sem uma chave própria, o Midaz trata a criação de uma transação idêntica na janela de idempotência como repetição. Defina uma chave distinta para cada transação que pretende lançar. **4 de novembro de 2026** ### [Devoluções no Pix BTG v1.14.0](https://docs.lerian.studio/pt/interfaces/pix-btg/indirect-pix-refund-operations.md) Uma requisição de devolução no Pix BTG precisa de `X-Idempotency` ou `X-Return-End-To-End`. Adicione pelo menos um desses headers às requisições de devolução antes de atualizar. **4 de novembro de 2026** ### [Readiness do Pix JD v1.6.1](https://docs.lerian.studio/pt/interfaces/pix-jd/pix-jd-environment-variables.md) O Pix JD disponibiliza readiness e métricas em `HEALTH_PORT`. Antes de atualizar, aponte a sonda de readiness e a coleta de métricas para essa porta e defina uma chave global de produção em `LICENSE_KEY`. **4 de novembro de 2026** ### [Readiness do Reporter v4.8.0](https://docs.lerian.studio/pt/products/reporter/reporter-environment-variables.md) O Reporter disponibiliza readiness em `HEALTH_PORT`. Antes de atualizar, defina `HEALTH_PORT` e aponte as sondas de readiness para essa porta. **3 de novembro de 2026** ### [Licença e contabilização de portabilidade no Lerian Consignado 4.2.0](https://docs.lerian.studio/pt/rails/consignado/how-consignado-works.md) As páginas e a referência da API do Consignado foram atualizadas para o Lerian Consignado 4.2.0. O gateway exige uma [licença Lerian](https://docs.lerian.studio/pt/platform/licensing/license-manager.md) em todos os modos de deploy e não inicia sem ela. O `numero_ccb` aceita no máximo 20 caracteres. A operação de registro de cessão do banco foi removida, e o gateway registra a cessão a partir do fato de cessão da Lender. Uma [averbação por portabilidade](https://docs.lerian.studio/pt/reference/rails/consignado/averbar-consignado-portabilidade.md) aceita agora aguarda a documentação. Documente-a pelo [anexo da CCB](https://docs.lerian.studio/pt/reference/rails/consignado/attach-consignado-ccb.md), como uma averbação. Com o bloco de contabilização, que lista cada contrato de origem quitado em `origins[]`, a Lender registra o contrato quando a Dataprev confirma a documentação e o registro de situação dela mostra exatamente esses contratos de origem. Essa contabilização exige Lender 4.0.0 ou posterior; atualize o Lender antes do gateway 4.2.0. A exclusão da instituição de origem precisa acontecer antes, porque a Dataprev recusa uma averbação anterior com a regra `PT`. Seu back office lê os registros de repasse retidos no bloco `held` das expectativas de repasse e libera cada um com `POST /v1/consignado/reconciliation/held-repasses/{id}/release`. O gateway publica cinco novos tipos de evento. `consignado.refinanciamento.efetivado`, `consignado.refinanciamento.revertido` e `consignado.refinanciamento.recusado` informam os resultados de um refinanciamento. Com `DATAPREV_MIGRACAO_ENABLED` ligado, `consignado.migracao.efetivada` informa um contrato que a Dataprev moveu para um novo vínculo de emprego. `consignado.certificate.expiring` é publicado antes de o certificado da Dataprev vencer. A descoberta de leilão e de portabilidade roda para todo tenant com custódia Dataprev completa, e `LEILAO_TENANT_ID` foi removida. A renegociação automática foi removida: toda renegociação vem do seu pedido de renegociação. Antes de atualizar, defina `LICENSE_KEY` em toda carga de trabalho e libere HTTPS de saída para `https://license.lerian.io`. Atualize o Access Manager para a versão 3.14.0 ou posterior antes de um originador chamar uma rota sem id de originador. Depois que um tenant migrar, não volte o gateway para a 4.0.0. Ligue `DATAPREV_AVERBACAO_ENABLED` e defina `AVERBACAO_ARTIFACTS_BUCKET` se você envia averbações por portabilidade, ou a rota responde `501`. Um comando de trilho cujo resultado a Dataprev deixa desconhecido responde `503` `OUTCOME_UNKNOWN`. Não o envie de novo: a mesma chave responde `409` `RAIL_COMMAND_OUTCOME_UNRESOLVED`. Leia os [comandos de trilho](https://docs.lerian.studio/pt/reference/rails/consignado/list-consignado-rail-commands.md) e feche um refinanciamento, uma renegociação ou uma alteração de termos estacionados pelo que o portal da Dataprev mostra. Quando um `503` `DATAPREV_UNAVAILABLE` disser que o comando fechou recusado, envie-o de novo com uma nova chave `X-Idempotency`. Uma subscription que lista tipos de evento não recebe nenhum dos cinco novos. Para recebê-los, crie uma subscription para todo o tenant que liste as chaves deles, obtidas em `GET /v1/catalog`, como `consignado_migracao.efetivada`. Se a contabilização responder `422` `LOAN_PRODUCT_VERSION_UNKNOWN` para uma versão de produto na Lender criada antes do vínculo do gateway com seu tenant, crie uma nova versão. Se a versão acabou de ser criada, aguarde sua chegada e tente novamente. Um papel personalizado do Access Manager precisa de `rail-command-close:execute` para fechar um refinanciamento, uma renegociação ou uma alteração de termos estacionados e de `held-repasses-release:execute` para liberar um repasse retido. **2 de novembro de 2026** ### [Licença e respostas divididas do BACEN no Lerian SPB](https://docs.lerian.studio/pt/rails/spb/spb-environment-variables.md) As páginas e a referência de API do Lerian SPB passaram para a build mais nova do Lerian SPB. O Lerian SPB precisa de uma licença em todo ambiente, inclusive desenvolvimento, e não inicia sem ela. A licença é global: o trilho não lê nenhum identificador de organização. Uma licença recusada responde `403` com um código `LCS-` em toda rota sob `/v1/str`, e o `/readyz` reporta um check `license`. Quando uma resposta do BACEN dividida em partes ainda não tem uma parte 30 minutos depois da primeira, o trilho abre um caso de conciliação `PARTITIONED_MESSAGE_INCOMPLETE`. Antes de atualizar, defina `LICENSE_KEY` em toda carga de trabalho do Lerian SPB. Inclua os casos `PARTITIONED_MESSAGE_INCOMPLETE` na sua rotina de conciliação. **2 de novembro de 2026** ### [Licença e reenvio de um Pix que não saiu no Lerian SPI](https://docs.lerian.studio/pt/rails/spi/how-spi-works.md) As páginas e a referência de API do Lerian SPI passaram para a build mais nova do Lerian SPI. Todo binário do Lerian SPI precisa de uma licença para iniciar, em todo ambiente, e para quando a licença é recusada. Um pagamento Pix que terminou `FAILED` com `503` e `SPI-1001` ou `SPI-1004` pode ser enviado de novo. Envie a primeira requisição de novo com a mesma chave `X-Idempotency`, ou envie a mesma requisição com uma chave nova e o `endToEndId` do pagamento que falhou. O trilho envia como uma nova tentativa do mesmo pagamento e publica `spi_payment.initiated` de novo. Uma solicitação de aprovação aceita só o tipo de assunto `MANUAL_RESOLUTION`. Antes de atualizar, defina `LICENSE_KEY` em todo binário do Lerian SPI. Se um consumidor age sobre `spi_payment.failed`, deixe que ele aceite um `spi_payment.initiated` posterior para o mesmo pagamento. **2 de novembro de 2026** ### [Licença e conciliação do ciclo no Lerian SILOC](https://docs.lerian.studio/pt/rails/siloc/siloc-operations.md) As páginas e a referência de API do Lerian SILOC passaram para a build mais nova do Lerian SILOC. O Lerian SILOC precisa de uma licença em todo ambiente e não inicia sem ela. Uma requisição que a licença recusa responde `403` com um código `LCS-`. `GET /api/v1/siloc/cycles` e `GET /api/v1/siloc/cycles/{cycleId}` trazem a `reconciliation` do ciclo, e a leitura separada da conciliação do ciclo não existe mais. `GET /api/v1/siloc/ot-multilateral-results/{noticeId}` devolve o resultado multilateral que uma conciliação indica em `resultNoticeId`. Uma requisição `SLC0004` termina `REFUSED` quando a resposta `SLC0004R1` dela traz uma situação diferente de sucesso. Um `LTR0002` ou `LTR0008` em `DISPATCHED` cujo ciclo LBTR terminou sem `R1` fica retido aguardando resposta, e dois operadores podem fechá-lo. Antes de atualizar, defina `LICENSE_KEY` no Lerian SILOC. Leia a conciliação de um ciclo nas leituras do ciclo. Trate `REFUSED` nas suas requisições `SLC0004`. **2 de novembro de 2026** ### [Licença do Lerian SCR](https://docs.lerian.studio/pt/rails/scr/scr-environment-variables.md) As páginas e a referência de API do Lerian SCR passaram para a build mais nova do Lerian SCR. O Lerian SCR se recusa a iniciar sem uma licença Lerian, em todo ambiente, e nenhuma configuração desliga essa verificação. Um check `license` em down faz o `/readyz` responder `503`. Antes de atualizar, defina `LICENSE_KEY` no Lerian SCR. **2 de novembro de 2026** ### [Licença da instalação no TED Lerian](https://docs.lerian.studio/pt/interfaces/ted-lerian/ted-lerian-environment-variables.md) As páginas e a referência de API do TED Lerian passaram para a build mais nova do TED Lerian. O TED Lerian confere uma licença para a instalação inteira ao iniciar e a confere de novo em segundo plano. O serviço não inicia com `LICENSE_KEY` vazia, em nenhum ambiente, e para quando a licença é recusada. Ele não lê mais `LICENSE_ENABLED`, `LICENSE_APPLICATION_ID` nem `ORGANIZATION_IDS`. Defina `LICENSE_KEY` em toda carga de trabalho do TED Lerian e libere HTTPS de saída para `https://license.lerian.io`. Remova `LICENSE_ENABLED`, `LICENSE_APPLICATION_ID` e `ORGANIZATION_IDS`. **2 de novembro de 2026** ### [Liquidação intra-PSP e operações paradas no Pix BTG v1.13.0](https://docs.lerian.studio/pt/interfaces/pix-btg/indirect-pix-intra-psp.md) As páginas e a referência de API do Pix BTG passaram para a v1.13.0. Um Pix intra-PSP e sua devolução liquidam cada um em uma transação Midaz, sem perna `@external`. O plugin confere o recebedor primeiro, então um recebedor negado não gera débito. Um Pix para a própria conta do pagador é recusado com `PIX-0460`. Quando o resultado do débito Midaz de um cash-out é desconhecido, a chamada de processamento responde `201` com o cash-out em `CREATED`, e o plugin não envia o Pix. O desbloqueio recusa um cash-out ou uma devolução inter-PSP em `CREATED` com `422` `PIX-0470`. Cada notificação de webhook ao cliente traz uma `Idempotency-Key`, e uma notificação reenviada traz a mesma chave. Se você concilia ou gera relatórios a partir do ledger, leia um Pix intra-PSP como uma transação entre as duas contas. Para um cash-out ou uma devolução inter-PSP em `CREATED`, abra um chamado no suporte da Lerian e informe o id da transferência ou da devolução. Deduplique os webhooks ao cliente pela `Idempotency-Key`. **1 de novembro de 2026** ### [Ativação de certificado e fechamento por dois operadores no Lerian SPB](https://docs.lerian.studio/pt/rails/spb/spb-operations.md) As páginas e a referência de API do Lerian SPB passaram para a build mais nova do Lerian SPB. O trilho lê o código do certificador de uma ativação a partir do emissor do certificado, então a requisição de ativação não traz mais `certifierCode`, e um corpo que o envia responde `422`. Um certificado que você rotacionou antes desta versão não tem código do certificador registrado, e a ativação dele responde `SPB-0003`. Cada dia do demonstrativo de uma declaração de compulsório traz `mode`, `I` ou `A`. Dois operadores podem fechar como falha qualquer mensagem que passou do prazo de liquidação, e não apenas uma transferência, e podem declarar uma perna LDL ou LTR a partir de uma resposta do STR que o trilho reteve sem ler. O trilho agora fecha uma perna LDL ou LTR que nunca enviou quando a grade do STR dela fecha ou o dia termina. Antes de ativar um certificado que você rotacionou antes desta versão, rotacione-o de novo. Remova `certifierCode` das suas requisições de ativação. Envie `mode` em cada dia de uma declaração de compulsório. **1 de novembro de 2026** ### [Respostas do Pix Automático e bloqueios de consulta DICT no Lerian SPI](https://docs.lerian.studio/pt/rails/spi/how-spi-works.md) As requisições `pain.014`, `camt.029` e `camt.055` do Pix Automático do Lerian SPI aceitam apenas a decisão. O rail lê os participantes e os identificadores da mensagem que registrou, e qualquer outro campo recebe `422`. O bloqueio de consulta DICT recebe e devolve `payerId`, o CPF ou CNPJ do usuário final, no lugar de `payerIdHash`. Ao atualizar, todo bloqueio de consulta DICT é removido. Envie apenas os campos da decisão nessas três requisições. Depois de atualizar, registre de novo cada bloqueio de consulta DICT com `payerId`. **1 de novembro de 2026** ### [Requisições retidas e ciclo LBTR no Lerian SILOC](https://docs.lerian.studio/pt/rails/siloc/how-siloc-works.md) As páginas e a referência de API do Lerian SILOC passaram para a build mais nova do Lerian SILOC. Dois operadores diferentes agora podem encerrar uma requisição de saída retida à espera de uma resposta que a Núclea nunca enviou. `GET /api/v1/siloc/outbound/messages` aceita `held=true` para listar essas requisições. Uma requisição `FAILED` pode, portanto, ser uma que a Núclea talvez tenha recebido, e o evento `studio.lerian.br-siloc.siloc_outbound.failed` dela traz o motivo. Um `LTR0002` ou `LTR0008` para uma operação cuja resposta anterior está ativa responde `409` e `SILOC-0026`. Um `503` e `SILOC-0002` agora significa que o comando não executou. Não trate uma requisição `FAILED` como prova de que ela nunca chegou à Núclea. Liste as requisições retidas. Peça a dois operadores que encerrem uma somente depois de confirmar com a Núclea que ela não vai responder. Trate `SILOC-0026` na sua integração. Envie de novo, com a mesma chave `X-Idempotency`, uma requisição recusada com `SILOC-0002`. **1 de novembro de 2026** ### [Erros de devolução e fechamento do dia no TED Lerian](https://docs.lerian.studio/pt/reference/interfaces/ted-lerian/ted-lerian-error-list.md) As páginas e a referência de API do TED Lerian passaram para a build mais nova do TED Lerian. Nas duas ações de devolução de TED recebida, `TED-1011` é um HTTP `422`. Uma devolução cuja resposta do trilho é desconhecida (`TED-1010`) continua solicitada até que a conciliação ou a revisão manual a feche. Quando o ledger recusa um estorno (`TED-1001`), o crédito permanece e a transferência recebida vai para revisão manual. No fechamento do dia, uma TED pendente que o trilho não conhece passa para `AWAITING_RECONCILIATION`. Os eventos de devolução de TED recebida trazem `previousStatus`. Trate `TED-1011` como `422` nas ações de devolução. Depois de um `TED-1010` em uma devolução, leia o status da TED antes de agir de novo. Aceite `AWAITING_RECONCILIATION` para uma TED pendente. ## Revisão recomendada *** **4 de novembro de 2026** ### [Provedor Pix JD do Flowker v1.5.0](https://docs.lerian.studio/pt/products/flowker/integration-guide.md) O Flowker v1.5.0 inclui o provedor nativo `pix-jd` para nós de workflow. Leia o guia de integração para configurar o provedor. **4 de novembro de 2026** ### [Lender no Lerian Console](https://docs.lerian.studio/pt/products/lender/console/lender-module.md) O módulo Lender no Lerian Console oferece telas para operações de crédito. Um administrador pode ativá-lo em Configurações, Produtos. O módulo requer Lender v4.0.0. **4 de novembro de 2026** ### [Boletos híbridos no Payments BTG v1.2.0](https://docs.lerian.studio/pt/interfaces/payments-btg/boleto-and-bill-payment.md) Um boleto híbrido também pode ser pago por Pix. Antes de emitir um, configure a chave Pix e o endereço do recebedor. **4 de novembro de 2026** ### [Limite diário do Pix Automático](https://docs.lerian.studio/pt/interfaces/pix-lerian/pix-lerian-pix-automatico.md) A Lerian configura um limite diário para pagadores pessoas físicas com CPF mediante solicitação pelo [Lerian Clients](https://clients.lerian.studio). Se nenhum limite for configurado, não há limite diário. **1 de novembro de 2026** ### [Access Manager v3.15.0: cadastre um método de MFA exigido durante a entrada](https://docs.lerian.studio/pt/platform/access-manager/features/mfa/api.md#enroll-a-required-method) No Access Manager v3.15.0, quando a organização exige um método de MFA que um usuário não cadastrou, a entrada responde `AUT-0019` com um token de MFA válido apenas para a adesão. O usuário configura e confirma o método com [Iniciar adesão à MFA](https://docs.lerian.studio/pt/reference/platform/access-manager/start-enrolling-a-required-mfa-factor.md) e [Confirmar adesão à MFA](https://docs.lerian.studio/pt/reference/platform/access-manager/confirm-an-mfa-enrollment-and-continue-the-login.md) e, depois, conclui o desafio de MFA. Trate `AUT-0019` em Solicitar token de acesso e em Verificar login por MFA. **1 de novembro de 2026** ### [Rotas de operação opcionais e arredondamento de tarifas no Console v3.0.0](https://docs.lerian.studio/pt/products/midaz/console/managing-accounting-routes#required-and-optional-operation-routes) As páginas do Console passaram para o Console v3.0.0. Uma rota contábil pode marcar uma rota de operação como opcional, e uma transação pode deixar uma rota opcional sem uso. O Console verifica a rota em **Go to Review** e de novo quando você envia. Um pacote de tarifas pode arredondar todas as tarifas que ele cobra, com o Midaz 4.4.0 ou posterior. A maioria das telas mostra datas e horas no horário de Brasília, qualquer que seja o fuso do navegador. As telas do Reporter agrupam os documentos regulatórios em **Regulatórios**: **Catálogo**, **Meus regulatórios** e **Entregas**. Revise suas rotas contábeis e marque como opcional cada rota de operação que algumas transações deixam sem uso. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.