n8n
Datos de empresas en workflows, sin código.
Con el nodo de n8n llevas datos de empresas a tus workflows sin código. El nodo está verificado por n8n y llama a la misma API que tu propio software.
Instalar el nodo
Los nodos verificados se instalan directamente desde el editor. Solo puede hacerlo el propietario o un administrador de la instancia de n8n; después, todos los miembros pueden usar el nodo.
- Abre un workflow y haz clic en “+” para abrir el panel de nodos.
- Busca “handelsregister.ai” y elige el nodo con la insignia de verificado.
- Haz clic en “Install”.
- Crea una credencial “Handelsregister.ai API” e introduce tu clave API. Como alternativa, usa un bearer token.
En una instancia autoalojada, también puedes instalar el nodo en Settings › Community Nodes con el nombre de paquete @handelsregister/n8n-nodes-handelsregister-ai.
Operaciones
El nodo ofrece los endpoints de la API como operaciones. Los créditos son los mismos que en la API.
| Operación | Qué hace | Créditos |
|---|---|---|
| Fetch Organization | Perfil de empresa con funciones seleccionables, modo IA y Tiempo real. | 5 + funciones |
| Search Organizations | Buscar empresas por nombre y filtros. “Return All” recorre todos los resultados, “Maximum Results” limita el número. | 1 por página |
| Fetch Person | Perfil de persona, desde Plus. | 15 |
| Fetch Document | Un documento del registro. El archivo queda después en la propiedad binaria “data”. | 15 |
| List Signals | Signals por tema, empresa y periodo, página a página. | 20 por página |
| Get Signal | Una sola señal. | 20 |
| Get Signal Catalog | Los temas de Signals. | gratis |
En las solicitudes de lectura, el nodo reintenta hasta tres veces los errores de red, 408, 429 y los errores de servidor. Con “Continue On Fail”, el workflow sigue ejecutándose, y el resultado contiene el estado, el código de error y meta.
Workflow de ejemplo
Este workflow crea una lista de todas las GmbH activas de una zona de código postal, cada una con su administración.
- Empieza con un trigger, por ejemplo “Manual Trigger” para probar o “Schedule Trigger” para un calendario fijo.
- Añade el nodo de handelsregister.ai con la operación “Search Organizations”. En los filtros, pon el código postal, la forma jurídica GmbH y el estado activo.
- Pon “Output” en un elemento por empresa. Activa “Return All” y limita el número con “Maximum Results”. Así sabes de antemano cuántos perfiles de empresa siguen.
- Añade un segundo nodo de handelsregister.ai con “Fetch Organization”. Introduce la expresión
{{ $json.entity_id }}enqy selecciona la función Related Persons, la administración. - Escribe el resultado en tu destino, por ejemplo una hoja de cálculo o tu CRM.