# Consultar carpeta tributaria obtenida

> Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar.



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

|                     |                                                                    |
| ------------------- | ------------------------------------------------------------------ |
| **Tool ID**         | `sii.carpeta_tributaria.consultar`                                 |
| **Nombre MCP**      | `sii__carpeta_tributaria__consultar`                               |
| **Conector**        | `sii`                                                              |
| **Plano**           | `action`                                                           |
| **Lee el alcance**  | `carpeta_tributaria` (debe estar habilitado en la conexión)        |
| **Scope (permiso)** | `sii:carpeta_tributaria:generar`                                   |
| **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 y campo `connectionId` en el `execute` de MCP. 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`](/docs/referencia/conexiones/estado-consultar).

## Qué hace [#qué-hace]

Si sincronizarSirve es false, sigue hacer: las indicaciones para pedir datos nuevos que siguen no aplican hasta resolver esa atención. La consulta de datos ya guardados sigue disponible según el plan. Consulta el resultado persistido de una solicitud puntual. No inicia sesión ni genera documentos en el SII. Descarga el original con collection\_documents/:id/download.

## Entrada [#entrada]

| Campo                 | Tipo             | Requerido | Descripción                            |
| --------------------- | ---------------- | --------- | -------------------------------------- |
| `collectionRequestId` | string `^ctr_.*` | sí        | Identificador de la solicitud puntual. |

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

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "collectionRequestId": {
        "type": "string",
        "pattern": "^ctr_.*",
        "description": "Identificador de la solicitud puntual."
      }
    },
    "required": [
      "collectionRequestId"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Salida [#salida]

| Campo                            | Tipo     | Requerido | Descripción                                       |                                                             |
| -------------------------------- | -------- | --------- | ------------------------------------------------- | ----------------------------------------------------------- |
| `request`                        | objeto   | null      | sí                                                | Solicitud de esta conexión; null si no existe.              |
| `request.id`                     | string   | sí        | Identificador de solicitud.                       |                                                             |
| `request.status`                 | string   | sí        | Estado persistido de la solicitud.                |                                                             |
| `request.document`               | objeto   | null      | sí                                                | Metadatos del documento, o null si aún no se ha almacenado. |
| `request.document.id`            | string   | sí        | Identificador del PDF original.                   |                                                             |
| `request.document.sha256`        | string   | sí        | SHA-256 del archivo original.                     |                                                             |
| `request.document.byteLength`    | número   | sí        | Tamaño del PDF en bytes.                          |                                                             |
| `request.document.issuedAt`      | string   | sí        | Fecha ISO 8601 de generación en el SII.           |                                                             |
| `request.document.retainedUntil` | string   | sí        | Fecha límite de retención del PDF.                |                                                             |
| `request.document.available`     | booleano | sí        | True solo si está listo y no venció su retención. |                                                             |

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

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "request": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Identificador de solicitud."
              },
              "status": {
                "type": "string",
                "description": "Estado persistido de la solicitud."
              },
              "document": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "Identificador del PDF original."
                      },
                      "sha256": {
                        "type": "string",
                        "description": "SHA-256 del archivo original."
                      },
                      "byteLength": {
                        "type": "number",
                        "description": "Tamaño del PDF en bytes."
                      },
                      "issuedAt": {
                        "type": "string",
                        "description": "Fecha ISO 8601 de generación en el SII."
                      },
                      "retainedUntil": {
                        "type": "string",
                        "description": "Fecha límite de retención del PDF."
                      },
                      "available": {
                        "type": "boolean",
                        "description": "True solo si está listo y no venció su retención."
                      }
                    },
                    "required": [
                      "id",
                      "sha256",
                      "byteLength",
                      "issuedAt",
                      "retainedUntil",
                      "available"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Metadatos del documento, o null si aún no se ha almacenado."
              }
            },
            "required": [
              "id",
              "status",
              "document"
            ],
            "additionalProperties": false
          },
          {
            "type": "null"
          }
        ],
        "description": "Solicitud de esta conexión; null si no existe."
      }
    },
    "required": [
      "request"
    ],
    "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.                                                   |
| `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. |
| `alcance_not_enabled`  | 403  | no           | Habilita el alcance en /connections o quítalo del input de la sincronización.                                       |

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

## Próximos pasos [#próximos-pasos]

* [`sii.conexion.sincronizar`](/docs/referencia/sii/conexion-sincronizar): la tool que escribe los datos que esta lectura devuelve.
* [Sincronizar y consultar](/docs/conceptos/sincronizar-consultar): por qué leer datos reales son dos pasos.


---

Esta página es parte de la documentación de Emisso. El índice completo, con cada página y su descripción, está en https://connect.emisso.ai/llms.txt. Esta misma página en HTML: https://connect.emisso.ai/docs/referencia/sii/carpeta_tributaria-consultar.
