Con la función de Importación de Préstamos de Belvo, puedes cargar tus carteras de préstamos directamente en el Portal de Débito Directo. Subes un archivo CSV que describe tus préstamos y sus clientes, y luego Belvo crea los clientes, registra sus métodos de pago y aplica tu estrategia de cobro para generar las solicitudes de pago.
Esta es la contraparte sin código de Registrar y Rastrear Carteras de Préstamos (API).
Antes de que se recojan fondos, debes:
- Obtener el consentimiento explícito de tus usuarios, autorizándote a debitar fondos de sus cuentas.
- Mantener evidencia documentada de este consentimiento.
Puedes hacerlo cargando consentimientos en masa con nuestra función de Cargas Masivas de Consentimientos, o programáticamente con nuestra API de Consentimiento.
En tu Portal de Débito Directo, ve a Colecciones Administradas → Importaciones de Préstamos (Sandbox | Producción).
Descarga la plantilla de libro de trabajo
.xlsxenlazada en esa pantalla. La hojaDescripcionesdescribe las 28 columnas, cuáles son obligatorias, y el libro de trabajo restringeBanco,Tipo de IDyEstado del Créditoa sus valores aceptados, por lo que no puedes escribir uno no soportado por error.Siempre comienza desde la plantilla actualSiempre descarga la plantilla desde la pantalla de Importaciones de Préstamos cada vez en lugar de reutilizar una copia antigua para evitar cualquier problema relacionado con la cobertura bancaria o nuevos campos requeridos.
En el libro de trabajo, completa la hoja
MXN.Guarda la hoja
MXNcomo un CSV. Ten en cuenta:- El separador debe ser una coma. Si usas punto y coma (
;), el archivo fallará al subirlo. Asegúrate de que tu CSV use comas (,). - Guarda solo la hoja
MXN. - Guarda los archivos como UTF-8 para asegurar que sea compatible con nuestro sistema.
- El separador debe ser una coma. Si usas punto y coma (
Nombra tu archivo CSV de manera que contenga la fecha de la colección. Consulta la sección Nombrar tu archivo para más detalles, ya que nombrar incorrectamente tu archivo puede llevar a que tus clientes sean cobrados en un día incorrecto.
Sube el CSV en la pantalla de Importaciones de Préstamos. Nota: La plataforma solo acepta archivos CSV.
Revisa el resultado. Las filas que no pudimos procesar se listan con la razón, y puedes corregirlas y subir un archivo corregido.
Belvo lee la fecha de recolección del nombre del archivo. Busca una fecha escrita como YYYY-MM-DD en cualquier parte del nombre, y esa fecha se convierte en el día en que se recolectan los préstamos en ese archivo. Por ejemplo, todos estos se recolectan el 15 de septiembre de 2026:
Daily_MyCompany_2026-09-15_managed_collection.csv
cartera 2026-09-15.csv
2026-09-15-loans.csvSi envías más de un archivo para la misma fecha de recolección, asegúrate de darle a cada archivo un nombre único y (opcionalmente) también agregar un _ + dígito al final de la fecha de recolección. Por ejemplo:
Client1-2026-09-15_0.csv
Client1-2026-09-15_1.csv
Client2-2026-09-15_0.csv
Client2-2026-09-15_1.csvSi el nombre del archivo no contiene una fecha en formato YYYY-MM-DD, Belvo utiliza la fecha de carga del archivo en Ciudad de México (GMT-6) en su lugar, sin fallar la carga. Esto hará que a tu cliente se le cobre en una fecha que no elegiste. Por lo tanto, te recomendamos encarecidamente que siempre proporciones una fecha de recolección en el nombre del archivo.
Si la misma Referencia Única cliente (UID) aparece más de una vez en un archivo, el archivo completo es rechazado y no se recoge nada de él. Una referencia repetida es suficiente.
Cuando Belvo no puede procesar una fila, la fila dada se omite y no se crea ninguna solicitud de pago para ella. Sin embargo, el resto del archivo se procesa normalmente. Puedes corregir las filas marcadas/omitidas y volver a cargar el archivo.
A continuación se presentan las razones más comunes por las que se omite una fila:
| Razón | Qué hacer |
|---|---|
| La CLABE pertenece a un banco que Belvo no soporta para Débito Directo | Nada, de tu parte. Esta es una cobertura que Belvo no tiene, por lo que la fila no puede ser recogida independientemente de cómo esté escrito el archivo. Verifica los bancos aceptados en la lista de bancos de la plantilla, y consulta Instituciones. |
| La misma referencia de cliente aparece dos veces | Envía una fila por cliente por fecha de cobro. Nota: Este error invalida todo el archivo, no solo la fila dada. |
| Un nombre o apellido contiene algo que no son letras | Elimina dígitos, puntuación y símbolos. Se aceptan caracteres acentuados y ñ. |
El número de teléfono no es +52 seguido de exactamente 10 dígitos | Escribe el número como +52 más el número nacional de 10 dígitos, sin espacios ni guiones. |
Una fecha no está escrita como YYYY-MM-DD | Usa YYYY-MM-DD. Este es el único formato aceptado, y las hojas de cálculo a menudo almacenan fechas como números, así que verifica lo que realmente se escribió en el CSV. |
Tipo de ID no es mx_rfc o mx_curp | Usa uno de esos dos valores, y asegúrate de que el número de documento coincida con el tipo: 18 caracteres para un CURP, 12 o 13 para un RFC. |
Estado del Crédito no es un estado aceptado | Usa past_due, restructured, canceled o in_arrears. |
| El número de cuenta tiene la longitud incorrecta | Una CLABE tiene 18 dígitos. Un número de tarjeta tiene de 13 a 16. Para una tarjeta, Banco también debe completarse con un identificador de banco. |