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 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)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. |