Recursos · Integración n8n

Integración ERPNext n8nAutomatiza ERPNext con n8n.

¿Un solo nodo puede mover todo un ERP? La integración ERPNext n8n expone un recurso, Document, y 5 operaciones sobre él, suficiente para crear, leer, actualizar y borrar cualquier DocType de tu instancia. No trae nodo trigger, así que el flujo arranca con un horario o un webhook.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué te aporta de verdad la integración ERPNext n8n?

La integración ERPNext n8n es un nodo que habla con la API de ERPNext usando una API key y su secreto. Expone un único recurso, Document, con 5 operaciones encima: crear, borrar, obtener, listar y actualizar. Como ERPNext guarda casi todos sus objetos en forma de DocType, esas 5 operaciones alcanzan bastante más que 5 tipos de registro.

El primer uso es el alta de datos. Una fila añadida en una pestaña de Google Sheets, o un formulario web que llama a un webhook (una URL que n8n publica y que un servicio externo golpea), termina en document.create escribiendo un Customer dentro de ERPNext. La colección Properties se rellena campo a campo y ERPNext devuelve el nombre de documento que acaba de asignar.

El segundo uso son los listados. document.getAll con Return All activado recorre todas las páginas de la API y trae los documentos de un DocType completo, mientras Field Names or IDs recorta la respuesta a las columnas que de verdad se leen. Ese resultado se puede mandar a un canal de Slack cada mañana o volcarse a una hoja compartida.

El tercer uso es mantener ERPNext al día con las herramientas de alrededor. Un cobro registrado en Stripe o una transferencia vista en Wise alimenta document.update, que solo toca las propiedades que le indicas y deja el resto de la ficha como estaba.

¿Cuándo pasar al nodo HTTP Request? En cuanto sales del documento. El nodo cubre un recurso, Document, y nada más. Lanzar un informe o llamar a un método de servidor queda fuera. HTTP Request llama a cualquier endpoint de la API y reutiliza el mismo credential de ERPNext mediante la autenticación predefinida, así que no hay una segunda clave que mantener.

Dos límites conviene tenerlos claros antes de montar nada. ERPNext no tiene nodo trigger en n8n, de modo que el flujo arranca en otro sitio: un Schedule Trigger a intervalo fijo, un Webhook de n8n al que llama un servicio externo, o el trigger de otra herramienta. Y crear, obtener, actualizar o borrar trabajan con un documento por item, así que el trabajo por lotes se hace recorriendo items. Si quieres ver cómo se compara la herramienta antes de invertir, está la Reseña n8n.

Conexión

¿Cómo conectas ERPNext con n8n?

  1. 01

    Genera la API key y su secreto

    Dentro de ERPNext, entra en Settings, luego My Settings y luego API Access, y genera una API Key. El API Secret sale en ese mismo momento y se muestra una sola vez, así que copia los dos antes de salir de la pantalla. La clave hereda los permisos de la cuenta de usuario a la que pertenece, que es la forma más sencilla de limitar lo que tus flujos pueden tocar. Un System Manager también puede generar claves para otros usuarios.

  2. 02

    Dile a n8n dónde vive tu ERPNext

    El credential pide un Environment. Con alojamiento en la nube, indicas tu Subdomain y eliges un Domain entre erpnext.com y frappe.cloud. Si lo alojas tú, indicas el Domain completo donde responde ERPNext. Queda la opción Ignore SSL Issues, que deja a n8n conectarse cuando la validación del certificado SSL no está disponible.

  3. 03

    Guárdalo una vez y reutilízalo

    Un credential se crea una sola vez en el menú Credentials de n8n y después aparece en el desplegable de cada nodo ERPNext que añadas, igual en n8n Cloud que en una instancia que alojes tú. Ese mismo credential sirve además para un nodo HTTP Request a través de la autenticación predefinida, que es como llegas a los endpoints que el nodo no cubre sin guardar una segunda copia de la clave.

Acciones

Lo que sabe hacer el nodo de ERPNext

El nodo ERPNext expone 5 operaciones en 1 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoCreateGetGet ManyUpdateDelete
Document✓✓✓✓✓

Document

5 operaciones
01

Create a document

document.create

Lo que ves en n8n

Notas y casos de uso

Eliges un tipo de registro, describes sus campos y n8n escribe un documento nuevo en ERPNext. La respuesta trae el nombre de documento que ERPNext le ha puesto, y ese nombre te sirve para los pasos siguientes.

Parámetros clave

  • DocType Name or ID: el tipo de registro que vas a crear, elegido en la lista que n8n carga desde tu instancia o puesto con una expresión como {{ $json.docType }}. El placeholder muestra Customer.
  • Properties: una entrada por cada campo que quieras rellenar, añadida con Add Property. Lo que dejes fuera se queda con lo que defina el DocType.
Casos de uso
un formulario de alta crea la ficha Customer antes de que nadie de ventas abra ERPNext.
02

Delete a document

document.delete

Lo que ves en n8n

Notas y casos de uso

Borra un registro de ERPNext de forma definitiva. Solo vuelve la confirmación, así que lo que quieras conservar se guarda en un nodo anterior.

Parámetros clave

  • DocType Name or ID: el tipo del registro afectado, porque un nombre solo es único dentro de su propio tipo.
  • Document Name: el nombre, es decir el identificador, del documento que se borra, normalmente heredado de un paso previo con {{ $json.name }}.
Casos de uso
una limpieza nocturna elimina los borradores que dejó una importación fallida.
03

Get a document

document.get

Lo que ves en n8n

Notas y casos de uso

Lee un registro y entrega todos sus campos al nodo siguiente. Va bien siempre que el flujo conozca un identificador pero le falte el detalle que hay detrás.

Parámetros clave

  • DocType Name or ID: el tipo de registro que se va a leer, elegido en la lista o pasado con una expresión.
  • Document Name: el nombre, es decir el identificador, del documento que quieres recuperar.
Casos de uso
entra un mensaje de soporte con el identificador de un cliente y esta operación trae la ficha para que la respuesta cite los datos correctos.
04

Get many documents

document.getAll

Lo que ves en n8n

Notas y casos de uso

Lista documentos de un tipo en lugar de buscar uno por su nombre. Aquí ningún parámetro es obligatorio, y por eso sirve para explorar una instancia.

Parámetros clave

  • DocType Name or ID: el tipo que quieres listar, con Customer como placeholder.
  • Return All: activado, n8n recorre las páginas de la API hasta el último documento; desactivado, se para en Limit.
  • Limit: el máximo de documentos cuando Return All está desactivado.
  • Field Names or IDs: los campos a devolver separados por comas, por ejemplo name,country.
  • Filters: propiedades personalizadas que añades una a una para acotar la lista.
Casos de uso
un export semanal de clientes activos, reducido a las columnas que mira administración.
05

Update a document

document.update

Lo que ves en n8n

Notas y casos de uso

Cambia un registro existente sin recrearlo. Solo se mueven las propiedades que indicas, así que la actualización parcial es lo normal y no la excepción.

Parámetros clave

  • DocType Name or ID: el tipo del registro que se modifica.
  • Document Name: el nombre, es decir el identificador, del documento afectado.
  • Properties: los campos que se sobrescriben, añadidos con Add Property. Si dejas la colección vacía, no cambia nada.
Casos de uso
una confirmación de pago que llega de la facturación cambia un campo de estado y escribe la referencia en la ficha.
Necesitas ayuda

¿Necesitas ayuda para automatizar ERPNext con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

ERPNext y n8n, las dudas más repetidas

01¿La integración ERPNext n8n es gratuita?
Sí. El nodo de ERPNext viene incluido en n8n, así que no hay nada que instalar ni ningún coste extra por el lado de n8n. Se comporta igual en n8n Cloud, la oferta alojada por n8n, y en una instancia que alojes tú con Docker o npm en Community Edition bajo licencia Sustainable Use. Un flujo montado en una funciona igual en la otra. Lo que cuesta tu cuenta de ERPNext es otro asunto y depende de cómo lo tengas montado: alojado en la nube en erpnext.com o frappe.cloud, o en tu propio dominio.
02¿Qué credenciales necesitas para conectar ERPNext con n8n?
Un único credential, basado en una API key. Necesitas una API Key generada desde tu propia cuenta de usuario de ERPNext, en Settings, My Settings, API Access, y el API Secret que se crea con ella. Después n8n necesita saber tu entorno: con alojamiento en la nube, el subdomain más un domain elegido entre erpnext.com y frappe.cloud; si lo alojas tú, el domain completo donde responde ERPNext. También hay una opción Ignore SSL Issues para los casos en los que la validación del certificado no está disponible. Si eres System Manager en ERPNext, puedes generar claves y secretos para otros usuarios, que es la manera limpia de darle a un flujo su propia cuenta.
03¿Qué límites tiene el nodo de ERPNext?
El nodo cubre un solo recurso, Document, con 5 operaciones. Es amplio, porque ERPNext modela casi todo como DocType, pero sigue siendo trabajo a nivel de documento: crear, obtener, listar, actualizar y borrar. Lanzar un informe, llamar a un método de servidor o tocar el resto de la API de ERPNext queda fuera, y ahí entra el nodo HTTP Request reutilizando el mismo credential con autenticación predefinida. La paginación solo existe en el listado, con Return All y Limit. Las otras cuatro operaciones tratan un documento por item de entrada, de modo que para un lote mandas varios items y dejas que el nodo los recorra.
04¿El nodo de ERPNext reacciona en tiempo real?
No, y conviene plantearlo desde el principio: ERPNext no tiene nodo trigger en n8n. Nada dentro de ERPNext puede arrancar un flujo de n8n con un nodo dedicado. El arranque viene de otro lado. Un Schedule Trigger lo lanza a intervalo fijo y luego Get many documents recoge lo que ha cambiado desde la pasada anterior, que es el método habitual para sincronizar. Un Webhook de n8n, es decir una URL que n8n publica y que llama un servicio externo, encaja cuando el cambio nace fuera de ERPNext. Y el trigger de otra herramienta al principio del flujo cumple la misma función.
05¿n8n o Make para ERPNext?
Depende de dónde pueden vivir tus datos y de qué modelo de coste te conviene. Make es una plataforma de automatización alojada, sin opción de alojarla tú, facturada por operación, así que un flujo que recorre muchos documentos sube de precio según crece el volumen. n8n funciona en su nube o en tu propio servidor, algo que pesa cuando ERPNext guarda fichas de clientes y apuntes contables que deberían quedarse en tu infraestructura. Las dos ofrecen lógica visual. La prueba real es tu carga: cuenta las operaciones que consumiría un mes de sincronización con ERPNext y compáralo con el coste de alojar.