# Poder Judicial

> Importación inicial de causas, seguimiento y búsqueda de documentos por página, con fuente y cobertura explícitas. Beta por invitación.



El conector `pjud` está en **beta por invitación para Civil, Laboral, Corte de Apelaciones y Corte Suprema**. Su registro en el catálogo describe el contrato; la disponibilidad requiere que la beta esté habilitada para tu organización. La cobertura efectiva se informa en cada lectura.

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

El widget solicita el **RUT de la persona, con dígito verificador**, y su **Clave Poder Judicial**. 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Única.

La Clave Poder Judicial se activa una vez en la Oficina Judicial Virtual, en **«Mis datos»**, después de ingresar la primera vez con ClaveÚnica. Es una clave propia de OJV: Emisso la guarda cifrada y la usa para el sync diario, sin ClaveÚnica ni la clave tributaria del SII. Si el portal pide una verificación humana al ingresar, Emisso se detiene y lo informa: en ese caso ingresa tú una vez en OJV y vuelve a intentar la conexión. Si OJV recibe la clave y no confirma el ingreso en dos sincronizaciones diarias seguidas, Emisso pausa la sincronización automática para no seguir enviándola: revisa tu Clave Poder Judicial en OJV y vuelve a vincularla para reanudarla.

La primera sincronización importa las referencias accesibles de **Mis Causas Civil, Laboral, Corte de Apelaciones y Corte Suprema**, usando los filtros publicados por el portal, y comienza su seguimiento. El progreso se conserva por competencia: Civil completado no significa que las demás hayan terminado. El inventario no equivale a todas las causas del estudio.

Consulta `pjud.cartera.consultar` para distinguir **causas encontradas**, **causas en seguimiento** y **expedientes disponibles para leer**. Una causa puede estar en seguimiento mientras sus actuaciones o documentos siguen en preparación. Un fallo o un límite no se presenta como ausencia de causas.

En **Ajustes → Causas en seguimiento** puedes ajustar las referencias. Guardar pasa al seguimiento manual y conserva esa selección, incluso vacía; una importación atrasada no la reemplaza. Retirar una referencia detiene su seguimiento en Emisso y conserva lo ya recuperado. Las conexiones que ya tenían una selección manual la mantienen.

## 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`    | Importa inicialmente y recupera datos de la cartera en seguimiento mediante una sesión de OJV.              |
| `pjud.conexion.verificar`      | Comprueba la identidad sobre una sesión existente; no trae expedientes.                                     |
| `pjud.cartera.consultar`       | Expone inventario, seguimiento, disponibilidad y preparación pendiente por competencia.                     |
| `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`   | Localiza actuaciones por folio exacto y cuaderno, 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.documentos.buscar_texto` | Encuentra fragmentos dentro de una o varias causas, con folio, fecha, página, hash y versión de extracción. |
| `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 buscar en la cartera vigente, omite `causaIds` en `documentos.buscar_texto`; para causas concretas, envía sus IDs. La búsqueda ignora mayúsculas, acentos y espacios o saltos de línea repetidos, une palabras cortadas con guion al final de línea y omite el guion entre dos letras: «médico-legal» encuentra también «medicolegal» y un compuesto cortado en su guion, pero no «médico legal» con espacio. «libro» también encuentra «libros». Con `modo: "frase"` (predeterminado) las palabras deben aparecer juntas y en orden; con `modo: "todas_las_palabras"` basta que la misma página contenga cada una, en cualquier orden. Cada coincidencia indica la clase, el folio y la fecha del documento, y cuántas veces aparece en la página. Revisa `cursor` y `coberturaBusqueda`: los documentos sin descarga o texto siguen fuera del contenido examinable. Puedes leer las páginas completas con `documentos.detallar` usando la versión devuelta por la búsqueda.

### Encontrar un antecedente que no aparece en el ebook [#encontrar-un-antecedente-que-no-aparece-en-el-ebook]

El ebook y los adjuntos se consultan como documentos separados. Sin el filtro `clase`, la búsqueda incluye el texto recuperado de principales, certificados, anexos y ebooks. Usa `clase: "anexo"` para limitarla a adjuntos; la ausencia de una frase en el ebook no demuestra que falte en el expediente.

1. Consulta `cartera.consultar` y elige la causa disponible. Revisa su fecha y cobertura.
2. Para un folio conocido, usa `actuaciones.consultar({ causaId, folio: "12" })`. Si hay más de un cuaderno con ese folio, distingue sus actuaciones antes de elegir. El folio es texto: `"0012"` y `"12"` no se equiparan.
3. Usa `documentos.consultar({ causaId, actuacionId })` para ver los archivos vinculados. Los anexos de causa pueden carecer de actuación: revísalos también consultando los documentos de la causa sin ese filtro.
4. Busca con `documentos.buscar_texto({ causaIds: [causaId], busqueda: "frase elegida" })`. Si la frase exacta no aparece, prueba `modo: "todas_las_palabras"`. Repite la llamada con el `cursor` devuelto y los mismos filtros, incluido el modo, incluso cuando una respuesta no tenga coincidencias. El `folio` de cada coincidencia es el de su actuación: en un anexo de una solicitud, el del escrito con que se acompañó; es null en un anexo de la causa.
5. Lee cada coincidencia mediante `documentos.detallar` con su `documentoId`, `paginaDesde`, `paginaHasta`, `versionSha256` y `versionExtraccion`. Solicita el original si necesitas cotejarlo. Para comparar escritos, repite la lectura de las páginas relevantes de ambos documentos.

Estos ejemplos muestran los inputs de dominio; REST o MCP debe incluir también la conexión autorizada. El número de página pertenece al PDF encontrado. El folio de una actuación, el folio publicado de un anexo y una foja son referencias distintas.

Una búsqueda sin cursor puede seguir siendo incompleta: revisa `busquedaCompleta`, las referencias sin descarga y las páginas sin texto. Los contadores describen la respuesta actual; no los sumes como documentos únicos entre páginas de resultados. La conclusión correcta es «no encontrado en el contenido examinado» cuando hay faltantes. Un PDF escaneado puede estar descargado sin ofrecer texto buscable; esta búsqueda no ejecuta OCR.

### Tres preguntas para comenzar en tu asistente [#tres-preguntas-para-comenzar-en-tu-asistente]

* **«Prepara esta causa para que la revise».** Comprueba inventario y cobertura, lee ficha y actuaciones relevantes, identifica sus documentos y prepara una minuta con páginas de respaldo y faltantes. Si el folio se repite, pide elegir el cuaderno; si falta texto, abre el original para revisión manual antes de concluir.
* **«Busca este término también en adjuntos».** Comprueba qué documentos están disponibles, busca sin `clase` para incluir el ebook y los anexos, recorre los cursores y lee las páginas encontradas. Cita cada archivo por separado y señala lo que quedó sin examinar. Si venció el enlace al original, solicita otro mediante `documentos.detallar`.
* **«¿Qué cambió desde ayer?».** Revisa inventario y frescura por causa, consulta `novedades.consultar` y lee las páginas que respaldan cada cambio. Distingue la carga inicial y las causas pendientes de actualización; si falta una segunda observación, indícalo. Cierra con las fuentes verificables y lo pendiente de revisar.

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 conserva la organización del portal: Civil por cuadernos; Laboral y las cortes en ámbito de causa. En Corte Suprema y Cortes de Apelaciones se leen la ficha del recurso (con su libro), los movimientos, los litigantes y los PDF de cada folio, el certificado y el ebook. Los modales de texto, tomo y documentos, los agregados, los anexos y el expediente de origen no se abren: la carga lo informa como límite (`pjud_fuentes_no_leidas`). Si una corte lista dos recursos con el mismo rol, el listado no publica su libro y esas filas no se importan; el alcance de la importación lo indica. Las secciones, anexos y documentos pueden estar parcialmente recuperados; Penal, Familia, Cobranza y Disciplinario siguen fuera de esta beta. La extracción puede ser parcial o requerir OCR; el conector lo indica sin inventar texto.

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

Para «¿qué cambió desde ayer y qué debería revisar?», consulta primero el inventario y la frescura por causa, después novedades y las páginas de respaldo. `observadoHasta` es un máximo global; no demuestra revisión de toda la cartera. La carga histórica inicial se excluye por defecto. Pedir un informe en una conversación no programa su envío: una entrega diaria requiere automatización, destinatarios y registro de entrega.

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


---

Esta página es parte de la documentación de Emisso. El índice completo, con cada página y su descripción, está en https://connect.emisso.ai/llms.txt. Esta misma página en HTML: https://connect.emisso.ai/docs/sistemas/pjud.
