# Poder Judicial

> Cartera elegida de causas civiles, actuaciones y documentos recuperados de OJV, con fuente y cobertura explícitas. Piloto en validación.



El conector `pjud` está en **piloto civil**. Su registro en el catálogo describe el contrato; la disponibilidad requiere que el piloto esté habilitado en el entorno. La aceptación completa y la estabilidad siguen en validación.

## Conectar y elegir la cartera [#conectar-y-elegir-la-cartera]

El widget solicita el **RUT de la persona, con dígito verificador**, y su **ClaveÚnica**. La organización conserva la conexión, pero el acceso a OJV corresponde a esa persona. No se utiliza la clave tributaria del SII ni Clave Poder Judicial.

Después del acceso, elige las causas en **Ajustes → Causas en seguimiento**, indicando tribunal y rol completo. El piloto admite referencias civiles de su catálogo de tribunales. Una cartera vacía no significa que el titular no tenga juicios. Retirar una referencia detiene su seguimiento en Connect y conserva lo ya recuperado.

## Consultar los datos [#consultar-los-datos]

El alcance `expedientes` usa el permiso `pjud:read`. Todas las llamadas requieren el `connectionId` de una conexión autorizada; no hay selección implícita.

| Tool                         | Para qué sirve                                                                         |
| ---------------------------- | -------------------------------------------------------------------------------------- |
| `pjud.conexion.sincronizar`  | Recupera y guarda datos de la cartera elegida mediante una sesión de OJV.              |
| `pjud.conexion.verificar`    | Comprueba la identidad sobre una sesión existente; no trae expedientes.                |
| `pjud.causas.consultar`      | Busca causas guardadas por referencia, carátula y filtros declarados.                  |
| `pjud.causas.detallar`       | Entrega ficha, partes accesibles y cuadernos observados.                               |
| `pjud.actuaciones.consultar` | Lista actuaciones de las secciones cubiertas con sus fechas de fuente.                 |
| `pjud.documentos.consultar`  | Distingue referencias, descargas y estado de extracción del texto.                     |
| `pjud.documentos.detallar`   | Lee texto por páginas y permite solicitar un enlace temporal al PDF original guardado. |
| `pjud.novedades.consultar`   | Lista cambios observados; excluye la carga inicial por defecto.                        |

Las consultas leen exclusivamente lo guardado. No abren OJV ni presentan escritos. El período de sincronización organiza la ejecución; no filtra la historia judicial.

Para abrir el PDF, solicita `incluirEnlaceOriginal: true` al detallar el documento. `enlaceOriginal` entrega una URL y su vencimiento: **cinco minutos**. El enlace permite descargar esa versión concreta a quien lo reciba durante su vigencia. Al abrirlo se vuelven a comprobar la conexión, su permiso de lectura y la credencial vinculada; revocar o cambiar esa credencial invalida los enlaces anteriores. No se incluyen credenciales ni tokens de OJV en la URL.

Una referencia todavía sin descargar no tiene original disponible. Un PDF guardado cuya extracción falló puede conservar su enlace: revisa `incidenciaExtraccion` y no interpretes la ausencia de texto como un documento vacío. Si el enlace vence, solicita uno nuevo con la misma tool.

## Cobertura y límites [#cobertura-y-límites]

Revisa siempre `estadoDatos`, `observadoHasta` y `cobertura`. Solo `con_datos` y `sin_registros` acreditan revisión completa de una sección. Una respuesta `partial`, un documento `referenciado` o una sección pendiente no prueban ausencia de actividad.

La lectura implementada cubre la ficha civil, la historia del cuaderno abierto y sus documentos principales y certificados. Anexos, otros cuadernos, competencias adicionales y algunas secciones de OJV siguen pendientes. La extracción puede ser parcial o requerir OCR; el conector lo indica sin inventar texto.

Los cambios detectados son diferencias entre observaciones de Connect, no notificaciones judiciales. No se calculan plazos legales ni se realizan presentaciones, firmas o pagos.

Consulta los contratos completos en la [referencia de Poder Judicial](/docs/referencia/pjud).
