Recursos · Integración n8n

Nodo Code n8nConfigura Code en n8n.

El nodo Code n8n ejecuta tu propio JavaScript o Python sobre los items que recorren un flujo de trabajo. Lo gobiernan dos parámetros: Language y Mode. Mode elige entre una ejecución única para todo el lote o una por item. Sirve cuando ningún nodo incluido hace la transformación.

Probar el nodo Code en n8nVer los 2 parámetros

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

Por qué automatizar

¿Para qué sirve el nodo Code n8n?

El nodo Code ejecuta JavaScript o Python propio dentro del flujo, sobre los items que le pasa el nodo anterior. n8n mueve los datos como una lista de objetos y cada uno cuelga de una clave json: el script lee esa forma y devuelve esa misma forma. Está pensado para la transformación y la lógica que ningún nodo incluido resuelve, y para nada más.

Empieza por lo que ningún nodo expone: el cálculo propio. Puntuar registros con una fórmula interna, componer un texto a partir de tres campos, decidir a qué rama va cada ficha. Con Mode en Run Once for Each Item el script ve un objeto por pasada, lo enriquece y lo devuelve enriquecido, de modo que el aviso que sale luego hacia Slack ya lleva la puntuación calculada y no una fila cruda.

El segundo uso es el contrario: reducir muchos items a uno. Run Once for All Items pone el lote entero al alcance del código, que cuenta lo que importa y devuelve un solo item. Ese item se convierte en un correo de Gmail con el resumen del día, fechado con $today en JavaScript o con _today si el equipo prefiere Python.

El tercero es el trabajo de forma. Una API contesta con objetos anidados y claves que sobran, mientras que una tabla espera columnas planas; unas líneas de código las aplanan y la escritura en Postgres deja de romperse por una clave que nunca fue columna. Conviene recordar la regla al devolver: una lista de objetos, cada uno bajo la clave json apuntando a un objeto, o el nodo falla.

Los límites se concentran en los módulos. El entorno aislado de JavaScript no admite import ni export, así que se carga con require. En n8n Cloud la importación de módulos no está soportada; en autoalojado instalas el módulo en el mismo entorno que n8n o extiendes la imagen oficial de Docker, y después lo permites con las variables de entorno NODE_FUNCTION_ALLOW_BUILTIN y NODE_FUNCTION_ALLOW_EXTERNAL. La versión descrita aquí es la 2.

Y una frontera que ahorra horas: Code no toca los credentials, es decir las credenciales guardadas por n8n. this.getCredentials() y $getCredentials() fallan a propósito, para que los datos de autenticación no pasen por tu script. Una llamada autenticada va al nodo HTTP Request, que sí gestiona credenciales, o al nodo dedicado al servicio; para elegir entre varias, un nodo Switch delante reparte el tráfico. Guardar qué registros ya se procesaron es tarea del nodo Remove Duplicates, no de la static data. Si todavía comparas plataformas, la Reseña n8n cubre ese terreno.

Parámetros

¿Qué parámetros expone el nodo Code ?

El nodo Code tiene 2 parámetros. Para cada uno: el nodo tal como lo configuras en n8n, qué cambia el parámetro y nuestras notas de campo.

01

Mode

mode

Lo que ves en n8n

Notas y casos de uso

Antes de escribir nada conviene decidir Mode: de él depende cuántas veces se ejecuta el script sobre los datos que entran, y por tanto qué tiene el código delante en cada pasada.

Parámetros clave

  • Run Once for All Items (runOnceForAllItems): el código corre una sola vez, sin importar cuántos items entren, con el lote entero a mano.
  • Run Once for Each Item (runOnceForEachItem): el código corre tantas veces como items haya, con un objeto por pasada.
  • JavaScript y Python: el cuadro de código bajo el selector, donde escribes lo que se ejecuta.
Casos de uso
una cifra que resume el lote entero pide el primer ajuste; una corrección registro a registro pide el segundo.
02

Language

language

Lo que ves en n8n

Notas y casos de uso

Language señala con qué motor se evalúa el cuadro de código. Lo que cambia son las ayudas que tienes a mano dentro del script, nunca la estructura de datos que el nodo debe devolver.

Parámetros clave

  • JavaScript (javaScript): te da variables de luxon como $today para fechas y $jmespath para consultar estructuras JSON.
  • Python (pythonNative): te da los métodos y variables integrados equivalentes, _today para fechas y _jmespath para las consultas.
Casos de uso
quien llega desde el análisis de datos suele quedarse en Python; quien sigue los tutoriales publicados se queda en JavaScript.
Necesitas ayuda

¿Necesitas ayuda para automatizar Code con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Nodo Code en n8n: dudas frecuentes

01¿El nodo Code viene incluido en n8n, en Cloud y autoalojado?
Sí. Code es un nodo core que viene con n8n: nada que instalar y ningún coste extra por parte de n8n, tanto en n8n Cloud como en una instancia autoalojada con la Community Edition bajo licencia Sustainable Use. n8n se autoaloja con Docker o npm, o se usa en n8n Cloud, la oferta alojada por n8n, y un flujo de trabajo se comporta igual en ambos casos. Hay un matiz propio de este nodo: la importación de módulos externos no está soportada en Cloud, solo en autoalojado, donde tú controlas el entorno.
02¿Qué hay que configurar antes de que el nodo Code funcione?
Nada del lado de la cuenta. El nodo Code no tiene credential, es decir ninguna credencial que registrar, ni selector Authentication: ninguna clave que pegar, ninguna app que autorizar. Eliges un Language, eliges un Mode y escribes el código. También es un límite duro: un nodo Code no puede acceder a las credenciales, por diseño, y así los datos de autenticación quedan lejos de tu script. Lo que sí necesita es un disparador delante, porque no abre un flujo por sí mismo. Un Schedule Trigger, un Webhook o el trigger de una herramienta valen.
03¿Qué límites tiene el nodo Code?
Tres pesan en el día a día. Tu código debe devolver la estructura que n8n espera, una lista de objetos donde cada uno cuelga de una clave json que apunta a un objeto; si no, el nodo falla con un error sobre los items o sobre esa clave que no es un objeto. No devolver nada, o devolver undefined, da la misma familia de errores. El entorno aislado de JavaScript rechaza import y export: los módulos pasan por require, y solo en autoalojado, con el módulo instalado y permitido por variables de entorno. La versión actual del nodo es la 2.
04¿Cuándo usar el nodo Code n8n y cuándo otro nodo?
Usa Code cuando la transformación o la lógica no tiene nodo propio: aplanar datos anidados, calcular un valor a partir de varios campos, ordenar o agregar un lote. Usa otra cosa en cuanto un nodo ya cubre el trabajo. Una llamada de API autenticada va al nodo HTTP Request, que admite credenciales, o al nodo dedicado a ese servicio. Repartir el trabajo entre varias credenciales le toca a un nodo Switch puesto delante. Y saltarse los registros ya tratados en una ejecución anterior es justo lo que hace el nodo Remove Duplicates, que guarda ese estado por ti.
05¿n8n o Make cuando necesitas código propio?
Depende de dónde quieras que corra ese código. Make es una plataforma de automatización alojada, sin opción de autoalojamiento y facturada por operación, así que un flujo que recorre muchos items tiene un coste que sigue al volumen. n8n corre en tu propio servidor con Docker o npm, o en n8n Cloud si prefieres no alojar nada, y el mismo flujo se comporta igual. Si los datos deben quedarse dentro de tu infraestructura, o si necesitas módulos instalados junto a n8n, el autoalojamiento zanja la duda. Si no quieres tocar un servidor, compara las dos ofertas alojadas.
Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.

Misma plataforma

Otros docs útiles sobre este stack.

Ver todas las integraciones