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:
{
"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 originalimport { writeFile } from "node:fs/promises";
// ARCHIVO_URL: el valor de archivo_url de un comprobante.
const url = process.env.ARCHIVO_URL;
const respuesta = await fetch(url);
if (!respuesta.ok) {
const { error } = await respuesta.json();
throw new Error(`${respuesta.status} ${error.codigo}: ${error.mensaje} (${error.id_peticion})`);
}
// El tipo de archivo llega en Content-Type (pdf, xml, jpeg o png).
await writeFile("original", Buffer.from(await respuesta.arrayBuffer()));import os
import requests
# ARCHIVO_URL: el valor de archivo_url de un comprobante.
with requests.get(
os.environ["ARCHIVO_URL"],
stream=True,
timeout=60,
) as respuesta:
if not respuesta.ok:
error = respuesta.json()["error"]
raise RuntimeError(f"{respuesta.status_code} {error['codigo']}: {error['mensaje']} ({error['id_peticion']})")
# El tipo de archivo llega en Content-Type (pdf, xml, jpeg o png).
with open("original", "wb") as destino:
for bloque in respuesta.iter_content(chunk_size=65536):
destino.write(bloque)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
| Respuesta | Qué pasó | Qué hacer |
|---|---|---|
401 INVALID_FILE_TOKEN | El 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_FOUND | El comprobante no tiene archivo disponible. | Nada: ese comprobante no se puede descargar. |
422 FILE_TOO_LARGE | El archivo pasa de 25 MiB. | La API no entrega archivos de ese tamaño. |
429 RATE_LIMITED | Se 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.