Consultar actuaciones judiciales

Reconstruye la cronología observada: por cuadernos en Civil o directamente en la causa laboral.


Tool ID	`pjud.actuaciones.consultar`
Nombre MCP	`pjud__actuaciones__consultar`
Conector	`pjud`
Plano	`action`
Lee el alcance	`expedientes` (debe estar habilitado en la conexión)
Scope (permiso)	`pjud:read`
Auth	`none`
Versión	`1`
Sensible	sí
Deprecado	no
Comportamiento	readOnly=true, destructive=false, idempotent=true, openWorld=false

Requiere conexión. Indica cuál en cada llamada: header X-Connect-Connection en REST, campo connectionId en el execute de MCP y en las opciones del SDK. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de conexiones.estado.consultar.

Qué hace

Las fechas de trámite, fuente y observación mantienen su significado; no calcula plazos legales. 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

Campo	Tipo	Requerido	Descripción
`causaId`	string `^pjc_[a-zA-Z0-9_-]{16,80}$`	sí	ID obtenido de pjud.causas.consultar. No es el rol escrito en el portal.
`cuadernoId`	string `^pjq_[a-zA-Z0-9_-]{16,80}$`	no	Identificador estable de cuaderno, obtenido de causas.detallar.
`desde`	string `^\d{4}-\d{2}-\d{2}$`	no	Día inicial del rango en AAAA-MM-DD, inclusive.
`hasta`	string `^\d{4}-\d{2}-\d{2}$`	no	Día final del rango en AAAA-MM-DD, inclusive.
`tramite`	string	no	Texto de búsqueda entre los datos persistidos de la conexión.
`cursor`	string	no	Cursor opaco de la respuesta anterior. Reenvíalo sin construirlo ni modificarlo.
`limit`	entero 1-100	no · default `50`	Máximo de filas por página; conserva el cursor para continuar en el mismo corte.

JSON Schema de entrada

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "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": {
      "type": "string",
      "pattern": "^pjq_[a-zA-Z0-9_-]{16,80}$",
      "description": "Identificador estable de cuaderno, obtenido de causas.detallar."
    },
    "desde": {
      "description": "Día inicial del rango en AAAA-MM-DD, inclusive.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "x-emisso-formato": "AAAA-MM-DD"
    },
    "hasta": {
      "description": "Día final del rango en AAAA-MM-DD, inclusive.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "x-emisso-formato": "AAAA-MM-DD"
    },
    "tramite": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Texto de búsqueda entre los datos persistidos de la conexión."
    },
    "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
    }
  },
  "required": [
    "causaId"
  ],
  "additionalProperties": false
}

Salida

Campo	Tipo	Requerido	Descripción
`actuaciones`	lista de objeto	sí	Actuaciones de esta página, con sus fechas originales y fuente.
`actuaciones[].actuacionId`	string `^pja_[a-zA-Z0-9_-]{16,80}$`	sí	Identificador estable de actuación dentro de su causa y ámbito de historia.
`actuaciones[].causaId`	string `^pjc_[a-zA-Z0-9_-]{16,80}$`	sí	ID obtenido de pjud.causas.consultar. No es el rol escrito en el portal.
`actuaciones[].cuadernoId`	string `^pjq_[a-zA-Z0-9_-]{16,80}$`	null	sí
`actuaciones[].folio`	string	sí	Folio dentro del ámbito de historia. No es un identificador único entre causas.
`actuaciones[].etapa`	string	null	sí
`actuaciones[].tramite`	string	null	sí
`actuaciones[].descripcion`	string	sí	Descripción de la pieza o cambio observado.
`actuaciones[].estadoFuente`	string	null	no
`actuaciones[].documentosReferenciadosFuente`	objeto	no	Controles documentales observados en la fila, por clase; no acredita descarga de sus bytes.
`actuaciones[].documentosReferenciadosFuente.principales`	entero 0-100	sí	Controles de documentos principales observados en la actuación.
`actuaciones[].documentosReferenciadosFuente.certificadosEnvio`	entero 0-100	sí	Controles de certificados de envío observados en la actuación.
`actuaciones[].documentosReferenciadosFuente.sinClasificar`	entero 0-100	sí	Controles documentales cuya clase no pudo identificarse.
`actuaciones[].tieneReferenciaAnexo`	booleano	no	Hay un control de anexos en la actuación; no acredita lectura ni descarga de su contenido.
`actuaciones[].lecturaAnexosFuente`	objeto	no	Lectura del listado de anexos de esta actuación; ausente cuando no hay control o en observaciones anteriores.
`actuaciones[].lecturaAnexosFuente.estado`	`"con_datos"` · `"sin_registros"` · `"fallida"` · `"no_revisada"`	sí	Resultado de revisar el listado, independiente de descargar sus PDF.
`actuaciones[].lecturaAnexosFuente.registrosObservados`	entero 0-5000	null	sí
`actuaciones[].lecturaAnexosFuente.revisadaEn`	string `^(?:(?:\d\d[2468][048]	\d\d[13579][26]	\d\d0[48]
`actuaciones[].lecturaAnexosFuente.codigoIncidencia`	string `^pjud_[a-z0-9_]{1,100}$`	null	sí
`actuaciones[].tieneGeoreferencia`	booleano	no	Hay un control de georreferencia; no acredita lectura de la información asociada.
`actuaciones[].fechaTramite`	string `^\d{4}-\d{2}-\d{2}$`	null	sí
`actuaciones[].fechaEntreParentesis`	string `^\d{4}-\d{2}-\d{2}$`	null	sí
`actuaciones[].fechaFuente`	string	sí	Texto original en DD/MM/AAAA, con otra fecha opcional entre paréntesis. Usa fechaTramite y fechaEntreParentesis para comparar. No lo pases por new Date ni interpretes la segunda fecha como notificación o inicio de plazo.
`actuaciones[].foja`	string	null	sí
`actuaciones[].documentoIds`	lista de string `^pjd_[a-zA-Z0-9_-]{16,80}$`	sí	Piezas documentales vinculadas a esta actuación.
`actuaciones[].fuente`	objeto	sí	Procedencia y fecha de observación. No contiene credenciales ni enlaces privados.
`actuaciones[].fuente.sistema`	string	sí	Sistema judicial del que procede la observación.
`actuaciones[].fuente.ruta`	`"mis_causas"` · `"consulta_unificada"` · `"ingreso_ojv"`	sí	Superficie OJV utilizada para recuperar la información.
`actuaciones[].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.
`actuaciones[].fuente.observadoEn`	string `^(?:(?:\d\d[2468][048]	\d\d[13579][26]	\d\d0[48]
`cursor`	string	null	sí
`estadoDatos`	`"sin_sincronizar"` · `"disponibles"` · `"incompletos"`	sí	Una lista vacía con sin_sincronizar o incompletos no acredita ausencia de actividad judicial.
`observadoHasta`	string `^(?:(?:\d\d[2468][048]	\d\d[13579][26]	\d\d0[48]
`cobertura`	lista de objeto	sí	Secciones efectivamente revisadas y sus límites, para las causas de esta consulta.
`cobertura[].causaId`	string `^pjc_[a-zA-Z0-9_-]{16,80}$`	sí	ID obtenido de pjud.causas.consultar. No es el rol escrito en el portal.
`cobertura[].cuadernoId`	string `^pjq_[a-zA-Z0-9_-]{16,80}$`	null	sí
`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[].revisadaEn`	string `^(?:(?:\d\d[2468][048]	\d\d[13579][26]	\d\d0[48]
`cobertura[].registrosObservados`	entero	null	sí
`cobertura[].codigoIncidencia`	string `^pjud_[a-z_]+$`	null	sí

JSON Schema de salida

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "actuaciones": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "actuacionId": {
            "type": "string",
            "pattern": "^pja_[a-zA-Z0-9_-]{16,80}$",
            "description": "Identificador estable de actuación dentro de su causa y ámbito de historia."
          },
          "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 de la actuación; null solo cuando la superficie presenta la historia directamente en la causa."
          },
          "folio": {
            "type": "string",
            "description": "Folio dentro del ámbito de historia. No es un identificador único entre causas."
          },
          "etapa": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Etapa procesal publicada; null si no aparece."
          },
          "tramite": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tipo de trámite publicado por el portal."
          },
          "descripcion": {
            "type": "string",
            "description": "Descripción de la pieza o cambio observado."
          },
          "estadoFuente": {
            "description": "Estado propio de la actuación publicado por OJV, sin interpretación jurídica.",
            "anyOf": [
              {
                "type": "string",
                "minLength": 1,
                "maxLength": 4000
              },
              {
                "type": "null"
              }
            ]
          },
          "documentosReferenciadosFuente": {
            "description": "Controles documentales observados en la fila, por clase; no acredita descarga de sus bytes.",
            "type": "object",
            "properties": {
              "principales": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100,
                "description": "Controles de documentos principales observados en la actuación."
              },
              "certificadosEnvio": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100,
                "description": "Controles de certificados de envío observados en la actuación."
              },
              "sinClasificar": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100,
                "description": "Controles documentales cuya clase no pudo identificarse."
              }
            },
            "required": [
              "principales",
              "certificadosEnvio",
              "sinClasificar"
            ],
            "additionalProperties": false
          },
          "tieneReferenciaAnexo": {
            "description": "Hay un control de anexos en la actuación; no acredita lectura ni descarga de su contenido.",
            "type": "boolean"
          },
          "lecturaAnexosFuente": {
            "description": "Lectura del listado de anexos de esta actuación; ausente cuando no hay control o en observaciones anteriores.",
            "type": "object",
            "properties": {
              "estado": {
                "type": "string",
                "enum": [
                  "con_datos",
                  "sin_registros",
                  "fallida",
                  "no_revisada"
                ],
                "description": "Resultado de revisar el listado, independiente de descargar sus PDF."
              },
              "registrosObservados": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 5000
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Referencias del listado revisado; null si no se pudo revisar."
              },
              "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": "Revisión del listado en esta observación; null si no se envió la solicitud."
              },
              "codigoIncidencia": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^pjud_[a-z0-9_]{1,100}$"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Código saneado del fallo de lectura; nunca contenido privado."
              }
            },
            "required": [
              "estado",
              "registrosObservados",
              "revisadaEn",
              "codigoIncidencia"
            ],
            "additionalProperties": false
          },
          "tieneGeoreferencia": {
            "description": "Hay un control de georreferencia; no acredita lectura de la información asociada.",
            "type": "boolean"
          },
          "fechaTramite": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "x-emisso-formato": "AAAA-MM-DD"
              },
              {
                "type": "null"
              }
            ],
            "description": "Día del trámite indicado por OJV en AAAA-MM-DD; null si no está disponible."
          },
          "fechaEntreParentesis": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "x-emisso-formato": "AAAA-MM-DD"
              },
              {
                "type": "null"
              }
            ],
            "description": "Segunda fecha entre paréntesis; no se interpreta como notificación ni inicio de plazo en AAAA-MM-DD; null si no está disponible."
          },
          "fechaFuente": {
            "type": "string",
            "description": "Texto original en DD/MM/AAAA, con otra fecha opcional entre paréntesis. Usa fechaTramite y fechaEntreParentesis para comparar. No lo pases por new Date ni interpretes la segunda fecha como notificación o inicio de plazo.",
            "x-emisso-formato": "DD/MM/AAAA (DD/MM/AAAA) opcional"
          },
          "foja": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Foja indicada por OJV; se conserva como texto."
          },
          "documentoIds": {
            "type": "array",
            "items": {
              "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."
            },
            "description": "Piezas documentales vinculadas a esta actuación."
          },
          "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": [
          "actuacionId",
          "causaId",
          "cuadernoId",
          "folio",
          "etapa",
          "tramite",
          "descripcion",
          "fechaTramite",
          "fechaEntreParentesis",
          "fechaFuente",
          "foja",
          "documentoIds",
          "fuente"
        ],
        "additionalProperties": false
      },
      "description": "Actuaciones de esta página, con sus fechas originales y fuente."
    },
    "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 mensajes, cookies o HTML del proveedor."
          }
        },
        "required": [
          "causaId",
          "cuadernoId",
          "seccion",
          "estado",
          "revisadaEn",
          "registrosObservados",
          "codigoIncidencia"
        ],
        "additionalProperties": false
      },
      "description": "Secciones efectivamente revisadas y sus límites, para las causas de esta consulta."
    }
  },
  "required": [
    "actuaciones",
    "cursor",
    "estadoDatos",
    "observadoHasta",
    "cobertura"
  ],
  "additionalProperties": false
}

Errores de esta tool

Código	HTTP	Reintentable	Qué hacer
`connection_disabled`	403	no	Reactívala en /connections o usa otra conexión del mismo sistema.
`alcance_not_enabled`	403	no	Habilita el alcance en /connections o quítalo del input de la sincronización.

Toda llamada puede devolver además los códigos transversales (validation_error, unauthorized, scope_not_granted, rate_limited, entre otros): el detalle vive en el catálogo de errores.

Próximos pasos

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