# Consultar carpeta tributaria obtenida

> Consulta el resultado persistido de una solicitud puntual.



{/* 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, 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]

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

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

* [`sii.conexion.sincronizar`](./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.