Buscar documentos del expediente

Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar. Si sincronizarSirve es false, sigue hacer: las indicaciones para pedir datos nuevos que siguen no aplican hasta resolver esa atención. La consulta de datos ya guardados sigue disponible según el plan. Distingue documento principal, certificado, anexo y ebook. Referenciado significa que existe una referencia en el portal; solo descargado acredita que Emisso 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.

POST
/v1/tools/pjud.documentos.consultar/execute
AuthorizationBearer <token>

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

X-Connect-Connection*string

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.

Match^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.consultar/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {      "causaId": "string"    }  }'
{  "data": {    "documentos": [      {        "documentoId": "string",        "causaId": "string",        "cuadernoId": "string",        "actuacionId": "string",        "descripcion": "string",        "tipoFuente": "string",        "folioFuente": "string",        "anexoObservado": {          "identidad": "contenido_en_ambito",          "sha256": "string",          "referencias": [            {              "fecha": "string",              "descripcion": "string"            }          ]        },        "clase": "principal",        "fechaFuente": "string",        "descarga": "referenciado",        "extraccion": "pendiente",        "procesamientoLocal": {          "estado": "pendiente"        },        "paginas": 1,        "sha256": "string",        "fuente": {          "sistema": "OJV",          "ruta": "mis_causas",          "portalUrl": "https://oficinajudicialvirtual.pjud.cl/indexN.php",          "observadoEn": "2019-08-24T14:15:22Z"        }      }    ],    "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",        "referenciasAnexosRecuperadas": true      }    ],    "estadoCarga": "completa",    "resumenDocumentos": {      "total": 0,      "originalesGuardados": 0,      "descargasPendientes": 0,      "descargasFallidas": 0,      "originalesSinAcceso": 0,      "textosExtraidos": 0,      "textosPendientes": 0,      "textosFallidos": 0,      "textosParciales": 0,      "textosRequierenOcr": 0,      "textosNoDisponibles": 0    },    "limitaciones": [      {        "causaId": "string",        "cuadernoId": "string",        "seccion": "cabecera",        "codigo": "pjud_seccion_ausente"      }    ]  },  "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  }}

Buscar texto en los expedientes POST

Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar. Si sincronizarSirve es false, sigue hacer: las indicaciones para pedir datos nuevos que siguen no aplican hasta resolver esa atención. La consulta de datos ya guardados sigue disponible según el plan. 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.

Leer un documento por páginas POST

Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar. Si sincronizarSirve es false, sigue hacer: las indicaciones para pedir datos nuevos que siguen no aplican hasta resolver esa atención. La consulta de datos ya guardados sigue disponible según el plan. Lee la versión sincronizada y permite citar sus páginas. Si requiere OCR o la extracción falló, no inventa contenido. Indica truncación y páginas restantes. El enlace temporal al original solo se solicita explícitamente; una consulta nunca inicia una descarga desde OJV. 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.