Consultar cambios de la cartera

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

Tool IDpjud.novedades.consultar
Nombre MCPpjud__novedades__consultar
Conectorpjud
Planoaction
Lee el alcanceexpedientes (debe estar habilitado en la conexión)
Scope (permiso)pjud:read
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. Entrega diferencias observadas por Emisso, con fecha de fuente y detección separadas. Sin causaIds revisa la cartera vigente; con IDs explícitos permite recuperar el historial de causas retiradas. La carga inicial está excluida por defecto y nunca representa hechos nuevos del día. Para un informe desde ayer revisa primero cartera.consultar y la cobertura de cada causa: observadoHasta es un máximo global, no prueba revisión de toda la cartera ni una base de comparación anterior al período. Consultar no marca novedades como leídas ni envía informes. Sin cambios y revisión incompleta son resultados distintos. Lee exclusivamente datos ya sincronizados de la conexión. Para actualizarlos usa pjud.conexion.sincronizar. Revisa estadoDatos, observadoHasta y cobertura antes de interpretar una lista vacía.

Entrada

CampoTipoRequeridoDescripción
cursorstringnoCursor opaco de la respuesta anterior. Reenvíalo sin construirlo ni modificarlo.
limitentero 1-100no · default 50Máximo de filas por página; conserva el cursor para continuar en el mismo corte.
desdestring `^(?:(?:\d\d[2468][048]\d\d[13579][26]\d\d0[48]
causaIdslista de string ^pjc_[a-zA-Z0-9_-]{16,80}$noLimita a estas causas, incluidas las retiradas. Si falta, usa la cartera vigente.
tiposlista de "carga_inicial" · "actuacion_incorporada" · "actuacion_actualizada" · "documento_incorporado" · "documento_disponible" · "documento_actualizado" · …noTipos de cambio que quieres incluir en esta consulta.
incluirCargaInicialbooleanono · default falseIncluye incorporaciones históricas iniciales; no son hechos nuevos del día.
JSON Schema de entrada
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Cursor opaco de la respuesta anterior. Reenvíalo sin construirlo ni modificarlo."
    },
    "limit": {
      "default": 50,
      "description": "Máximo de filas por página; conserva el cursor para continuar en el mismo corte.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "desde": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "description": "Instante ISO 8601 con zona horaria."
    },
    "causaIds": {
      "description": "Limita a estas causas, incluidas las retiradas. Si falta, usa la cartera vigente.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^pjc_[a-zA-Z0-9_-]{16,80}$",
        "description": "ID obtenido de pjud.causas.consultar. No es el rol escrito en el portal."
      }
    },
    "tipos": {
      "description": "Tipos de cambio que quieres incluir en esta consulta.",
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "carga_inicial",
          "actuacion_incorporada",
          "actuacion_actualizada",
          "documento_incorporado",
          "documento_disponible",
          "documento_actualizado",
          "causa_actualizada",
          "seccion_actualizada"
        ],
        "description": "Tipo de diferencia observada. Carga inicial corresponde a historia incorporada, no a actividad nueva del día."
      }
    },
    "incluirCargaInicial": {
      "default": false,
      "description": "Incluye incorporaciones históricas iniciales; no son hechos nuevos del día.",
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

Salida

CampoTipoRequeridoDescripción
novedadeslista de objetosíCambios observados por Emisso dentro de la cartera y del corte de consulta.
novedades[].novedadIdstring ^pjn_[a-zA-Z0-9_-]{16,80}$síIdentificador inmutable del cambio detectado por Emisso.
novedades[].causaIdstring ^pjc_[a-zA-Z0-9_-]{16,80}$síID obtenido de pjud.causas.consultar. No es el rol escrito en el portal.
novedades[].actuacionIdstring ^pja_[a-zA-Z0-9_-]{16,80}$nullsí
novedades[].documentoIdstring ^pjd_[a-zA-Z0-9_-]{16,80}$nullsí
novedades[].tipo"carga_inicial" · "actuacion_incorporada" · "actuacion_actualizada" · "documento_incorporado" · "documento_disponible" · "documento_actualizado" · …síTipo de diferencia observada. Carga inicial corresponde a historia incorporada, no a actividad nueva del día.
novedades[].seccionCivilobjetonullsí
novedades[].seccionCivil.nombre"notificaciones" · "escritos_por_resolver" · "exhortos" · "remisiones"síTabla civil cuyo contenido cambió.
novedades[].seccionCivil.cuadernoIdstring ^pjq_[a-zA-Z0-9_-]{16,80}$síIdentificador estable de cuaderno, obtenido de causas.detallar.
novedades[].seccionLaboralobjetonullno
novedades[].seccionLaboral.nombre"litigantes" · "notificaciones" · "diligencias" · "liquidacion" · "materias" · "escritos_por_resolver" · …síTabla laboral de la causa cuyo contenido cambió.
novedades[].observadoEnstring `^(?:(?:\d\d[2468][048]\d\d[13579][26]\d\d0[48]
novedades[].fechaFuentestring ^\d{4}-\d{2}-\d{2}$nullsí
novedades[].descripcionstringsíDescripción de la pieza o cambio observado.
novedades[].cambioslista de objetosíDiferencias puntuales entre valores observados.
novedades[].cambios[].campo"caratulado" · "estado" · "etapa" · "procedimiento" · "ubicacion" · "documento_sha256" · …síCampo cuyo valor cambió entre observaciones.
novedades[].cambios[].antesstringnullsí
novedades[].cambios[].despuesstringnullsí
novedades[].fuenteobjetosíProcedencia y fecha de observación. No contiene credenciales ni enlaces privados.
novedades[].fuente.sistemastringsíSistema judicial del que procede la observación.
novedades[].fuente.ruta"mis_causas" · "consulta_unificada" · "ingreso_ojv"síSuperficie OJV utilizada para recuperar la información.
novedades[].fuente.portalUrl"https://oficinajudicialvirtual.pjud.cl/indexN.php" · "https://ojv.pjud.cl/kpitec-ojv-web/views/login.html"síAcceso al portal; puede requerir sesión. No contiene enlaces privados ni tokens de OJV.
novedades[].fuente.observadoEnstring `^(?:(?:\d\d[2468][048]\d\d[13579][26]\d\d0[48]
cursorstringnullsí
estadoDatos"sin_sincronizar" · "disponibles" · "incompletos"síUna lista vacía con sin_sincronizar o incompletos no acredita ausencia de actividad judicial.
observadoHastastring `^(?:(?:\d\d[2468][048]\d\d[13579][26]\d\d0[48]
coberturalista de objetosíSecciones efectivamente revisadas y sus límites, para las causas de esta consulta.
cobertura[].causaIdstring ^pjc_[a-zA-Z0-9_-]{16,80}$síID obtenido de pjud.causas.consultar. No es el rol escrito en el portal.
cobertura[].cuadernoIdstring ^pjq_[a-zA-Z0-9_-]{16,80}$nullsí
cobertura[].seccion"cabecera" · "historia" · "litigantes" · "notificaciones" · "escritos_por_resolver" · "exhortos" · …síSección concreta cuya cobertura se informa.
cobertura[].estado"con_datos" · "sin_registros" · "parcial" · "fallida" · "no_accesible" · "no_implementada"síSolo con_datos y sin_registros acreditan revisión completa de esta sección. Los otros valores indican información pendiente o inaccesible.
cobertura[].revisadaEnstring `^(?:(?:\d\d[2468][048]\d\d[13579][26]\d\d0[48]
cobertura[].registrosObservadosenteronullsí
cobertura[].codigoIncidenciastring ^pjud_[a-z_]+$nullsí
cobertura[].referenciasAnexosRecuperadasbooleanonoEn documentos civiles, confirma que se recuperaron los originales de todas las referencias de anexos de los listados revisados, o que esos listados estaban vacíos. Su ausencia no acredita la captura; no significa texto completo ni identidad judicial de los anexos.
estadoCarga"completa" · "completa_con_limitaciones" · "pendiente" · "con_errores" · "no_verificada"noResultado operativo de cargar los originales, terminar el procesamiento local de texto y revisar las secciones ofrecidas de las causas examinadas en esta consulta. No acredita la cobertura probatoria completa de OJV ni representa necesariamente toda la conexión.
resumenDocumentosobjetonullno
resumenDocumentos.totalenterosíDocumentos guardados o referenciados de las causas examinadas; incluye los que quedan fuera de la página de documentos devuelta.
resumenDocumentos.originalesGuardadosenterosíDocumentos cuyos bytes originales están guardados y tienen un hash SHA-256 conocido, aunque su texto siga pendiente o incompleto.
resumenDocumentos.descargasPendientesenterosíDocumentos referenciados cuyo original todavía no está guardado.
resumenDocumentos.descargasFallidasenterosíDocumentos cuyo original no pudo confirmarse guardado por una descarga fallida o inconsistente.
resumenDocumentos.originalesSinAccesoenterosíDocumentos cuyo original no se pudo recuperar por falta de acceso.
resumenDocumentos.textosExtraidosenterosíDocumentos con texto recuperado en todas las páginas detectadas; no acredita por sí solo la cobertura completa de la causa.
resumenDocumentos.textosPendientesenterosíDocumentos con extracción pendiente o trabajo local automático por completar. Pueden conservar texto parcial o figurar también entre los textos fallidos.
resumenDocumentos.textosFallidosenterosíDocumentos con extracción fallida o procesamiento local terminado con error. Pueden conservar texto parcial o tener reintentos pendientes.
resumenDocumentos.textosParcialesenterosíDocumentos con texto recuperado solo en parte de sus páginas; no implica que falte el PDF original.
resumenDocumentos.textosRequierenOcrenterosíDocumentos sin texto recuperado que requieren reconocimiento de imágenes. No acredita que sus páginas estén vacías ni que falte el original.
resumenDocumentos.textosNoDisponiblesenterosíDocumentos cuyo estado indica que no hay texto disponible; no demuestra ausencia de contenido en el original.
limitacioneslista de objetonoLímites comprobados de la fuente o del texto extraído; no ocultan errores ni documentos por descargar.
limitaciones[].causaIdstring ^pjc_[a-zA-Z0-9_-]{16,80}$síID obtenido de pjud.causas.consultar. No es el rol escrito en el portal.
limitaciones[].cuadernoIdstring ^pjq_[a-zA-Z0-9_-]{16,80}$nullsí
limitaciones[].seccion"cabecera" · "historia" · "litigantes" · "notificaciones" · "escritos_por_resolver" · "exhortos" · …síSección concreta cuya cobertura se informa.
limitaciones[].codigo"pjud_seccion_ausente" · "pjud_anexos_identidad_no_publicada" · "pjud_texto_parcial" · "pjud_texto_requiere_ocr" · "pjud_inventario_no_verificado" · "pjud_fuentes_no_leidas"síLímite comprobado: sección ausente en la superficie revisada, identidad de anexos no publicada, texto parcial, texto que requiere OCR, inventario de cuadernos no verificable o fuentes documentales que el conector no abre (texto, tomo, documentos, agregados o anexos de una corte). No equivale a un fallo de descarga.
JSON Schema de salida
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "novedades": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "novedadId": {
            "type": "string",
            "pattern": "^pjn_[a-zA-Z0-9_-]{16,80}$",
            "description": "Identificador inmutable del cambio detectado por Emisso."
          },
          "causaId": {
            "type": "string",
            "pattern": "^pjc_[a-zA-Z0-9_-]{16,80}$",
            "description": "ID obtenido de pjud.causas.consultar. No es el rol escrito en el portal."
          },
          "actuacionId": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^pja_[a-zA-Z0-9_-]{16,80}$",
                "description": "Identificador estable de actuación dentro de su causa y ámbito de historia."
              },
              {
                "type": "null"
              }
            ],
            "description": "Actuación asociada; null para información de toda la causa."
          },
          "documentoId": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^pjd_[a-zA-Z0-9_-]{16,80}$",
                "description": "ID obtenido de pjud.documentos.consultar; nunca un enlace ni un token de OJV."
              },
              {
                "type": "null"
              }
            ],
            "description": "Documento afectado por el cambio, si corresponde."
          },
          "tipo": {
            "type": "string",
            "enum": [
              "carga_inicial",
              "actuacion_incorporada",
              "actuacion_actualizada",
              "documento_incorporado",
              "documento_disponible",
              "documento_actualizado",
              "causa_actualizada",
              "seccion_actualizada"
            ],
            "description": "Tipo de diferencia observada. Carga inicial corresponde a historia incorporada, no a actividad nueva del día."
          },
          "seccionCivil": {
            "default": null,
            "description": "Sección civil y contexto de cuaderno cuya tabla cambió; consulta causas.detallar con esos filtros. null para los otros tipos de novedad.",
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "nombre": {
                    "type": "string",
                    "enum": [
                      "notificaciones",
                      "escritos_por_resolver",
                      "exhortos",
                      "remisiones"
                    ],
                    "description": "Tabla civil cuyo contenido cambió."
                  },
                  "cuadernoId": {
                    "type": "string",
                    "pattern": "^pjq_[a-zA-Z0-9_-]{16,80}$",
                    "description": "Identificador estable de cuaderno, obtenido de causas.detallar."
                  }
                },
                "required": [
                  "nombre",
                  "cuadernoId"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "seccionLaboral": {
            "description": "Tabla laboral cuya revisión cambió; consulta causas.detallar con ese filtro. Ausente o null para otras novedades.",
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "nombre": {
                    "type": "string",
                    "enum": [
                      "litigantes",
                      "notificaciones",
                      "diligencias",
                      "liquidacion",
                      "materias",
                      "escritos_por_resolver",
                      "remisiones"
                    ],
                    "description": "Tabla laboral de la causa cuyo contenido cambió."
                  }
                },
                "required": [
                  "nombre"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "observadoEn": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
            "description": "Instante ISO 8601 con zona horaria."
          },
          "fechaFuente": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "x-emisso-formato": "AAAA-MM-DD"
              },
              {
                "type": "null"
              }
            ],
            "description": "Día de fuente asociado a la pieza o al cambio en AAAA-MM-DD; null si no está disponible."
          },
          "descripcion": {
            "type": "string",
            "description": "Descripción de la pieza o cambio observado."
          },
          "cambios": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "campo": {
                  "type": "string",
                  "enum": [
                    "caratulado",
                    "estado",
                    "etapa",
                    "procedimiento",
                    "ubicacion",
                    "documento_sha256",
                    "descripcion",
                    "tramite",
                    "fecha_tramite",
                    "fecha_entre_parentesis",
                    "fecha_fuente",
                    "foja",
                    "estado_administrativo",
                    "forma_inicio",
                    "estado_actuacion"
                  ],
                  "description": "Campo cuyo valor cambió entre observaciones."
                },
                "antes": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Valor previo; null si no existía o no estaba disponible."
                },
                "despues": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Valor observado en esta revisión; null si no está disponible."
                }
              },
              "required": [
                "campo",
                "antes",
                "despues"
              ],
              "additionalProperties": false
            },
            "description": "Diferencias puntuales entre valores observados."
          },
          "fuente": {
            "type": "object",
            "properties": {
              "sistema": {
                "type": "string",
                "const": "OJV",
                "description": "Sistema judicial del que procede la observación."
              },
              "ruta": {
                "type": "string",
                "enum": [
                  "mis_causas",
                  "consulta_unificada",
                  "ingreso_ojv"
                ],
                "description": "Superficie OJV utilizada para recuperar la información."
              },
              "portalUrl": {
                "type": "string",
                "enum": [
                  "https://oficinajudicialvirtual.pjud.cl/indexN.php",
                  "https://ojv.pjud.cl/kpitec-ojv-web/views/login.html"
                ],
                "description": "Acceso al portal; puede requerir sesión. No contiene enlaces privados ni tokens de OJV."
              },
              "observadoEn": {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                "description": "Instante ISO 8601 con zona horaria."
              }
            },
            "required": [
              "sistema",
              "ruta",
              "portalUrl",
              "observadoEn"
            ],
            "additionalProperties": false,
            "description": "Procedencia y fecha de observación. No contiene credenciales ni enlaces privados."
          }
        },
        "required": [
          "novedadId",
          "causaId",
          "actuacionId",
          "documentoId",
          "tipo",
          "seccionCivil",
          "observadoEn",
          "fechaFuente",
          "descripcion",
          "cambios",
          "fuente"
        ],
        "additionalProperties": false
      },
      "description": "Cambios observados por Emisso dentro de la cartera y del corte de consulta."
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 4096,
          "description": "Cursor opaco de la respuesta anterior. Reenvíalo sin construirlo ni modificarlo."
        },
        {
          "type": "null"
        }
      ],
      "description": "null cuando no quedan filas en este corte; no acredita que OJV esté completamente revisada."
    },
    "estadoDatos": {
      "type": "string",
      "enum": [
        "sin_sincronizar",
        "disponibles",
        "incompletos"
      ],
      "description": "Una lista vacía con sin_sincronizar o incompletos no acredita ausencia de actividad judicial."
    },
    "observadoHasta": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
          "description": "Instante ISO 8601 con zona horaria."
        },
        {
          "type": "null"
        }
      ],
      "description": "Corte de observación de los datos persistidos. No es la fecha de la consulta ni la de una resolución."
    },
    "cobertura": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "causaId": {
            "type": "string",
            "pattern": "^pjc_[a-zA-Z0-9_-]{16,80}$",
            "description": "ID obtenido de pjud.causas.consultar. No es el rol escrito en el portal."
          },
          "cuadernoId": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^pjq_[a-zA-Z0-9_-]{16,80}$",
                "description": "Identificador estable de cuaderno, obtenido de causas.detallar."
              },
              {
                "type": "null"
              }
            ],
            "description": "Cuaderno al que corresponde la información; null para una sección de toda la causa."
          },
          "seccion": {
            "type": "string",
            "enum": [
              "cabecera",
              "historia",
              "litigantes",
              "notificaciones",
              "escritos_por_resolver",
              "exhortos",
              "remisiones",
              "documentos",
              "diligencias",
              "liquidacion",
              "materias"
            ],
            "description": "Sección concreta cuya cobertura se informa."
          },
          "estado": {
            "type": "string",
            "enum": [
              "con_datos",
              "sin_registros",
              "parcial",
              "fallida",
              "no_accesible",
              "no_implementada"
            ],
            "description": "Solo con_datos y sin_registros acreditan revisión completa de esta sección. Los otros valores indican información pendiente o inaccesible."
          },
          "revisadaEn": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                "description": "Instante ISO 8601 con zona horaria."
              },
              {
                "type": "null"
              }
            ],
            "description": "Instante ISO 8601 de revisión; null si esa sección no se revisó."
          },
          "registrosObservados": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Filas observadas en la sección; null significa que no se pudo contar, no cero."
          },
          "codigoIncidencia": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^pjud_[a-z_]+$"
              },
              {
                "type": "null"
              }
            ],
            "description": "Código saneado; nunca texto del proveedor."
          },
          "referenciasAnexosRecuperadas": {
            "description": "En documentos civiles, confirma que se recuperaron los originales de todas las referencias de anexos de los listados revisados, o que esos listados estaban vacíos. Su ausencia no acredita la captura; no significa texto completo ni identidad judicial de los anexos.",
            "type": "boolean",
            "const": true
          }
        },
        "required": [
          "causaId",
          "cuadernoId",
          "seccion",
          "estado",
          "revisadaEn",
          "registrosObservados",
          "codigoIncidencia"
        ],
        "additionalProperties": false
      },
      "description": "Secciones efectivamente revisadas y sus límites, para las causas de esta consulta."
    },
    "estadoCarga": {
      "type": "string",
      "enum": [
        "completa",
        "completa_con_limitaciones",
        "pendiente",
        "con_errores",
        "no_verificada"
      ],
      "description": "Resultado operativo de cargar los originales, terminar el procesamiento local de texto y revisar las secciones ofrecidas de las causas examinadas en esta consulta. No acredita la cobertura probatoria completa de OJV ni representa necesariamente toda la conexión."
    },
    "resumenDocumentos": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "total": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Documentos guardados o referenciados de las causas examinadas; incluye los que quedan fuera de la página de documentos devuelta."
            },
            "originalesGuardados": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Documentos cuyos bytes originales están guardados y tienen un hash SHA-256 conocido, aunque su texto siga pendiente o incompleto."
            },
            "descargasPendientes": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Documentos referenciados cuyo original todavía no está guardado."
            },
            "descargasFallidas": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Documentos cuyo original no pudo confirmarse guardado por una descarga fallida o inconsistente."
            },
            "originalesSinAcceso": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Documentos cuyo original no se pudo recuperar por falta de acceso."
            },
            "textosExtraidos": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Documentos con texto recuperado en todas las páginas detectadas; no acredita por sí solo la cobertura completa de la causa."
            },
            "textosPendientes": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Documentos con extracción pendiente o trabajo local automático por completar. Pueden conservar texto parcial o figurar también entre los textos fallidos."
            },
            "textosFallidos": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Documentos con extracción fallida o procesamiento local terminado con error. Pueden conservar texto parcial o tener reintentos pendientes."
            },
            "textosParciales": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Documentos con texto recuperado solo en parte de sus páginas; no implica que falte el PDF original."
            },
            "textosRequierenOcr": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Documentos sin texto recuperado que requieren reconocimiento de imágenes. No acredita que sus páginas estén vacías ni que falte el original."
            },
            "textosNoDisponibles": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Documentos cuyo estado indica que no hay texto disponible; no demuestra ausencia de contenido en el original."
            }
          },
          "required": [
            "total",
            "originalesGuardados",
            "descargasPendientes",
            "descargasFallidas",
            "originalesSinAcceso",
            "textosExtraidos",
            "textosPendientes",
            "textosFallidos",
            "textosParciales",
            "textosRequierenOcr",
            "textosNoDisponibles"
          ],
          "additionalProperties": false,
          "description": "Conteos de todos los documentos guardados o referenciados de las causas examinadas en esta consulta, no solo de la página de resultados. Texto parcial o pendiente no implica que falte el PDF original. Los conteos de texto pueden solaparse cuando hay procesamiento pendiente o con error."
        },
        {
          "type": "null"
        }
      ],
      "description": "Conteos de documentos de las causas examinadas. null cuando algún resumen antiguo no permite comprobarlos; nunca significa cero documentos ni representa necesariamente toda la conexión."
    },
    "limitaciones": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "causaId": {
            "type": "string",
            "pattern": "^pjc_[a-zA-Z0-9_-]{16,80}$",
            "description": "ID obtenido de pjud.causas.consultar. No es el rol escrito en el portal."
          },
          "cuadernoId": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^pjq_[a-zA-Z0-9_-]{16,80}$",
                "description": "Identificador estable de cuaderno, obtenido de causas.detallar."
              },
              {
                "type": "null"
              }
            ],
            "description": "Cuaderno al que afecta la limitación; null cuando corresponde a información de toda la causa."
          },
          "seccion": {
            "type": "string",
            "enum": [
              "cabecera",
              "historia",
              "litigantes",
              "notificaciones",
              "escritos_por_resolver",
              "exhortos",
              "remisiones",
              "documentos",
              "diligencias",
              "liquidacion",
              "materias"
            ],
            "description": "Sección concreta cuya cobertura se informa."
          },
          "codigo": {
            "type": "string",
            "enum": [
              "pjud_seccion_ausente",
              "pjud_anexos_identidad_no_publicada",
              "pjud_texto_parcial",
              "pjud_texto_requiere_ocr",
              "pjud_inventario_no_verificado",
              "pjud_fuentes_no_leidas"
            ],
            "description": "Límite comprobado: sección ausente en la superficie revisada, identidad de anexos no publicada, texto parcial, texto que requiere OCR, inventario de cuadernos no verificable o fuentes documentales que el conector no abre (texto, tomo, documentos, agregados o anexos de una corte). No equivale a un fallo de descarga."
          }
        },
        "required": [
          "causaId",
          "cuadernoId",
          "seccion",
          "codigo"
        ],
        "additionalProperties": false
      },
      "description": "Límites comprobados de la fuente o del texto extraído; no ocultan errores ni documentos por descargar."
    }
  },
  "required": [
    "novedades",
    "cursor",
    "estadoDatos",
    "observadoHasta",
    "cobertura"
  ],
  "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