Consultar carpeta tributaria obtenida

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

Tool IDsii.carpeta_tributaria.consultar
Nombre MCPsii__carpeta_tributaria__consultar
Conectorsii
Planoaction
Lee el alcancecarpeta_tributaria (debe estar habilitado en la conexión)
Scope (permiso)sii:carpeta_tributaria:generar
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 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.

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

CampoTipoRequeridoDescripción
collectionRequestIdstring ^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

CampoTipoRequeridoDescripción
requestobjetonullsí
request.idstringsíIdentificador de solicitud.
request.statusstringsíEstado persistido de la solicitud.
request.documentobjetonullsí
request.document.idstringsíIdentificador del PDF original.
request.document.sha256stringsíSHA-256 del archivo original.
request.document.byteLengthnúmerosíTamaño del PDF en bytes.
request.document.issuedAtstringsíFecha ISO 8601 de generación en el SII.
request.document.retainedUntilstringsíFecha límite de retención del PDF.
request.document.availablebooleanosí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ódigoHTTPReintentableQué hacer
connection_disabled403noReactívala en /connections o usa otra conexión del mismo sistema.
connection_not_found404noUsa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada.
alcance_not_enabled403noHabilita 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

En esta página