Guía para realizar una importación masiva de suscripciones en Debi
La plataforma permite importar suscripciones de forma masiva mediante un archivo Excel o CSV. Esta función es ideal para realizar el registro de múltiples suscripciones sin hacer el proceso de forma manual.
🧭 ¿Dónde se encuentra esta opción?
- Ve al menú lateral izquierdo.
- Haz clic en "Archivos".
- Selecciona "Importaciones" > "Crear nueva" > "Importar suscripciones".
🛠️ Pasos para realizar la importación
1. Descargar la plantilla de ejemplo
Al iniciar el proceso verás el Paso 1 con un botón para descargar una plantilla CSV. Este archivo contiene todos los campos necesarios para registrar las suscripciones.
2. Completar la plantilla con tus datos
A continuación, se muestra el significado de cada campo incluido en la plantilla:
| Campo | Descripción |
|---|---|
amount | Monto que se cobrará por la suscripción |
description | Descripción o detalle de la suscripción |
customer_id | ID del cliente (asignado por la plataforma) |
payment_method_number | Número plano de la tarjeta o CBU que se usará para el cobro |
payment_method_id | ID del método de pago (si ya está previamente cargado en el sistema) |
start_date | Fecha de inicio de la suscripción (formato YYYY-MM-DD) |
interval_unit | Frecuencia del cobro (ejemplo: mensual, semanal, anual) |
day_of_month | Día del mes en que debe generarse el cobro |
metadata_additional_data | Información adicional opcional que quieras asociar a la suscripción |
💡 Tip: Cuando abras el CSV en Excel, asegúrate de que el formato de las fechas se mantenga como
YYYY-MM-DD, ya que el excel toma la configuración regional de tu dispositivo, por lo que es recomendable guardar como csv antes de subirlo para evitar filas inválidas por formato incorrecto.
3. Configurar opciones antes de subir
Antes de cargar el archivo, puedes activar dos opciones útiles:
- Permitir importación parcial: Las filas válidas se importarán incluso si otras tienen errores.
- Usar Smart Merge: Si el correo ya está registrado, el sistema asociará la nueva suscripción al cliente existente.
4. Subir el archivo
- Haz clic en "Subir archivo".
- Selecciona tu archivo guardado en formato Excel o CSV.
- El sistema mostrará una barra de progreso durante la validación del contenido.
5. Confirmar la importación
Luego de validar el archivo:
- Aparecerá un mensaje preguntando: ¿Estás seguro de procesar este archivo?
- Haz clic en Aceptar para continuar.
- Se mostrará el porcentaje de avance y podrás hacer clic en "Ir al recurso" para revisar las suscripciones cargadas.
✅ Recomendaciones clave
- Verifica que las fechas estén en formato
YYYY-MM-DD. - No edites el archivo después de guardarlo como CSV para evitar cambios automáticos.
- Usa
payment_method_idsolo si el método de pago ya existe. - La opción de importación parcial es útil para evitar perder todo el trabajo por un error mínimo.
📘 Conclusión
La funcionalidad de importación masiva agiliza la carga de suscripciones y ayuda a mantener el orden y consistencia en grandes volúmenes de datos. Con esta guía podrás implementarla sin complicaciones.
Importación masiva en un solo paso (clientes + suscripciones)
Además del método tradicional, Debi permite realizar una importación masiva combinada, en la que puedes cargar en un solo archivo tanto los datos de nuevos clientes como sus suscripciones asociadas.
Este método es ideal si estás comenzando y aún no tienes clientes registrados en la plataforma.
📂 ¿Cómo acceder?
- En el menú lateral izquierdo, ve a "Archivos".
- Luego selecciona "Importaciones" > "Crear nueva" > "Importar suscripciones".
- Descarga la plantilla de ejemplo que encontrarás en el Paso 1.
🧾 Campos para carga de clientes nuevos y suscripciones
La plantilla descargada inicialmente está orientada al formato tradicional, pero puedes agregar columnas con los siguientes datos del cliente:
🔹 Datos del cliente
| Campo | Descripción |
|---|---|
customer_name | Nombre completo del cliente |
customer_identification_type | Tipo de identificación (DNI, CUIT, Pasaporte, Cédula, etc.) |
customer_identification_number | Número de la identificación seleccionada |
customer_mobile_number | Número de teléfono móvil del cliente |
customer_email | Dirección de correo electrónico |
⚠️ Si estás creando clientes nuevos, no uses el campo
customer_id.
🔸 Datos de la suscripción (como en el método tradicional)
| Campo | Descripción |
|---|---|
amount | Monto que se cobrará por la suscripción |
description | Descripción de la suscripción |
payment_method_number | Número plano de la tarjeta o CBU (no tokenizada) |
start_date | Fecha en la que debe activarse la suscripción (formato YYYY-MM-DD) |
interval_unit | Frecuencia del cobro (ejemplo: mensual, semanal, anual) |
day_of_month | Día del mes en que debe realizarse el cobro |
metadata_additional_data | Información adicional opcional para asociar a la suscripción |
🚫 En este flujo NO debes incluir el campo
payment_method_id, ya que se está utilizando un método de pago nuevo (número plano).
📤 Subir el archivo
Una vez completado el archivo con todos los datos:
-
Guárdalo en formato Excel o CSV para evitar problemas de formato.
-
En el Paso 2, haz clic en "Subir archivo" y selecciona tu archivo.
-
El sistema validará el contenido y mostrará:
- Datos correctos e incorrectos.
- Número de filas aceptadas.
- Motivos de error (por ejemplo, número inválido o método de pago mal cargado).
✅ Validar y confirmar importación
Una vez validado:
- Se mostrará una barra de progreso con el estado de la carga.
- Si todo está correcto, haz clic en "Confirmar".
- Aparecerá el mensaje: ¿Está seguro de procesar este archivo?
- Al aceptar, se procederá a crear automáticamente los clientes y suscripciones.
Cuando finalice el proceso, en la columna "Recursos", podrás hacer clic en "Ir" para revisar la suscripción creada y verificar que tanto el cliente como el método de pago hayan sido registrados correctamente.
🧠 Consideraciones adicionales
- Revisa bien los números telefónicos y fechas antes de guardar el archivo.
- Si el archivo tiene errores, puedes corregirlo y volver a cargarlo.
- Este flujo ahorra mucho tiempo si trabajas con grandes volúmenes de nuevos clientes.
🎯 Conclusión general
Con estas dos modalidades de importación, puedes gestionar suscripciones de manera rápida, ya sea para clientes ya existentes o cargando nuevos desde cero.
Usa la opción que mejor se ajuste a tu flujo operativo, y recuerda siempre validar bien los datos antes de confirmar la importación.