# Buscar texto en los expedientes
> Busca una palabra o frase en el texto guardado de los documentos y entrega, por página, la cita original con el folio y la fecha del documento.
{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}
| | |
| ------------------- | ------------------------------------------------------------------ |
| **Tool ID** | `pjud.documentos.buscar_texto` |
| **Nombre MCP** | `pjud__documentos__buscar_texto` |
| **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 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`](/docs/referencia/conexiones/estado-consultar).
## Qué hace [#qué-hace]
Ignora mayúsculas, acentos, guiones blandos 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, así médico-legal también encuentra medicolegal o un compuesto cortado en su guion (con espacio, médico legal, es otra frase); cada palabra también encuentra palabras que la contienen (libro encuentra libros). modo frase, el predeterminado, exige las palabras juntas y en orden; todas\_las\_palabras exige que la misma página contenga cada palabra, en cualquier orden. Sin clase incluye principales, certificados, anexos y ebooks; clase anexo limita a adjuntos. Omite causaIds para usar el seguimiento vigente; IDs explícitos permiten consultar también historia retirada autorizada. Cada coincidencia trae clase, cuaderno, actuación, folio, fecha y descripción del documento, apariciones en la página, fragmento original, hash y versión de extracción para continuar con documentos.detallar. No ejecuta OCR ni descarga OJV. Continúa con cursor y los mismos filtros, incluido modo, aunque no haya coincidencias en la primera respuesta; revisa coberturaBusqueda antes de concluir que el antecedente no existe. 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 |
| ------------- | -------------------------------------------------------------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `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. |
| `busqueda` | string | sí | Palabra o frase que se busca. Se comparan texto y consulta sin mayúsculas, acentos, guiones blandos ni guiones entre dos letras, con los blancos repetidos y saltos de línea como un solo espacio. |
| `modo` | `"frase"` · `"todas_las_palabras"` | no · default `"frase"` | frase busca las palabras juntas y en orden. todas\_las\_palabras exige que la página contenga cada palabra distinta de la consulta, en cualquier orden y lugar. Con una sola palabra ambos modos coinciden. El cursor solo continúa con el mismo modo. |
| `causaIds` | lista de string `^pjc_[a-zA-Z0-9_-]{16,80}$` | no | Causas autorizadas donde buscar; sin este filtro usa el seguimiento actual. |
| `competencia` | `"suprema"` · `"apelaciones"` · `"civil"` · `"laboral"` · `"penal"` · `"cobranza"` · … | no | Competencia judicial de la causa. Su presencia en el contrato no implica que todas las competencias estén implementadas. |
| `tribunal` | string | no | Texto de búsqueda entre los datos persistidos de la conexión. |
| `clase` | `"principal"` · `"certificado_envio"` · `"anexo"` · `"ebook"` · `"sin_clasificar"` | no | Clase documental identificada desde la referencia de OJV. |
| `desde` | string `^\d{4}-\d{2}-\d{2}$` | no | Día de fuente inicial de los documentos, inclusive. |
| `hasta` | string `^\d{4}-\d{2}-\d{2}$` | no | Día de fuente final de los documentos, inclusive. |
JSON Schema de entrada
```json
{
"$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": "Palabra o frase que se busca. Se comparan texto y consulta sin mayúsculas, acentos, guiones blandos ni guiones entre dos letras, con los blancos repetidos y saltos de línea como un solo espacio."
},
"modo": {
"default": "frase",
"description": "frase busca las palabras juntas y en orden. todas_las_palabras exige que la página contenga cada palabra distinta de la consulta, en cualquier orden y lugar. Con una sola palabra ambos modos coinciden. El cursor solo continúa con el mismo modo.",
"type": "string",
"enum": [
"frase",
"todas_las_palabras"
]
},
"causaIds": {
"description": "Causas autorizadas donde buscar; sin este filtro usa el seguimiento actual.",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"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": "string",
"minLength": 1,
"maxLength": 200,
"description": "Texto de búsqueda entre los datos persistidos de la conexión."
},
"clase": {
"type": "string",
"enum": [
"principal",
"certificado_envio",
"anexo",
"ebook",
"sin_clasificar"
],
"description": "Clase documental identificada desde la referencia de OJV."
},
"desde": {
"description": "Día de fuente inicial de los documentos, inclusive.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"x-emisso-formato": "AAAA-MM-DD"
},
"hasta": {
"description": "Día de fuente final de los documentos, inclusive.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"x-emisso-formato": "AAAA-MM-DD"
}
},
"required": [
"busqueda"
],
"additionalProperties": false
}
```
## Salida [#salida]
| Campo | Tipo | Requerido | Descripción | | | | | | | | | | | | | | | | | | | |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | --------------------- | ------------------ | ------- | ------- | ---------- | -------------- | ------- | --- | ----------------- | --- | ------------------------ | -------------------------------------------- | ----------------- | ----------------------- | ---- | -- | ----------------------------------------------------------------------------------------------------- |
| `coincidencias` | lista de objeto | sí | Un fragmento por página coincidente; el texto se conserva tal como fue extraído. | | | | | | | | | | | | | | | | | | | |
| `coincidencias[].causaId` | string `^pjc_[a-zA-Z0-9_-]{16,80}$` | sí | ID obtenido de pjud.causas.consultar. No es el rol escrito en el portal. | | | | | | | | | | | | | | | | | | | |
| `coincidencias[].documentoId` | string `^pjd_[a-zA-Z0-9_-]{16,80}$` | sí | ID obtenido de pjud.documentos.consultar; nunca un enlace ni un token de OJV. | | | | | | | | | | | | | | | | | | | |
| `coincidencias[].clase` | `"principal"` · `"certificado_envio"` · `"anexo"` · `"ebook"` · `"sin_clasificar"` | sí | Clase del documento que contiene la página: principal, certificado\_envio, anexo, ebook o sin\_clasificar. | | | | | | | | | | | | | | | | | | | |
| `coincidencias[].cuadernoId` | string `^pjq_[a-zA-Z0-9_-]{16,80}$` | null | sí | Cuaderno del documento; null cuando la pieza pertenece a la causa y no a un cuaderno, como en la historia laboral. | | | | | | | | | | | | | | | | | | |
| `coincidencias[].actuacionId` | string `^pja_[a-zA-Z0-9_-]{16,80}$` | null | sí | Actuación vinculada al documento; null en anexos de la causa o documentos sin actuación. | | | | | | | | | | | | | | | | | | |
| `coincidencias[].folio` | string | null | sí | Folio publicado de la actuación vinculada. En un anexo de una solicitud es el folio del escrito con que se acompañó. null en anexos de la causa o documentos sin actuación. No es el folio propio del anexo ni la página del PDF, y puede repetirse entre cuadernos. | | | | | | | | | | | | | | | | | | |
| `coincidencias[].fechaFuente` | string `^\d{4}-\d{2}-\d{2}$` | null | sí | Día de fuente del documento en AAAA-MM-DD, guardado desde OJV; en un anexo civil es la fecha publicada junto a su referencia. null si no está disponible. No es la fecha de observación ni inicia plazos. | | | | | | | | | | | | | | | | | | |
| `coincidencias[].descripcion` | string | sí | Descripción publicada del documento; en un anexo civil, su referencia literal en el listado. | | | | | | | | | | | | | | | | | | | |
| `coincidencias[].pagina` | entero | sí | Número de página dentro del PDF original; comienza en 1. | | | | | | | | | | | | | | | | | | | |
| `coincidencias[].fragmento` | string | sí | Cita del texto original, sin normalizar, que empieza hasta 160 caracteres antes de la primera coincidencia de la página; en todas\_las\_palabras, de la primera aparición de cualquiera de las palabras. | | | | | | | | | | | | | | | | | | | |
| `coincidencias[].offsetInicio` | entero | sí | Inicio del fragmento en unidades UTF-16 del texto original de la página completa, aunque la búsqueda la haya examinado por tramos. | | | | | | | | | | | | | | | | | | | |
| `coincidencias[].apariciones` | entero | sí | Apariciones no superpuestas en la página: de la frase en modo frase; la suma de las de cada palabra distinta en todas\_las\_palabras. Cuenta sobre el texto normalizado de la página completa. | | | | | | | | | | | | | | | | | | | |
| `coincidencias[].versionSha256` | string `^[a-f0-9]{64}$` | sí | Hash del PDF que contiene la coincidencia; reenvíalo a documentos.detallar. | | | | | | | | | | | | | | | | | | | |
| `coincidencias[].versionExtraccion` | entero | sí | Versión inmutable del texto; reenvíala junto al hash a documentos.detallar. | | | | | | | | | | | | | | | | | | | |
| `coincidencias[].metodo` | `"texto_pdf"` · `"ocr"` | sí | Método que produjo el texto buscado en esta página. | | | | | | | | | | | | | | | | | | | |
| `coberturaBusqueda` | objeto | sí | Contadores de esta página de exploración. Pendientes y cursor indican corpus aún no examinado; sin texto incluye OCR pendiente y extracción fallida. Completa solo acredita el corpus autorizado con texto utilizable. | | | | | | | | | | | | | | | | | | | |
| `coberturaBusqueda.causasSolicitadas` | entero | sí | Causas seleccionadas para todo este corte de búsqueda. | | | | | | | | | | | | | | | | | | | |
| `coberturaBusqueda.competenciasPendientes` | entero | sí | Competencias de importación inicial que todavía no tienen un inventario completo; cero en selección manual o con causaIds explícitos. | | | | | | | | | | | | | | | | | | | |
| `coberturaBusqueda.causasExaminadas` | entero | sí | Causas examinadas en esta respuesta de exploración. | | | | | | | | | | | | | | | | | | | |
| `coberturaBusqueda.causasSinExpediente` | entero | sí | Causas examinadas sin datos recuperados. | | | | | | | | | | | | | | | | | | | |
| `coberturaBusqueda.causasRestringidas` | entero | sí | Causas examinadas cuyo acceso está restringido. | | | | | | | | | | | | | | | | | | | |
| `coberturaBusqueda.documentosExaminados` | entero | sí | Referencias documentales examinadas en esta respuesta. | | | | | | | | | | | | | | | | | | | |
| `coberturaBusqueda.documentosBuscados` | entero | sí | Documentos cuyo texto utilizable se examinó en esta respuesta. | | | | | | | | | | | | | | | | | | | |
| `coberturaBusqueda.documentosSinDescarga` | entero | sí | Referencias examinadas sin bytes recuperados. | | | | | | | | | | | | | | | | | | | |
| `coberturaBusqueda.documentosSinTexto` | entero | sí | Documentos examinados con páginas sin texto o extracción fallida. | | | | | | | | | | | | | | | | | | | |
| `coberturaBusqueda.documentosRestringidos` | entero | sí | Documentos examinados cuyo contenido no se puede consultar. | | | | | | | | | | | | | | | | | | | |
| `coberturaBusqueda.paginasBuscadas` | entero | sí | Páginas o tramos con texto examinados en esta respuesta. Cada respuesta examina hasta 2.000.000 de caracteres y una página que no cabe pasa entera a la siguiente; solo una página que supera sola ese límite se examina por tramos en modo frase, y todas\_las\_palabras la examina completa. | | | | | | | | | | | | | | | | | | | |
| `coberturaBusqueda.paginasSinTexto` | entero | sí | Páginas examinadas sin texto utilizable que pueden requerir OCR. | | | | | | | | | | | | | | | | | | | |
| `coberturaBusqueda.documentosPendientes` | entero | sí | Referencias que quedan por examinar en la causa donde se detuvo esta respuesta. | | | | | | | | | | | | | | | | | | | |
| `coberturaBusqueda.causasPendientes` | entero | sí | Causas que quedan por examinar, incluida la causa en que se detuvo la búsqueda. | | | | | | | | | | | | | | | | | | | |
| `coberturaBusqueda.presupuestoAlcanzado` | booleano | sí | La exploración llegó al límite de causas, documentos o caracteres; continúa con el cursor. | | | | | | | | | | | | | | | | | | | |
| `coberturaBusqueda.busquedaCompleta` | booleano | sí | Terminó el corte y todas sus causas/secciones/documentos permitieron buscar texto; false si quedó cobertura pendiente en cualquier página de exploración. | | | | | | | | | | | | | | | | | | | |
| `cursor` | string | null | sí | null cuando no quedan filas en este corte; no acredita que OJV esté completamente revisada. | | | | | | | | | | | | | | | | | | |
| `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": {
"coincidencias": {
"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."
},
"documentoId": {
"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."
},
"clase": {
"type": "string",
"enum": [
"principal",
"certificado_envio",
"anexo",
"ebook",
"sin_clasificar"
],
"description": "Clase del documento que contiene la página: principal, certificado_envio, anexo, ebook o sin_clasificar."
},
"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 del documento; null cuando la pieza pertenece a la causa y no a un cuaderno, como en la historia laboral."
},
"actuacionId": {
"anyOf": [
{
"type": "string",
"pattern": "^pja_[a-zA-Z0-9_-]{16,80}$",
"description": "Identificador estable de actuación dentro de su causa y ámbito de historia."
},
{
"type": "null"
}
],
"description": "Actuación vinculada al documento; null en anexos de la causa o documentos sin actuación."
},
"folio": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Folio publicado de la actuación vinculada. En un anexo de una solicitud es el folio del escrito con que se acompañó. null en anexos de la causa o documentos sin actuación. No es el folio propio del anexo ni la página del PDF, y puede repetirse entre cuadernos."
},
"fechaFuente": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"x-emisso-formato": "AAAA-MM-DD"
},
{
"type": "null"
}
],
"description": "Día de fuente del documento en AAAA-MM-DD, guardado desde OJV; en un anexo civil es la fecha publicada junto a su referencia. null si no está disponible. No es la fecha de observación ni inicia plazos."
},
"descripcion": {
"type": "string",
"description": "Descripción publicada del documento; en un anexo civil, su referencia literal en el listado."
},
"pagina": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Número de página dentro del PDF original; comienza en 1."
},
"fragmento": {
"type": "string",
"maxLength": 1200,
"description": "Cita del texto original, sin normalizar, que empieza hasta 160 caracteres antes de la primera coincidencia de la página; en todas_las_palabras, de la primera aparición de cualquiera de las palabras."
},
"offsetInicio": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Inicio del fragmento en unidades UTF-16 del texto original de la página completa, aunque la búsqueda la haya examinado por tramos."
},
"apariciones": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Apariciones no superpuestas en la página: de la frase en modo frase; la suma de las de cada palabra distinta en todas_las_palabras. Cuenta sobre el texto normalizado de la página completa."
},
"versionSha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$",
"description": "Hash del PDF que contiene la coincidencia; reenvíalo a documentos.detallar."
},
"versionExtraccion": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Versión inmutable del texto; reenvíala junto al hash a documentos.detallar."
},
"metodo": {
"type": "string",
"enum": [
"texto_pdf",
"ocr"
],
"description": "Método que produjo el texto buscado en esta página."
}
},
"required": [
"causaId",
"documentoId",
"clase",
"cuadernoId",
"actuacionId",
"folio",
"fechaFuente",
"descripcion",
"pagina",
"fragmento",
"offsetInicio",
"apariciones",
"versionSha256",
"versionExtraccion",
"metodo"
],
"additionalProperties": false
},
"description": "Un fragmento por página coincidente; el texto se conserva tal como fue extraído."
},
"coberturaBusqueda": {
"type": "object",
"properties": {
"causasSolicitadas": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Causas seleccionadas para todo este corte de búsqueda."
},
"competenciasPendientes": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Competencias de importación inicial que todavía no tienen un inventario completo; cero en selección manual o con causaIds explícitos."
},
"causasExaminadas": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Causas examinadas en esta respuesta de exploración."
},
"causasSinExpediente": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Causas examinadas sin datos recuperados."
},
"causasRestringidas": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Causas examinadas cuyo acceso está restringido."
},
"documentosExaminados": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Referencias documentales examinadas en esta respuesta."
},
"documentosBuscados": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Documentos cuyo texto utilizable se examinó en esta respuesta."
},
"documentosSinDescarga": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Referencias examinadas sin bytes recuperados."
},
"documentosSinTexto": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Documentos examinados con páginas sin texto o extracción fallida."
},
"documentosRestringidos": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Documentos examinados cuyo contenido no se puede consultar."
},
"paginasBuscadas": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Páginas o tramos con texto examinados en esta respuesta. Cada respuesta examina hasta 2.000.000 de caracteres y una página que no cabe pasa entera a la siguiente; solo una página que supera sola ese límite se examina por tramos en modo frase, y todas_las_palabras la examina completa."
},
"paginasSinTexto": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Páginas examinadas sin texto utilizable que pueden requerir OCR."
},
"documentosPendientes": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Referencias que quedan por examinar en la causa donde se detuvo esta respuesta."
},
"causasPendientes": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Causas que quedan por examinar, incluida la causa en que se detuvo la búsqueda."
},
"presupuestoAlcanzado": {
"type": "boolean",
"description": "La exploración llegó al límite de causas, documentos o caracteres; continúa con el cursor."
},
"busquedaCompleta": {
"type": "boolean",
"description": "Terminó el corte y todas sus causas/secciones/documentos permitieron buscar texto; false si quedó cobertura pendiente en cualquier página de exploración."
}
},
"required": [
"causasSolicitadas",
"competenciasPendientes",
"causasExaminadas",
"causasSinExpediente",
"causasRestringidas",
"documentosExaminados",
"documentosBuscados",
"documentosSinDescarga",
"documentosSinTexto",
"documentosRestringidos",
"paginasBuscadas",
"paginasSinTexto",
"documentosPendientes",
"causasPendientes",
"presupuestoAlcanzado",
"busquedaCompleta"
],
"additionalProperties": false,
"description": "Contadores de esta página de exploración. Pendientes y cursor indican corpus aún no examinado; sin texto incluye OCR pendiente y extracción fallida. Completa solo acredita el corpus autorizado con texto utilizable."
},
"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": [
"coincidencias",
"coberturaBusqueda",
"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](/docs/referencia/errores).
## Próximos pasos [#próximos-pasos]
* [`pjud.conexion.sincronizar`](/docs/referencia/pjud/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.