Docs
EN
POST https://api.veriko.mx/v1/validations/imports

Iniciar importación masiva de validaciones

Audiencia
public
Permiso
validations:create

Sube uno o varios archivos para validar múltiples transferencias contra Banxico CEP en segundo plano. Modos:

  • text + template: archivo CSV / XLSX / XLS / TXT / JSON con encabezados canónicos (ES o EN).

  • text + free: TXT / CSV libre; el sistema aplica un barrido de regex por línea sin escalación a IA.

  • images: PNG / JPG / WEBP (individual o multi-select como file[]) o un ZIP de imágenes; cada imagen pasa por el pipeline canónico de OCR y normalización. Las multi-select se empaquetan server-side en un ZIP tmp.

Solo se permite un lote en curso por usuario (import_already_in_flight cuando ya hay otro activo). El job devuelve status pending inmediatamente; usa GET /v1/validations/imports/{id} para consultar el progreso. Endpoint cookie-only: rechaza llamadas con API key (401).

Petición
curl -X POST 'https://api.veriko.mx/v1/validations/imports' \
  -H 'Authorization: Bearer mxcep_••••' \
  -H 'Content-Type: application/json'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

Probar en el playground →
Respuesta 201 CreateValidationImportAttributes — Job creado en estado `pending`. El parsing arranca async.
Campo Tipo Descripción
status string

Estado inicial del import recién creado (`pending` hasta que el usuario confirme el commit).
Códigos de respuesta POST /v1/validations/imports
Código Clase Descripción Cuerpo
201 2xx Job creado en estado `pending`. El parsing arranca async. Sin cuerpo
401 4xx Sin sesión activa O llamada con API key (este endpoint requiere autenticación por cookie). ErrorResponse
409 4xx Ya hay un lote activo para este usuario. Espera a que termine o cancélalo antes de iniciar uno nuevo (`import_already_in_flight`). ErrorResponse
422 4xx Falló la validación del upload. Códigos: `file_required` (sin archivo), `multi_upload_not_allowed_for_text` (multi-file con upload_type=text), `zip_pack_failed` (packing interno del ZIP falló), `upload_error_<N>` (códigos PHP UPLOAD_ERR_*), `file_too_large`, `unsupported_format`, `persist_failed`. ErrorResponse
Errores de POST /v1/validations/imports
Código Clave Detalle