Saltar al contenido
Vintu API
Tema de la documentación
Ir a la app

Descargar el original de un comprobante

GET /v1/archivos/{token}

Usa la URL completa de archivo_url; no lleva la cabecera Authorization. El enlace vale una hora y deja de valer si se revoca la clave que lo obtuvo; entonces responde 401 INVALID_FILE_TOKEN y basta con volver a pedir el comprobante. Un archivo de más de 25 MiB responde 422 FILE_TOO_LARGE sin empezar a enviarse.

Permiso

No lleva cabecera Authorization: el enlace de archivo_url hace de credencial. La clave que obtuvo el enlace tiene que seguir vigente y conservar comprobantes:leer.

Parámetros

Parámetro En Tipo Descripción
token obligatorio ruta string Parte final de archivo_url.

Petición

ARCHIVO_URL es el valor de archivo_url de un comprobante, tal cual. Ver Descarga de archivos.

# ARCHIVO_URL: el valor de archivo_url de un comprobante.
# El tipo de archivo llega en Content-Type (pdf, xml, jpeg o png).
curl "$ARCHIVO_URL" \
  --output original

Respuesta

200 · El archivo original, como adjunto.

Tipos posibles: application/pdf, application/xml, text/xml, image/jpeg, image/png, application/octet-stream.

Cabecera Descripción
X-Request-ID Identificador de la petición; cítalo al pedir soporte.
Content-Disposition Siempre attachment.
RateLimit-Limit Peticiones por minuto admitidas.
RateLimit-Remaining Peticiones que quedan en la ventana.
RateLimit-Reset Segundos hasta que se recupera el cupo.

Errores

Todos con el cuerpo {"error": {"codigo", "mensaje", "id_peticion"}}. Compara contra codigo; el mensaje puede cambiar. Ver Errores.

Estado Códigos Cuándo
401 INVALID_FILE_TOKEN Enlace inválido, vencido o de una clave revocada (INVALID_FILE_TOKEN). Vuelve a pedir el comprobante para obtener uno nuevo.
404 NOT_FOUND El recurso no existe o no es de esta cuenta (NOT_FOUND).
422 FILE_TOO_LARGEVALIDATION_ERROR El archivo supera los 25 MiB (FILE_TOO_LARGE) o el enlace está mal formado (VALIDATION_ERROR).
429 RATE_LIMITED Se superó el límite de peticiones (RATE_LIMITED). Espera lo que indica Retry-After.
503 DEPENDENCY_UNAVAILABLELOCAL_CAPACITY Servicio no disponible temporalmente (DEPENDENCY_UNAVAILABLE o LOCAL_CAPACITY). Reintenta tras Retry-After.