Descargar el PDF de una factura, guía o nota
Descarga el PDF oficial de una factura 33 o 34, guía de despacho 52 o nota 56 o 61 emitida con el Facturador Gratuito del SII, por REST o MCP.
sii.dte.descargar entrega el PDF oficial de un documento que la empresa de la conexión emitió con el
Facturador Gratuito del SII: el mismo que muestra el portal en Documentos emitidos, con su timbre. Sirve
para lo emitido por Emisso y para lo emitido directo en el portal. No emite ni guarda nada: Emisso busca el
documento, baja el PDF y te lo entrega.
Pide el tipo, el folio y la fecha de emisión. La empresa la fija la conexión, no un parámetro:
curl -X POST https://connect.emisso.ai/api/v1/tools/sii.dte.descargar/execute \
-H "Authorization: Bearer connect_sk_…" \
-H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
-H "Content-Type: application/json" \
-d '{"input": {"tipoDte": "52", "folio": "18", "fechaEmision": "2026-10-06"}}'Salida esperada (200, campo data, recortada):
{
"tipoDte": "52",
"folio": "18",
"nombreArchivo": "dte52_folio18.pdf",
"contentType": "application/pdf",
"byteLength": 220136,
"sha256": "<64 caracteres hexadecimales>",
"contenidoBase64": "JVBERi0xLjQK…"
}Decodifica contenidoBase64 y guárdalo con nombreArchivo. sha256 sirve para comprobar que los bytes
llegaron enteros. Por MCP es una herramienta de lectura: va por execute.
| Campo | Qué va |
|---|---|
tipoDte | "33" factura, "34" factura exenta, "52" guía de despacho, "56" nota de débito o "61" nota de crédito. |
folio | Folio del documento, en texto y sin ceros a la izquierda. Es el que devuelve sii.dte.emitir. |
fechaEmision | Fecha de emisión, AAAA-MM-DD, la misma que devuelve sii.dte.emitir. |
Requiere la conexión de representante con el permiso sii:write, la misma con que se emite. Para una boleta
39 o 41 se usa sii.boleta.descargar.
Errores frecuentes
| Código y detalle | Cuándo | Qué hacer |
|---|---|---|
upstream_unexpected_response · sii_dte_pdf_documento_no_encontrado | El documento no está entre los emitidos de la empresa en el Facturador Gratuito: el tipo, el folio o la fecha no calzan, o se emitió con otro sistema. | Revisa tipo, folio y fecha de emisión. |
upstream_unexpected_response · sii_dte_pdf_documento_no_emitido | El documento está en el portal pero no llegó a emitirse, por ejemplo quedó en vista previa. | No tiene PDF de emisión. |
upstream_error | El portal no respondió o entregó algo que no es el PDF. | Intenta de nuevo en unos minutos. |
La referencia completa del contrato está en sii.dte.descargar.
Campos, validación y límites
Todos los campos de las facturas 33/34, guías 52 y notas 56/61 de Emisso: obligatoriedad, largos, decimales, referencias y errores por REST o MCP.
Resultados y errores
Qué significa cada resultado de una emisión o anulación ante el SII, cómo reintentar sin duplicar documentos y qué hacer con los errores más comunes.