Guía para realizar una importación masiva de pagos en Debi
🧭 Introducción
La funcionalidad de importación masiva en Debi permite cargar múltiples pagos de forma eficiente mediante una plantilla en formato archivo. Esta herramienta es ideal para organizaciones que manejan grandes volúmenes de cobros y desean automatizar el proceso, minimizando errores manuales.
En esta guía aprenderás a realizar correctamente una importación masiva de pagos paso a paso.
🛠️ Pasos para importar pagos masivamente de forma tradicional
1. Acceder a la sección de importaciones
Desde el menú lateral izquierdo:
- Dirígete a Archivos > Importaciones
- Haz clic en Crear nueva
- Selecciona Importar pagos
2. Descargar y completar la plantilla
Una vez dentro del proceso de importación, verás los pasos enumerados:
📄 Paso 1: Descargar la plantilla de ejemplo
La plantilla contiene los campos necesarios para la carga de pagos:
| Campo | Descripción |
|---|---|
customer_id | ID asignado al cliente dentro de la plataforma Debi. |
descripción | Texto que identifica el motivo o concepto del pago. |
payment_method_number | Número de tarjeta sin tokenizar (no recomendado si ya se tokenizó antes). |
payment_method_id | ID del método de pago ya tokenizado, recomendado por seguridad. |
amount | Monto del pago. |
metadata | Campos personalizados. La plantilla incluye dos, pero puedes agregar más. |
Importante:
- Si usas el
payment_method_numberno debes usar elpayment_method_idy viceversa. - Si ya tienes clientes con métodos de pago asignados (preferido o alternativo asignado al cliente), puedes importar el pago sin
payment_method_idypayment_method_numberporque el sistema puede asignárselos automáticamente. - Si es cliente no tiene método de pago, e importas el pago sin
payment_method_numbernipayment_method_id, el pago aparecerá en estadoincompleteya que quedará pendiente de asignar manualmente o por medio de una sesión su correspondiente método de pago.
Ejemplo de uso:
- Cliente 1: Sin datos de método de pago porque tiene uno por defecto asignado. El pago hereda el método de pago por defecto.
- Cliente 2: Con
payment_method_iddirectamente asignado. - Cliente 3: Sin método de pago, el pago se importa sin indicar método de pago, y por eso quedará en estado incompleto
3. Subir el archivo completado
📤 Paso 2: Cargar archivo
- Haz clic en Subir archivo
- Selecciona tu archivo.
- El sistema procesará el contenido y te mostrará una vista previa con las líneas detectadas
✅ Validación automática: La plataforma indica si los registros son válidos o inválidos. Puedes alternar la vista para revisar los errores.
4. Confirmar la importación
Una vez validados los registros:
- Haz clic en Confirmar
- Aparecerá una ventana de confirmación final
- Presiona Aceptar para iniciar la carga
La plataforma mostrará una barra de progreso y confirmará que los pagos se han creado correctamente.
5. Verificar los pagos importados
- Desde la lista generada, puedes hacer clic en Ir a recursos para revisar los pagos creados.
- Verifica que cada cliente tenga asociado el medio de cobro correcto, ya sea por asignación directa o por uso del método por defecto guardado en su perfil.
🔍 Notas importantes
- El uso del
Payment Method IDes preferible porque garantiza mayor seguridad y rapidez en el proceso. - Puedes usar metadatos para enriquecer los pagos con información adicional.
- Los pagos no se generan hasta que se confirme explícitamente la importación.
🧾 Conclusión
La importación masiva de pagos es una herramienta poderosa para automatizar procesos dentro de Debi. Asegúrate de completar correctamente la plantilla, validar los registros antes de confirmar y utilizar los métodos de pago más seguros disponibles. Esta funcionalidad optimiza el tiempo y mejora la precisión del proceso de cobros.
🚀 Importación masiva de pagos sin clientes registrados en Debi
En casos de migraciones iniciales o cuando aún no se han creado clientes en la plataforma Debi, existe una opción más directa para importar pagos y registrar automáticamente los clientes en un solo paso.
🛠️ Pasos para importar pagos y crear clientes automáticamente
1. Acceder a la sección de importaciones
Desde el panel lateral izquierdo:
- Dirígete a Archivos > Importaciones
- Haz clic en Crear nueva
- Selecciona Importar pagos
2. Preparar el archivo de importación
📄 Descargar y modificar la plantilla
Aunque la plantilla base incluye el campo Customer ID, este no aplica si aún no tienes clientes registrados. En su lugar, debes agregar campos que permitan crear automáticamente los registros de cliente:
| Campo | Descripción |
|---|---|
Customer Name | Nombre del cliente |
Customer Identification Type | Tipo de documento (DNI, CUIT, pasaporte, etc.) |
Customer Identification Number | Número del documento según el tipo elegido |
Customer Mobile Number | Número de teléfono móvil |
Customer Email | Correo electrónico del cliente |
Description | Descripción del pago |
Payment Method Number | Número de tarjeta sin tokenizar (opcional) |
Amount | Monto del pago |
Metadata | Campos personalizados adicionales (ej. curso, referencia, etc.) |
💡 Nota: Puedes adaptar los campos según los datos disponibles, siempre y cuando incluyas la información mínima para crear el cliente.
3. Uso del Smart Merge por email (opcional)
Debi incluye una validación inteligente que revisa si un cliente con el mismo email ya existe. El sistema actúa de la siguiente manera:
- Si el email ya existe, se asigna el pago al cliente correspondiente.
- Si no existe, se crea un nuevo cliente automáticamente.
4. Subir el archivo
- Haz clic en Subir archivo
- Selecciona el archivo que contiene los datos completos de clientes y pagos
- Una vez cargado, el sistema mostrará una vista previa de los datos procesados
🧠 Importante: Verás que el sistema genera automáticamente un
Customer IDpara cada nuevo cliente cargado.
5. Confirmar y generar los pagos
- Haz clic en Confirmar
- Aparecerá un mensaje de confirmación
- Presiona Aceptar para iniciar la importación
Verás una barra de progreso y una vez completado el proceso, podrás acceder al detalle:
- Revisa cada línea haciendo clic en Ir de la columna recurso
- Verifica que el cliente fue creado correctamente con todos sus datos
- Confirma que el pago haya sido generado y asignado
🔍 Ventajas de este método
- Ahorra tiempo al evitar la carga separada de clientes.
- Ideal para procesos de migración o cuando no se dispone de datos previos en Debi.
- Permite centralizar el proceso de alta de clientes y cobros.
📘 Conclusión
La funcionalidad de importación masiva sin clientes registrados es una solución eficiente para comenzar a operar rápidamente en Debi. Preparando correctamente la plantilla, podrás crear nuevos clientes y asignarles pagos en un solo paso, optimizando tus tiempos y recursos.
Puedes ver los siguientes videos:
Importación masiva de pagos:
Importación masiva de pagos con creación de clientes en un solo paso: