n8n
Dados de empresas em workflows, sem código.
Com o node do n8n, você traz dados de empresas para os seus workflows sem código. O node é verificado pelo n8n e chama a mesma API que o seu próprio software.
Instalar o node
Você instala nodes verificados direto do editor. Só o owner ou um admin da instância n8n pode fazer isso; depois, todos os membros podem usar o node.
- Abra um workflow e clique em “+” para abrir o painel de nodes.
- Busque por “handelsregister.ai” e escolha o node com o selo de verificado.
- Clique em “Install”.
- Crie uma credencial “Handelsregister.ai API” e informe sua chave de API. Como alternativa, use um bearer token.
Numa instância self-hosted, você também pode instalar o node em Settings › Community Nodes com o nome do pacote @handelsregister/n8n-nodes-handelsregister-ai.
Operações
O node oferece os endpoints da API como operações. Os créditos são os mesmos da API.
| Operação | O que faz | Créditos |
|---|---|---|
| Fetch Organization | Perfil da empresa com recursos selecionáveis, Modo IA e Tempo real. | 5 + recursos |
| Search Organizations | Buscar empresas por nome e filtros. “Return All” percorre todos os resultados, “Maximum Results” limita a quantidade. | 1 por página |
| Fetch Person | Perfil de pessoa, a partir do Plus. | 15 |
| Fetch Document | Um documento do registro. O arquivo fica então na propriedade binária “data”. | 15 |
| List Signals | Signals por tema, empresa e período, página por página. | 20 por página |
| Get Signal | Um único sinal. | 20 |
| Get Signal Catalog | Os temas de Signals. | grátis |
Em requisições de leitura, o node repete erros de rede, 408, 429 e erros de servidor até três vezes. Com “Continue On Fail”, o workflow continua, e o resultado contém o status, o código de erro e meta.
Workflow de exemplo
Este workflow monta uma lista de todas as GmbHs ativas numa área de código postal, cada uma com sua administração.
- Comece com um trigger, por exemplo “Manual Trigger” para experimentar ou “Schedule Trigger” para um horário fixo.
- Adicione o node handelsregister.ai com a operação “Search Organizations”. Nos filtros, defina o código postal, a forma jurídica GmbH e a situação ativa.
- Defina “Output” como um item por empresa. Ative “Return All” e limite a quantidade com “Maximum Results”. Assim você sabe de antemão quantos perfis de empresas virão em seguida.
- Adicione um segundo node handelsregister.ai com “Fetch Organization”. Informe a expressão
{{ $json.entity_id }}emqe selecione o recurso Related Persons, a administração. - Grave o resultado no seu destino, por exemplo uma planilha ou o seu CRM.