Sincronizar conexión SII

Sincroniza los alcances solicitados (rcv, boletas, guias, boletas_honorarios, documentos, f29) para un período en una sola sincronización.

Tool IDsii.conexion.sincronizar
Nombre MCPsii__conexion__sincronizar
Conectorsii
Planoread
Alcancesrcv, boletas, guias, boletas_honorarios, documentos, carpeta_tributaria, f29
Scope (permiso)sii:read
Authconnection_credentials
Versión14
Sensiblesí
Deprecadono
ComportamientoreadOnly=false, destructive=false, idempotent=true, openWorld=true

Requiere conexión. Indica cuál en cada llamada: header X-Connect-Connection en REST y campo connectionId en el execute_write 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

En la prueba solo se cargan los 3 meses más recientes; los anteriores requieren un plan activo. Guías: solo los últimos 6 meses.

Entrada

CampoTipoRequeridoDescripción
periodostring ^\d{4}-\d{2}$síEl mes que se va a sincronizar, en formato AAAA-MM y en calendario chileno (por ejemplo '2026-07'). Traer varios meses son varias llamadas, una por mes. El mismo mes de una conexión se puede pedir una vez cada 10 minutos; antes responde 'rate_limited'.
alcanceslista de "rcv" · "boletas" · "guias" · "boletas_honorarios" · "documentos" · "carpeta_tributaria" · …síQué módulos de datos traer en esta corrida, al menos uno. Todos se traen en la misma sincronización, así que pedir varios en una llamada cuesta menos que llamar una vez por cada uno. Un alcance debe estar habilitado en la conexión; si no lo está, la llamada responde 'alcance_not_enabled'.
collectionRequestIdstring ^ctr_.*noSolicitud puntual autorizada; solo para el worker de carpeta tributaria.
JSON Schema de entrada
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "periodo": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}$",
      "description": "El mes que se va a sincronizar, en formato AAAA-MM y en calendario chileno (por ejemplo '2026-07'). Traer varios meses son varias llamadas, una por mes. El mismo mes de una conexión se puede pedir una vez cada 10 minutos; antes responde 'rate_limited'."
    },
    "alcances": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "rcv",
          "boletas",
          "guias",
          "boletas_honorarios",
          "documentos",
          "carpeta_tributaria",
          "f29"
        ]
      },
      "description": "Qué módulos de datos traer en esta corrida, al menos uno. Todos se traen en la misma sincronización, así que pedir varios en una llamada cuesta menos que llamar una vez por cada uno. Un alcance debe estar habilitado en la conexión; si no lo está, la llamada responde 'alcance_not_enabled'."
    },
    "collectionRequestId": {
      "description": "Solicitud puntual autorizada; solo para el worker de carpeta tributaria.",
      "type": "string",
      "pattern": "^ctr_.*"
    }
  },
  "required": [
    "periodo",
    "alcances"
  ]
}

Ejemplo

curl
curl -X POST https://connect.emisso.ai/api/v1/tools/sii.conexion.sincronizar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{"input":{"periodo":"2026-07","alcances":["rcv","boletas"]}}'
MCP · meta-tool execute_write
{
  "tool": "sii.conexion.sincronizar",
  "params": {
    "periodo": "2026-07",
    "alcances": [
      "rcv",
      "boletas"
    ]
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}

Salida esperada (200):

{
  "data": {
    "periodo": "2026-07",
    "estado": "encolado",
    "jobId": "sjb_9f2kc0q8w1m4x7t3p6b5d",
    "yaEnCurso": false
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "sii.conexion.sincronizar",
    "plane": "read",
    "latency_ms": 58240,
    "audit_status": "recorded"
  }
}

La respuesta llega al instante y sin datos: el trabajo quedó en cola. Cuando termina, el resultado por alcance se lee en 'outcomes' de GET /v1/syncs/{jobId}. Los alcances pedidos se traen en la misma sincronización, así que pedirlos juntos cuesta menos que una llamada por alcance.

Salida

CampoTipoRequeridoDescripción
periodostringsíEco del período que se pidió, para poder correlacionar la respuesta sin guardarlo tú.
estado"encolado" · "completado"sí'encolado' = la sincronización quedó en cola y va a empezar enseguida; esta respuesta NO trae datos todavía, y el trabajo se sigue por 'jobId'. 'completado' = la sincronización ya corrió y su resumen por alcance viene en 'results'. Un cliente recibe siempre 'encolado': un sync consulta el sistema externo y puede tardar minutos, así que no se te hace esperar por él.
jobIdstringnullno
yaEnCursobooleanono'true' significa que ya había una sincronización viva para esa conexión y ese período, así que no se creó otra. No es un error ni un rechazo. Si esa sincronización sigue en cola, 'jobId' es el suyo; si ya está corriendo, 'jobId' llega null y su avance se ve en 'trabajos' de 'conexiones.estado.consultar'. Cubre el período, no necesariamente los alcances que pediste: si pediste otros, vuelve a pedirlos cuando termine. Ojo con el otro lado: 'false' NO garantiza que la hayas creado tú: dos llamadas a la vez pueden recibir las dos 'false' y el MISMO 'jobId'. Lo que sí vale siempre es que hay una sola sincronización activa por conexión y período.
resultslista de objetonoEl resumen por alcance, una fila por alcance sincronizado. AUSENTE cuando 'estado' es 'encolado': el trabajo todavía no corrió. Ausente no es lo mismo que vacío: un arreglo vacío significaría que se miró y no había nada.
results[].alcancestringsíCuál de los alcances pedidos describe esta fila. Hay una fila por alcance solicitado, en el orden canónico del conector, no en el orden en que los pediste.
results[].marcadorstringnoUso interno de Emisso; no se publica. En GET /v1/syncs/{id}, la fila trae en su lugar 'motivo': qué pasó y quién tiene que actuar, de la lista cerrada del catálogo de errores.
results[].status"ok" · "partial" · "failed" · "omitted"sí'ok' = el alcance terminó bien; que 'recordsSynced' sea 0 no lo vuelve un fallo. 'partial' = trajo datos pero alguna casilla quedó incompleta, y 'incompletos' dice cuántas: lo sincronizado sirve, y reintentar el mismo período más tarde puede completarlo. 'failed' = no terminó bien, y la causa va en 'error'; mira igual 'recordsSynced', porque un 'failed' no garantiza que no se haya escrito nada. Y revisa fila por fila: un alcance puede fallar mientras los otros de la misma corrida terminan bien. omitted: el alcance no aplica; documentos sin información en MiPyme no es una falla.
results[].detallestringnoExplicación del resultado del alcance; documentos sin datos en MiPyme no requiere corregir la autorización.
results[].recordsSyncedenterosíCuántos registros de este alcance escribió ESTA corrida. Es el trabajo de esta llamada, no el total acumulado que tienes guardado: para saber cuánto hay, consulta. Un 0 no significa por sí solo «no hay datos»; cuando el cero tiene una explicación, viene en 'detalle'.
results[].incompletosenteronoCuántas casillas de este alcance quedaron sin traer. Es lo que vuelve 'partial' al status: lo sincronizado sirve, y reintentar el mismo período más tarde puede completarlo. Una casilla legítimamente vacía no cuenta.
results[].completobooleanono'true' sólo si ninguna casilla de este alcance falló. No alcanza por sí solo para dar el período por cerrado: revísalo junto con 'reconMismatches' y 'filasDescartadas', porque un documento puede faltar por esas dos vías sin que 'completo' se entere.
results[].reconMismatchesenteronoVeces que las filas del detalle no coincidieron con el total que el resumen del SII declaraba. Es observabilidad y no detiene el sync, pero un valor distinto de 0 dice que el período puede estar incompleto.
results[].dedupCollisionsenteronoCuántas filas llegaron repetidas dentro de esta misma corrida (misma clave natural) y se colapsaron en una. No se cuentan dos veces en 'recordsSynced'.
results[].filasDescartadasenteronoFilas que llegaron con una forma inesperada (sin tipo ni folio resoluble) y no se pudieron guardar. Un valor distinto de 0 significa que el alcance corrió entero pero se perdieron filas, aunque 'completo' diga 'true'.
results[].fueraDeVentanaenteronoSólo en 'guias': cuántas direcciones cayeron fuera de la ventana de 6 meses que el SII conserva. No es una falla y el status igual sale 'ok', pero es lo único que distingue 'no había guías' de 'no pudimos verlas'. Reintentar no lo arregla.
results[].diferidosenteronoSólo en 'rcv': cuántos grupos (estado y tipo de documento) se bajaron completos como archivo, cuando el detalle en línea del SII no está disponible o para obtener el desglose de impuestos de varios documentos. No es una falla: esos datos están guardados.
results[].totalesenteronoSólo en 'rcv': cuántos totales del mes se guardaron (boletas, comprobantes de pago con tarjeta y otros tipos que el SII informa sólo como total, no documento por documento). Se leen con 'sii.rcv_totales.consultar'.
results[].agregadosEnDetalleenteronoSólo en 'rcv': filas del detalle con forma de total del mes (sin fecha ni razón social) en un tipo que el SII declaró como documentos. No debería pasar; si es distinto de 0, avísale a soporte.
results[].incompletosPorMotivolista de objetonoSólo en 'rcv', y siempre en ese alcance aunque quede vacía: el porqué de las casillas que cuenta 'incompletos'. La suma de 'casillas' es 'incompletos'.
results[].incompletosPorMotivo[].motivostringsíPor qué no se trajeron. Estable: 'presupuesto' y 'tope' (se acabó el tiempo; el próximo sync lo reintenta), 'acceso_no_disponible' (el SII no permitió leer en ese momento), 'detalle_vacio', 'resumen_<código>', 'filas_no_calzan', 'csv_<motivo>', 'transporte', 'tipo_solo_resumen_<tipo>' (un tipo que el SII solo informa totalizado, por ejemplo 48), entre otros. La lista es abierta.
results[].incompletosPorMotivo[].casillasenterosíCuántas casillas quedaron sin traer por ese motivo.
results[].perspectivasFallidaslista de objetonoEn 'guias' y 'boletas_honorarios': qué direcciones fallaron, con su código de error. Esos dos alcances la emiten siempre, aunque quede vacía; ningún otro la emite.
results[].perspectivasFallidas[].perspectiva"emitidas" · "recibidas"síQué lado falló: 'emitidas' son las que emitió esta empresa y 'recibidas' las que le emitieron.
results[].perspectivasFallidas[].codestringsíEl código del catálogo de errores que explica por qué falló ese lado. Decide por el código, nunca por el texto.
results[].perspectivasFallidas[].marcadorstringnoUso interno de Emisso; no se publica. En GET /v1/syncs/{id}, la fila trae en su lugar 'motivo': qué pasó y quién tiene que actuar, de la lista cerrada del catálogo de errores.
results[].totalenteronoSólo en 'documentos': cuántos DTE anunció el SII en las partes del período procesadas en esta corrida. Es el conteo CRUDO del portal, con sus repetidos, así que restarle 'documentos' NO da el hueco. Para eso está 'faltantes', cuando la cobertura pudo verificarse. Con 'completo' falso puede quedar parte del período sin revisar.
results[].ventanasenteronoSólo en 'documentos': cuántas ventanas de descarga (hasta 20 folios cada una) se planificaron para los XML pendientes en esta corrida.
results[].ventanasRechazadasenteronoSólo en 'documentos': cuántas ventanas de descarga rechazó el portal. Lo que sí bajó se guarda igual y el período sale 'partial'; el detalle del rechazo viaja en 'marcador'.
results[].documentosenteronoSólo en 'documentos': cuántos DTE se descargaron de verdad. El hueco es 'faltantes'; la resta contra 'total' NO lo da, porque 'total' viene con los repetidos del portal.
results[].faltantesenteronoSólo en 'documentos': cuántas identidades del índice enumerado siguen sin XML confirmado, contando lo guardado en corridas anteriores y lo descargado ahora. Se omite cuando la lectura de conocidos quedó incompleta y aún hay cobertura no verificada. Incluye ventanas sin intentar; si el índice quedó parcial, es una cota mínima. Lo que sí bajó se guarda igual.
results[].sinIndiceenteronoSólo en 'documentos': cuántos DTE se descargaron sin que su clave apareciera en el índice del listado. Significa que el índice quedó corto, distinto de que la fila no trajera estado (eso llega como 'estado' en null).
results[].hashMismatchesenteronoSólo en 'documentos': contador legado de repeticiones con XML distinto, incluidas las dos perspectivas. Para diferencias dentro de una misma perspectiva usa hashMismatchesMismaPerspectiva.
results[].colisionesEntrePerspectivasenteronoSólo en 'documentos': cuántos documentos únicos aparecen como emitidos y recibidos del mismo contribuyente.
results[].hashMismatchesMismaPerspectivaenteronoSólo en 'documentos': cuántas repeticiones traían XML distinto dentro de emitidos o dentro de recibidos. Ausente en resultados históricos que no lo midieron.
results[].verificadoAlstringnoSólo en 'documentos', y sólo cuando el status es 'ok'. Instante ISO 8601 en UTC (termina en 'Z') desde el que los documentos guardados de ese mes coinciden con todo lo que el SII mostraba: el mes se revisó entero, sin partes pendientes ni rechazadas, en una revisión que empezó en ese instante. No significa que el mes quedó cerrado para siempre: un documento que el SII publique después, aunque tenga fecha de emisión de ese mes, aparece en una sincronización posterior. Pasa sobre todo con documentos recibidos, que algunos proveedores emiten con fecha del mes y el SII muestra días más tarde. Si necesitas cerrar un mes, usa un 'verificadoAl' posterior al plazo que tu proceso da a los documentos atrasados. Ausente si esta corrida dejó partes del mes pendientes o rechazadas, o si el mes todavía no termina su primera revisión completa.
results[].declaracionesenteronoSólo en 'f29': cuántas declaraciones vigentes muestra el SII en su grilla, que cubre el año en curso y los seis anteriores. El período pedido no la acota: el F29 se revisa entero.
results[].nuevasenteronoSólo en 'f29': cuántas declaraciones se leyeron completas en esta corrida por primera vez.
results[].pendientesenteronoSólo en 'f29': cuántas declaraciones quedaron sin leer (por tiempo o porque su formulario no se pudo leer). Se retoman solas en la revisión siguiente; un valor distinto de 0 vuelve 'partial' el status.
results[].diagnosticovalornoDiagnóstico observado de F29, de la guarda de identidad de boletas o del tiempo usado por documentos: categorías cerradas, conteos, tiempos y formas numéricas saneadas. Ausente si no se observó; no prueba completitud.
results[].errorstringnoPor qué este alcance no terminó bien. Presente solo cuando 'status' es 'failed'. Normalmente es un código del catálogo de errores; cuando el sistema externo truncó el listado es una etiqueta de resultado ('movimientos_truncated', 'cartolas_truncated') que no está en ese catálogo y que significa «se escribió lo que alcanzó a venir». Decide por el valor, nunca por el texto libre.
JSON Schema de salida
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "periodo": {
      "type": "string",
      "description": "Eco del período que se pidió, para poder correlacionar la respuesta sin guardarlo tú."
    },
    "estado": {
      "type": "string",
      "enum": [
        "encolado",
        "completado"
      ],
      "description": "'encolado' = la sincronización quedó en cola y va a empezar enseguida; esta respuesta NO trae datos todavía, y el trabajo se sigue por 'jobId'. 'completado' = la sincronización ya corrió y su resumen por alcance viene en 'results'. Un cliente recibe siempre 'encolado': un sync consulta el sistema externo y puede tardar minutos, así que no se te hace esperar por él."
    },
    "jobId": {
      "description": "El identificador de la sincronización encolada. Por la API REST, el avance se consulta en 'GET /v1/syncs/{jobId}'; por MCP, búscalo en 'trabajos' de 'conexiones.estado.consultar' y revisa 'datosListos' ahí mismo. Es el mismo id que viaja en el webhook 'sync.succeeded' o 'sync.failed' si tu plan los incluye. Es null cuando 'estado' es 'completado', porque ahí el resultado ya está en la respuesta, y cuando 'yaEnCurso' es true y esa sincronización ya está corriendo.",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "yaEnCurso": {
      "description": "'true' significa que ya había una sincronización viva para esa conexión y ese período, así que no se creó otra. No es un error ni un rechazo. Si esa sincronización sigue en cola, 'jobId' es el suyo; si ya está corriendo, 'jobId' llega null y su avance se ve en 'trabajos' de 'conexiones.estado.consultar'. Cubre el período, no necesariamente los alcances que pediste: si pediste otros, vuelve a pedirlos cuando termine. Ojo con el otro lado: 'false' NO garantiza que la hayas creado tú: dos llamadas a la vez pueden recibir las dos 'false' y el MISMO 'jobId'. Lo que sí vale siempre es que hay una sola sincronización activa por conexión y período.",
      "type": "boolean"
    },
    "results": {
      "description": "El resumen por alcance, una fila por alcance sincronizado. AUSENTE cuando 'estado' es 'encolado': el trabajo todavía no corrió. Ausente no es lo mismo que vacío: un arreglo vacío significaría que se miró y no había nada.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "alcance": {
            "type": "string",
            "description": "Cuál de los alcances pedidos describe esta fila. Hay una fila por alcance solicitado, en el orden canónico del conector, no en el orden en que los pediste."
          },
          "marcador": {
            "description": "Uso interno de Emisso; no se publica. En GET /v1/syncs/{id}, la fila trae en su lugar 'motivo': qué pasó y quién tiene que actuar, de la lista cerrada del catálogo de errores.",
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "ok",
              "partial",
              "failed",
              "omitted"
            ],
            "description": "'ok' = el alcance terminó bien; que 'recordsSynced' sea 0 no lo vuelve un fallo. 'partial' = trajo datos pero alguna casilla quedó incompleta, y 'incompletos' dice cuántas: lo sincronizado sirve, y reintentar el mismo período más tarde puede completarlo. 'failed' = no terminó bien, y la causa va en 'error'; mira igual 'recordsSynced', porque un 'failed' no garantiza que no se haya escrito nada. Y revisa fila por fila: un alcance puede fallar mientras los otros de la misma corrida terminan bien. omitted: el alcance no aplica; documentos sin información en MiPyme no es una falla."
          },
          "detalle": {
            "description": "Explicación del resultado del alcance; documentos sin datos en MiPyme no requiere corregir la autorización.",
            "type": "string"
          },
          "recordsSynced": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Cuántos registros de este alcance escribió ESTA corrida. Es el trabajo de esta llamada, no el total acumulado que tienes guardado: para saber cuánto hay, consulta. Un 0 no significa por sí solo «no hay datos»; cuando el cero tiene una explicación, viene en 'detalle'."
          },
          "incompletos": {
            "description": "Cuántas casillas de este alcance quedaron sin traer. Es lo que vuelve 'partial' al status: lo sincronizado sirve, y reintentar el mismo período más tarde puede completarlo. Una casilla legítimamente vacía no cuenta.",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "completo": {
            "description": "'true' sólo si ninguna casilla de este alcance falló. No alcanza por sí solo para dar el período por cerrado: revísalo junto con 'reconMismatches' y 'filasDescartadas', porque un documento puede faltar por esas dos vías sin que 'completo' se entere.",
            "type": "boolean"
          },
          "reconMismatches": {
            "description": "Veces que las filas del detalle no coincidieron con el total que el resumen del SII declaraba. Es observabilidad y no detiene el sync, pero un valor distinto de 0 dice que el período puede estar incompleto.",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "dedupCollisions": {
            "description": "Cuántas filas llegaron repetidas dentro de esta misma corrida (misma clave natural) y se colapsaron en una. No se cuentan dos veces en 'recordsSynced'.",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "filasDescartadas": {
            "description": "Filas que llegaron con una forma inesperada (sin tipo ni folio resoluble) y no se pudieron guardar. Un valor distinto de 0 significa que el alcance corrió entero pero se perdieron filas, aunque 'completo' diga 'true'.",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "fueraDeVentana": {
            "description": "Sólo en 'guias': cuántas direcciones cayeron fuera de la ventana de 6 meses que el SII conserva. No es una falla y el status igual sale 'ok', pero es lo único que distingue 'no había guías' de 'no pudimos verlas'. Reintentar no lo arregla.",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "diferidos": {
            "description": "Sólo en 'rcv': cuántos grupos (estado y tipo de documento) se bajaron completos como archivo, cuando el detalle en línea del SII no está disponible o para obtener el desglose de impuestos de varios documentos. No es una falla: esos datos están guardados.",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "totales": {
            "description": "Sólo en 'rcv': cuántos totales del mes se guardaron (boletas, comprobantes de pago con tarjeta y otros tipos que el SII informa sólo como total, no documento por documento). Se leen con 'sii.rcv_totales.consultar'.",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "agregadosEnDetalle": {
            "description": "Sólo en 'rcv': filas del detalle con forma de total del mes (sin fecha ni razón social) en un tipo que el SII declaró como documentos. No debería pasar; si es distinto de 0, avísale a soporte.",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "incompletosPorMotivo": {
            "description": "Sólo en 'rcv', y siempre en ese alcance aunque quede vacía: el porqué de las casillas que cuenta 'incompletos'. La suma de 'casillas' es 'incompletos'.",
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "motivo": {
                  "type": "string",
                  "description": "Por qué no se trajeron. Estable: 'presupuesto' y 'tope' (se acabó el tiempo; el próximo sync lo reintenta), 'acceso_no_disponible' (el SII no permitió leer en ese momento), 'detalle_vacio', 'resumen_<código>', 'filas_no_calzan', 'csv_<motivo>', 'transporte', 'tipo_solo_resumen_<tipo>' (un tipo que el SII solo informa totalizado, por ejemplo 48), entre otros. La lista es abierta."
                },
                "casillas": {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991,
                  "description": "Cuántas casillas quedaron sin traer por ese motivo."
                }
              },
              "required": [
                "motivo",
                "casillas"
              ],
              "additionalProperties": false
            }
          },
          "perspectivasFallidas": {
            "description": "En 'guias' y 'boletas_honorarios': qué direcciones fallaron, con su código de error. Esos dos alcances la emiten siempre, aunque quede vacía; ningún otro la emite.",
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "perspectiva": {
                  "type": "string",
                  "enum": [
                    "emitidas",
                    "recibidas"
                  ],
                  "description": "Qué lado falló: 'emitidas' son las que emitió esta empresa y 'recibidas' las que le emitieron."
                },
                "code": {
                  "type": "string",
                  "description": "El código del catálogo de errores que explica por qué falló ese lado. Decide por el código, nunca por el texto."
                },
                "marcador": {
                  "description": "Uso interno de Emisso; no se publica. En GET /v1/syncs/{id}, la fila trae en su lugar 'motivo': qué pasó y quién tiene que actuar, de la lista cerrada del catálogo de errores.",
                  "type": "string"
                }
              },
              "required": [
                "perspectiva",
                "code"
              ],
              "additionalProperties": false
            }
          },
          "total": {
            "description": "Sólo en 'documentos': cuántos DTE anunció el SII en las partes del período procesadas en esta corrida. Es el conteo CRUDO del portal, con sus repetidos, así que restarle 'documentos' NO da el hueco. Para eso está 'faltantes', cuando la cobertura pudo verificarse. Con 'completo' falso puede quedar parte del período sin revisar.",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "ventanas": {
            "description": "Sólo en 'documentos': cuántas ventanas de descarga (hasta 20 folios cada una) se planificaron para los XML pendientes en esta corrida.",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "ventanasRechazadas": {
            "description": "Sólo en 'documentos': cuántas ventanas de descarga rechazó el portal. Lo que sí bajó se guarda igual y el período sale 'partial'; el detalle del rechazo viaja en 'marcador'.",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "documentos": {
            "description": "Sólo en 'documentos': cuántos DTE se descargaron de verdad. El hueco es 'faltantes'; la resta contra 'total' NO lo da, porque 'total' viene con los repetidos del portal.",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "faltantes": {
            "description": "Sólo en 'documentos': cuántas identidades del índice enumerado siguen sin XML confirmado, contando lo guardado en corridas anteriores y lo descargado ahora. Se omite cuando la lectura de conocidos quedó incompleta y aún hay cobertura no verificada. Incluye ventanas sin intentar; si el índice quedó parcial, es una cota mínima. Lo que sí bajó se guarda igual.",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "sinIndice": {
            "description": "Sólo en 'documentos': cuántos DTE se descargaron sin que su clave apareciera en el índice del listado. Significa que el índice quedó corto, distinto de que la fila no trajera estado (eso llega como 'estado' en null).",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "hashMismatches": {
            "description": "Sólo en 'documentos': contador legado de repeticiones con XML distinto, incluidas las dos perspectivas. Para diferencias dentro de una misma perspectiva usa hashMismatchesMismaPerspectiva.",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "colisionesEntrePerspectivas": {
            "description": "Sólo en 'documentos': cuántos documentos únicos aparecen como emitidos y recibidos del mismo contribuyente.",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "hashMismatchesMismaPerspectiva": {
            "description": "Sólo en 'documentos': cuántas repeticiones traían XML distinto dentro de emitidos o dentro de recibidos. Ausente en resultados históricos que no lo midieron.",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "verificadoAl": {
            "description": "Sólo en 'documentos', y sólo cuando el status es 'ok'. Instante ISO 8601 en UTC (termina en 'Z') desde el que los documentos guardados de ese mes coinciden con todo lo que el SII mostraba: el mes se revisó entero, sin partes pendientes ni rechazadas, en una revisión que empezó en ese instante. No significa que el mes quedó cerrado para siempre: un documento que el SII publique después, aunque tenga fecha de emisión de ese mes, aparece en una sincronización posterior. Pasa sobre todo con documentos recibidos, que algunos proveedores emiten con fecha del mes y el SII muestra días más tarde. Si necesitas cerrar un mes, usa un 'verificadoAl' posterior al plazo que tu proceso da a los documentos atrasados. Ausente si esta corrida dejó partes del mes pendientes o rechazadas, o si el mes todavía no termina su primera revisión completa.",
            "type": "string"
          },
          "declaraciones": {
            "description": "Sólo en 'f29': cuántas declaraciones vigentes muestra el SII en su grilla, que cubre el año en curso y los seis anteriores. El período pedido no la acota: el F29 se revisa entero.",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "nuevas": {
            "description": "Sólo en 'f29': cuántas declaraciones se leyeron completas en esta corrida por primera vez.",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "pendientes": {
            "description": "Sólo en 'f29': cuántas declaraciones quedaron sin leer (por tiempo o porque su formulario no se pudo leer). Se retoman solas en la revisión siguiente; un valor distinto de 0 vuelve 'partial' el status.",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "diagnostico": {
            "description": "Diagnóstico observado de F29, de la guarda de identidad de boletas o del tiempo usado por documentos: categorías cerradas, conteos, tiempos y formas numéricas saneadas. Ausente si no se observó; no prueba completitud.",
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "number",
                    "const": 1,
                    "description": "Versión del formato de este diagnóstico."
                  },
                  "tipo": {
                    "type": "string",
                    "const": "sii_f29",
                    "description": "Identifica el diagnóstico de una lectura F29 parcial."
                  },
                  "pendientes": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991,
                    "description": "Declaraciones cuya lectura quedó pendiente en esta ejecución."
                  },
                  "causas": {
                    "type": "object",
                    "properties": {
                      "pdf_no_disponible": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Compactos que no estuvieron disponibles para descargar."
                      },
                      "contrato_parser": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Compactos rechazados porque no cumplieron la estructura esperada por el lector."
                      },
                      "identidad": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Compactos rechazados por no corresponder a la declaración solicitada."
                      },
                      "desconocido": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Fallos de lectura del compacto que no corresponden a otra categoría del diagnóstico."
                      },
                      "presupuesto_agotado": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Declaraciones que quedaron pendientes por agotarse el tiempo disponible para la lectura."
                      }
                    },
                    "required": [
                      "pdf_no_disponible",
                      "contrato_parser",
                      "identidad",
                      "desconocido",
                      "presupuesto_agotado"
                    ],
                    "additionalProperties": false,
                    "description": "Conteos de los motivos observados de lectura incompleta."
                  },
                  "guardas_contrato": {
                    "type": "object",
                    "properties": {
                      "sin_texto": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Compactos rechazados porque no se obtuvo texto."
                      },
                      "encabezado": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Compactos sin folio, RUT o período en el encabezado esperado."
                      },
                      "tabla_codigos": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Compactos donde no se encontró la tabla de códigos."
                      },
                      "valor_ilegible": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Compactos rechazados por un valor que no pudo interpretarse."
                      },
                      "codigo_duplicado": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Compactos con un código repetido que presenta valores distintos."
                      },
                      "numero_huerfano": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Compactos con números que no pudieron asociarse a un código."
                      },
                      "periodo": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Compactos cuyo período tiene una forma inesperada."
                      },
                      "otro": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Rechazos de estructura que no corresponden a otra guarda del diagnóstico."
                      }
                    },
                    "required": [
                      "sin_texto",
                      "encabezado",
                      "tabla_codigos",
                      "valor_ilegible",
                      "codigo_duplicado",
                      "numero_huerfano",
                      "periodo",
                      "otro"
                    ],
                    "additionalProperties": false,
                    "description": "Conteos de las comprobaciones de estructura que rechazaron compactos."
                  },
                  "presupuesto": {
                    "description": "Tiempos y cortes de esta ejecución, cuando se conoce su límite de lectura.",
                    "type": "object",
                    "properties": {
                      "entrada_ms": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Milisegundos desde el inicio de la sincronización hasta la entrada al alcance F29."
                      },
                      "duracion_ms": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Milisegundos transcurridos en el alcance F29 al tomar el diagnóstico."
                      },
                      "remanente_entrada_ms": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Milisegundos disponibles hasta el límite de lectura al entrar al alcance F29."
                      },
                      "remanente_salida_ms": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Milisegundos disponibles hasta el límite de lectura al tomar el diagnóstico."
                      },
                      "margen_flush_ms": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Milisegundos reservados para guardar los datos recuperados después de la lectura."
                      },
                      "cortes": {
                        "type": "object",
                        "properties": {
                          "antes_periodo": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Declaraciones pendientes por un corte de tiempo antes de consultar su período."
                          },
                          "detalle": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Declaraciones pendientes por agotarse el tiempo durante la consulta del detalle de un período."
                          },
                          "antes_compacto": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Declaraciones pendientes por un corte de tiempo antes de solicitar su compacto."
                          },
                          "compacto": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Declaraciones pendientes por agotarse el tiempo durante la lectura de su compacto."
                          }
                        },
                        "required": [
                          "antes_periodo",
                          "detalle",
                          "antes_compacto",
                          "compacto"
                        ],
                        "additionalProperties": false,
                        "description": "Declaraciones afectadas por cortes de tiempo, agrupadas según la etapa de lectura."
                      }
                    },
                    "required": [
                      "entrada_ms",
                      "duracion_ms",
                      "remanente_entrada_ms",
                      "remanente_salida_ms",
                      "margen_flush_ms",
                      "cortes"
                    ],
                    "additionalProperties": false
                  },
                  "valores_ilegibles": {
                    "description": "Resumen acotado de las formas de valores que el lector no pudo interpretar.",
                    "type": "object",
                    "properties": {
                      "formas": {
                        "maxItems": 2,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "codigo": {
                              "type": "string",
                              "pattern": "^(?:0|[1-9]\\d{0,3})$(?![\\s\\S])",
                              "description": "Código de la casilla F29 cuyo valor no pudo interpretarse; no es el folio de la declaración."
                            },
                            "modo": {
                              "type": "string",
                              "enum": [
                                "entero",
                                "tasa"
                              ],
                              "description": "Modo de interpretación numérica asignado al código y a la forma observada."
                            },
                            "zona": {
                              "type": "string",
                              "enum": [
                                "tabla",
                                "franja",
                                "totales"
                              ],
                              "description": "Zona del compacto donde se encontró el valor ilegible."
                            },
                            "valor": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "tipo": {
                                      "type": "string",
                                      "const": "numero",
                                      "description": "El fragmento contiene dígitos y sólo los signos o separadores numéricos admitidos por el diagnóstico."
                                    },
                                    "patron": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 64,
                                      "pattern": "^[D.,\\- ]+$(?![\\s\\S])",
                                      "description": "Forma del fragmento con cada dígito sustituido por D y los espacios normalizados; no contiene el importe."
                                    },
                                    "espacios": {
                                      "maxItems": 64,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "posicion": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 63,
                                            "description": "Posición del espacio en el fragmento, contada desde cero."
                                          },
                                          "tipo": {
                                            "type": "string",
                                            "enum": [
                                              "espacio",
                                              "no_separable",
                                              "fino",
                                              "fino_no_separable"
                                            ],
                                            "description": "Clase de espacio observada antes de normalizar el fragmento."
                                          }
                                        },
                                        "required": [
                                          "posicion",
                                          "tipo"
                                        ],
                                        "additionalProperties": false
                                      },
                                      "description": "Posiciones y clases de los espacios del fragmento numérico."
                                    }
                                  },
                                  "required": [
                                    "tipo",
                                    "patron",
                                    "espacios"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "tipo": {
                                      "type": "string",
                                      "enum": [
                                        "no_numerico",
                                        "sobre_tope"
                                      ],
                                      "description": "El fragmento no tiene la forma numérica admitida o supera los 64 caracteres; su contenido se omite."
                                    }
                                  },
                                  "required": [
                                    "tipo"
                                  ],
                                  "additionalProperties": false
                                }
                              ],
                              "description": "Forma del valor rechazado, sin dígitos originales ni texto libre."
                            },
                            "codigoRelativo": {
                              "type": "object",
                              "properties": {
                                "x": {
                                  "anyOf": [
                                    {
                                      "type": "number",
                                      "minimum": -1000,
                                      "maximum": 1000
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Desplazamiento horizontal del código respecto del valor en las coordenadas del PDF; null si no es finito o supera el rango admitido."
                                },
                                "y": {
                                  "anyOf": [
                                    {
                                      "type": "number",
                                      "minimum": -1000,
                                      "maximum": 1000
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Desplazamiento vertical del código respecto del valor en las coordenadas del PDF; null si no es finito o supera el rango admitido."
                                }
                              },
                              "required": [
                                "x",
                                "y"
                              ],
                              "additionalProperties": false,
                              "description": "Posición del código respecto del valor, redondeada a una décima y limitada a 1000 unidades por eje."
                            },
                            "vecinos": {
                              "maxItems": 4,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "forma": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "tipo": {
                                            "type": "string",
                                            "const": "numero",
                                            "description": "El fragmento contiene dígitos y sólo los signos o separadores numéricos admitidos por el diagnóstico."
                                          },
                                          "patron": {
                                            "type": "string",
                                            "minLength": 1,
                                            "maxLength": 64,
                                            "pattern": "^[D.,\\- ]+$(?![\\s\\S])",
                                            "description": "Forma del fragmento con cada dígito sustituido por D y los espacios normalizados; no contiene el importe."
                                          },
                                          "espacios": {
                                            "maxItems": 64,
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "posicion": {
                                                  "type": "integer",
                                                  "minimum": 0,
                                                  "maximum": 63,
                                                  "description": "Posición del espacio en el fragmento, contada desde cero."
                                                },
                                                "tipo": {
                                                  "type": "string",
                                                  "enum": [
                                                    "espacio",
                                                    "no_separable",
                                                    "fino",
                                                    "fino_no_separable"
                                                  ],
                                                  "description": "Clase de espacio observada antes de normalizar el fragmento."
                                                }
                                              },
                                              "required": [
                                                "posicion",
                                                "tipo"
                                              ],
                                              "additionalProperties": false
                                            },
                                            "description": "Posiciones y clases de los espacios del fragmento numérico."
                                          }
                                        },
                                        "required": [
                                          "tipo",
                                          "patron",
                                          "espacios"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "tipo": {
                                            "type": "string",
                                            "enum": [
                                              "no_numerico",
                                              "sobre_tope"
                                            ],
                                            "description": "El fragmento no tiene la forma numérica admitida o supera los 64 caracteres; su contenido se omite."
                                          }
                                        },
                                        "required": [
                                          "tipo"
                                        ],
                                        "additionalProperties": false
                                      }
                                    ],
                                    "description": "Forma del fragmento vecino, sin dígitos originales ni texto libre."
                                  },
                                  "x": {
                                    "anyOf": [
                                      {
                                        "type": "number",
                                        "minimum": -1000,
                                        "maximum": 1000
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Desplazamiento horizontal del vecino respecto del valor; null si no es finito o supera el rango admitido."
                                  },
                                  "y": {
                                    "anyOf": [
                                      {
                                        "type": "number",
                                        "minimum": -1000,
                                        "maximum": 1000
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Desplazamiento vertical del vecino respecto del valor; null si no es finito o supera el rango admitido."
                                  }
                                },
                                "required": [
                                  "forma",
                                  "x",
                                  "y"
                                ],
                                "additionalProperties": false
                              },
                              "description": "Hasta cuatro fragmentos vecinos, descritos sólo por su forma y posición relativa."
                            },
                            "cantidad": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991,
                              "description": "Veces que se observó esta misma forma durante la ejecución."
                            }
                          },
                          "required": [
                            "codigo",
                            "modo",
                            "zona",
                            "valor",
                            "codigoRelativo",
                            "vecinos",
                            "cantidad"
                          ],
                          "additionalProperties": false
                        },
                        "description": "Hasta dos formas distintas de valores ilegibles, sin importes ni texto libre."
                      },
                      "omitidas": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991,
                        "description": "Observaciones de formas ilegibles omitidas por no cumplir el esquema seguro o por superar el máximo de dos formas distintas."
                      }
                    },
                    "required": [
                      "formas",
                      "omitidas"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "version",
                  "tipo",
                  "pendientes",
                  "causas",
                  "guardas_contrato"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "number",
                    "const": 1,
                    "description": "Versión del formato de este diagnóstico."
                  },
                  "tipo": {
                    "type": "string",
                    "const": "sii_boletas_identidad",
                    "description": "Identifica el diagnóstico de un rechazo de identidad en la lectura de boletas."
                  },
                  "causa": {
                    "type": "string",
                    "enum": [
                      "sin_identidad",
                      "otra_identidad"
                    ],
                    "description": "La respuesta no permitió verificar la identidad o correspondía a otra identidad."
                  },
                  "modo": {
                    "type": "string",
                    "const": "persona",
                    "description": "Quien autentica es distinto del contribuyente de la conexión; no indica que las boletas sean personales."
                  },
                  "esquema": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "portal_credentials",
                          "portal_credentials_representante"
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Esquema de acceso usado para la consulta; null si no corresponde a uno de los esquemas reconocidos."
                  },
                  "forma": {
                    "type": "object",
                    "properties": {
                      "dataTipo": {
                        "type": "string",
                        "enum": [
                          "objeto",
                          "array",
                          "nulo",
                          "indefinido",
                          "cadena",
                          "numero",
                          "booleano",
                          "bigint",
                          "simbolo",
                          "funcion",
                          "inaccesible"
                        ],
                        "description": "Tipo del cuerpo recibido, sin exponer su contenido."
                      },
                      "boletas": {
                        "type": "object",
                        "properties": {
                          "presencia": {
                            "type": "string",
                            "enum": [
                              "presente",
                              "ausente",
                              "accesor",
                              "inaccesible"
                            ],
                            "description": "Indica si el campo es una propiedad propia con valor, está ausente, usa un accesor no ejecutado o no pudo inspeccionarse."
                          },
                          "tipo": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "objeto",
                                  "array",
                                  "nulo",
                                  "indefinido",
                                  "cadena",
                                  "numero",
                                  "booleano",
                                  "bigint",
                                  "simbolo",
                                  "funcion",
                                  "inaccesible"
                                ]
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Tipo del valor del campo cuando está presente; null si no se leyó un valor propio."
                          },
                          "cantidadFilas": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Longitud de la lista de boletas; null si el campo no es una lista o no pudo inspeccionarse."
                          }
                        },
                        "required": [
                          "presencia",
                          "tipo",
                          "cantidadFilas"
                        ],
                        "additionalProperties": false,
                        "description": "Presencia, tipo y cantidad de filas del campo de boletas, sin leer sus filas."
                      },
                      "rut": {
                        "type": "object",
                        "properties": {
                          "presencia": {
                            "type": "string",
                            "enum": [
                              "presente",
                              "ausente",
                              "accesor",
                              "inaccesible"
                            ],
                            "description": "Indica si el campo es una propiedad propia con valor, está ausente, usa un accesor no ejecutado o no pudo inspeccionarse."
                          },
                          "tipo": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "objeto",
                                  "array",
                                  "nulo",
                                  "indefinido",
                                  "cadena",
                                  "numero",
                                  "booleano",
                                  "bigint",
                                  "simbolo",
                                  "funcion",
                                  "inaccesible"
                                ]
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Tipo del valor del campo cuando está presente; null si no se leyó un valor propio."
                          }
                        },
                        "required": [
                          "presencia",
                          "tipo"
                        ],
                        "additionalProperties": false,
                        "description": "Presencia y tipo del campo RUT recibido, sin publicar su valor."
                      },
                      "dv": {
                        "type": "object",
                        "properties": {
                          "presencia": {
                            "type": "string",
                            "enum": [
                              "presente",
                              "ausente",
                              "accesor",
                              "inaccesible"
                            ],
                            "description": "Indica si el campo es una propiedad propia con valor, está ausente, usa un accesor no ejecutado o no pudo inspeccionarse."
                          },
                          "tipo": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "objeto",
                                  "array",
                                  "nulo",
                                  "indefinido",
                                  "cadena",
                                  "numero",
                                  "booleano",
                                  "bigint",
                                  "simbolo",
                                  "funcion",
                                  "inaccesible"
                                ]
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Tipo del valor del campo cuando está presente; null si no se leyó un valor propio."
                          }
                        },
                        "required": [
                          "presencia",
                          "tipo"
                        ],
                        "additionalProperties": false,
                        "description": "Presencia y tipo del dígito verificador recibido, sin publicar su valor."
                      }
                    },
                    "required": [
                      "dataTipo",
                      "boletas",
                      "rut",
                      "dv"
                    ],
                    "additionalProperties": false,
                    "description": "Forma de los campos relevantes de la respuesta rechazada, sin identidades ni contenido de boletas."
                  }
                },
                "required": [
                  "version",
                  "tipo",
                  "causa",
                  "modo",
                  "esquema",
                  "forma"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "number",
                    "const": 1,
                    "description": "Versión del formato de este diagnóstico."
                  },
                  "tipo": {
                    "type": "string",
                    "const": "sii_documentos_plazo",
                    "description": "Identifica el diagnóstico del tiempo usado por documentos."
                  },
                  "prorrogaHabilitada": {
                    "type": "boolean",
                    "description": "Si esta sincronización admitía tiempo adicional para documentos."
                  },
                  "prorrogaMs": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991,
                    "description": "Milisegundos usados después del plazo habitual."
                  },
                  "motivoCorte": {
                    "type": "string",
                    "enum": [
                      "barrido_completo",
                      "sin_tramo_disponible",
                      "plazo_base",
                      "sin_muestra",
                      "sii_lento",
                      "error_sii",
                      "techo"
                    ],
                    "description": "Por qué terminó la sincronización de documentos."
                  },
                  "paginas": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991,
                    "description": "Cantidad de lecturas usadas para medir la velocidad del SII."
                  },
                  "paginaMediaMs": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Duración media de las últimas lecturas medidas; null si no hubo."
                  },
                  "anomalias": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991,
                    "description": "Respuestas del SII que necesitaron reintento."
                  },
                  "anomaliasPorOrigen": {
                    "type": "object",
                    "properties": {
                      "indice": {
                        "description": "Reintentos al consultar el índice de documentos.",
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "descarga": {
                        "description": "Reintentos al descargar documentos.",
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "pagina_vacia": {
                        "description": "Reintentos por páginas vacías del índice.",
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "error": {
                        "description": "Errores del SII que terminaron la sincronización después del plazo habitual.",
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      }
                    },
                    "additionalProperties": false,
                    "description": "Reintentos por etapa."
                  },
                  "baseRestanteAlEmpezarMs": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991,
                    "description": "Plazo habitual que quedaba al empezar documentos."
                  },
                  "techoSobreBaseMs": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991,
                    "description": "Tiempo adicional máximo que admitía esta sincronización."
                  }
                },
                "required": [
                  "version",
                  "tipo",
                  "prorrogaHabilitada",
                  "prorrogaMs",
                  "motivoCorte",
                  "paginas",
                  "paginaMediaMs",
                  "anomalias",
                  "anomaliasPorOrigen",
                  "baseRestanteAlEmpezarMs",
                  "techoSobreBaseMs"
                ],
                "additionalProperties": false
              }
            ]
          },
          "error": {
            "description": "Por qué este alcance no terminó bien. Presente solo cuando 'status' es 'failed'. Normalmente es un código del catálogo de errores; cuando el sistema externo truncó el listado es una etiqueta de resultado ('movimientos_truncated', 'cartolas_truncated') que no está en ese catálogo y que significa «se escribió lo que alcanzó a venir». Decide por el valor, nunca por el texto libre.",
            "type": "string"
          }
        },
        "required": [
          "alcance",
          "status",
          "recordsSynced"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "periodo",
    "estado"
  ],
  "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.
too_many_pending429síDeja terminar los trabajos en curso antes de encolar más.

La llamada solo encola: las fallas del sistema externo (credencial, sesión, caída del portal) no llegan en esta respuesta, sino en el trabajo: en outcomes y last_error de GET /v1/syncs/{jobId}, o en los webhooks sync.succeeded (un alcance que falló junto a otros que terminaron) y sync.failed.

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