- Base de conocimientos
- Ingresos
- Contratos
- Migrar contratos a HubSpot
BetaMigrar contratos a HubSpot
Última actualización: 23 de julio de 2026
Disponible con cualquiera de las siguientes suscripciones, a no ser que se indique de otro modo:
-
Revenue Hub Pro, Enterprise
-
Se requieren licencias
La suscripción es obligatoria Para migrar contratos es necesario disponer de una suscripción a Revenue Hub .
Se requieren licencias Para migrar los contratos es necesario disponer de una licencia de Revenue Hub .
Se requieren permisos Para llevar a cabo la migración se necesitan permisos de superadministrador .
Migrar los contratos existentes desde un sistema antiguo a HubSpot para gestionar la facturación y la elaboración de informes de ingresos. La migración conserva los métodos de pago, el historial de contratos y los calendarios de pago a plazos futuros. Tras la migración, podrás utilizar HubSpot como fuente de referencia para los datos sobre los ingresos comprometidos. Obtén más información sobre cómo utilizar los contratos en HubSpot.
Antes de empezar
Antes de comenzar a trabajar con esta característica, asegúrate de que comprendes perfectamente qué pasos hay que dar con antelación, así como las limitaciones de la función y las posibles consecuencias de utilizarla.
Comprender los requisitos
-
Nota: si eres superadministrador, puedes inscribir tu cuenta en la versiónbetade « : Migración de la facturación a contratos de Revenue Hub» ( ).
-
Tu cuenta de HubSpot debe utilizar Stripe como opción de procesamiento de pagos con Stripe. Si utiliz , los pagos de HubSpot y deseas migrar los métodos de pago de una cuenta externa de Stripe a los pagos de HubSpot, rellena este formulario.
-
Formatea el archivo CSV según el proceso de pago y la opción de continuidad de ingresos que selecciones. Obtén más información sobre cómo elegir el formato de migración más adecuado para tu empresa.
Comprender las limitaciones y consideraciones
- Si utilizas la continuidad de ingresos, prueba la importación en un entorno de pruebas. Si se importan datos incorrectos a tu cuenta, no podrás corregir los datos históricos de los informes de cascada de MRR.
- Una vez activado el contrato, HubSpot pasa a ser el sistema de referencia para la facturación. La migración no se puede deshacer.
- Cualquier modificación del contrato debe realizarse en HubSpot. Más información sobre cómo consultar y gestionar contratos.
- Tras la activación, solo podrás actualizar la «Excepción de la fecha de inicio de facturación» y el «ID del método de pago» si el contrato no tiene facturas de pago ni pagos.
Elige el formato de migración
Antes de realizar la migración, selecciona un formato de migración en función de cómo quieras que HubSpot gestione los contratos tras la migración. El formato de migración depende del proceso de recopilación y de si se desea incluir los eventos históricos de modificación de contratos (por ejemplo, actualizaciones o ampliaciones).
Proceso de cobro de los pagos
- Pagos manuales: tras la migración, se generan facturas para que los compradores las paguen manualmente.
- Pagos automáticos: tras la migración, las facturas se cobran automáticamente mediante el pago que figura en el sistema.
Continuidad de los ingresos
- No hay continuidad en los ingresos: los contratos se importan sin que se produzcan cambios en los ingresos.
- Continuidad de los ingresos: utiliza las claves de rampa para agrupar los elementos de pedido en fases y mostrar los eventos de cambio (por ejemplo, mejoras, ampliaciones o rebajas) en la cascada de MRR de HubSpot. Si utilizas la continuidad de ingresos, prueba la importación en un entorno de pruebas. Si se importan datos incorrectos a tu cuenta, no podrás corregir los datos históricos de los informes de cascada de MRR.
Rampas
Teclas de rampa
Las claves de rampa agrupan varias filas de elementos de pedido en fases. Las filas que tengan la misma clave de rampa se tratan como una rampa continua.
En HubSpot, cada fase de la rampa genera eventos de MRR (por ejemplo, nuevos clientes, actualizaciones, ampliaciones) al inicio de cada fase. La clave «ramp» puede ser cualquier cadena de texto (por ejemplo, ramp-a). Esa misma cuerda debe extenderse a lo largo de todas las filas de esa rampa.
Cómo construir una rampa
Para migrar las rampas correctamente, estructúralas de la siguiente manera:
- Intervalos de fechas que no se solapan: los periodos de cada fila no deben solaparse con los de otra fila. Si las fases de la rampa deben ser continuas, cada fase debería comenzar al finalizar la fase anterior.
- Condiciones por fase: las condiciones de cada fila se refieren únicamente a esa fase del contrato, y no a toda la vigencia del mismo.
- Cantidad total de cada fila: introduce la cantidad total del elemento de pedido correspondiente a esa fase
- ID de importación de la rampa clave: agrupa los elementos de pedido bajo la misma rampa. Más información sobre cómo crear una propiedad de rampa personalizada.
Nota:
- Un contrato puede incluir elementos de pedido con escalonamiento y sin escalonamiento. En el caso de los elementos de pedido sin rampa, deja el
ramp_key_import_iden blanco y utiliza las mismasimport_unique_idque las líneas del contrato correspondiente. - Un contrato puede incluir varios productos que se implementan de forma independiente. Cada producto debe tener su propio
ramp_key_import_id. Cada rampa genera sus propios eventos MRR.
Por ejemplo, en el caso de un contrato de 12 meses con un cambio de precio al cabo de tres meses:
| Elemento de pedido | Precio unitario | Cantidad | Término | Fecha de inicio | ramp_key_import_id |
|---|---|---|---|---|---|
| Servicio mensual | $100 | 1 | 3 meses | 1 de enero de 2026 | ramp-a |
| Servicio mensual | $100 | 2 | 9 meses | 1 de abril de 2026 | ramp-a |
Posibles formatos de migración
| Formato de migración | Proceso de cobros | Continuidad de los ingresos |
|---|---|---|
| Pagos manuales sin continuidad en los ingresos | Pagos manuales | No incluido |
| Pagos manuales con continuidad de ingresos | Pagos manuales | Incluye |
| Pagos automáticos sin continuidad de ingresos | Pagos automáticos | No incluido |
| Pagos automáticos con continuidad de ingresos | Pagos automáticos | Incluido |
Prepárate para la migración
Antes de iniciar la migración, configura tu cuenta y prepara tu archivo CSV según el formato de migración seleccionado.
Crear propiedades personalizadas
Crea las propiedades personalizadas necesarias antes de importar tu archivo CSV. Las propiedades que debes crear dependen del formato de migración seleccionado. Más información sobre la creación de propiedades personalizadas.
| Formato de migración | Objetos | Nombre de la propiedad personalizada | Tipo de propiedad personalizada | Reglas de validación | Se utiliza para |
|---|---|---|---|---|---|
| Todas las opciones | Contratos | import_unique_id |
Texto de línea única | Requerir valores únicos | Agrupa todas las filas que pertenecen al mismo contrato. |
| Pagos manuales con continuidad de ingresos o pagos automáticos con continuidad de ingresos | Elementos de línea | ramp_key_import_id |
Texto de línea única | Ninguno | Agrupa varios elementos de pedido en fases. |
Configurar el archivo CSV
Configura el archivo CSV que se utilizará con la herramienta de importación para migrar los contratos a HubSpot.
Archivos CSV de ejemplo
Utiliza los archivos CSV de ejemplo que aparecen a continuación, en función del formato de migración que estés utilizando.
| Formato de migración | Enlace CSV |
|---|---|
| Pagos manuales, sin continuidad en los ingresos | Descargar |
| Pagos manuales con continuidad de ingresos | Descargar |
| Pagos automáticos, sin continuidad de ingresos | Descargar |
| Pagos automáticos con continuidad de ingresos | Descargar |
| Mixto: un producto con estructura de precios escalonada y otro con tarifa plana (sin clave de escalonamiento) | Descargar |
Varias rampas independientes: el producto A (ramp-a) y el producto B (ramp-b) se activan por separado |
Descargar |
Formato CSV
Tu archivo CSV debe incluir las siguientes columnas y propiedades de HubSpot.
| Nombre de la columna | Objetos | Propiedad | Detalles |
|---|---|---|---|
| Fecha de entrada en vigor del contrato | Contrato | hs_contract_effective_date |
La fecha en la que el contrato entra en vigor. |
| Código de divisa | Contrato | hs_currency_code |
Código de divisa, como USD. |
| Nombre | Contrato | hs_name |
Nombre del contrato. |
| Facturación de HubSpot activada | Contrato | hs_hubspot_billing_enabled |
Debe ser TRUE para todos los contratos que se vayan a migrar. |
| Proceso de cobros | Contrato | hs_collection_process |
Manual o automático. Debe ajustarse al formato de migración. |
| Modificación de la fecha de inicio de la facturación | Contrato | hs_billing_start_date_override |
La fecha en la que HubSpot comienza a facturar. Esta fecha debe ser una fecha futura en el momento de la migración. Obligatorio para todos los formatos de migración. |
| ID del método de pago del pago | Contrato | hs_external_payment_method_reference_id |
Déjalo en blanco para los pagos manuales. Es necesario para los pagos automáticos. |
| Correo | Contacto | email |
La dirección de correo electrónico del contacto de facturación. |
| Nombre | Contacto | firstname |
Nombre de la persona de contacto para la facturación. |
| Apellido | Contacto | lastname |
Apellido de la persona de contacto para la facturación. |
| Producto | Elemento de pedido | hs_product_id |
Número de identificación del producto. La migración hace referencia a un registro de producto ya existente y no crea un nuevo producto. |
| Nombre del elemento de pedido | Elemento de pedido | name |
Nombre del elemento de pedido. |
| Precio unitario | Elemento de pedido | price |
Precio unitario en la divisa del contrato. |
| Cantidad | Elemento de pedido | quantity |
La cantidad de cada elemento de pedido durante una fase. |
| import_id_único | Elemento de pedido | Propiedad personalizada | Identificador compartido para todas las filas del mismo contrato. |
| Término | Elemento de pedido | hs_recurring_billing_period |
El término del elemento de pedido. Cuando utilices rampas, introduce el término correspondiente a cada segmento. |
| Frecuencia de facturación periódica | Elemento de pedido | recurringbillingfrequency |
Frecuencia de facturación (por ejemplo, mensual). |
| Fecha de inicio del elemento de pedido | Elemento de pedido | hs_recurring_billing_start_date |
Fecha de inicio de la facturación del elemento de pedido. |
| ramp_key_import_id | Elemento de pedido | Propiedad personalizada | Agrupa las fases de los elementos de pedido individuales en una sola rampa. Es imprescindible para garantizar la continuidad de los ingresos. Deja este campo en blanco para los formatos de migración sin continuidad de ingresos. |
Iniciar la migración
Una vez que hayas configurado tu archivo CSV, podrás empezar a migrar los contratos a HubSpot.
- En tu cuenta de HubSpot, haz clic en Más y luego ve a Ingresos > Contratos. Si Más no aparece en tu cuenta, ve directamente a Ingresos > Contratos.
- En la parte superior derecha, haz clic en Importar.
- En la sección Importar un archivo , haga clic en Importar datos.
- Haz clic en Importaciones avanzadas (todos los objetos).
- En la sección «Objetos», haz clic en «Contratos». El elemento de pedido «partidas» se seleccionará automáticamente.
- En la parte inferior derecha, haz clic en Siguiente.
- Configure cómo desea importar sus datos:
- Subir un archivo: arrástralo y suéltalo, o haz clic en «Seleccionar un archivo» y, a continuación, selecciona el archivo que deseas importar.
- Copiar y pegar: haz clic en «Pegar» directamente desde tu hoja de cálculo y pega tus datos. Los datos deben copiarse de un archivo de hoja de cálculo (por ejemplo, Numbers, Google Sheets).
- Idioma: si vas a importar datos en un idioma distinto al predeterminado, haz clic en el menú desplegable «Selecciona el idioma de los encabezados de las columnas de tu archivo» y selecciona el idioma. Seleccionar el idioma correcto permite a HubSpot ajustar mejor los encabezados de columna a las propiedades predeterminadas existentes. Si no hay coincidencias en el idioma que hayas seleccionado, HubSpot buscará una propiedad en inglés para hacer la coincidencia.
- En la parte inferior derecha, haz clic en Siguiente.
- Asigna las columnas del archivo de importación a las propiedades de HubSpot. Más información sobre las asignaciones de propiedades CSV.
- En la parte inferior derecha, haz clic en Siguiente.
- En el campo «Nombre de la importación », introduce un nombre para la importación.
- Haz clic en el menú desplegable «Seleccionar la base jurídica para el tratamiento de los datos de un contacto » y selecciona una base jurídica. Más información sobre cómo realizar un seguimiento de la base jurídica del tratamiento de datos en HubSpot.
- Haz clic en el menú desplegable «Formato de fecha » y selecciona un formato de fecha.
- Haz clic en el menú desplegable «Zona horaria » y selecciona una zona horaria.
- Haz clic en el menú desplegable «Formato numérico » y selecciona un formato numérico.
- Marca la casilla de verificación «Establecer estos contactos como contactos de marketing» si deseas interactuar con los contactos importados mediante las herramientas de marketing de HubSpot. Más información sobre los contactos de marketing.
- Marca la casilla de verificación «Enriquecer registros » para enriquecer los registros durante la importación. Más información sobre el enriquecimiento de datos de contacto y de empresas.
- En la esquina inferior derecha, haz clic en «Finalizar importación».
Solución de problemas
Repasa los errores más comunes que se producen al importar datos y los pasos para solucionarlos. Si te aparece otro error, revisa el formato del archivo CSV y las asignaciones de propiedades y, a continuación, vuelve a intentar la importación.
Modificación de la fecha de inicio de la facturación para una fecha anterior
El error «La fecha de inicio de facturación es anterior a la fecha actual» se produce cuando la fecha de inicio de facturación de un elemento de pedido del archivo CSV es anterior a la fecha actual .
Para solucionar este error:
- Actualiza las fechas de facturación para que sean futuras.
- Guarda el archivo CSV y vuelve a iniciar la importación.
El ID del método de pago de Stripe no es válido o falta
Este error se produce cuando se selecciona la opción de pagos automáticos como método de cobro, pero no se ha añadido el identificador del método de pago de Stripe al archivo CSV.
Para solucionar este error, puedes hacer una de estas dos cosas:
- Cambia las entradas de pagos automáticos por pagos manuales.
- Añade un identificador de método de pago de Stripe para que se generen automáticamente los asientos de pago en el archivo CSV.
Se ha detectado un «import_unique_id» duplicado de un intento anterior
Si una importación falla, es posible que HubSpot registre igualmente los import_unique_id valores de la importación fallida.
Para solucionar este error:
- Actualiza tu archivo CSV con los nuevos ID.
- Importa el archivo CSV actualizado.
Glosario
Revisa las siguientes condiciones antes de migrar los contratos a HubSpot.
| Término | Descripción |
|---|---|
| Pagos automáticos | Un proceso de cobros en el que las facturas se cargan automáticamente mediante un método de pago guardado. |
| Modificación de la fecha de inicio de la facturación | La fecha en la que HubSpot debería empezar a facturar el contrato migrado. |
| Proceso de cobros | Cómo se cobran los pagos tras la migración. Los pagos pueden ser cobrados manualmente por el comprador o de forma automática mediante un método de pago registrado. |
| import_id_único | Una propiedad personalizada que se utiliza para agrupar las filas que pertenecen al mismo contrato durante la migración. |
| Pagos manuales | Un proceso de cobros en el que las facturas se generan en HubSpot y los compradores las abonan manualmente. |
| Formato de migración | La estructura CSV utilizada para la importación. El formato de migración depende de cómo se vayan a realizar los cobros de los pagos y de si deseas incluir la continuidad de los ingresos. |
| MRR | Ingresos recurrentes mensuales. En HubSpot, el MRR se utiliza para generar informes sobre los ingresos recurrentes derivados de los contratos. |
| Cascada de MRR | Un informe de ingresos que muestra cómo varían los ingresos recurrentes a lo largo del tiempo debido a acontecimientos como la captación de nuevos clientes, las actualizaciones, las ampliaciones, las reducciones de plan y la pérdida de clientes. |
| ID del método de pago del pago | La referencia al método de pago externo que se utiliza en los contratos con pagos automáticos. |
| Rampa | Un cambio en el precio o en la cantidad que se produce a lo largo de la vigencia de un contrato. |
| Tecla de rampa | Valor que se utiliza para agrupar filas de elementos de pedido relacionados en una sola rampa. |
| Fase de aceleración | Un periodo dentro de una rampa. Cada fase tiene su propio plazo, precio, cantidad y fecha de inicio. |
| ramp_key_import_id | Una propiedad personalizada de los elementos de pedido que se utiliza para agrupar las filas de los elementos de pedido en fases de rampa durante la migración. |
| Continuidad de los ingresos | Una opción que incluya los cambios históricos en los contratos, como mejoras, ampliaciones o reducciones, para que puedan reflejarse en los informes de ingresos. |
| Sistema de registro | El sistema principal utilizado para gestionar y mantener la información sobre contratos y facturación tras la migración. |