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.


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.

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

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

{
  "$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

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í
`coincidencias[].actuacionId`	string `^pja_[a-zA-Z0-9_-]{16,80}$`	null	sí
`coincidencias[].folio`	string	null	sí
`coincidencias[].fechaFuente`	string `^\d{4}-\d{2}-\d{2}$`	null	sí
`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í
`estadoDatos`	`"sin_sincronizar"` · `"disponibles"` · `"incompletos"`	sí	Una lista vacía con sin_sincronizar o incompletos no acredita ausencia de actividad judicial.
`observadoHasta`	string `^(?:(?:\d\d[2468][048]	\d\d[13579][26]	\d\d0[48]
`cobertura`	lista de objeto	sí	Secciones efectivamente revisadas y sus límites, para las causas de esta consulta.
`cobertura[].causaId`	string `^pjc_[a-zA-Z0-9_-]{16,80}$`	sí	ID obtenido de pjud.causas.consultar. No es el rol escrito en el portal.
`cobertura[].cuadernoId`	string `^pjq_[a-zA-Z0-9_-]{16,80}$`	null	sí
`cobertura[].seccion`	`"cabecera"` · `"historia"` · `"litigantes"` · `"notificaciones"` · `"escritos_por_resolver"` · `"exhortos"` · …	sí	Sección concreta cuya cobertura se informa.
`cobertura[].estado`	`"con_datos"` · `"sin_registros"` · `"parcial"` · `"fallida"` · `"no_accesible"` · `"no_implementada"`	sí	Solo con_datos y sin_registros acreditan revisión completa de esta sección. Los otros valores indican información pendiente o inaccesible.
`cobertura[].revisadaEn`	string `^(?:(?:\d\d[2468][048]	\d\d[13579][26]	\d\d0[48]
`cobertura[].registrosObservados`	entero	null	sí
`cobertura[].codigoIncidencia`	string `^pjud_[a-z_]+$`	null	sí

JSON Schema de salida

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "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

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

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

Próximos pasos

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