Como integrar uma consulta de LEI da GLEIF ao onboarding empresarial
Uma empresa familiar do setor hoteleiro pede refinanciamento, e a solicitação volta da nova etapa de KYB com a indicação “LEI não emitido”. Você sabe que a empresa é cliente há anos, mas isso não aparece no registro. O gerente de relacionamento quer entender por que um cliente conhecido foi encaminhado para análise. Você abre o registro, confere os dados da empresa e volta ao motivo do encaminhamento. Para quem cuida do onboarding ou do crédito, é nesse momento que o status de um registro se cruza com uma decisão real de renovação, antes do próximo processamento em lote.
LEIs vencidos costumam pertencer a empresas ativas
Fizemos consultas à API da GLEIF em 30 de outubro de 2026. Quase todos os registros vencidos tinham status da entidade ACTIVE.
| status do registro | registros |
|---|---|
| todos os registros | 3,479,309 |
| ISSUED | 1,996,911 |
| LAPSED | 1,215,130 |
| RETIRED | 257,889 |
| DUPLICATE | 6,515 |
| ANNULLED | 1,795 |
| PENDING_TRANSFER | 638 |
| PENDING_ARCHIVAL | 431 |
| LAPSED, com status da entidade ACTIVE | 1,215,129 |
| status da entidade INACTIVE, qualquer status de registro | 257,472 |
Os dados por país mostram o mesmo problema no Reino Unido: há mais registros vencidos do que emitidos. Uma regra que encaminha para análise qualquer registro que não esteja como ISSUED pode colocar empresas em operação na fila por causa de uma renovação não feita.
| país | ISSUED | LAPSED |
|---|---|---|
| GB | 95,054 | 117,317 |
| ES | 105,819 | 78,294 |
| FR | 96,690 | 74,596 |
| IT | 173,586 | 67,789 |
| DE | 186,532 | 55,570 |
| NL | 129,760 | 46,488 |
| PL | 25,394 | 14,832 |
| CZ | 19,038 | 11,752 |
| IE | 22,972 | 11,440 |
O hotel encaminhado para análise tem registro LAPSED e status da entidade ACTIVE. A Companies House também informa que a empresa está ativa e indica que ela foi constituída em 1978. O status do registro, por si só, não permite concluir que a empresa encerrou as atividades.
O status do LEI e o da entidade respondem a perguntas diferentes
O status do registro descreve o cadastro do LEI. Já o status da entidade indica o que se sabe sobre o registro jurídico e as atividades da empresa.
ACTIVEsignifica que, no último relato ou atualização, a entidade informou que estava legalmente registrada e em operação.INACTIVEsignifica que foi constatado que a entidade não estava mais legalmente registrada, não estava mais em operação ou ambas as coisas. Encerramento, aquisição e fusão são alguns dos motivos possíveis.LAPSEDsignifica que o registro não foi renovado até a data prevista, sem indicação em fontes públicas de que a entidade tenha encerrado as atividades.RETIREDsignifica que a entidade encerrou as atividades e não se fundiu a outra entidade.ANNULLEDsignifica que o registro foi considerado incorreto ou inválido depois de emitido.
Para o hotel, o registro correspondente na Companies House informa que a empresa está ativa e indica a data de constituição.
Encontre um LEI pelo número de registro e pelo país
Pesquise pelo número de registro e pela jurisdição em conjunto, mantendo o número exatamente como aparece no registro, inclusive os zeros à esquerda. Em nossas consultas, o número da Companies House do hotel, junto com o código do país GB, encontrou o LEI. Ao remover o zero à esquerda, nenhum registro foi encontrado. Já a busca pelo número sem a jurisdição retornou mais de um resultado.
A API da GLEIF permite pesquisar dados de entidades jurídicas e de propriedade, incluindo relações entre controladoras e controladas. No Decisimo, configure uma fonte de dados para fazer uma solicitação GET e ler a resposta JSON no objeto de dados. O número de registro e o país podem vir da solicitação pelo fluxo de decisão.
Configure o cabeçalho Accept: application/vnd.api+json nas solicitações da fonte de dados, seguindo a documentação da fonte de dados. Com esse cabeçalho, uma consulta por um LEI desconhecido retornou um erro 404 em JSON, que a regra pode ler. Com Accept: */*, a resposta foi uma página HTML. Mapeie o erro 404 em JSON para o resultado “sem LEI registrado” e diferencie essa resposta de uma falha na chamada.
Encaminhe registros de LEI pelo status e pelo nome legal
Use uma tabela de decisão para transformar o registro retornado em um resultado. No exemplo abaixo, uma entidade informada como INACTIVE ou um registro com status RETIRED ou ANNULLED é encaminhado para análise humana. Um registro LAPSED de uma entidade ACTIVE segue adiante com um alerta de renovação, e uma divergência no nome é encaminhada para análise. Esses resultados são exemplos que um credor poderia definir, não uma política universal. Em uma solicitação de crédito empresarial, a política do credor determina como essas verificações afetam a decisão.
O exemplo está configurado para considerar a primeira linha correspondente. Por isso, a ordem das linhas determina qual condição gera um resultado.
| linha | condição | resultado |
|---|---|---|
| 1 | nenhum registro encontrado para o número de registro e o país | continue, LEI não registrado |
| 2 | status da entidade INACTIVE, ou registro RETIRED ou ANNULLED | refer: entidade informada como encerrada, incorporada por outra ou registro inválido |
| 3 | nome legal diferente do informado na solicitação | refer: divergência no nome |
| 4 | registro LAPSED e entidade ACTIVE | continue, sinalizar LEI vencido |
| 5 | qualquer valor | continue |
No caso do hotel, o status da entidade ACTIVE e o registro LAPSED levam à linha que mantém o processo em andamento e sinaliza a renovação, desde que o nome corresponda. O registro do LEI informa o nome legal MERTON HOUSE HOLIDAY HOTEL LIMITED. Compare esse nome com o nome legal informado na solicitação antes de tomar a decisão final.
Use o LEI da controladora final para agrupar a exposição
Use o LEI da controladora final como chave de grupo nas verificações de exposição. As relações de controle acrescentam informações sobre a estrutura societária ao registro de cada tomador, inclusive quando há uma controladora estrangeira por trás de uma empresa local.
Consulte a relação com a controladora no registro do LEI e mantenha o LEI da controladora final como chave de grupo. Se não houver uma controladora informada, mantenha esse campo sem valor. A verificação de exposição do grupo pode usar os LEIs retornados para agrupar tomadores relacionados.
O status e os dados da controladora podem mudar. Faça uma nova verificação da carteira em lote para identificar alterações em qualquer um desses campos. Depois, analise os registros cujo status ou chave de grupo mudou.
Aplique as verificações de LEI nos lotes de renovação
No próximo lote de renovação, use este procedimento na carteira:
- Encontre o registro pelo número e pelo país, mantendo o número exatamente como aparece no registro, inclusive os zeros à esquerda.
- Envie o cabeçalho Accept para JSON e mapeie um erro 404 em JSON para “sem LEI registrado”.
- Encaminhe para análise humana entidades com status
INACTIVEou registros com statusRETIREDouANNULLED. - Trate
LAPSEDem uma entidadeACTIVEcomo um alerta de renovação. - Compare o nome legal com o nome informado na solicitação.
- Consulte a controladora final e mantenha o LEI dela como chave de grupo para a exposição. Se não houver controladora informada, mantenha o campo sem valor.
- Faça uma nova verificação da carteira em lote para identificar alterações de status e de controladora.
Perguntas frequentes sobre consultas de LEI da GLEIF
A API da GLEIF exige uma chave ou uma conta?
As chamadas à API da GLEIF descritas aqui não exigiram chave nem conta. Envie a solicitação de consulta com o cabeçalho Accept para JSON.
O que significa um LEI com status LAPSED?
Significa que o registro não foi renovado até a data prevista e que as fontes públicas não indicaram que a entidade encerrou as atividades. Em nossas consultas, encontramos registros vencidos associados a entidades informadas como ativas. Trate LAPSED como um alerta de renovação e use o status da entidade para avaliar a situação informada sobre as atividades.
Como encontrar o LEI de uma empresa pelo número de registro?
Pesquise pelo número de registro junto com a jurisdição, mantendo o número exatamente como aparece no registro, inclusive os zeros à esquerda. Em nossas consultas, o número de registro e o país juntos retornaram o registro da empresa. Use os dois dados na busca.
Como encontrar a controladora de uma empresa pelo LEI?
Pesquise as relações de propriedade usando o LEI da empresa. A API da GLEIF permite consultar relações entre controladoras e controladas, e o LEI da controladora final pode ser usado como chave de grupo para a exposição.
O que a API da GLEIF retorna para um LEI inexistente?
Um LEI desconhecido retorna HTTP 404. Com Accept: application/vnd.api+json, nossa consulta retornou um erro em JSON. Mapeie essa resposta para “sem LEI registrado”.
Os dados da GLEIF são confiáveis o suficiente para tomar uma decisão?
Use esses dados como uma informação para apoiar a decisão, não como prova definitiva da identidade ou da exatidão atual dos dados. Os termos da GLEIF dizem que ela não garante que as informações sejam exatas, corretas ou atualizadas. Compare o nome legal com o informado na solicitação e consulte também as informações relevantes do registro.
Quanto tempo leva uma consulta à GLEIF?
Com base em nossas consultas, considere cerca de meio segundo por busca: cinco consultas por número de registro levaram de 0,48 a 0,62 segundos cada, e uma consulta por LEI levou 0,50 segundo. Meça o tempo de resposta na sua integração antes de definir expectativas para o fluxo da solicitação.