{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/es/products/payments_mexico/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","img"]},"type":"markdown"},"seo":{"title":"Introducción","description":"Belvo provides open finance products for Latin America that allow you to securely access and aggregate financial data as well as accept and issue bank-to-bank payments","siteUrl":"https://developers.belvo.com/","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"introducción","__idx":0},"children":["Introducción"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Esta es la contraparte sin código de ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/es/products/payments_mexico/direct-debit-loans-api","target":"_blank"},"children":["Registrar y Rastrear Carteras de Préstamos (API)"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Obtén el consentimiento del usuario para debitar cuentas"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Antes de que se recojan fondos, debes:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Obtener el consentimiento explícito de tus usuarios, autorizándote a debitar fondos de sus cuentas."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Mantener evidencia documentada de este consentimiento."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Puedes hacerlo cargando consentimientos en masa con nuestra función de ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/es/products/payments_mexico/direct-debit-sftp-consents-guide","target":"_blank"},"children":["Cargas Masivas de Consentimientos"]},", o programáticamente con nuestra ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/es/apis/belvopaymentsmexico/payment-consents-(direct-debit-mexico)","target":"_blank"},"children":["API de Consentimiento"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"instrucciones","__idx":1},"children":["Instrucciones"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["En tu Portal de Débito Directo, ve a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Colecciones Administradas"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Importaciones de Préstamos"]}," (",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://portal.sandbox.directdebit.belvo.com/portal/managed-collections/loan-imports","target":"_blank"},"children":["Sandbox"]}," | ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://portal.directdebit.belvo.com/portal/managed-collections/loan-imports","target":"_blank"},"children":["Producción"]},")."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Descarga la plantilla de libro de trabajo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".xlsx"]}," enlazada en esa pantalla."," ","La hoja ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Descripciones"]}," describe las 28 columnas, cuáles son obligatorias, y el libro de trabajo restringe ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Banco"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Tipo de ID"]}," y ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Estado del Crédito"]}," a sus valores aceptados, por lo que no puedes escribir uno no soportado por error."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Siempre comienza desde la plantilla actual"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Siempre descarga la plantilla desde la pantalla de ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["En el libro de trabajo, completa la hoja ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MXN"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Guarda la hoja ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MXN"]}," como un ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CSV"]},". Ten en cuenta:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["El separador debe ser una coma."]}," Si usas punto y coma (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[";"]},"), el archivo fallará al subirlo. Asegúrate de que tu CSV use comas (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[","]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Guarda solo la hoja ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MXN"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Guarda los archivos como UTF-8"]}," para asegurar que sea compatible con nuestro sistema."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Nombra tu archivo CSV de manera que contenga la fecha de la colección. Consulta la sección ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#naming-your-file"},"children":["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."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sube el CSV en la pantalla de ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Importaciones de Préstamos"]},". Nota: La plataforma solo acepta archivos CSV."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Revisa el resultado. Las filas que no pudimos procesar se listan con la razón, y puedes corregirlas y subir un archivo corregido."]}]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mx-pay-dd-loan-snapshots-ui.acfbda5bc1d7b16593ef0779e1fc452e3cea140bb69a55570f0b13e8e34632b0.9c1bb791.png","withLightbox":false},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"nombrar-tu-archivo","__idx":2},"children":["Nombrar tu archivo"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Belvo lee la ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["fecha de recolección"]}," del nombre del archivo. Busca una fecha escrita como ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["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:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","data-title":"Nombres de archivo válidos","header":{"title":"Nombres de archivo válidos","controls":{"copy":{}}},"source":"Daily_MyCompany_2026-09-15_managed_collection.csv\ncartera 2026-09-15.csv\n2026-09-15-loans.csv\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Si 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 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["_"]}," + dígito al final de la fecha de recolección. Por ejemplo:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","data-title":"Cargas múltiples de archivos para la misma fecha de recolección","header":{"title":"Cargas múltiples de archivos para la misma fecha de recolección","controls":{"copy":{}}},"source":"Client1-2026-09-15_0.csv\nClient1-2026-09-15_1.csv\nClient2-2026-09-15_0.csv\nClient2-2026-09-15_1.csv\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Fechas de Recolección Vacías"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Si el nombre del archivo no contiene una fecha en formato ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YYYY-MM-DD"]},", Belvo utiliza la ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"qué-sucede-con-las-filas-que-belvo-no-puede-procesar","__idx":3},"children":["Qué sucede con las filas que Belvo no puede procesar"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Asegúrate de proporcionar identificadores únicos de cliente"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Si la misma ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Referencia Única cliente (UID)"]}," aparece más de una vez en un archivo, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["el archivo completo es rechazado"]}," y no se recoge nada de él. Una referencia repetida es suficiente."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A continuación se presentan las razones más comunes por las que se omite una fila:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Razón"},"children":["Razón"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Qué hacer"},"children":["Qué hacer"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La CLABE pertenece a un banco que Belvo no soporta para Débito Directo"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/es/products/payments_mexico/direct-debit-institutions","target":"_blank"},"children":["Instituciones"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La misma referencia de cliente aparece dos veces"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Envía una fila por cliente por fecha de cobro. Nota: Este error invalida todo el archivo, no solo la fila dada."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Un nombre o apellido contiene algo que no son letras"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Elimina dígitos, puntuación y símbolos. Se aceptan caracteres acentuados y ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ñ"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["El número de teléfono no es ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["+52"]}," seguido de exactamente 10 dígitos"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Escribe el número como ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["+52"]}," más el número nacional de 10 dígitos, sin espacios ni guiones."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Una fecha no está escrita como ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YYYY-MM-DD"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Usa ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Tipo de ID"]}," no es ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mx_rfc"]}," o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mx_curp"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Estado del Crédito"]}," no es un estado aceptado"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Usa ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["past_due"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["restructured"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canceled"]}," o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["in_arrears"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["El número de cuenta tiene la longitud incorrecta"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Una CLABE tiene 18 dígitos. Un número de tarjeta tiene de 13 a 16. Para una tarjeta, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Banco"]}," también debe completarse con un identificador de banco."]}]}]}]}]}]},"headings":[{"value":"Introducción","id":"introducción","depth":1},{"value":"Instrucciones","id":"instrucciones","depth":2},{"value":"Nombrar tu archivo","id":"nombrar-tu-archivo","depth":2},{"value":"Qué sucede con las filas que Belvo no puede procesar","id":"qué-sucede-con-las-filas-que-belvo-no-puede-procesar","depth":2}],"frontmatter":{"seo":{"title":"Introducción"}},"lastModified":"2026-09-11T13:53:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/es/products/payments_mexico/direct-debit-loan-portfolios-no-code","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}