# 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.



{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}

|                     |                                                                    |
| ------------------- | ------------------------------------------------------------------ |
| **Tool ID**         | `sii.dte_xml.consultar`                                            |
| **Nombre MCP**      | `sii__dte_xml__consultar`                                          |
| **Conector**        | `sii`                                                              |
| **Plano**           | `action`                                                           |
| **Scope (permiso)** | `sii:read`                                                         |
| **Auth**            | `none`                                                             |
| **Versión**         | `1`                                                                |
| **Sensible**        | sí                                                                 |
| **Deprecado**       | no                                                                 |
| **Comportamiento**  | readOnly=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`](../conexiones/estado-consultar).

## Qué hace [#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 [#entrada]

| Campo         | Tipo                        | Requerido | Descripción                                                        |
| ------------- | --------------------------- | --------- | ------------------------------------------------------------------ |
| `operacionId` | string `^req_[0-9a-z]{21}$` | sí        | El operacionId que devolvió sii.dte.emitir o sii.anulacion.emitir. |

<details>
  <summary>
    JSON Schema de entrada
  </summary>

  ```json
  {
    "$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
  }
  ```
</details>

## Salida [#salida]

| Campo          | Tipo                                       | Requerido | Descripción                                                                                                                                                                                      |
| -------------- | ------------------------------------------ | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `operacionId`  | string `^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.                                                                                                                                                                      |
| `folio`        | string `^[1-9][0-9]*$`                     | sí        | Folio del documento, en texto.                                                                                                                                                                   |
| `fechaEmision` | string                                     | sí        | Fecha de emisión del documento.                                                                                                                                                                  |
| `xmlFirmado`   | string                                     | sí        | 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. |

<details>
  <summary>
    JSON Schema de salida
  </summary>

  ```json
  {
    "$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
  }
  ```
</details>

## Errores de esta tool [#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. |

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](../errores).
