Consultar cartera judicial

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

Tool IDpjud.causas.consultar
Nombre MCPpjud__causas__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. Busca en la cartera elegida por identificador o carátula. El nombre no identifica inequívocamente a una persona. La inactividad observada no implica abandono ni incumplimiento. 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.
busquedastringnoTexto de búsqueda entre los datos persistidos de la conexión.
competencia"suprema" · "apelaciones" · "civil" · "laboral" · "penal" · "cobranza" · …noCompetencia judicial de la causa. Su presencia en el contrato no implica que todas las competencias estén implementadas.
tribunalstringnoTexto de búsqueda entre los datos persistidos de la conexión.
estadostringnoTexto de búsqueda entre los datos persistidos de la conexión.
ultimaActuacionDesdestring ^\d{4}-\d{2}-\d{2}$noDía inicial de última actuación en AAAA-MM-DD, inclusive.
ultimaActuacionHastastring ^\d{4}-\d{2}-\d{2}$noDía final de última actuación en AAAA-MM-DD, inclusive.
incluirRetiradasbooleanono · default falseIncluye causas retiradas del seguimiento, conservadas como historia en Emisso.
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
    },
    "busqueda": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Texto de búsqueda entre los datos persistidos de la conexión."
    },
    "competencia": {
      "type": "string",
      "enum": [
        "suprema",
        "apelaciones",
        "civil",
        "laboral",
        "penal",
        "cobranza",
        "familia",
        "disciplinario"
      ],
      "description": "Competencia judicial de la causa. Su presencia en el contrato no implica que todas las competencias estén implementadas."
    },
    "tribunal": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Texto de búsqueda entre los datos persistidos de la conexión."
    },
    "estado": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Texto de búsqueda entre los datos persistidos de la conexión."
    },
    "ultimaActuacionDesde": {
      "description": "Día inicial de última actuación en AAAA-MM-DD, inclusive.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "x-emisso-formato": "AAAA-MM-DD"
    },
    "ultimaActuacionHasta": {
      "description": "Día final de última actuación en AAAA-MM-DD, inclusive.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "x-emisso-formato": "AAAA-MM-DD"
    },
    "incluirRetiradas": {
      "default": false,
      "description": "Incluye causas retiradas del seguimiento, conservadas como historia en Emisso.",
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

Salida

CampoTipoRequeridoDescripción
causaslista de objetosíCausas de esta página de la cartera autorizada.
causas[].causaIdstring ^pjc_[a-zA-Z0-9_-]{16,80}$síID obtenido de pjud.causas.consultar. No es el rol escrito en el portal.
causas[].competencia"suprema" · "apelaciones" · "civil" · "laboral" · "penal" · "cobranza" · …síCompetencia judicial de la causa. Su presencia en el contrato no implica que todas las competencias estén implementadas.
causas[].tribunalobjetosíTribunal que conoce la causa.
causas[].tribunal.codigostringnullsí
causas[].tribunal.nombrestringsíNombre publicado del tribunal.
causas[].identificadorstringsíReferencia judicial visible, por ejemplo C-1234-2026.
causas[].rolstringnullsí
causas[].ritstringnullsí
causas[].rucstringnullsí
causas[].anioentero 1800-9999nullsí
causas[].caratuladostringsíCarátula tal como la informa OJV. No identifica por sí sola al cliente del estudio.
causas[].estadostringnullsí
causas[].etapastringnullsí
causas[].procedimientostringnullsí
causas[].ubicacionstringnullsí
causas[].estadoAdministrativostringnullno
causas[].formaIniciostringnullno
causas[].librostringnullno
causas[].fechaIngresostring ^\d{4}-\d{2}-\d{2}$nullsí
causas[].ultimaActuacionstring ^\d{4}-\d{2}-\d{2}$nullsí
causas[].seguimiento"activo" · "retirado"síEstado del seguimiento en Emisso, independiente del estado procesal.
causas[].origenIncorporacion"seleccion_mis_causas" · "referencia_exacta"síCómo se eligió esta causa para la cartera autorizada.
causas[].fuenteobjetosíProcedencia y fecha de observación. No contiene credenciales ni enlaces privados.
causas[].fuente.sistemastringsíSistema judicial del que procede la observación.
causas[].fuente.ruta"mis_causas" · "consulta_unificada" · "ingreso_ojv"síSuperficie OJV utilizada para recuperar la información.
causas[].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.
causas[].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": {
    "causas": {
      "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."
          },
          "competencia": {
            "type": "string",
            "enum": [
              "suprema",
              "apelaciones",
              "civil",
              "laboral",
              "penal",
              "cobranza",
              "familia",
              "disciplinario"
            ],
            "description": "Competencia judicial de la causa. Su presencia en el contrato no implica que todas las competencias estén implementadas."
          },
          "tribunal": {
            "type": "object",
            "properties": {
              "codigo": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Código oficial del tribunal dentro de su competencia; null si la fuente no lo entrega."
              },
              "nombre": {
                "type": "string",
                "minLength": 1,
                "description": "Nombre publicado del tribunal."
              }
            },
            "required": [
              "codigo",
              "nombre"
            ],
            "additionalProperties": false,
            "description": "Tribunal que conoce la causa."
          },
          "identificador": {
            "type": "string",
            "minLength": 1,
            "description": "Referencia judicial visible, por ejemplo C-1234-2026."
          },
          "rol": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Rol informado por la fuente; null si utiliza otro identificador."
          },
          "rit": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "RIT informado por la fuente; null cuando no corresponde."
          },
          "ruc": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "RUC informado por la fuente; no se deduce de otros identificadores."
          },
          "anio": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 1800,
                "maximum": 9999
              },
              {
                "type": "null"
              }
            ],
            "description": "Año de la referencia judicial; null si no está disponible."
          },
          "caratulado": {
            "type": "string",
            "description": "Carátula tal como la informa OJV. No identifica por sí sola al cliente del estudio."
          },
          "estado": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Estado publicado por OJV, sin reinterpretación jurídica."
          },
          "etapa": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Etapa procesal publicada; null si no aparece."
          },
          "procedimiento": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Procedimiento informado en la cabecera de OJV."
          },
          "ubicacion": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Ubicación informada por el portal; null si no está disponible."
          },
          "estadoAdministrativo": {
            "description": "Estado administrativo publicado por OJV, independiente del estado procesal. Ausente en observaciones anteriores o de otra competencia.",
            "anyOf": [
              {
                "type": "string",
                "minLength": 1,
                "maxLength": 4000
              },
              {
                "type": "null"
              }
            ]
          },
          "formaInicio": {
            "description": "Forma de inicio publicada por OJV. Ausente cuando la superficie observada no incorpora este campo.",
            "anyOf": [
              {
                "type": "string",
                "minLength": 1,
                "maxLength": 4000
              },
              {
                "type": "null"
              }
            ]
          },
          "libro": {
            "description": "Libro de la Corte Suprema o de Apelaciones publicado en la ficha del recurso, por ejemplo Civil o Laboral - Cobranza. Ausente en otras competencias.",
            "anyOf": [
              {
                "type": "string",
                "minLength": 1,
                "maxLength": 200
              },
              {
                "type": "null"
              }
            ]
          },
          "fechaIngreso": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "x-emisso-formato": "AAAA-MM-DD"
              },
              {
                "type": "null"
              }
            ],
            "description": "Día de ingreso de la causa en AAAA-MM-DD; null si no está disponible."
          },
          "ultimaActuacion": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "x-emisso-formato": "AAAA-MM-DD"
              },
              {
                "type": "null"
              }
            ],
            "description": "Día de la última actuación observada en AAAA-MM-DD; null si no está disponible."
          },
          "seguimiento": {
            "type": "string",
            "enum": [
              "activo",
              "retirado"
            ],
            "description": "Estado del seguimiento en Emisso, independiente del estado procesal."
          },
          "origenIncorporacion": {
            "type": "string",
            "enum": [
              "seleccion_mis_causas",
              "referencia_exacta"
            ],
            "description": "Cómo se eligió esta causa para la cartera autorizada."
          },
          "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": [
          "causaId",
          "competencia",
          "tribunal",
          "identificador",
          "rol",
          "rit",
          "ruc",
          "anio",
          "caratulado",
          "estado",
          "etapa",
          "procedimiento",
          "ubicacion",
          "fechaIngreso",
          "ultimaActuacion",
          "seguimiento",
          "origenIncorporacion",
          "fuente"
        ],
        "additionalProperties": false
      },
      "description": "Causas de esta página de la cartera autorizada."
    },
    "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": [
    "causas",
    "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