Connect

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 Connect emitió en esta conexión, por el operacionId que devolvió la emisión.

Tool IDsii.dte_xml.consultar
Nombre MCPsii__dte_xml__consultar
Conectorsii
Planoaction
Scope (permiso)sii:read
Authnone
Versión1
Sensiblesí
Deprecadono
ComportamientoreadOnly=true, destructive=false, idempotent=true, openWorld=false

Requiere conexión. Indica cuál en cada llamada: header X-Connect-Connection en REST, campo connectionId en el execute de MCP y en las opciones del SDK. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de conexiones.estado.consultar.

Qué hace

Lo lee de lo guardado al emitir: no contacta al SII y responde aunque el documento todavía no aparezca en sii.cl. Sólo para documentos emitidos.

Entrada

CampoTipoRequeridoDescripción
operacionIdstring ^req_[0-9a-z]{21}$síEl operacionId que devolvió sii.dte.emitir o sii.anulacion.emitir.
JSON Schema de entrada
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "operacionId": {
      "type": "string",
      "pattern": "^req_[0-9a-z]{21}$",
      "description": "El operacionId que devolvió sii.dte.emitir o sii.anulacion.emitir."
    }
  },
  "required": [
    "operacionId"
  ],
  "additionalProperties": false
}

Salida

CampoTipoRequeridoDescripción
operacionIdstring ^req_[0-9a-z]{21}$síEl operacionId que devolvió sii.dte.emitir o sii.anulacion.emitir.
tipoDte"33" · "34" · "52" · "56" · "61"síTipo del documento emitido.
foliostring ^[1-9][0-9]*$síFolio del documento, en texto.
fechaEmisionstringsíFecha de emisión del documento.
xmlFirmadostringsíXML del DTE firmado que Connect envió y el SII aceptó, con su timbre electrónico (TED). Basta para generar la representación impresa y el PDF417. Es el documento tributario: guárdalo como tal.
JSON Schema de salida
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "operacionId": {
      "type": "string",
      "pattern": "^req_[0-9a-z]{21}$",
      "description": "El operacionId que devolvió sii.dte.emitir o sii.anulacion.emitir."
    },
    "tipoDte": {
      "type": "string",
      "enum": [
        "33",
        "34",
        "52",
        "56",
        "61"
      ],
      "description": "Tipo del documento emitido."
    },
    "folio": {
      "type": "string",
      "pattern": "^[1-9][0-9]*$",
      "description": "Folio del documento, en texto."
    },
    "fechaEmision": {
      "type": "string",
      "x-emisso-formato": "AAAA-MM-DD",
      "description": "Fecha de emisión del documento."
    },
    "xmlFirmado": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1048576,
      "description": "XML del DTE firmado que Connect envió y el SII aceptó, con su timbre electrónico (TED). Basta para generar la representación impresa y el PDF417. Es el documento tributario: guárdalo como tal."
    }
  },
  "required": [
    "operacionId",
    "tipoDte",
    "folio",
    "fechaEmision",
    "xmlFirmado"
  ],
  "additionalProperties": false
}

Errores de esta tool

CódigoHTTPReintentableQué hacer
connection_disabled403noReactívala en /connections o usa otra conexión del mismo sistema.

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.

En esta página