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, MCP o SDK.

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 Connect y para lo emitido directo en el portal. No emite ni guarda nada: Connect 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.

Descargar el PDF de una factura, guía o nota

Errores frecuentes

En esta página