Descargar el PDF de una factura, guía o nota
Descarga desde el Facturador Gratuito del SII el PDF oficial de un documento emitido por la empresa de la conexión: factura 33 o 34, guía de despacho 52 o nota 56 o 61, por tipo, folio y fecha de emisión.
| Tool ID | sii.dte.descargar |
| Nombre MCP | sii__dte__descargar |
| Conector | sii |
| Plano | action |
| Scope (permiso) | sii:write |
| Auth | connection_credentials |
| Versión | 1 |
| Sensible | sí |
| Deprecado | no |
| Comportamiento | readOnly=true, destructive=false, idempotent=true, openWorld=true |
Requiere conexión. Indica cuál en cada llamada: header
X-Connect-Connectionen REST y campoconnectionIden elexecutede MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale deconexiones.estado.consultar.
Qué hace
Lo devuelve en base64 con su SHA-256. Sirve para documentos emitidos por Emisso o directo en el portal; no emite ni guarda nada. Requiere la conexión de representante con el permiso sii:write.
Entrada
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
tipoDte | "33" · "34" · "52" · "56" · "61" | sí | Tipo del documento: 33 factura, 34 factura exenta, 52 guía de despacho, 56 nota de débito o 61 nota de crédito. |
folio | string ^[1-9][0-9]{0,17}$ | sí | Folio del documento, en texto y sin ceros a la izquierda. |
fechaEmision | string | sí | Fecha de emisión del documento, AAAA-MM-DD, como la muestra el SII. |
JSON Schema de entrada
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"tipoDte": {
"type": "string",
"enum": [
"33",
"34",
"52",
"56",
"61"
],
"description": "Tipo del documento: 33 factura, 34 factura exenta, 52 guía de despacho, 56 nota de débito o 61 nota de crédito."
},
"folio": {
"type": "string",
"pattern": "^[1-9][0-9]{0,17}$",
"description": "Folio del documento, en texto y sin ceros a la izquierda."
},
"fechaEmision": {
"type": "string",
"x-emisso-formato": "AAAA-MM-DD",
"description": "Fecha de emisión del documento, AAAA-MM-DD, como la muestra el SII."
}
},
"required": [
"tipoDte",
"folio",
"fechaEmision"
],
"additionalProperties": false
}Salida
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
tipoDte | "33" · "34" · "52" · "56" · "61" | sí | Tipo del documento: 33 factura, 34 factura exenta, 52 guía de despacho, 56 nota de débito o 61 nota de crédito. |
folio | string ^[1-9][0-9]{0,17}$ | sí | Folio del documento, en texto y sin ceros a la izquierda. |
nombreArchivo | string | sí | Nombre sugerido para guardar el archivo, como «dte52_folio18.pdf». |
contentType | string | sí | Tipo de contenido del archivo. |
byteLength | entero | sí | Tamaño del PDF en bytes. |
sha256 | string ^[0-9a-f]{64}$ | sí | SHA-256 del PDF en hexadecimal, para verificar los bytes decodificados. |
contenidoBase64 | string | sí | El PDF en base64. Es el documento oficial que muestra el Facturador Gratuito. |
JSON Schema de salida
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"tipoDte": {
"type": "string",
"enum": [
"33",
"34",
"52",
"56",
"61"
],
"description": "Tipo del documento: 33 factura, 34 factura exenta, 52 guía de despacho, 56 nota de débito o 61 nota de crédito."
},
"folio": {
"type": "string",
"pattern": "^[1-9][0-9]{0,17}$",
"description": "Folio del documento, en texto y sin ceros a la izquierda."
},
"nombreArchivo": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Nombre sugerido para guardar el archivo, como «dte52_folio18.pdf»."
},
"contentType": {
"type": "string",
"const": "application/pdf",
"description": "Tipo de contenido del archivo."
},
"byteLength": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 3145728,
"description": "Tamaño del PDF en bytes."
},
"sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "SHA-256 del PDF en hexadecimal, para verificar los bytes decodificados."
},
"contenidoBase64": {
"type": "string",
"minLength": 1,
"description": "El PDF en base64. Es el documento oficial que muestra el Facturador Gratuito."
}
},
"required": [
"tipoDte",
"folio",
"nombreArchivo",
"contentType",
"byteLength",
"sha256",
"contenidoBase64"
],
"additionalProperties": false
}Errores de esta tool
| Código | HTTP | Reintentable | Qué hacer |
|---|---|---|---|
connection_disabled | 403 | no | Reactívala en /connections o usa otra conexión del mismo sistema. |
connection_not_found | 404 | no | Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada. |
connection_credential_required | 428 | no | Crea un enlace con conexiones.enlace.crear (modo reconectar si la conexión ya existe) y pide a la persona que entregue la credencial de nuevo. No reintentes con la credencial anterior. |
connection_busy | 409 | sí | Espera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez. |
upstream_error | 502 | sí | Reintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración. |
timeout | 504 | sí | Reintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo. |
sii_maximo_sesiones | 409 | no | Cierra tus sesiones en sii.cl o espera unos minutos y vuelve a intentar. No cambies la clave. |
Toda llamada puede devolver además los códigos transversales (validation_error, unauthorized, scope_not_granted, rate_limited, entre otros): el detalle vive en el catálogo de errores.
Obtener el XML firmado de un documento emitido
Entrega el XML firmado, con su timbre electrónico (TED), de una factura, nota o nota de crédito de anulación que Emisso emitió en esta conexión, por el operacionId que devolvió la emisión.
Emitir DTE en el SII
Inicia una emisión en el Facturador Gratuito: requiere previewRef vigente, Idempotency-Key explícita y autorización de la variante en la conexión.