Arquitectura de datos CRM en HubSpot para empresas B2B en Latinoamérica

La arquitectura de datos CRM en HubSpot es el conjunto de decisiones que define qué objetos usas, cómo se asocian, qué identificador evita duplicados, cómo se nombran las propiedades y dónde queda documentado todo. En empresas B2B de Chile y Latinoamérica, el problema típico no es partir de cero: es un portal que creció sin reglas, con empresas repetidas y campos que nadie entiende. Ordenarlo exige cinco decisiones: objetos y etiquetas de asociación, un identificador único (RUT o dominio), una convención de nombres, un criterio para objetos personalizados y un diccionario de datos.

En resumen

• La arquitectura de datos CRM en HubSpot define qué objetos usas, cómo se asocian, qué identificador evita duplicados, cómo nombras las propiedades y dónde lo documentas.
• En empresas B2B de Chile conviene sumar el RUT como propiedad de valor único, porque es la llave que usan el ERP y la facturación para identificar al cliente.
• Antes de integrar el ERP, define el identificador único, limpia los duplicados y documenta en un diccionario de datos qué sistema es dueño de cada propiedad de HubSpot.

Si vas a montar HubSpot desde el principio, empieza por la guía sobre cómo estructurar HubSpot desde cero para tu operación comercial. Aquí nos quedamos con el portal que ya existe y con cómo gobernar su dato sin detener la operación.

¿Por qué se desordena la arquitectura de datos de un portal HubSpot?

Porque cada área agrega lo que necesita y nadie es dueño del modelo. Marketing crea campos para sus formularios, ventas inventa los suyos y una integración con el ERP suma otros tantos. A los dos años, el portal funciona, pero nadie confía en lo que muestra. Es un problema de gobierno del dato, la base de Revenue Operations (RevOps) en empresas B2B de Chile, más que de la herramienta.

¿Reconoces estos síntomas?

• La misma empresa aparece dos o tres veces, con nombres escritos distinto.
• Hay propiedades casi iguales, como "Rubro", "Industria" y "Sector", y nadie sabe cuál usa el reporte.
• Los negocios no están asociados a la empresa correcta o no se sabe quién decide la compra.
• La integración con el ERP crea registros nuevos en vez de actualizar los existentes.
• Nadie puede explicar qué significa cada etapa del pipeline ni qué indicador se mide en cada una.

En Chile esto se nota apenas el CRM se conecta a un ERP como Defontana o Softland. El ERP identifica al cliente por RUT y HubSpot lo hace por dominio o correo. Sin una llave común, la integración duplica y las ventas dejan de coincidir con la facturación. Es la razón más común de por qué los reportes de HubSpot no cuadran con el ERP.

Detrás de casi todos los síntomas hay tres errores de diseño:

Error de diseño	Cómo se ve en el portal	Decisión que lo corrige
Modelar según la herramienta y no según el proceso de negocio	Pipelines por vendedor, campos que nadie llena	Definir objetos y etapas a partir de cómo vendes y atiendes
Permitir duplicados por falta de reglas y controles	Empresas repetidas, historial partido	Un identificador único por objeto, validado al crear e importar
Subestimar la integración con sistemas satélite	El ERP, la facturación o el soporte escriben donde quieren	Un diccionario que diga qué sistema es dueño de cada dato

¿Por dónde empezar si tu portal ya está desordenado?

El orden importa más que la velocidad: si limpias duplicados antes de definir el identificador, vuelven la semana siguiente. Este es el orden que recomendamos:

1. Alinea definiciones. Ventas, marketing, servicio y finanzas acuerdan qué es una empresa, un cliente y un negocio ganado.
2. Documenta el modelo actual. Exporta las propiedades y dibuja los objetos y sus asociaciones tal como están hoy.
3. Decide la convención de nombres y ordena las propiedades. Va antes de crear cualquier propiedad, porque el nombre interno no se cambia. Consolida en una sola (migrando valores), renombra la etiqueta visible o archiva las que sobran.
4. Define el identificador y limpia duplicados. Crea el RUT con valores únicos y limpia duplicados antes de migrar los valores, porque HubSpot rechazará los RUT repetidos. Todo esto, antes de reconectar integraciones.
5. Forma a los usuarios clave. Diseña el registro para que sea lo mínimo y entrega un reporte de uso por persona; el uso diario lo lidera la gerencia.
6. Automatiza al final. Primero alertas y asignaciones simples, después flujos complejos. Los workflows requieren una edición Professional o Enterprise.

¿Qué objetos y asociaciones necesita un portal B2B en HubSpot?

La mayoría de los portales B2B funcionan bien con los cuatro objetos estándar: empresas, contactos, negocios y tickets. Lo que suele faltar son etiquetas de asociación que expliquen el papel de cada relación.

Objeto	Qué representa	Decisión clave
Empresas	La cuenta: la razón social o el grupo que compra	Identificador único y relación matriz y filial
Contactos	Las personas con las que hablas	Correo como llave y rol en la compra
Negocios	Cada oportunidad de venta	Un pipeline por proceso de venta, no por vendedor ni por país
Tickets	Casos de servicio o postventa	Pipeline propio y asociación a la empresa y al negocio

Entre contacto y negocio, una etiqueta distingue al decisor, al usuario y al que aprueba el pago. Entre empresas, HubSpot ya trae las etiquetas Empresa matriz y Empresa filial en todos los planes; cada filial puede tener una sola matriz. Para otras relaciones puedes crear un par de etiquetas, como Distribuidor y Cliente final, una para cada lado.

Las etiquetas personalizadas se configuran en Gestión de datos > Modelo de datos y requieren Professional o Enterprise. Admiten hasta 50 por par de objetos, y un par cuenta como una sola, según la guía oficial de etiquetas de asociación.

Regla práctica: si una relación cambia la forma de vender o de reportar, merece una etiqueta. Si solo es informativa, basta la asociación simple.

Quedan dos decisiones más. La primera es la cantidad de pipelines: HubSpot permite 15 pipelines personalizados en Starter, 100 en Professional y 350 en Enterprise, compartidos entre negocios, tickets y otros objetos (el pipeline por defecto no cuenta). Tener muchos suele indicar que se armaron por persona y no por proceso.

La segunda son las marcas o unidades de negocio que comparten portal, algo frecuente en grupos con operación en Chile, Perú y Colombia. Ahí conviene revisar cómo separar varias marcas en un mismo portal de HubSpot; la herramienta de Marcas exige Marketing Hub Enterprise y su complemento.

¿Qué identificador único evita duplicados: RUT, dominio o correo?

HubSpot deduplica los contactos por correo y las empresas por la propiedad Nombre de dominio de la empresa. En B2B en Chile conviene sumar el RUT como propiedad de valor único, porque es la llave que usan el ERP y la facturación.

Las empresas que crea una integración o la API no se deduplican por dominio, según la documentación de deduplicación de HubSpot. Por eso la integración debe buscar por RUT antes de crear.

El dominio también falla con holdings de un solo sitio web y varias razones sociales, empresas sin sitio y pymes con correos de Gmail.

Identificador	Dónde funciona	Riesgo a controlar
Correo	Contactos creados por formulario, importación o a mano	Correos genéricos y personas que cambian de empresa
Nombre de dominio de la empresa	Empresas creadas a mano, por formulario o importación; no aplica a las creadas por API o integraciones	Holdings con un dominio y varias razones sociales
RUT como propiedad de valor único	Empresas, al crear el registro y al importar	Formatos distintos si no hay regla de validación
ID de registro	Cualquier objeto, en importaciones	Solo sirve si el sistema externo guarda ese ID

Cualquier plan permite exigir valores únicos en hasta diez propiedades por objeto, en campos de texto, teléfono o número, así que HubSpot impide que dos empresas tengan el mismo RUT. Ojo: la opción de valores únicos solo se activa al crear la propiedad. Si ya tienes un campo RUT, crea uno nuevo con valores únicos, limpia y normaliza los RUT, migra los valores y archiva el antiguo.

Las reglas de validación con expresiones regulares, útiles para forzar un formato de RUT sin puntos y con guion, piden Professional o Enterprise, según la documentación de reglas de validación de HubSpot.

Si operas en varios países de Latinoamérica, usa una sola propiedad de identificador tributario (RUT en Chile, RFC en México, NIT en Colombia, RUC en Perú) y otra que indique el país, no una por país. Si validas el formato con expresiones regulares, la regla debe aceptar el formato de cada país, o la validación se hace desde la integración.

Para los duplicados que ya existen, la herramienta Acciones > Gestionar duplicados en contactos y empresas requiere Professional o Enterprise y muestra hasta 10.000 pares para fusionar uno por uno. La fusión masiva exige Data Hub (antes Operations Hub) Professional o Enterprise. Antes de fusionar, decide qué registro sobrevive: normalmente el que tiene el identificador del ERP.

Las integraciones que respetan el modelo de datos buscan por RUT antes de crear. Si la tuya crea primero y pregunta después, los duplicados vuelven aunque limpies cada mes.

¿Cuándo conviene crear un objeto personalizado en HubSpot?

Cuando necesitas registrar algo con vida propia, varias instancias por empresa y propiedades propias, que no cabe en empresas, contactos, negocios ni tickets. Los objetos personalizados están disponibles en cualquier edición Enterprise y se crean en Gestión de datos > Modelo de datos.

Necesidad	Mejor opción
Un dato que describe a la empresa, como rubro o tamaño	Propiedad
El rol de una persona en un negocio	Etiqueta de asociación
La relación entre una matriz y sus filiales	Asociación matriz y filial nativa (todos los planes)
Una venta con etapas	Negocio con su pipeline
Contratos, proyectos, sucursales o unidades inmobiliarias con ciclo propio	Objeto personalizado

Antes de crearlo, responde cuatro preguntas:

• ¿Hay varias instancias por empresa, como varios contratos o varias obras?
• ¿Tiene estados o un ciclo propio, distinto del negocio?
• ¿Necesitas reportar sobre él, no solo verlo en la ficha?
• ¿Lo va a escribir una integración, como el ERP o un sistema de proyectos?

Si respondes que sí a tres o más, el objeto personalizado se justifica. Una empresa de logística puede necesitar embarques; una inmobiliaria, proyectos y unidades; una empresa de servicios profesionales, contratos con fecha de renovación.

Cambiar de opinión cuesta: cada workflow, reporte e integración queda atado al objeto. Y sin Enterprise, no uses negocios o tickets como sustituto de otra cosa: mezclas los reportes.

¿Cómo nombrar y documentar las propiedades en un diccionario de datos?

Con una convención escrita antes de crear la próxima propiedad y un diccionario que diga, para cada campo, qué significa, quién lo llena y de qué sistema viene. Sin eso, cada persona crea su propia versión del dato.

¿Qué reglas debe tener la convención de nombres?

La regla que más pesa: el nombre interno no se puede editar después de crear la propiedad, y las integraciones y la API dependen de él.

Elemento	Regla	Ejemplo
Nombre visible	Español claro, sin siglas internas	Condición de pago
Nombre interno	Minúsculas, prefijo del sistema de origen	erp_condicion_pago
Grupo de propiedades	Por origen o por proceso	Datos del ERP
Tipo de campo	Lista desplegable si se usa para segmentar o reportar	Rubro con opciones cerradas
Descripción	Definición de negocio en la pestaña Documentación	Plazo pactado en la última factura

Una propiedad por concepto: si hoy tienes "Rubro", "Industria" y "Sector", elige una, migra los valores con una importación o un workflow y archiva las otras. El texto libre en campos de segmentación descuadra los reportes.

¿Qué columnas lleva el diccionario de datos?

Empieza por Configuración > Propiedades > Exportar todas las propiedades. El archivo trae nombre, nombre interno, tipo, descripción, grupo, opciones, creador, usos y tasa de llenado de cada propiedad. Sobre esa base agrega lo que HubSpot no sabe:

• Definición de negocio: qué significa el dato en una frase.
• Dueño: quién decide si la propiedad cambia o se archiva.
• Sistema de origen: qué sistema es la fuente de verdad, por ejemplo el ERP para la condición de pago.
• Quién la escribe: una persona, un formulario, un workflow o una integración.
• Reportes que la usan: para saber qué se rompe si cambia.
• Estado: vigente, en revisión o por archivar.

Para la columna de origen te ayuda la propiedad Fuente del registro, que dice cómo se creó cada registro: importación, formulario, workflow o integración. No la confundas con las propiedades de fuente en HubSpot que miden el origen de marketing de un contacto.

Si una integración usa una aplicación privada, anota quién tiene el token. HubSpot ahora las llama aplicaciones privadas heredadas: a partir del 26 de octubre de 2026 las cuentas existentes ya no podrán crear nuevas. Las actuales siguen funcionando y las alternativas son Service Keys (beta) o aplicaciones privadas basadas en proyectos.

¿Cada cuánto se revisa el modelo?

Una vez por trimestre suele bastar: archiva lo que tiene baja tasa de llenado y ningún uso, y ajusta el modelo cuando el negocio cambia, por ejemplo al abrir México o sumar una línea de producto. Si manejas más de un portal, el diccionario también es la base para clonar propiedades entre portales sin copiar el desorden.

¿Cómo te ayuda Revenue Hub Latam a ordenar tu modelo de datos?

Revenue Hub Latam es partner Platinum de HubSpot en Santiago y ordena el modelo de datos de portales heredados con el Rescate de HubSpot: objetos, identificador, propiedades y diccionario, con alcance y precio cerrados. Con la garantía Es tuyo, el diccionario y las integraciones quedan con código, llaves y documentación a nombre del cliente.

Si prefieres empezar midiendo, el Diagnóstico de HubSpot entrega inventario, riesgos y backlog por 30 UF más IVA. Si vas a licitar el trabajo, revisa cómo armar un RFP para un proyecto de arquitectura de datos.

Preguntas frecuentes

¿Qué es la arquitectura de datos CRM en HubSpot?

Es el diseño de cómo se guardan y relacionan los datos comerciales en HubSpot: qué objetos usas, cómo se asocian, qué identificador evita duplicados y cómo se nombran y documentan las propiedades. En empresas B2B de Chile y Latinoamérica, una buena arquitectura permite que ventas, marketing, servicio y finanzas lean los mismos números sin cuadrarlos a mano.

¿Cómo evito empresas duplicadas en HubSpot si trabajo con RUT?

Crea una propiedad RUT nueva con la opción de valores únicos, disponible en cualquier plan. Esa opción solo se activa al crear la propiedad: si ya tienes un campo RUT, limpia los duplicados, migra los valores al campo nuevo y archiva el antiguo. Usa un formato sin puntos y con guion (con regla de validación si tienes Professional o Enterprise) y haz que la integración con el ERP busque por RUT antes de crear.

¿Qué plan de HubSpot necesito para crear objetos personalizados?

Necesitas cualquier edición Enterprise, por ejemplo de Sales Hub, Service Hub, Marketing Hub, Data Hub, Content Hub o Smart CRM. Se crean en Gestión de datos > Modelo de datos. Si tu empresa en Chile o Latinoamérica no tiene Enterprise, suele bastar con propiedades bien definidas y etiquetas de asociación, que requieren Professional o Enterprise.

¿Qué son las etiquetas de asociación en HubSpot?

Son nombres que describen el rol de una relación entre registros, como decisor o usuario entre un contacto y un negocio, o distribuidor y cliente final entre dos empresas. Las personalizadas requieren Professional o Enterprise y admiten hasta 50 por par de objetos. Sirven para reportar quién decide en cada cuenta. La relación matriz y filial entre empresas ya viene por defecto en todos los planes.

¿Se puede cambiar el nombre interno de una propiedad en HubSpot?

No. HubSpot permite editar el nombre visible, la descripción y las opciones, pero no el nombre interno ni el objeto de la propiedad después de crearla. Las integraciones y la API usan el nombre interno, así que conviene definir la convención antes. Si una propiedad quedó mal nombrada, crea una nueva, migra los valores, actualiza integraciones y reportes y archiva la antigua.

¿Qué debe incluir un diccionario de datos de HubSpot?

Debe incluir, para cada propiedad, el nombre visible y el interno, el tipo, el grupo, la definición de negocio, el dueño, el sistema de origen, quién la escribe, los reportes que la usan y su estado. La base se obtiene con la opción Exportar todas las propiedades, que ya trae la tasa de llenado y los usos.

¿Cuánto tiempo toma ordenar el modelo de datos de un portal existente?

Depende de cuántos objetos y propiedades tiene el portal, cuántas integraciones escriben en él y cuántos duplicados hay. El trabajo avanza por fases: inventario, convención de nombres, identificador y limpieza de duplicados, diccionario y reconexión de integraciones. Lo que más lo alarga suele ser esa última fase, porque cada integración debe buscar por la llave antes de crear. Un inventario inicial, como el Diagnóstico de HubSpot, permite estimarlo.

¿Conviene ordenar los datos antes o después de integrar el ERP?

Antes. Si la integración con el ERP se conecta a un portal sin identificador único ni dueños por dato, multiplica los duplicados y mezcla fuentes de verdad. Primero define el RUT como llave, limpia duplicados y documenta qué sistema manda en cada propiedad. Después conecta el ERP, sea Defontana, Softland u otro usado en Chile, Perú o México.