Integración Zoho CRM n8nAutomatiza Zoho CRM con n8n.

La ficha de empresa aparece en Zoho CRM y el nodo devuelve su identificador a los pasos siguientes.

• Account Name: el único campo obligatorio, a menudo {{ $json.company }} tomado del formulario o de la hoja que lanzó la ejecución.
• Additional Fields: 17 campos opcionales, entre ellos Industry, Phone, Website, Annual Revenue y un grupo Billing Address.

El nombre de la cuenta manda: si ya existe una ficha con ese nombre se actualiza, si no Zoho CRM crea una nueva. No hace falta una búsqueda previa.

• Account Name: el valor que decide entre crear y actualizar, así que debe ser el que tu sistema de origen trata como único.
• Additional Fields: los mismos 17 campos opcionales, escritos en ambos casos.

Un campo, una baja. El nodo envía la eliminación a Zoho CRM y pasa el resultado al resto del flujo.

• Account ID: el identificador de la cuenta a eliminar, visible al final de la URL de la ficha en Zoho CRM, o arrastrado desde un nodo anterior con {{ $json.id }}.

Con un identificador basta: esta operación lo convierte de nuevo en la ficha de empresa completa, antes de que el flujo decida nada.

• Account ID: identificador de la cuenta a recuperar, el mismo valor que aparece al final de la URL.

El listado de empresas vuelve en bloque, página tras página si se lo pides.

• Return All: activado, n8n recorre todas las páginas de cuentas; desactivado, Limit fija cuántas fichas vuelven.
• Options: Territory ID con Include Child acota la extracción a un territorio y a los que dependen de él, y Approved deja solo las fichas aprobadas.

Correcciones y enriquecimiento pasan por aquí: la ficha conserva su identificador y solo cambian los campos que enumeras.

• Account ID: la cuenta a modificar.
• Update Fields: 18 campos, incluido el propio Account Name, además de Employees, Annual Revenue y Website.

Ahora personas, no empresas. La operación escribe una ficha de contacto en Zoho CRM y devuelve su identificador.

• Last Name: el único campo que Zoho CRM exige; vacío, detiene la ejecución del nodo.
• Additional Fields: 21 campos, entre ellos Email (Primary), First Name, Title (el puesto que ocupa en su empresa), Department y Mobile.

Aquí decide el email. Si ya hay un contacto con esa dirección, Zoho CRM actualiza su ficha; si no, abre una nueva.

• Email (Primary): vive dentro de Additional Fields y actúa como clave de cruce del upsert.
• Last Name: sigue siendo obligatorio, incluso cuando la dirección ya existe en el CRM.

Peticiones de borrado y duplicados sueltos terminan aquí, una ficha por ejecución.

• Contact ID: identificador del contacto a eliminar, leído casi siempre de una búsqueda previa o guardado junto a la persona en tu propia base.

Recuperar una sola ficha de persona mantiene honesto el resto del flujo: lo que circula después es lo que Zoho CRM guarda en este momento.

• Contact ID: identificador del contacto a recuperar.

Segmentos enteros de la agenda vuelven de una sola vez.

• Return All: activado para una extracción completa, desactivado para pararse en Limit cuando basta una muestra para probar la rama.
• Options: Fields deja la carga en las columnas que realmente usas, y Sort By con Sort Order decide el orden de llegada.

Misma persona, valores nuevos. El identificador no se mueve y los campos listados se reescriben.

• Contact ID: el contacto a modificar.
• Update Fields: 23 campos, entre ellos Email (Primary), Phone, Title, Department y Last Name.

Se abre una oportunidad en el embudo. Dos campos son obligatorios y la etapa es uno de ellos, así que ninguna operación queda sin sitio.

• Deal Name: el rótulo que el equipo comercial leerá en la vista de embudo.
• Stage Name or ID: elige una etapa de la lista que carga n8n, o pasa un identificador mediante una expresión.
• Additional Fields: Amount, Closing Date, Next Step y Probability, un porcentaje escrito en número simple (12 para 12 %).

Aquí el cruce lo lleva el nombre de la oportunidad: si ya existe una con ese nombre se actualiza, y si no se crea.

• Deal Name: hace también de clave, así que conviene codificar en él una referencia estable, por ejemplo un número de expediente.
• Stage Name or ID: exigido en los dos casos, de modo que hay que indicar etapa incluso cuando la oportunidad ya existe.

Los embudos se ensucian rápido, tanto con pruebas como con errores. Esta operación retira una oportunidad de Zoho CRM.

• Deal ID: identificador de la oportunidad a eliminar, conservado del nodo que la creó o salido de un Get Many anterior.

Leer una sola oportunidad le da al flujo el estado de hoy, antes de reescribir nada.

• Deal ID: identificador de la oportunidad a recuperar.

El embudo llega como datos, no como una captura de pantalla.

• Return All: actívalo para el embudo completo; si lo dejas apagado, Limit decide cuántas oportunidades devuelve el nodo.
• Options: Sort By con Sort Order sube primero las más recientes o las más grandes, y Fields recorta cada oportunidad a las columnas del informe.

Cambio de etapa, importe corregido, fecha aplazada: todo eso pasa por esta operación.

• Deal ID: la oportunidad a modificar.
• Update Fields: 12 campos, entre ellos Stage Name or ID, Amount, Closing Date y Probability.

La factura se monta desde el propio flujo, con sus líneas de producto incluidas.

• Subject: obligatorio, es el título de la factura y el único campo que el nodo no deja vacío.
• Products: una entrada por línea, con Product Name or ID, Quantity, Unit Price y Tax.
• Account Name or ID: vincula la factura a una empresa, junto a Invoice Date, Due Date y Status.

Lo que Zoho CRM compara es el asunto: si ya hay una factura con ese asunto se actualiza, y si no se crea un documento nuevo.

• Subject: clave de cruce y título a la vez, por lo que una referencia de pedido funciona mejor que un rótulo genérico.
• Products: las líneas se escriben en los dos casos, cada una con su Quantity, Unit Price y Total.

Los borradores creados por error no tienen por qué limpiarse a mano.

• Invoice ID: identificador de la factura a eliminar, devuelto por la operación que la creó.

Un documento, recuperado por su identificador, en el estado en que Zoho CRM lo conserva. Leer antes de escribir evita que un flujo de facturación trabaje sobre una copia vieja.

• Invoice ID: identificador de la factura a recuperar.

Las facturas vuelven en forma de lista, que es justo lo que necesita una rutina de cobro.

• Return All: activado, n8n recorre todas las páginas de facturas; desactivado, Limit acota el lote para que una prueba salga ligera.
• Options: Fields reduce cada factura a las pocas columnas que usa el aviso, y Sort By con Sort Order sube primero las más antiguas.

El estado y los totales se mueven durante la vida de un documento, y aquí es donde el flujo los reescribe.

• Invoice ID: la factura a modificar.
• Update Fields: 19 campos, entre ellos Status, Due Date, Invoice Number, Grand Total y la propia lista Products.

Da de alta un registro en el módulo Lead y devuelve su identificador, que los nodos siguientes reutilizan para actualizarlo o borrarlo.

• Company: la empresa del posible cliente, obligatoria en Zoho incluso para un autónomo, y casi siempre resuelta con una expresión (una referencia al dato que entra en el nodo) como {{ $json.company }}.
• Last Name: el apellido, también obligatorio; vacío, detiene la ejecución.
• Additional Fields: 23 campos opcionales que se añaden uno a uno, entre ellos Email, Phone, Lead Source y Lead Status.

El cruce se hace por correo electrónico: si un registro ya lleva esa dirección, Zoho lo actualiza; si no, crea uno nuevo. Una sola operación en lugar de una búsqueda más una bifurcación.

• Company y Last Name: obligatorios, igual que en una creación normal.
• Email: vive dentro de Additional Fields y es quien decide el cruce. Si existe un registro con ese correo se actualiza, si no se crea uno nuevo.

Borra el registro de Zoho CRM sin pedir confirmación. El control se pone antes, en el propio flujo de trabajo.

• Lead ID: el identificador del registro a borrar, no el nombre ni el correo. Sale de un paso Get Many anterior o del nodo de creación, por ejemplo {{ $json.id }}.

Leer un registro devuelve sus valores actuales, los de la base, no los que mandó el formulario hace tres semanas.

• Lead ID: el identificador del registro a recuperar. Zoho lo devuelve al crearlo y también viaja en la salida de un paso Get Many.

Esta operación enumera los campos definidos en el módulo Lead, incluidos los personalizados. Responde a la pregunta que bloquea casi cualquier mapeo: ¿cómo se llama de verdad este campo en la API?

No hay parámetros que rellenar. Eliges la operación, ejecutas el nodo una vez y lees la salida.

Del nodo sale un lote de registros, un elemento por ficha, listo para filtrar, contar o volcar en otro sitio.

• Return All: activado, n8n encadena las páginas de la API hasta la última ficha; desactivado, Limit fija cuántas vuelven.
• Approved y Converted: por defecto solo llegan los registros aprobados, y los ya convertidos se quedan fuera.
• Sort By, Sort Order (ascendente o descendente) y Fields para aligerar la salida.

Modificar una ficha existente solo toca lo que abres en la colección. El resto del registro se queda como estaba.

• Lead ID: el identificador del registro a modificar, el mismo que devolvió la creación.
• Update Fields: 25 campos disponibles, entre ellos Lead Status, Description, Phone y Custom Fields.

Un artículo entra en el módulo Products, y a partir de ahí los presupuestos, pedidos de venta y órdenes de compra pueden citarlo por nombre o por identificador.

• Product Name: el único valor obligatorio.
• Additional Fields: 10 campos opcionales, entre ellos Unit Price, Quantity in Stock, Manufacturer, Product Category y Taxable.
• Commission Rate: un porcentaje escrito como número simple, 12 significa doce por ciento.

Aquí la clave es el nombre del producto. Zoho actualiza la ficha que lo lleva y crea una cuando el catálogo todavía no la conoce.

• Product Name: obligatorio y responsable del cruce. Si existe una ficha con ese nombre se actualiza, si no se crea una nueva.
• Additional Fields: el mismo conjunto opcional, útil para refrescar Unit Price o Quantity in Stock en cada pasada.

Sacar un producto del catálogo cuesta una operación. Los documentos que ya lo citan conservan su historial, pero nada nuevo podrá apuntar a él.

• Product ID: el identificador del producto a borrar, no su nombre comercial. Un paso Get Many previo convierte el nombre en identificador.

Consultar una ficha de producto devuelve sus valores del momento, que es justo lo que hace falta antes de poner un precio.

• Product ID: el identificador del producto a recuperar, tomado de un nodo anterior, normalmente {{ $json.id }}.

El catálogo entero sale del nodo, un elemento por producto, lo que convierte esta operación en el punto de partida de cualquier volcado o comparación con otra herramienta.

• Return All: marcado, el nodo encadena las páginas de la API para traerlo todo; sin marcar, Limit pone el techo.
• Fields: devuelve solo las columnas pedidas, práctico cuando una ficha tiene decenas.
• Sort By, Sort Order y Territory ID afinan todavía más el lote.

Corregir un producto existente afecta solo a los campos que abres en la colección. Los demás siguen igual en Zoho CRM.

• Product ID: el identificador del producto a modificar.
• Update Fields: 10 campos disponibles, entre ellos Unit Price, Quantity in Stock, Quantity in Demand, Description y Product Active.

Emitir una orden de compra crea el documento en Zoho CRM, con sus líneas ya valoradas, y devuelve la ficha resultante.

• Subject: el título de la orden, único valor obligatorio.
• Vendor Name or ID: se elige en la lista cargada desde Zoho o se pasa como identificador mediante una expresión.
• Products: cada línea pide un Product Name or ID, una Quantity y un Unit Price; al lado quedan Due Date, Terms and Conditions y Discount.

El título hace de identificador. Una orden que ya se llama así se actualiza, y cualquier otra cosa se convierte en una orden nueva.

• Subject: obligatorio y portador del cruce. Si existe una orden con ese título se actualiza, si no se crea una nueva.
• Vendor Name or ID y las líneas de Products se rellenan igual que en una creación.

La orden de compra desaparece de Zoho CRM. Sirve cuando un documento nunca debió existir, no cuando simplemente ya se cerró.

• Purchase Order ID: el identificador de la orden a borrar, y no su título.

Cargar una orden de compra devuelve sus líneas y sus totales tal y como están en Zoho CRM en ese momento.

• Purchase Order ID: el identificador de la orden a recuperar, devuelto por la creación o tomado de un listado.

Las órdenes de compra salen en lote, y así se ve el gasto comprometido sin exportar nada a mano.

• Return All: activo, se recorren todas las páginas de la API; inactivo, Limit decide cuántas órdenes vuelven.
• Sort By y Sort Order: las más recientes primero con un orden descendente sobre una fecha.
• Fields: deja solo las columnas que el informe necesita.

Hacer evolucionar una orden ya registrada es el gesto habitual a lo largo de su ciclo de vida.

• Purchase Order ID: el identificador de la orden a modificar.
• Update Fields: 20 campos disponibles, entre ellos Status Name or ID, Tracking Number, Carrier, Due Date y Subject.

El nodo inserta un presupuesto en el módulo Quotes de Zoho CRM y devuelve el registro creado, con su identificador, para que el nodo siguiente lo aproveche.

• Subject: el título del presupuesto, obligatorio, casi siempre tomado del item entrante con {{ $json.subject }}.
• Additional Fields: la colección opcional donde se configuran Valid Till, Terms and Conditions y Quote Stage Name or ID.
• Products: una entrada por línea, con Quantity, Unit Price y Total.

El asunto manda: si ya existe un presupuesto con ese Subject, Zoho CRM lo actualiza; si no, lo crea. Así un flujo lanzado dos veces no deja dos presupuestos.

• Subject: obligatorio, y el valor con el que se hace la correspondencia.
• Additional Fields: la misma colección opcional que en la creación, para Sub Total, Grand Total o Description.
• Products: Product Name or ID se elige en la lista, o se rellena con una expresión cuando el identificador del producto viaja con el item.

Una llamada, un registro menos: el presupuesto sale del módulo Quotes para siempre, así que conviene poner el control antes y no después. El identificador suele llegar de una operación Get Many, o del presupuesto creado antes en la misma ejecución.

• Quote ID: el identificador del presupuesto que se elimina, no su asunto, normalmente {{ $json.id }} traído del paso anterior.

Releer un presupuesto campo por campo, eso es todo. Sirve cuando el flujo solo tiene el identificador y le falta el contenido.

• Quote ID: el identificador del presupuesto que se recupera; Zoho CRM espera ese ID, un asunto no vale.

Los presupuestos vuelven en lista, un item de n8n por registro. De ahí arranca cualquier rama de exportación o de informes.

• Return All: activo, n8n encadena las páginas de la API de Zoho CRM hasta el último presupuesto; inactivo, Limit fija cuántos items llegan.
• Sort By y Sort Order: el campo de ordenación, ascendente (asc) o descendente (desc).
• Approved: activo por defecto, así que los presupuestos pendientes de aprobación quedan fuera hasta que lo desmarcas.

Aquí no se crea nada. Se corrige un presupuesto que ya existe y solo cambian los valores puestos en Update Fields.

• Quote ID: obligatorio, el registro que se modifica.
• Quote Stage Name or ID: hace avanzar el presupuesto por sus etapas, desde la lista o con una expresión.
• Valid Till: la fecha a partir de la cual el presupuesto deja de valer.
• Grand Total y Adjustment: el importe después de impuestos y descuentos, y la corrección aplicada sobre él.

El pedido se escribe en Zoho CRM y queda colgado de una cuenta. Es el paso que suele venir después de un presupuesto aceptado.

• Account Name or ID: obligatorio, elegido en la lista desplegable o resuelto por expresión cuando el identificador de la cuenta llega con el item.
• Subject: obligatorio, el título con el que aparece el pedido.
• Products: las líneas pedidas, con Quantity, Unit Price y Discount, donde escribes 12 para un 12%.
• Due Date: la fecha de pago o de entrega prevista.

Dos campos obligatorios, igual que en la creación, con un matiz que cuenta: el asunto decide si Zoho CRM escribe un pedido nuevo o refresca el que ya lo lleva.

• Subject: obligatorio, y clave de correspondencia.
• Account Name or ID: también obligatorio, la cuenta a la que pertenece el pedido.
• Status Name or ID: el estado del pedido, desde la lista o con una expresión.
• Sales Order Number: el número de pedido que lleva el registro.

El borrado apunta a un pedido concreto y lo saca del módulo. Su sitio está al final de una rama, después de una comprobación, nunca justo detrás de un listado sin filtrar.

• Sales Order ID: el identificador del pedido que se elimina.

Útil cuando llega un identificador de pedido desde otra herramienta y el flujo necesita el registro real: el nodo busca ese pedido y pasa sus campos al resto del flujo.

• Sales Order ID: el identificador del pedido que se recupera, a menudo {{ $json.id }}.

Todos los pedidos, o solo los primeros, según una casilla. Cada registro sale como item separado, listo para filtrar o sumar más adelante.

• Return All: marcado, n8n pide página tras página hasta agotar el módulo; sin marcar, Limit pone el techo.
• Territory ID: deja solo los registros de un territorio, y Include Child limita la respuesta a sus territorios hijos.
• Converted: inactivo por defecto, actívalo para quedarte solo con los registros convertidos.

Un pedido se mueve. Cambia el estado, se retrasa una fecha, se acuerda una comisión. Esta operación escribe esos valores sobre el registro y deja el resto intacto.

• Sales Order ID: obligatorio, el registro que se modifica.
• Status Name or ID: el nuevo estado del pedido.
• Due Date: la fecha revisada.
• Sales Commission: la comisión del comercial en porcentaje, 12 para un 12%.

Los vendors son los proveedores dentro de Zoho CRM. Esta operación añade uno y devuelve el registro, para que un flujo de compras siga sin cortarse.

• Vendor Name: el único campo obligatorio.
• Email, Phone y Website: los datos de contacto, los tres en Additional Fields.
• Category: la categoría en la que se clasifica al proveedor.

El nombre del proveedor hace de clave: si ya hay uno registrado con ese nombre exacto se actualiza, cualquier otro nombre genera un registro nuevo.

• Vendor Name: obligatorio, y valor sobre el que se busca la coincidencia.
• Address: la colección de dirección, que se rellena campo a campo.
• Currency: la moneda asociada al proveedor.
• Custom Fields: tus campos personalizados de Zoho CRM, en la misma colección.

Un proveedor se va y su ficha detrás. Pasas un identificador y el registro desaparece del módulo de proveedores de Zoho CRM. Conviene poner antes un paso que compruebe que se trata de la ficha correcta.

• Vendor ID: el identificador del proveedor que se elimina; el nombre del proveedor no sirve aquí.

A veces el flujo solo tiene un identificador de proveedor, llegado de otra herramienta o de un listado anterior. El nodo lo convierte en la ficha completa, con teléfono, web y categoría incluidos, y la pasa al resto del flujo.

• Vendor ID: el identificador del proveedor que se recupera, normalmente {{ $json.id }} de un nodo anterior.

Todo el directorio de proveedores cabe en un solo nodo, y después se ordena, se filtra o se copia a otro sitio.

• Return All: recorre la lista entera de proveedores; sin marcar, Limit decide cuántos items vuelven.
• Fields: los campos que se conservan en la respuesta, lo que aligera las ejecuciones largas.
• Sort By: el campo de ordenación, con Sort Order en asc o desc.

Los datos de contacto envejecen más rápido que el resto de una ficha de proveedor. Pasas el identificador y lo que ha cambiado, y lo demás sigue igual.

• Vendor ID: obligatorio, el proveedor que se modifica.
• Vendor Name: editable aquí, al contrario que en el upsert, donde hace de clave.
• Email y Phone: los datos que conviene refrescar primero.
• Description: el texto libre sobre el proveedor.