A API do GBRIS explicada: como as equipas de compliance e fintech acedem a 11 registos comerciais numa única chamada

Interfață GBRIS API pentru integrarea datelor companiilor și conformitate

Se a sua equipa verifica empresas em vários países, já conhece a rotina. Abre o Handelsregister alemão, pesquisa em italiano, navega num registo polaco que parece não ter sido redesenhado desde 2009 e, a dado momento, solicita um documento que chega como um PDF digitalizado numa língua que ninguém na sua equipa lê. Dois dias depois, tem metade das informações de que precisava.

Não é um problema de processo. É um problema de infraestrutura. E é para isso que a API do GBRIS foi criada.

O que é a API do GBRIS?

A API do GBRIS é uma interface unificada que oferece às equipas de compliance, plataformas fintech e profissionais jurídicos acesso programático a dados estruturados de pessoas coletivas provenientes de 11 registos comerciais, através de uma única integração.

Jurisdições atualmente suportadas: Alemanha, Reino Unido, França, Espanha, Dinamarca, Noruega, Suécia, Finlândia, Lituânia, Estónia e Índia, com novos registos a serem adicionados de forma contínua.

Em vez de criar e manter ligações separadas para cada registo nacional, o seu sistema envia um único pedido e recebe uma resposta normalizada e legível por máquina: nome da empresa, forma jurídica, estado de registo, morada, identificadores e documentos oficiais disponíveis.

Na prática: uma única chamada à API substitui o que anteriormente era um processo manual com vários separadores, vários idiomas e vários dias.

Para quem é?

A API do GBRIS foi concebida para equipas que gerem a verificação de empresas em grande escala:

Equipas de compliance e AML que realizam verificações KYC sobre contrapartes, clientes ou fornecedores em várias jurisdições

Plataformas fintech que precisam de verificar empresas no âmbito dos fluxos de integração de clientes (onboarding)

Equipas jurídicas e de M&A que realizam due diligence sobre entidades em vários países

Plataformas de procurement e B2B que precisam de validar fornecedores antes da celebração de contratos

Programadores de SaaS que criam ferramentas de compliance ou inteligência empresarial e necessitam de dados fiavéis sobre empresas como base

Se a verificação de uma empresa estrangeira implica atualmente uma pessoa, um browser e uma folha de cálculo, a API foi criada para o seu caso de uso.

Como as equipas a utilizam

Estes são os padrões de integração mais comuns que observamos na prática.

Pesquisa e verificação de entidades

Uma única chamada à API com o nome de uma empresa ou o número de registo devolve o registo canónico da pessoa coletiva: estado atual, morada registada e identificadores. Esta é a base para as verificações KYC, os fluxos de onboarding e a verificação de fornecedores – em qualquer situação em que seja necessário confirmar que uma empresa é real, está ativa e está corretamente identificada.

Enriquecimento de dados e sincronização com CRM

Uma vez que o esquema de resposta é consistente em todas as jurisdições suportadas, pode consultar a API periodicamente e escrever dados atualizados do registo (nome legal, morada, órgãos sociais, alterações de estado) diretamente no seu CRM ou ERP. Não é necessária lógica de análise específica por país. Os seus registos mantêm-se atualizados sem atualizações manuais.

Desduplicarão através de Persistent IDs

O GBRIS atribui um Persistent ID estável a cada pessoa coletiva do mundo real, mesmo quando essa entidade aparece com nomes ligeiramente diferentes em registos distintos ou tem inscrições em várias jurisdições. Pode cruzar os seus registos internos com estes IDs para encontrar e fundir duplicados de forma programática – algo que a correspondência de cadeias de carateres por si só não consegue fazer de forma fiavél.

Checkout B2B e preenchimento automático de formulários

Chame o endpoint de pesquisa enquanto um utilizador escreve o nome de uma empresa, apresente os resultados correspondentes diretamente no formulário e, após seleção, preencha automaticamente o nome legal, o número de IVA e a morada registada. Um pedido substitui a introdução manual e fornece-lhe uma contraparte verificada desde o início da transação.

Pesquisa transfronteiça de entidades

A parametrização country_code + query permite pesquisar em várias jurisdições através do mesmo endpoint. Útil para plataformas que precisam de identificar entidades em vários mercados sem criar e manter integrações separadas para cada registo nacional.

Solicitação de documentos através da API

Além dos dados de entidade, a API oferece acesso programático a documentos oficiais do registo: as mesmas certidões de constituição, relatórios anuais e outros depósitos disponíveis em gbris.com, mas solicitados e entregues inteiramente no seu fluxo de trabalho. Envie um pedido de documento através da API, receba uma notificação webhook quando o ficheiro estiver pronto e faça o download diretamente. Sem etapas manuais, sem e-mails, sem mudar de sistema. Para equipas que precisam de recolher e arquivar documentos oficiais em grande escala, isto elimina o último ponto de contacto manual restante no processo de verificação.

Como funciona

Pesquisa em jurisdições

O endpoint principal permite pesquisar qualquer pessoa coletiva pelo nome ou identificador de registo, com um filtro de país opcional. A resposta devolve tudo o que o GBRIS sabe sobre essa entidade num formato JSON limpo e consistente, independentemente do país em que a empresa está registada.

Uma pesquisa por uma GmbH alemã devolve a mesma estrutura de dados que uma pesquisa por uma OÜ estoniana ou uma SAS francesa. O seu sistema não precisa de saber nada sobre os formatos de registo locais. O GBRIS trata da conversão.

Entity Resolution: uma empresa, um registo

A mesma empresa pode aparecer com nomes ligeiramente diferentes em registos distintos, ou ter vários identificadores em múltiplas jurisdições. O GBRIS resolve-os num único perfil de entidade unificado e atribui-lhe um Persistent ID: uma referência estável que não muda mesmo quando os dados subjacentes do registo são atualizados.

Para os fluxos de trabalho de compliance, isto é importante. Não está a comparar cadeias de carateres. Está a acompanhar pessoas coletivas reais.

Solicitação de documentos – integrada

Além dos dados, a API permite solicitar diretamente documentos oficiais do registo (relatórios anuais, certidões de constituição e outros depósitos) sem sair do seu fluxo de trabalho. Quando um documento está pronto, um webhook notifica automaticamente o seu sistema e o ficheiro fica disponível para download através da API.

Sem pedidos manuais. Sem salas de espera. Sem PDFs que chegam por e-mail três dias depois.

Porque não integrar os registos diretamente?

É tecnicamente possível ligar-se diretamente a cada registo comercial nacional. Algumas empresas fazem-no. A contrapartida é significativa:

Cada registo tem o seu próprio método de autenticação, formato de dados e limites de taxa

As estruturas de dados variam consideravelmente: o que a Alemanha chama «Handelsregisternummer» não é o mesmo campo que a Itália chama «Codice fiscale»

Os registos ficam indisponíveis, alteram as suas APIs e atualizam esquemas sem aviso prévio

A cobertura de 11 jurisdições implica 11 integrações separadas para criar, testar e manter

A API do GBRIS absorve essa complexidade. Escreve a integração uma única vez contra uma interface estável e documentada, e a cobertura expande-se à medida que o GBRIS adiciona novas jurisdições.

Como é a resposta

Um registo de entidade típico da API inclui:

Nome e forma jurídica, normalizados com o sistema de classificação do GBRIS (por ex., de_gmbh para uma GmbH alemã, com todos os metadados)

Estado: se a empresa está ativa, dissolvida ou suspensa

Identificadores: códigos de registo com contexto sobre qual registo os emitiu e em que jurisdição

Moradas: morada jurídica registada e, quando disponível, morada operacional

Documentos disponíveis: uma lista de depósitos oficiais solicitáveis com preço e idioma indicados

Data de validação: quando o GBRIS verificou pela última vez o registo face ao registo de origem

Todos os campos seguem um esquema consistente em todas as jurisdições. Não é necessária análise personalizada por país.

Preços

O preço da API é simples: €0,02 por pedido. Sem taxa de configuração, sem subscrição, sem compromisso mínimo.

Isto é mais importante do que pode parecer. A maioria das APIs de dados de registos concorrentes inclui pelo menos um dos seguintes elementos: uma taxa de configuração inicial antes de ter efetuado uma única chamada; uma subscrição mensal que decorre independentemente de usar ou não a API; ou níveis de volume mínimo que o obrigam a pagar em excesso até que a sua utilização escale. Para equipas que estão a avaliar a API, a executar um piloto ou a operar com volumes variáveis, estas estruturas criam atrito antes de a integração ter provado o seu valor.

Com o GBRIS, o primeiro pedido custa o mesmo que o milésimo. Não paga pelo acesso. Paga pelos resultados.

Como começar

O acesso à API do GBRIS é feito através de bearer token. Os tokens são emitidos manualmente pela equipa do GBRIS. Para solicitar acesso, envie um e-mail para [email protected] com uma breve descrição do seu caso de uso previsto e dos volumes de pedidos esperados.

A documentação completa (incluindo o guia de início rápido, a referência de endpoints e a configuração de webhooks) está disponível em developers.gbris.com.

Para uma visão geral da API e dos preços, visite gbris.com/gbris-api.

Conclusão

A verificação transfronteiça de empresas sempre foi mais lenta e mais manual do que deveria ser. A API do GBRIS não simplifica os registos subjacentes. Torna-os irrelevantes para o seu fluxo de trabalho. Uma única integração. Dados normalizados. Documentos oficiais a pedido.

Para as equipas de compliance e fintech que verificam empresas em grande escala, não se trata de uma melhoria menor. É uma forma diferente de trabalhar.