Herramienta Agregador

El Agregador recopila filas de datos individuales en un único array. Funciona como lo opuesto de la herramienta Iterador:

• El Iterator divide un array en elementos separados.
• El Agregador combina los elementos de nuevo en un array.

Si el Iterator te permite procesar cada elemento por separado, el Agregador te ayuda a reunir todo en el formato correcto para la etapa final.

Por qué necesitas el Agregador

Cuando una etapa espera un array (por ejemplo, elementos de línea en una factura), Albato debe recibir ese array como un único objeto estructurado.

Si mapeas campos directamente desde diferentes etapas después de un Iterator, el sistema no puede combinarlos automáticamente en un solo array. Esto provoca un conflicto de estructura y genera un error.

El Agregador resuelve este problema. Combina datos de múltiples etapas en un único array estructurado. La etapa final recibe entonces todo desde una sola fuente, correctamente formateado y sin conflictos.

Ejemplo de flujo que usa el Iterador/Agregador:

Iterador → Procesamiento de datos → Agregador → Etapa final.

Cómo configurar el Agregador

Primero, haz clic en la etapa de Agregador previamente agregada en la ubicación deseada, siempre después del Iterador.

En la configuración, necesitas agregar campos y cada uno de ellos representa una columna del futuro array.

Para cada campo, configuras dos parámetros:

• Nombre. Este nombre estará disponible en las siguientes etapas y te ayudará a seleccionar el campo correcto.
• Seleccionar un campo. La fuente de datos de cualquier etapa anterior en la automatización. Estos valores seleccionados formarán nuevas secciones de línea que luego se enviarán como un array.

Dentro de una única etapa del Agregador, puedes recopilar datos simultáneamente:

• del Iterator;
• de herramientas de procesamiento (por ejemplo, Operación matemática);
• de otras etapas anteriores.

Ejemplo: Creando una factura en Zoho Books con elementos de línea del pedido

Analicemos un ejemplo real de automatización. El objetivo es crear una factura en Zoho Books cuando se recibe un nuevo pedido y enviar todas las posiciones del pedido como elementos de línea.

La automatización quedaría así:

Webhook → Encontrar cliente → Iterator → Procesamiento de datos → Agregador → Crear factura

Etapa 1. Webhook de entrada

La automatización comienza con Webhook: Webhook de entrada.

El webhook envía un pedido que incluye un array de productos. Cada elemento contiene:

• nombre del producto;
• precio;
• cantidad;
• impuesto;
• envío;
• código promocional.

En esta etapa, los datos existen como un único objeto que contiene un array de elementos.

Etapa 2. Encontrar el cliente

La siguiente etapa es Google Sheets: Encontrar una fila.

Aquí, la automatización utiliza el correo electrónico recibido del webhook para buscar el cliente correspondiente en una tabla de Google Sheets. Una vez que se encuentra la fila correcta, recupera el ID del Cliente , que es necesario para crear la factura en Zoho Books.

Esta lógica está separada del procesamiento del array, pero es necesaria para la etapa final.

Etapa 3. Iterator

En esta etapa, el Iterator selecciona el array Items recibido de Google Sheets:

Al elegir los datos de Google Sheets, la automatización divide los datos recopilados de diferentes IDs y productos de cada fila de tu hoja. Cada dato puede entonces procesarse por separado en las siguientes etapas.

Esto te permite calcular impuestos, modificar descripciones o ajustar valores para cada elemento antes de reunirlos nuevamente en un array estructurado.

Etapa 4. Procesando cada elemento

Después del Iterator, cada elemento se procesa por separado.

En esta etapa, puedes aplicar herramientas adicionales, por ejemplo:

• usar la herramienta Remove tags para limpiar la descripción del producto;
• usar la herramienta Operación matemática para calcular impuestos u otros valores.

Etapa 6. Agregador

Después del procesamiento, se añade la etapa Tool: Agregador.

Aquí es donde ocurre la transformación principal.

En la configuración del Agregador, se agregan los campos y en este caso, estamos uniendo diferentes datos, provenientes de la hoja y del Webhook en un único Array.

¿Qué sucede después?

El Agregador:

• Toma la primera iteración.
• Recopila todos los campos especificados.
• Forma una fila del array.
• Pasa a la segunda iteración.
• Repite el proceso.

Como resultado, se crea un nuevo array estructurado. Este array se convierte en una única fuente de datos para la siguiente etapa.

Etapa 7. Sustitución de tabla

Después del Agregador, se utiliza una herramienta de Sustitución de tabla (Table lookup) para transformar valores específicos antes de enviarlos a Zoho Books.

En esta etapa, el sistema verifica el valor recibido de la etapa anterior (por ejemplo, un porcentaje de impuesto o código interno) y lo reemplaza por el ID correspondiente requerido por Zoho Books.

Esto es necesario porque algunas apps, por ejemplo Zoho Books, no aceptan el nombre o el valor del campo directamente. En su lugar, requieren IDs internos ya guardados allí.

La etapa de Sustitución de tabla realiza el mapeo de valores legibles a los IDs exactos esperados por el servicio.

Etapa 8. Creando la factura en Zoho Books

Después de configurar las etapas anteriores, agrega la acción para crear recibos: Zoho Books - Create Invoice.

En la sección Line items, cada campo se mapea a partir del resultado del Agregador:

Esto significa que Zoho Books recibe un array completamente estructurado de elementos de línea, con todos los valores ya procesados y correctamente formateados.

Conclusión

El Agregador garantiza que los datos basados en array se envíen correctamente al servicio final.

Combina filas procesadas en un único array estructurado que el servicio de destino puede aceptar sin conflictos ni problemas de formato.

Si tu automatización utiliza el Iterador y recopila datos de array de múltiples etapas, el Agregador se convierte en una parte esencial del flujo. Hace que automatizaciones complejas sean estables, predecibles y técnicamente correctas.

Para saber más sobre cómo funcionan nuestras herramientas, explora nuestro blog. Puedes encontrar una guía detallada sobre la herramienta Iterador en este artículo aquí .

Si tienes alguna duda, nuestro equipo de soporte siempre está disponible en el chat en vivo.