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

Descarga de archivos

Cada comprobante trae en archivo_url un enlace para descargar el documento original (PDF, XML o imagen) tal como llegó a Vintu:

Comprobante (datos ficticios, recortado)JSON
{
"id": "00000000-0000-4000-8000-0000000000d1",
"archivo_url": "https://api.vintu.io/v1/archivos/ENLACE_DE_EJEMPLO"
}

Cómo se usa

Pide la URL tal cual, sin la cabecera Authorization: el enlace ya lleva su propia credencial.

# 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

La respuesta es el archivo con su tipo (application/pdf, application/xml, text/xml, image/jpeg o image/png) y Content-Disposition: attachment.

Cuánto dura un enlace

  • Una hora desde que se pidió el comprobante.
  • Deja de valer antes si se revoca la clave que lo obtuvo, en un máximo de 60 segundos.

Por eso no lo guardes: cuando necesites el archivo, vuelve a pedir el comprobante con GET /v1/comprobantes/{id} y usa el enlace nuevo.

Errores

RespuestaQué pasóQué hacer
401 INVALID_FILE_TOKENEl enlace venció, está mal copiado o la clave que lo obtuvo fue revocada.Pide el comprobante otra vez para obtener un enlace nuevo.
404 NOT_FOUNDEl comprobante no tiene archivo disponible.Nada: ese comprobante no se puede descargar.
422 FILE_TOO_LARGEEl archivo pasa de 25 MiB.La API no entrega archivos de ese tamaño.
429 RATE_LIMITEDSe agotó el cupo de descargas.Espera Retry-After. Ver Límites de uso.

Un archivo demasiado grande se rechaza antes de enviar el primer byte: nunca recibirás un 200 con el archivo cortado.

Trata el enlace como una credencial

Quien tenga la URL puede descargar el archivo mientras el enlace valga. No la escribas en registros ni la compartas; si necesitas dar acceso a un tercero, descarga el archivo y entrégaselo.