Download Document
SAT API Reference
Download Document
Downloads a specific document from a completed job in XML or PDF format
GET
Download Document
Description
This endpoint allows you to download individual documents from a completed extraction job. Use the job’spublicId and the specific document ID to perform the download.
Parameters
ID público único del job completado (ej. “JOB20250104123456789A”)
ID único del documento a descargar
Formato del archivo a descargar:
XML: Archivo XML original del SAT (por defecto)PDF: Representación visual del documento
Si es
true, incluye el header Content-Disposition: attachment para forzar la descarga en navegadores.
Por defecto: falseResponse
La respuesta es el contenido binario del archivo solicitado.Headers de respuesta
Tipo MIME del archivo:
application/xmlpara archivos XMLapplication/pdfpara archivos PDF
Tamaño del archivo en bytes
Header de descarga (solo si se especifica
download=true)Ejemplo: attachment; filename="factura_12345678-1234-1234-1234-123456789012.xml"UUID fiscal del documento (solo para facturas CFDI)
Tipo de documento descargado
Formato del archivo:
XML o PDFEjemplos
Descarga masiva de documentos
Para descargar múltiples documentos eficientemente:Formatos disponibles por tipo de documento
Facturas (INVOICE)
Facturas (INVOICE)
- XML: Archivo CFDI original del SAT con todos los datos fiscales
- PDF: Representación visual de la factura (cuando está disponible)
Constancia de Situación Fiscal (TAX_STATUS)
Constancia de Situación Fiscal (TAX_STATUS)
- PDF: Único formato disponible para constancias fiscales
Retenciones (TAX_RETENTION)
Retenciones (TAX_RETENTION)
- XML: Archivo XML de la retención
- PDF: Representación visual (cuando está disponible)
Códigos de error
Mejores prácticas
Almacenamiento local: Los documentos descargados son válidos legalmente. Asegúrate de almacenarlos de forma segura y con respaldos.