Volver al inicio

Validación CSV masiva

Valide miles de coordenadas bancarias en una sola solicitud mediante la carga de un archivo CSV.

Función del Paquete Business

La validación CSV masiva está disponible exclusivamente con el Paquete Business (100.000 validaciones). Cada fila del archivo consume un crédito de validación.

Cómo funciona

1

Prepare su CSV

Cree un archivo CSV con las columnas requeridas: type, identifier, account_number. Cada fila representa una coordenada bancaria a validar.

2

Envíe el archivo

Cargue su archivo CSV a través del endpoint POST /api/v1/validate/bulk. El procesamiento es asíncrono para archivos grandes.

3

Descargue los resultados

Descargue el archivo CSV enriquecido con las columnas de resultado: status, confidence, bank_name y errors.

Formato CSV

Columnas requeridas

ColumnaDescripciónEjemplo
typeTipo de validación: US, UK, SWIFT o IBANUS
identifierIdentificador principal (routing number, sort code, BIC o IBAN)021000021
account_numberNúmero de cuenta (requerido para US y UK, vacío para SWIFT e IBAN)1234567890

Tipos soportados

US

ABA Routing

UK

Sort Code

SWIFT

BIC/SWIFT

IBAN

IBAN

Ejemplo de archivo CSV

typeidentifieraccount_number
US0210000211234567890
UK20000058658244
SWIFTCHASUS33
IBANDE89370400440532013000

Endpoint API

POST/api/v1/validate/bulk

Envíe su archivo CSV mediante una solicitud multipart/form-data.

Content-Type:multipart/form-data
Tamaño máx. del archivo:10 MB
Filas máx.:10,000
curl
curl -X POST https://bankvalidor.com/api/v1/validate/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@bank_coordinates.csv"

Formato de la respuesta

El archivo CSV devuelto contiene las columnas originales más las columnas de resultado añadidas por BankValidor.

Columnas añadidas

ColumnaDescripción
statusResultado de la validación: VALID, WARNING o INVALID
confidenceNivel de confianza: HIGH, MEDIUM, LOW o NONE
bank_nameNombre del banco identificado (si se encuentra en los registros)
errorsMensajes de error detallados (si la validación falla)

Ejemplo completo

Archivo de entrada (input.csv)

input.csv
type,identifier,account_number
US,021000021,1234567890
UK,200000,58658244
SWIFT,CHASUS33,
SWIFT,INVALIDXX,
IBAN,DE89370400440532013000,

Archivo de salida (output.csv)

output.csv
type,identifier,account_number,status,confidence,bank_name,errors
US,021000021,1234567890,VALID,HIGH,JPMorgan Chase,
UK,200000,58658244,VALID,HIGH,Barclays Bank,
SWIFT,CHASUS33,,VALID,HIGH,JPMorgan Chase Bank N.A.,
SWIFT,INVALIDXX,,INVALID,NONE,,Invalid SWIFT/BIC format
IBAN,DE89370400440532013000,,VALID,HIGH,Commerzbank,

Límites y restricciones

  • 10.000 filas máximo por archivo

    Los archivos que superen este límite serán rechazados. Divida sus archivos si es necesario.

  • 1 carga simultánea por clave API

    Las cargas adicionales se pondrán en cola y se procesarán secuencialmente.

  • Timeout de 5 minutos

    Los archivos grandes pueden requerir varios minutos de procesamiento. Use webhooks para ser notificado de la finalización.

Documentación relacionada

API REST

Documentación completa de los endpoints de validación individual.

Consultar →

Webhooks

Reciba notificaciones automáticas al finalizar el procesamiento de sus archivos CSV.

Consultar →

BankValidor — Validación CSV masiva