Complete "Lección 2: Trabajando con Expresiones y Transformaciones de Datos" primero para desbloquear esta lección.Ir a la lección anterior

Introducción

Cuando un flujo de trabajo de n8n recibe una lista de items —por ejemplo 500 filas de una hoja de cálculo o 1,000 contactos desde una API— enviar cada uno de forma naïve al siguiente nodo puede causar problemas: límites de tasa, timeouts, picos de memoria o tablas de base de datos bloqueadas. El nodo SplitInBatches resuelve esto dividiendo una lista en grupos más pequeños y liberándolos un lote a la vez, dejando descansar a los nodos aguas abajo entre lotes.

Piénsalo como una cinta transportadora controlada: en lugar de volcar 1.000 cajas a un trabajador de golpe, se las alimenta de 50 en 50.

diagrama de flujo que muestra 1 array de entrada repartido en 3 lotes secuenciales alimentando a un único nodo aguas abajo

Cómo funciona SplitInBatches

SplitInBatches se coloca entre su fuente de datos y el nodo que procesa cada ítem. En la primera ejecución emite el primer trozo (tamaño configurable, por defecto 1 ítem), se pausa y luego, en ejecuciones subsiguientes, emite el siguiente trozo hasta agotar la lista. Cada lote pasa por la misma rama aguas abajo, por lo que normalmente se empareja con un nodo Set, HTTP Request o de base de datos.

Existem dos salidas importantes en el nodo: "Done" se activa una vez después de liberar el último lote —útil para un paso final de resumen o limpieza— y "Loop" alimenta el siguiente lote de vuelta a través de tu rama de procesamiento.

Configuración básica

Abre el nodo y establece Batch Size a un número que coincida con lo que tu servicio aguas abajo puede manejar. Para la mayoría de APIs HTTP que limitan a 100 requests por minuto, un Batch Size de 10 con un nodo Wait de 6 segundos entre lotes funciona bien.

json
{
"node": "SplitInBatches",
"parameters": {
"batchSize": 10,
"options": {}
},
"type": "n8n-nodes-base.splitInBatches"
}

Conecta la salida "Loop" a tu nodo de procesamiento, luego desde ese nodo enchufa de nuevo a SplitInBatches para que se libere la siguiente tanda. Conecta la salida "Done" al paso de resumen que necesites.

Ejemplo práctico: empujar contactos a una API externa

Imagina que extraes 200 contactos de un CRM y necesitas hacer POST de cada uno a un webhook. Sin batching lanzarías 200 solicitudes de golpe y probablemente recibirías un error 429 Too Many Requests.

El flujo de trabajo se ve así: un disparador Cron se ejecuta diariamente, un nodo HTTP Request recupera contactos, SplitInBatches los agrupa de a 10, cada lote pasa a un bucle que llama al webhook para cada elemento, luego un nodo Wait pausa 6 segundos, después el control regresa a SplitInBatches para el siguiente lote. Una vez que se procesan todos los lotes, la rama "Done" registra "Sincronizados 200 contactos" en Slack.

Diagrama del ciclo de vida que muestra una iteración completa del bucle: SplitInBatches libera el lote → el nodo Process procesa los elementos → Wait pausa → regreso a SplitInBatches → repetición hasta que se activa la rama Done

Errores comunes

Olvidar conectar el lazo de retorno es el error número uno: sin esa conexión el flujo de trabajo se detiene después del primer lote. Otro fallo frecuente es colocar el nodo Wait fuera del bucle, después de SplitInBatches en lugar de dentro de la rama del bucle; eso hace inútil la delimitación de velocidad porque no hay throttling entre lotes. Por último, recuerda que SplitInBatches mantiene su estado por ejecución, así que cada nueva ejecución de disparo empieza desde el lote uno — no puedes reanudar un bucle de lotes a medio terminar a través de ejecuciones separadas.

Resumen

SplitInBatches es el nodo de referencia cuando un servicio downstream no puede absorber toda tu lista en una sola operación. Define un tamaño de lote sensato basado en el límite de tasa de la API objetivo, siempre conecta la salida del bucle, acompáñalo con un nodo Wait dentro del bucle para una pulsación con control de velocidad, y usa la rama "Done" para las tareas de fin de ejecución.

Para listas de más de unos pocos cientos de ítems o para procesamiento en paralelo, mira el nodo Loop o un subflujo con un disparador Execute Workflow en su lugar — eso se cubre en lecciones posteriores.

Práctica de la lección

Punto de control de la lección

Repasa lo aprendido y recibe comentarios sobre tu trabajo.

0/1
Respondidas · 0/1