GEThttps://api.veriko.mx/v1/finance/ceps

Descargar los comprobantes en un archivo comprimido

Audiencia
public
Autenticación
API key
Permiso
finance:download
Guía de uso →

Entrega en un solo ZIP todos los CEP disponibles de un rango de fechas. Cada validación con comprobante aporta su XML, y las que además tienen el PDF firmado lo incluyen también, bajo ceps/. El archivo trae dos manifiestos con el mismo contenido en distinto formato —manifest.csv y manifest.xlsx— que asocian cada comprobante con su validación, su fecha y su clave de rastreo. Sirven para conciliar sin abrir los comprobantes uno por uno. Un rango sin comprobantes responde 404 no_ceps; unas fechas mal formadas, o un to anterior al from, responden 400 invalid_range. Este endpoint exige el permiso finance:download, no finance:generate_self. La distinción es deliberada: los informes financieros describen la actividad, mientras que aquí se entregan los comprobantes en sí. Para un solo comprobante está GET /v1/validations/{id}/cep, y para el estado de cuenta del mes sin los archivos, GET /v1/finance/statement.

Parámetros
ParámetroUbicaciónTipoObligatorioDescripción
from*querystring (date)obligatorio

Fecha de inicio (inclusive, YYYY-MM-DD).

p. ej. 2026-04-01
to*querystring (date)obligatorio

Fecha de fin (inclusive, YYYY-MM-DD). Debe ser ≥ from.

p. ej. 2026-04-30
user_idquerystring (uuid)opcional

Solo para administradores con finance:generate_all. UUID del usuario a consultar.

p. ej. f47ac10b-58cc-4372-a567-0e02b2c3d479
Petición
curl -X GET 'https://api.veriko.mx/v1/finance/ceps' \
  -H 'Authorization: Bearer veriko_••••'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

Códigos de respuestaGET /v1/finance/ceps
CódigoClaseDescripciónCuerpo
2002xxZIP con los XML/PDF de CEP y los manifiestos CSV + XLSX.Sin cuerpo
4004xxinvalid_range — fechas mal formadas o to < from.ErrorResponse
4014xxSe requiere autenticación o las credenciales son inválidasErrorResponse
4034xxPermisos insuficientesErrorResponse
4044xxno_ceps — el rango no contiene ningún CEP disponible.ErrorResponse
Cabeceras de respuesta200
CabeceraTipoDescripción
Cache-ControlstringDisables intermediary caching de la descarga.
Content-DispositionstringNombre de archivo sugerido para la descarga.
Content-LengthintegerTamaño exacto del ZIP en bytes.
Content-Typestring
X-Finance-ItemsintegerNúmero de CEPs incluidos en el ZIP.
Errores de GET /v1/finance/ceps
CódigoClaveEjemplo
401unauthorized

Credenciales de autenticación ausentes o inválidas.

Envelope
meta.request_id
c4d5e6f7a8b9
403forbidden

No tienes permiso para acceder a este recurso.

Envelope
meta.request_id
d5e6f7a8b9c0