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. 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.
API key de la organización, en 'Authorization: Bearer connect_sk_…'. Es la credencial para tu backend y tus agentes propios; se crea en el dashboard con permisos explícitos y su valor completo se muestra una sola vez. Autentica como agente: la bitácora atribuye la acción a la clave, nunca a la persona que la creó.
In: header
Header Parameters
Cuál conexión (conn_…) ejecuta esta llamada. Obligatoria en todo sistema conectable y sin resolución implícita, ni siquiera cuando la organización tiene una sola conexión activa: la conexión ES la empresa, y elegir por ti una que hoy acierta mañana acierta distinto sin que nadie cambie nada. Los ids salen de la tool 'conexiones.estado.consultar'. Si falta, la respuesta es 'validation_error' y no se contacta al sistema externo.
^conn_Request Body
application/json
La entrada de la tool, envuelta en 'input'. Manda '{"input": {}}' cuando la tool no toma argumentos: el sobre es obligatorio aunque esté vacío.
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/tools/pjud.documentos.buscar_texto/execute" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Content-Type: application/json" \ -d '{ "input": { "busqueda": "string" } }'{ "data": { "coincidencias": [ { "causaId": "string", "documentoId": "string", "clase": "principal", "cuadernoId": "string", "actuacionId": "string", "folio": "string", "fechaFuente": "string", "descripcion": "string", "pagina": 1, "fragmento": "string", "offsetInicio": 0, "apariciones": 1, "versionSha256": "string", "versionExtraccion": 1, "metodo": "texto_pdf" } ], "coberturaBusqueda": { "causasSolicitadas": 0, "competenciasPendientes": 0, "causasExaminadas": 0, "causasSinExpediente": 0, "causasRestringidas": 0, "documentosExaminados": 0, "documentosBuscados": 0, "documentosSinDescarga": 0, "documentosSinTexto": 0, "documentosRestringidos": 0, "paginasBuscadas": 0, "paginasSinTexto": 0, "documentosPendientes": 0, "causasPendientes": 0, "presupuestoAlcanzado": true, "busquedaCompleta": true }, "cursor": "string", "estadoDatos": "sin_sincronizar", "observadoHasta": "2019-08-24T14:15:22Z", "cobertura": [ { "causaId": "string", "cuadernoId": "string", "seccion": "cabecera", "estado": "con_datos", "revisadaEn": "2019-08-24T14:15:22Z", "registrosObservados": 0, "codigoIncidencia": "string" } ] }, "meta": { "request_id": "string", "operation_request_id": "733a3a71-b72d-4633-94b1-070c6664565f", "tool_id": "string", "plane": "action", "latency_ms": 0, "audit_status": "recorded", "idempotency": "replayed" }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}Verificar acceso a Poder Judicial POST
Comprueba la identidad del titular en una sesión OJV vigente. No lee causas ni documentos. Si falta sesión, la sincronización prepara el acceso con la credencial vinculada.
Buscar documentos del expediente POST
Distingue documento principal, certificado, anexo y ebook. Referenciado significa que existe una referencia en el portal; solo descargado acredita que Connect recuperó el archivo. Para leer páginas usa documentos.detallar. 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.