Beam Help
Solicitar ayuda

How-to · Zoho CRM

Cómo obtener un subformulario en Zoho CRM

Recupera datos de subformularios para acceder a registros relacionados dentro de tus módulos.

Los subformularios en Zoho CRM te permiten capturar y mostrar múltiples filas de datos relacionados directamente dentro de un registro principal — piensa en líneas de productos en un negocio, o varios contactos en una cuenta. Esto es lo que necesitas saber para trabajar con ellos de forma eficaz.


Por qué esto es importante


Los subformularios son esenciales cuando un único registro de CRM necesita contener un conjunto repetido de datos estructurados sin crear registros secundarios separados. Se usan habitualmente para líneas de pedido, listas de asistentes o cualquier escenario en el que un registro principal tiene muchas filas relacionadas. Entender cómo consultar, personalizar y ampliar los subformularios ahorra un tiempo considerable de introducción manual de datos y permite generar informes más completos.


Paso a paso


Paso 1. Comprende qué es un subformulario y dónde encontrarlo.

Un subformulario aparece como una sección en forma de tabla dentro del diseño de un módulo de Zoho CRM. Cada fila de la tabla representa una entrada, y puedes agregar, editar, clonar o eliminar filas individuales directamente en la página de detalle del registro. Las actualizaciones recientes de la plataforma también permiten ordenar y filtrar filas según criterios, y realizar estas acciones mediante Ajax/edición puntual sin recargar la página completa. [2]


Paso 2. Fija columnas clave y ajusta el ancho de columnas para facilitar la navegación.

Si tu subformulario tiene muchas columnas, los administradores ahora pueden fijar varias columnas para que permanezcan visibles mientras los usuarios se desplazan horizontalmente. Los administradores también pueden ajustar el ancho de cada columna para reducir el desplazamiento horizontal innecesario y ofrecer al equipo una interfaz más limpia. Ambas configuraciones las gestiona un administrador de la cuenta de Zoho CRM. [2]


Paso 3. Consulta datos de subformularios mediante el Developer Hub.

Cuando necesites recuperar registros de subformularios de forma programática, ve a Configuración → Developer Hub → Consultas y haz clic en Agregar consulta. En el cuadro de diálogo «Crear consulta», introduce un Nombre de consulta y un Nombre de API, luego haz clic en Siguiente. En Configuración, elige el módulo de destino — el generador de consultas admite explícitamente los subformularios como tipo de origen. Desde allí, selecciona los campos que deseas devolver (hasta 50 campos por consulta) y aplica los criterios que necesites, incluidos valores dinámicos que se resuelven en tiempo de ejecución. [6]


Paso 4. Aplica criterios para filtrar filas del subformulario.

Dentro de la sección Criterios del generador de consultas, puedes elegir Ninguno para devolver todas las filas, filtrar por ID de registro o crear lógica condicional con operadores AND/OR y distintos comparadores. Los criterios dinámicos permiten que el valor se proporcione en el momento en que se ejecuta la consulta, lo que hace que las consultas sean reutilizables en diferentes registros. [6]


Paso 5. Agrega datos del subformulario en campos del registro principal.

Zoho CRM ofrece hasta cinco campos de Suma agregada de forma nativa en un subformulario, que acumulan los totales numéricos de las columnas en el registro principal. Si necesitas más de cinco agregaciones, los campos de fórmula estándar del registro principal no pueden leer directamente los datos del subformulario sin scripts adicionales. [1] Para los equipos que necesiten una solución sin código, considera reestructurar qué columnas usan los cinco espacios de agregación disponibles, o explora la automatización basada en Deluge para enviar valores calculados a un campo de moneda o número normal en el registro principal. [1]


Paso 6. Agrega filas al subformulario desde la app móvil de Zoho CRM o Zoho Forms.

Si tu equipo captura datos en movimiento, las filas del subformulario se pueden agregar a través de la app móvil de Zoho CRM. Por otro lado, si recopilas datos mediante formularios web, Zoho Forms admite un tipo de campo Subformulario que permite a los encuestados enviar múltiples entradas de línea, las cuales pueden enviarse a los registros de Zoho CRM a través de la integración Forms–CRM. [4] [3]


Paso 7. Gestiona el acceso al subformulario para usuarios del portal.

Los permisos del subformulario pueden extenderse a los usuarios del portal, lo que permite a partes externas — como clientes o socios — ver o gestionar las filas del subformulario sin necesitar una licencia completa de CRM. Este permiso se configura a nivel de subformulario dentro de la configuración del diseño de tu CRM. [2]


Errores comunes


  • Los campos de fórmula no pueden leer columnas del subformulario de forma nativa. Los campos de fórmula estándar del módulo principal no tienen acceso a los valores individuales de las filas del subformulario. Estás limitado a los cinco campos de agregación integrados para consolidaciones sin código; cualquier cosa más allá requiere scripts de Deluge. [1]
  • Los subcampos del campo Nombre en Deluge requieren un manejo especial. Al insertar filas en un subformulario mediante código Deluge, los campos de tipo Nombre (que tienen subcomponentes como nombre y apellido) no siempre aceptan la asignación con notación de puntos de forma directa. Este es un punto de fricción conocido al crear automatizaciones que rellenan filas de subformularios de forma programática. [5]
  • Se aplican límites de campos en las consultas. Al usar el generador de consultas del Developer Hub para obtener datos de subformularios, puedes seleccionar un máximo de 50 campos por consulta y un máximo de dos campos relacionados/de búsqueda. Planifica tus consultas en consecuencia para evitar alcanzar estos límites. [6]

Qué verificar


  • Verifica los permisos de administrador — el anclaje de columnas, los ajustes de ancho de columna y la configuración de acceso al portal para subformularios requieren derechos de administrador de CRM; confirma que el usuario correcto está realizando estos cambios. [2]
  • Confirma el uso de los espacios de agregación — comprueba cuántos de los cinco campos de Suma agregada ya están en uso en tu subformulario antes de diseñar nueva lógica de consolidación. [1]
  • Prueba los criterios de consulta con valores dinámicos — después de crear una consulta en el Developer Hub que apunte a un subformulario, realiza una ejecución de prueba para confirmar que los criterios dinámicos se resuelven correctamente con registros reales. [6]

---


*Beam Help es una consultoría independiente de Zoho y no es el soporte oficial de Zoho. Para problemas a nivel de plataforma, verifica siempre con tu edición y plan actuales de Zoho CRM.*

Sources cited

  1. [1] Adding a custom formula field from sub-forms
  2. [2] Q1 2025 Update
  3. [3] Forms | Integrations | Knowledge Base
  4. [4] What's New in Zoho Forms
  5. [5] When adding subform records, how do I access member fields of a name field
  6. [6] Hi, how can we help?
  7. [7] Introducing Intake Forms
  8. [8] Create extensions using cloud editor | Online Help | Zoho Projects