Connect
API REST

Buscar documentos del expediente

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.

POST
/v1/tools/pjud.documentos.consultar/execute

Authorization

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",        "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"      }    ]  },  "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 ClaveÚnica.

Leer un documento por páginas POST

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.