Consultar carpeta tributaria obtenida


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.

Qué hace

No inicia sesión ni genera documentos en el SII. Descarga el original con collection_documents/:id/download.

Entrada

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

JSON Schema de entrada

{
  "$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
}

Salida

Campo	Tipo	Requerido	Descripción
`request`	objeto	null	sí
`request.id`	string	sí	Identificador de solicitud.
`request.status`	string	sí	Estado persistido de la solicitud.
`request.document`	objeto	null	sí
`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.

JSON Schema de salida

{
  "$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
}

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.

Próximos pasos

sii.conexion.sincronizar: la tool que escribe los datos que esta lectura devuelve.
Sincronizar y consultar: por qué leer datos reales son dos pasos.