# Ver el expediente de una causa
> Entrega cabecera, partes accesibles y tablas de la competencia.
{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}
| | |
| ------------------- | ------------------------------------------------------------------ |
| **Tool ID** | `pjud.causas.detallar` |
| **Nombre MCP** | `pjud__causas__detallar` |
| **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`](../conexiones/estado-consultar).
## Qué hace [#qué-hace]
Civil organiza la historia por cuaderno; Laboral la presenta en la causa. Conserva estados y cobertura por sección. No presume que una parte sea cliente del estudio. 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 [#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. |
| `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 de tablas por página. Una tabla vacía ocupa una posición; conserva el cursor para continuar. |
| `cuadernoId` | string `^pjq_[a-zA-Z0-9_-]{16,80}$` | no | Limita las tablas al contexto de este cuaderno. |
| `seccionCivil` | `"notificaciones"` · `"escritos_por_resolver"` · `"exhortos"` · `"remisiones"` | no | Limita las tablas a esta sección civil. |
| `seccionLaboral` | `"litigantes"` · `"notificaciones"` · `"diligencias"` · `"liquidacion"` · `"materias"` · `"escritos_por_resolver"` · … | no | Limita las tablas a esta sección laboral, en ámbito de causa. No se combina con cuadernoId ni seccionCivil. |
JSON Schema de entrada
```json
{
"$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."
},
"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 de tablas por página. Una tabla vacía ocupa una posición; conserva el cursor para continuar.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cuadernoId": {
"description": "Limita las tablas al contexto de este cuaderno.",
"type": "string",
"pattern": "^pjq_[a-zA-Z0-9_-]{16,80}$"
},
"seccionCivil": {
"description": "Limita las tablas a esta sección civil.",
"type": "string",
"enum": [
"notificaciones",
"escritos_por_resolver",
"exhortos",
"remisiones"
]
},
"seccionLaboral": {
"description": "Limita las tablas a esta sección laboral, en ámbito de causa. No se combina con cuadernoId ni seccionCivil.",
"type": "string",
"enum": [
"litigantes",
"notificaciones",
"diligencias",
"liquidacion",
"materias",
"escritos_por_resolver",
"remisiones"
]
}
},
"required": [
"causaId"
],
"additionalProperties": false
}
```
## Salida [#salida]
| Campo | Tipo | Requerido | Descripción | | | | | | | | | | | | | | | | | | | |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | --------------------- | ------------------ | ------- | ------- | ---------- | -------------- | ------- | --- | ----------------- | --- | ------------------------ | -------------------------------------------- | ----------------- | ----------------------- | ---- | ----------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `causa` | objeto | null | sí | Expediente solicitado, o null si no hay información disponible en esta conexión. | | | | | | | | | | | | | | | | | | |
| `causa.causaId` | string `^pjc_[a-zA-Z0-9_-]{16,80}$` | sí | ID obtenido de pjud.causas.consultar. No es el rol escrito en el portal. | | | | | | | | | | | | | | | | | | | |
| `causa.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. | | | | | | | | | | | | | | | | | | | |
| `causa.tribunal` | objeto | sí | Tribunal que conoce la causa. | | | | | | | | | | | | | | | | | | | |
| `causa.tribunal.codigo` | string | null | sí | Código oficial del tribunal dentro de su competencia; null si la fuente no lo entrega. | | | | | | | | | | | | | | | | | | |
| `causa.tribunal.nombre` | string | sí | Nombre publicado del tribunal. | | | | | | | | | | | | | | | | | | | |
| `causa.identificador` | string | sí | Referencia judicial visible, por ejemplo C-1234-2026. | | | | | | | | | | | | | | | | | | | |
| `causa.rol` | string | null | sí | Rol informado por la fuente; null si utiliza otro identificador. | | | | | | | | | | | | | | | | | | |
| `causa.rit` | string | null | sí | RIT informado por la fuente; null cuando no corresponde. | | | | | | | | | | | | | | | | | | |
| `causa.ruc` | string | null | sí | RUC informado por la fuente; no se deduce de otros identificadores. | | | | | | | | | | | | | | | | | | |
| `causa.anio` | entero 1800-9999 | null | sí | Año de la referencia judicial; null si no está disponible. | | | | | | | | | | | | | | | | | | |
| `causa.caratulado` | string | sí | Carátula tal como la informa OJV. No identifica por sí sola al cliente del estudio. | | | | | | | | | | | | | | | | | | | |
| `causa.estado` | string | null | sí | Estado publicado por OJV, sin reinterpretación jurídica. | | | | | | | | | | | | | | | | | | |
| `causa.etapa` | string | null | sí | Etapa procesal publicada; null si no aparece. | | | | | | | | | | | | | | | | | | |
| `causa.procedimiento` | string | null | sí | Procedimiento informado en la cabecera de OJV. | | | | | | | | | | | | | | | | | | |
| `causa.ubicacion` | string | null | sí | Ubicación informada por el portal; null si no está disponible. | | | | | | | | | | | | | | | | | | |
| `causa.estadoAdministrativo` | string | null | no | Estado administrativo publicado por OJV, independiente del estado procesal. Ausente en observaciones anteriores o de otra competencia. | | | | | | | | | | | | | | | | | | |
| `causa.formaInicio` | string | null | no | Forma de inicio publicada por OJV. Ausente cuando la superficie observada no incorpora este campo. | | | | | | | | | | | | | | | | | | |
| `causa.fechaIngreso` | string `^\d{4}-\d{2}-\d{2}$` | null | sí | Día de ingreso de la causa en AAAA-MM-DD; null si no está disponible. | | | | | | | | | | | | | | | | | | |
| `causa.ultimaActuacion` | string `^\d{4}-\d{2}-\d{2}$` | null | sí | Día de la última actuación observada en AAAA-MM-DD; null si no está disponible. | | | | | | | | | | | | | | | | | | |
| `causa.seguimiento` | `"activo"` · `"retirado"` | sí | Estado del seguimiento en Connect, independiente del estado procesal. | | | | | | | | | | | | | | | | | | | |
| `causa.origenIncorporacion` | `"seleccion_mis_causas"` · `"referencia_exacta"` | sí | Cómo se eligió esta causa para la cartera autorizada. | | | | | | | | | | | | | | | | | | | |
| `causa.fuente` | objeto | sí | Procedencia y fecha de observación. No contiene credenciales ni enlaces privados. | | | | | | | | | | | | | | | | | | | |
| `causa.fuente.sistema` | string | sí | Sistema judicial del que procede la observación. | | | | | | | | | | | | | | | | | | | |
| `causa.fuente.ruta` | `"mis_causas"` · `"consulta_unificada"` · `"ingreso_ojv"` | sí | Superficie OJV utilizada para recuperar la información. | | | | | | | | | | | | | | | | | | | |
| `causa.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. | | | | | | | | | | | | | | | | | | | |
| `causa.fuente.observadoEn` | string \`^(?:(?:\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)))$\` | sí | Instante ISO 8601 con zona horaria. | |
| `cuadernos` | lista de objeto | sí | Cuadernos observados. Consulta la cobertura para saber cuáles fueron revisados. | | | | | | | | | | | | | | | | | | | |
| `cuadernos[].cuadernoId` | string `^pjq_[a-zA-Z0-9_-]{16,80}$` | sí | Identificador estable de cuaderno, obtenido de causas.detallar. | | | | | | | | | | | | | | | | | | | |
| `cuadernos[].numeroFuente` | string | null | sí | Número de cuaderno publicado por OJV, conservado como texto. | | | | | | | | | | | | | | | | | | |
| `cuadernos[].nombre` | string | sí | Nombre publicado por OJV. | | | | | | | | | | | | | | | | | | | |
| `cuadernos[].estado` | string | null | sí | Estado publicado por OJV, sin reinterpretación jurídica. | | | | | | | | | | | | | | | | | | |
| `partes` | lista de objeto | sí | Partes visibles en la sección autorizada del expediente. | | | | | | | | | | | | | | | | | | | |
| `partes[].nombre` | string | sí | Nombre publicado por OJV. | | | | | | | | | | | | | | | | | | | |
| `partes[].rolFuente` | string | sí | Calidad procesal publicada. No presupone que la persona sea cliente del estudio. | | | | | | | | | | | | | | | | | | | |
| `partes[].rut` | string | null | sí | RUT visible en la sección autorizada; null si la fuente no lo expone. | | | | | | | | | | | | | | | | | | |
| `seccionesCiviles` | lista de objeto | sí | Página de tablas civiles guardadas y permitidas. Una tabla ausente no acredita que carezca de registros. | | | | | | | | | | | | | | | | | | | |
| `seccionesCiviles[].cuadernoId` | string `^pjq_[a-zA-Z0-9_-]{16,80}$` | sí | Cuaderno que estaba seleccionado al observar esta tabla; no atribuye exclusividad de sus filas a ese cuaderno. | | | | | | | | | | | | | | | | | | | |
| `seccionesCiviles[].fuente` | objeto | sí | Procedencia e instante de observación de la tabla, sin enlaces privados. | | | | | | | | | | | | | | | | | | | |
| `seccionesCiviles[].fuente.sistema` | string | sí | Sistema judicial del que procede la observación. | | | | | | | | | | | | | | | | | | | |
| `seccionesCiviles[].fuente.ruta` | `"mis_causas"` · `"consulta_unificada"` · `"ingreso_ojv"` | sí | Superficie OJV utilizada para recuperar la información. | | | | | | | | | | | | | | | | | | | |
| `seccionesCiviles[].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. | | | | | | | | | | | | | | | | | | | |
| `seccionesCiviles[].fuente.observadoEn` | string \`^(?:(?:\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)))$\` | sí | Instante ISO 8601 con zona horaria. | |
| `seccionesCiviles[].contenido` | valor | sí | Filas de la tabla observada, con fechas normalizadas y sin enlaces privados ni IDs inventados. | | | | | | | | | | | | | | | | | | | |
| `seccionesCiviles[].filasDesde` | entero | sí | Posición de la primera fila devuelta en esta tabla, comenzando en cero. No es un ID judicial. | | | | | | | | | | | | | | | | | | | |
| `seccionesCiviles[].totalFilas` | entero | sí | Filas en la última tabla guardada. Revisa el cursor de la respuesta para continuar la lectura. | | | | | | | | | | | | | | | | | | | |
| `seccionesLaborales` | lista de objeto | sí | Página de tablas laborales guardadas y permitidas. Sus referencias no acreditan descarga de anexos ni lectura de expedientes de Corte. | | | | | | | | | | | | | | | | | | | |
| `seccionesLaborales[].fuente` | objeto | sí | Procedencia e instante de observación de la tabla, sin enlaces privados. | | | | | | | | | | | | | | | | | | | |
| `seccionesLaborales[].fuente.sistema` | string | sí | Sistema judicial del que procede la observación. | | | | | | | | | | | | | | | | | | | |
| `seccionesLaborales[].fuente.ruta` | `"mis_causas"` · `"consulta_unificada"` · `"ingreso_ojv"` | sí | Superficie OJV utilizada para recuperar la información. | | | | | | | | | | | | | | | | | | | |
| `seccionesLaborales[].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. | | | | | | | | | | | | | | | | | | | |
| `seccionesLaborales[].fuente.observadoEn` | string \`^(?:(?:\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)))$\` | sí | Instante ISO 8601 con zona horaria. | |
| `seccionesLaborales[].contenido` | valor | sí | Filas observadas en la causa laboral, sin enlaces privados ni IDs inventados. | | | | | | | | | | | | | | | | | | | |
| `seccionesLaborales[].filasDesde` | entero | sí | Posición de la primera fila devuelta en esta tabla, comenzando en cero. No es un ID judicial. | | | | | | | | | | | | | | | | | | | |
| `seccionesLaborales[].totalFilas` | entero | sí | Filas en la última tabla guardada. Revisa el cursor de la respuesta para continuar la lectura. | | | | | | | | | | | | | | | | | | | |
| `ambitoHistoria` | `"causa"` · `"cuadernos"` | null | sí | Dónde presenta OJV la historia observada. null cuando no hay expediente disponible; causa no acredita un inventario completo de cuadernos. | | | | | | | | | | | | | | | | | | |
| `cursor` | string | null | sí | Continuación de las tablas en el mismo corte; null si esta lectura terminó. No acredita cobertura completa de OJV. | | | | | | | | | | | | | | | | | | |
| `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] | \[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)))$\` | null | sí | Corte de observación de los datos persistidos. No es la fecha de la consulta ni la de una resolución. |
| `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í | Cuaderno al que corresponde la información; null para una sección de toda la causa. | | | | | | | | | | | | | | | | | | |
| `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] | \[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)))$\` | null | sí | Instante ISO 8601 de revisión; null si esa sección no se revisó. |
| `cobertura[].registrosObservados` | entero | null | sí | Filas observadas en la sección; null significa que no se pudo contar, no cero. | | | | | | | | | | | | | | | | | | |
| `cobertura[].codigoIncidencia` | string `^pjud_[a-z_]+$` | null | sí | Código saneado; nunca mensajes, cookies o HTML del proveedor. | | | | | | | | | | | | | | | | | | |
JSON Schema de salida
```json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"causa": {
"anyOf": [
{
"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"
}
]
},
"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 Connect, 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
},
{
"type": "null"
}
],
"description": "Expediente solicitado, o null si no hay información disponible en esta conexión."
},
"cuadernos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cuadernoId": {
"type": "string",
"pattern": "^pjq_[a-zA-Z0-9_-]{16,80}$",
"description": "Identificador estable de cuaderno, obtenido de causas.detallar."
},
"numeroFuente": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Número de cuaderno publicado por OJV, conservado como texto."
},
"nombre": {
"type": "string",
"description": "Nombre publicado por OJV."
},
"estado": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Estado publicado por OJV, sin reinterpretación jurídica."
}
},
"required": [
"cuadernoId",
"numeroFuente",
"nombre",
"estado"
],
"additionalProperties": false
},
"description": "Cuadernos observados. Consulta la cobertura para saber cuáles fueron revisados."
},
"partes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"nombre": {
"type": "string",
"description": "Nombre publicado por OJV."
},
"rolFuente": {
"type": "string",
"description": "Calidad procesal publicada. No presupone que la persona sea cliente del estudio."
},
"rut": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "RUT visible en la sección autorizada; null si la fuente no lo expone."
}
},
"required": [
"nombre",
"rolFuente",
"rut"
],
"additionalProperties": false
},
"description": "Partes visibles en la sección autorizada del expediente."
},
"seccionesCiviles": {
"default": [],
"description": "Página de tablas civiles guardadas y permitidas. Una tabla ausente no acredita que carezca de registros.",
"type": "array",
"items": {
"type": "object",
"properties": {
"cuadernoId": {
"type": "string",
"pattern": "^pjq_[a-zA-Z0-9_-]{16,80}$",
"description": "Cuaderno que estaba seleccionado al observar esta tabla; no atribuye exclusividad de sus filas a ese cuaderno."
},
"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 e instante de observación de la tabla, sin enlaces privados."
},
"contenido": {
"oneOf": [
{
"type": "object",
"properties": {
"seccion": {
"type": "string",
"const": "notificaciones",
"description": "Tabla civil de notificaciones."
},
"filas": {
"maxItems": 5000,
"type": "array",
"items": {
"type": "object",
"properties": {
"rol": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Rol publicado en la fila; no se deduce de la causa abierta."
},
"estado": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Estado de notificación informado por OJV."
},
"tipo": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Tipo de notificación publicado, sin interpretación jurídica."
},
"fechaTramite": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"x-emisso-formato": "AAAA-MM-DD"
},
{
"type": "null"
}
],
"description": "Fecha de trámite en AAAA-MM-DD, sin cálculo de plazos."
},
"tipoParticipante": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Tipo de participante publicado."
},
"nombre": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Nombre visible en la sección autorizada."
},
"tramite": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Trámite publicado en la fila."
},
"observacionFallida": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Observación de una diligencia fallida, cuando está publicada."
}
},
"required": [
"rol",
"estado",
"tipo",
"fechaTramite",
"tipoParticipante",
"nombre",
"tramite",
"observacionFallida"
],
"additionalProperties": false
},
"description": "Notificaciones publicadas en la tabla observada."
}
},
"required": [
"seccion",
"filas"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"seccion": {
"type": "string",
"const": "escritos_por_resolver",
"description": "Tabla civil de escritos pendientes de resolución."
},
"filas": {
"maxItems": 5000,
"type": "array",
"items": {
"type": "object",
"properties": {
"fechaIngreso": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"x-emisso-formato": "AAAA-MM-DD"
},
{
"type": "null"
}
],
"description": "Fecha de ingreso del escrito en AAAA-MM-DD."
},
"tipo": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Tipo de escrito pendiente publicado."
},
"solicitante": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Solicitante publicado por OJV."
},
"tieneDocumento": {
"type": "boolean",
"description": "Hay un control documental en la fila; no acredita descarga ni lectura del archivo."
},
"tieneAnexos": {
"type": "boolean",
"description": "Hay un control de anexos; no acredita su contenido."
}
},
"required": [
"fechaIngreso",
"tipo",
"solicitante",
"tieneDocumento",
"tieneAnexos"
],
"additionalProperties": false
},
"description": "Escritos pendientes publicados en la tabla observada."
}
},
"required": [
"seccion",
"filas"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"seccion": {
"type": "string",
"const": "exhortos",
"description": "Tabla civil de exhortos."
},
"filas": {
"maxItems": 5000,
"type": "array",
"items": {
"type": "object",
"properties": {
"rolOrigen": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Rol de origen publicado."
},
"tipo": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Tipo de exhorto publicado."
},
"rolDestino": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Rol de destino publicado, si está visible."
},
"fechaOrden": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"x-emisso-formato": "AAAA-MM-DD"
},
{
"type": "null"
}
],
"description": "Fecha en que se ordenó el exhorto, en AAAA-MM-DD."
},
"fechaIngreso": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"x-emisso-formato": "AAAA-MM-DD"
},
{
"type": "null"
}
],
"description": "Fecha de ingreso del exhorto en AAAA-MM-DD."
},
"tribunalDestino": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Tribunal de destino publicado."
},
"estado": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Estado del exhorto publicado."
}
},
"required": [
"rolOrigen",
"tipo",
"rolDestino",
"fechaOrden",
"fechaIngreso",
"tribunalDestino",
"estado"
],
"additionalProperties": false
},
"description": "Exhortos publicados en la tabla observada."
}
},
"required": [
"seccion",
"filas"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"seccion": {
"type": "string",
"const": "remisiones",
"description": "Tabla civil de remisiones a Corte."
},
"filas": {
"maxItems": 5000,
"type": "array",
"items": {
"type": "object",
"properties": {
"rolCorte": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Rol de Corte visible; null cuando solo hay un control sin rol publicado."
},
"descripcion": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Descripción del trámite de remisión publicada."
},
"fechaTramite": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"x-emisso-formato": "AAAA-MM-DD"
},
{
"type": "null"
}
],
"description": "Fecha de trámite de la remisión en AAAA-MM-DD."
},
"tieneReferenciaCorte": {
"type": "boolean",
"description": "Hay un control para consultar la referencia de Corte; no acredita que se haya leído su expediente."
}
},
"required": [
"rolCorte",
"descripcion",
"fechaTramite",
"tieneReferenciaCorte"
],
"additionalProperties": false
},
"description": "Remisiones publicadas en la tabla observada; no contienen el expediente de Corte."
}
},
"required": [
"seccion",
"filas"
],
"additionalProperties": false
}
],
"description": "Filas de la tabla observada, con fechas normalizadas y sin enlaces privados ni IDs inventados."
},
"filasDesde": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Posición de la primera fila devuelta en esta tabla, comenzando en cero. No es un ID judicial."
},
"totalFilas": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Filas en la última tabla guardada. Revisa el cursor de la respuesta para continuar la lectura."
}
},
"required": [
"cuadernoId",
"fuente",
"contenido",
"filasDesde",
"totalFilas"
],
"additionalProperties": false
}
},
"seccionesLaborales": {
"default": [],
"description": "Página de tablas laborales guardadas y permitidas. Sus referencias no acreditan descarga de anexos ni lectura de expedientes de Corte.",
"type": "array",
"items": {
"type": "object",
"properties": {
"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 e instante de observación de la tabla, sin enlaces privados."
},
"contenido": {
"oneOf": [
{
"type": "object",
"properties": {
"seccion": {
"type": "string",
"const": "litigantes",
"description": "Tabla laboral de litigantes."
},
"filas": {
"maxItems": 5000,
"type": "array",
"items": {
"type": "object",
"properties": {
"estadoFuente": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Estado del litigante publicado por OJV."
},
"tieneIndicadorEstado": {
"type": "boolean",
"description": "La celda contiene un indicador visual de estado; no interpreta su significado."
},
"abogadoDefensorFuente": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Abogado o defensor publicado en la fila."
},
"rolFuente": {
"type": "string",
"minLength": 1,
"maxLength": 4000,
"description": "Calidad procesal publicada por OJV."
},
"rut": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "RUT visible del litigante; null si la fuente no lo publica."
},
"tipoPersona": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Tipo de persona publicado por OJV."
},
"nombre": {
"type": "string",
"minLength": 1,
"maxLength": 4000,
"description": "Nombre o razón social publicada por OJV."
}
},
"required": [
"estadoFuente",
"tieneIndicadorEstado",
"abogadoDefensorFuente",
"rolFuente",
"rut",
"tipoPersona",
"nombre"
],
"additionalProperties": false
},
"description": "Litigantes publicados en la tabla observada."
}
},
"required": [
"seccion",
"filas"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"seccion": {
"type": "string",
"const": "notificaciones",
"description": "Tabla laboral de notificaciones."
},
"filas": {
"maxItems": 5000,
"type": "array",
"items": {
"type": "object",
"properties": {
"estado": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Estado de notificación informado por OJV."
},
"fechaTramite": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"x-emisso-formato": "AAAA-MM-DD"
},
{
"type": "null"
}
],
"description": "Fecha de trámite en AAAA-MM-DD, sin cálculo de plazos."
},
"tipoParte": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Tipo de parte publicado en la fila."
},
"nombre": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Nombre visible en la notificación."
},
"tramite": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Trámite de notificación publicado."
},
"observacionFallida": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Observación de notificación fallida, cuando está publicada."
}
},
"required": [
"estado",
"fechaTramite",
"tipoParte",
"nombre",
"tramite",
"observacionFallida"
],
"additionalProperties": false
},
"description": "Notificaciones publicadas en la tabla observada."
}
},
"required": [
"seccion",
"filas"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"seccion": {
"type": "string",
"const": "diligencias",
"description": "Tabla laboral de diligencias."
},
"filas": {
"maxItems": 5000,
"type": "array",
"items": {
"type": "object",
"properties": {
"tieneDocumentoIda": {
"type": "boolean",
"description": "Hay un control para el documento de ida; no acredita descarga ni lectura."
},
"tieneDocumentoVuelta": {
"type": "boolean",
"description": "Hay un control para el documento de vuelta; no acredita descarga ni lectura."
},
"estado": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Estado de la diligencia publicado por OJV."
},
"rit": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "RIT publicado en la diligencia."
},
"ruc": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "RUC publicado en la diligencia."
},
"tipo": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Tipo de diligencia publicado."
},
"referencia": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Referencia publicada para la diligencia."
},
"fechaTramite": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"x-emisso-formato": "AAAA-MM-DD"
},
{
"type": "null"
}
],
"description": "Fecha de trámite de la diligencia en AAAA-MM-DD."
}
},
"required": [
"tieneDocumentoIda",
"tieneDocumentoVuelta",
"estado",
"rit",
"ruc",
"tipo",
"referencia",
"fechaTramite"
],
"additionalProperties": false
},
"description": "Diligencias publicadas en la tabla observada."
}
},
"required": [
"seccion",
"filas"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"seccion": {
"type": "string",
"const": "liquidacion",
"description": "Tabla laboral de liquidación."
},
"filas": {
"maxItems": 5000,
"type": "array",
"items": {
"type": "object",
"properties": {
"liquidacionFuente": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Texto de liquidación publicado por OJV."
},
"tieneReferenciaLiquidacion": {
"type": "boolean",
"description": "Hay un control para consultar la liquidación; no acredita descarga ni lectura."
},
"rut": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "RUT publicado en la liquidación."
},
"nombre": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Nombre publicado en la liquidación."
},
"montoLiquidoFuente": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Monto líquido conservado como texto de la fuente, sin reinterpretación monetaria."
}
},
"required": [
"liquidacionFuente",
"tieneReferenciaLiquidacion",
"rut",
"nombre",
"montoLiquidoFuente"
],
"additionalProperties": false
},
"description": "Liquidaciones publicadas en la tabla observada."
}
},
"required": [
"seccion",
"filas"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"seccion": {
"type": "string",
"const": "materias",
"description": "Tabla laboral de materias."
},
"filas": {
"maxItems": 5000,
"type": "array",
"items": {
"type": "object",
"properties": {
"codigo": {
"type": "string",
"minLength": 1,
"maxLength": 4000,
"description": "Código de materia publicado por OJV."
},
"glosa": {
"type": "string",
"minLength": 1,
"maxLength": 4000,
"description": "Glosa de materia publicada por OJV."
},
"estado": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Estado de la materia publicado por OJV."
},
"fechaTermino": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"x-emisso-formato": "AAAA-MM-DD"
},
{
"type": "null"
}
],
"description": "Fecha de término de la materia en AAAA-MM-DD."
}
},
"required": [
"codigo",
"glosa",
"estado",
"fechaTermino"
],
"additionalProperties": false
},
"description": "Materias publicadas en la tabla observada."
}
},
"required": [
"seccion",
"filas"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"seccion": {
"type": "string",
"const": "escritos_por_resolver",
"description": "Tabla laboral de escritos pendientes de resolución."
},
"filas": {
"maxItems": 5000,
"type": "array",
"items": {
"type": "object",
"properties": {
"tieneDocumento": {
"type": "boolean",
"description": "Hay un control documental en la fila; no acredita descarga ni lectura."
},
"tieneAnexos": {
"type": "boolean",
"description": "Hay un control de anexos; no acredita su contenido."
},
"fechaIngreso": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"x-emisso-formato": "AAAA-MM-DD"
},
{
"type": "null"
}
],
"description": "Fecha de ingreso del escrito en AAAA-MM-DD."
},
"referencia": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Referencia del escrito publicada por OJV."
},
"solicitante": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Solicitante publicado por OJV."
},
"tipoIngreso": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Tipo de ingreso publicado por OJV."
}
},
"required": [
"tieneDocumento",
"tieneAnexos",
"fechaIngreso",
"referencia",
"solicitante",
"tipoIngreso"
],
"additionalProperties": false
},
"description": "Escritos pendientes publicados en la tabla observada."
}
},
"required": [
"seccion",
"filas"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"seccion": {
"type": "string",
"const": "remisiones",
"description": "Tabla laboral de remisiones a Corte."
},
"filas": {
"maxItems": 5000,
"type": "array",
"items": {
"type": "object",
"properties": {
"rolCorte": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Rol de Corte visible; null cuando solo hay un control sin rol publicado."
},
"descripcion": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4000
},
{
"type": "null"
}
],
"description": "Descripción del trámite de remisión publicada."
},
"fechaTramite": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"x-emisso-formato": "AAAA-MM-DD"
},
{
"type": "null"
}
],
"description": "Fecha de trámite de la remisión en AAAA-MM-DD."
},
"tieneReferenciaCorte": {
"type": "boolean",
"description": "Hay un control para consultar la referencia de Corte; no acredita lectura de su expediente."
}
},
"required": [
"rolCorte",
"descripcion",
"fechaTramite",
"tieneReferenciaCorte"
],
"additionalProperties": false
},
"description": "Remisiones publicadas en la tabla observada; no contienen el expediente de Corte."
}
},
"required": [
"seccion",
"filas"
],
"additionalProperties": false
}
],
"description": "Filas observadas en la causa laboral, sin enlaces privados ni IDs inventados."
},
"filasDesde": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Posición de la primera fila devuelta en esta tabla, comenzando en cero. No es un ID judicial."
},
"totalFilas": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Filas en la última tabla guardada. Revisa el cursor de la respuesta para continuar la lectura."
}
},
"required": [
"fuente",
"contenido",
"filasDesde",
"totalFilas"
],
"additionalProperties": false
}
},
"ambitoHistoria": {
"default": null,
"description": "Dónde presenta OJV la historia observada. null cuando no hay expediente disponible; causa no acredita un inventario completo de cuadernos.",
"anyOf": [
{
"type": "string",
"enum": [
"causa",
"cuadernos"
]
},
{
"type": "null"
}
]
},
"cursor": {
"default": null,
"description": "Continuación de las tablas en el mismo corte; null si esta lectura terminó. No acredita cobertura completa de OJV.",
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 4096,
"description": "Cursor opaco de la respuesta anterior. Reenvíalo sin construirlo ni modificarlo."
},
{
"type": "null"
}
]
},
"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": [
"causa",
"cuadernos",
"partes",
"seccionesCiviles",
"seccionesLaborales",
"ambitoHistoria",
"cursor",
"estadoDatos",
"observadoHasta",
"cobertura"
],
"additionalProperties": false
}
```
## Errores de esta tool [#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](../errores).
## Próximos pasos [#próximos-pasos]
* [`pjud.conexion.sincronizar`](./conexion-sincronizar): la tool que escribe los datos que esta lectura devuelve.
* [Sincronizar y consultar](/docs/conceptos/sincronizar-consultar): por qué leer datos reales son dos pasos.