Validación masiva de transferencias (consola)
Objetivo
Validar muchas transferencias de una sola vez: subes un archivo con sus datos —o las fotos de los comprobantes—, la plataforma lee cada fila y te dice en qué grupo cayó, corriges lo que se pueda corregir y confirmas el lote. A partir de ahí las validaciones corren en segundo plano contra el CEP de Banxico, igual que si las hubieras enviado una a una.
Requisitos previos
- Sesión iniciada en la consola de Veriko.
- Los datos de las transferencias, en una de estas dos formas:
- Archivo de texto — CSV, XLSX, XLS, TXT o JSON.
- Imágenes — PNG, JPG o WEBP, sueltas o dentro de un ZIP.
- Un solo lote a la vez. Si ya tienes una importación en curso, la siguiente subida responde
422 import_already_in_flight: termínala o cancélala primero. - Cuota mensual suficiente para todas las filas del lote. No se comprueba al subir, sino al confirmar — ver Cuotas y planes.
Pasos
1. Descargar la plantilla (opcional, recomendado)
La plantilla trae los encabezados canónicos y tres filas de ejemplo, y se puede pedir en csv, xlsx, xls, txt o json. Los encabezados salen en tu idioma, pero eso es solo comodidad para quien la llena: el lector acepta encabezados en español y en inglés indistintamente.
Usarla te ahorra el modo libre, que es menos preciso.
2. Subir el archivo
Al subir eliges entre dos modos, y dentro del primero, entre dos lecturas:
| Modo | Qué hace |
|---|---|
Texto · template | Lee el archivo por sus encabezados canónicos. Es el camino preciso. |
Texto · free | Barrido de expresiones regulares línea por línea, sin escalar a IA. Sirve para archivos que no siguen ninguna estructura, a costa de precisión. |
| Imágenes | Cada imagen pasa por el mismo OCR y la misma normalización que una validación por comprobante. Si seleccionas varias, el servidor las junta en un solo lote. |
3. Esperar la lectura
El asistente muestra el máximo por lote del plan activo, leído de GET /v1/billing/subscription (bulk_validations_max). El lector rechaza cualquier lote que exceda ese máximo antes de guardar filas.
El rechazo temprano también cubre las entradas del ZIP y las filas de texto que contiene. Los archivos de texto admiten hasta 10 000 filas y 64 columnas; JSON admite hasta 12 MiB. El ZIP se descomprime por flujo, con un máximo real de 20 MiB por entrada y el máximo total configurado para el servicio.
El OCR de imágenes corre durante la vista previa. Cada mes puedes previsualizar el mayor entre 20 imágenes y dos veces el máximo por lote de tu plan. Las imágenes de cargas canceladas también cuentan; al agotar ese presupuesto el trabajo falla con ocr_preview_limit_exceeded antes de llamar al proveedor.
El lote nace en pending, pasa a parsing mientras se lee el archivo y llega a preview_ready cuando hay algo que revisar. La consola lo muestra como Analizando archivo… y avanza sola.
4. Revisar los cuatro grupos
Cada fila leída cae en un grupo, y la vista previa te deja filtrar por ellos:
| Grupo | Qué significa |
|---|---|
| Válidas | La fila está completa y pasa las comprobaciones locales. Entra a la confirmación tal cual. |
| Corregibles | Hay un campo mal, pero lo puedes arreglar aquí mismo. |
| Fatales | Falta algo que no se puede reponer desde la vista previa. |
| Duplicadas | La fila choca con otra del mismo lote. |
5. Corregir o quitar filas
Editar una fila vuelve a pasarle las comprobaciones locales —checksum de la CLABE, fecha válida, monto mayor que cero— y la reasigna de grupo sola: una corregible bien arreglada pasa a válida sin que tengas que hacer nada más. También puedes eliminar una fila del lote; los contadores se actualizan al momento.
Las dos cosas solo se permiten mientras el lote está en preview_ready. Una vez confirmado, ya no.
6. Confirmar el lote
Confirmar despacha todas las filas confirmables. Antes de despachar ninguna, la plataforma suma las filas y las compara con tu cuota disponible: si no alcanza, no se despacha ni una y la respuesta es 422 quota_insufficient. No hay lotes a medias por cuota.
7. Seguir el avance
Confirmado el lote, el estado pasa a committing y luego a completed. A los contadores de la vista previa se suman los de ejecución: despachadas, válidas, no encontradas, inválidas, CEP no disponible, error y saltadas. Puedes marcar Avísame cuando termine y dejar la pestaña.
8. Cancelar, si hace falta
Cancelar descarta las filas que aún no han salido. Las que ya están en proceso terminan por su cuenta, y la cuota de Banxico ya consumida no se reembolsa.
Siguientes pasos
- Revisa los resultados una a una: Consultar el historial de validaciones.
- Entiende cómo se clasifican las filas y qué comparten los dos dominios de importación: Importaciones masivas.
- Si en vez de transferencias vas a cargar cuentas beneficiarias: Importación masiva de beneficiarios.