Connect
API REST

Consultar inventario y preparación de causas

Distingue referencias encontradas en Mis Causas, selección de seguimiento y expedientes recuperados. Una referencia pendiente no incluye una cabecera inventada. El progreso de Civil y Laboral es independiente; un fallo o un límite de descubrimiento no acredita una cartera vacía. Una selección manual no requiere importación automática. 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.cartera.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.cartera.consultar/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {}  }'
{  "data": {    "causas": [      {        "referencia": {          "competencia": "suprema",          "tribunal": {            "codigo": "string",            "nombre": "string"          },          "rol": "string",          "anio": 1800,          "causaId": "string"        },        "encontrado": true,        "enSeguimiento": true,        "expedienteDisponible": true,        "estadoDatos": "sin_sincronizar",        "observadoEn": "2019-08-24T14:15:22Z"      }    ],    "modo": "sin_inicializar",    "progreso": [      {        "competencia": "civil",        "estado": "pendiente",        "encontradas": 0,        "observadoEn": "2019-08-24T14:15:22Z",        "codigoIncidencia": "string",        "alcance": "string"      }    ],    "contadores": {      "encontradas": 0,      "enSeguimiento": 0,      "expedientesDisponibles": 0,      "pendientesDeExpediente": 0,      "expedientesIncompletos": 0,      "causasRestringidas": 0    },    "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  }}

Consultar actuaciones judiciales POST

Localiza actuaciones por folio exacto o reconstruye la cronología observada. El mismo folio puede aparecer en varios cuadernos civiles: conserva todas las coincidencias y elige el cuaderno antes de consultar sus documentos por actuacionId. Laboral presenta la historia en la causa. Las fechas de trámite, fuente y observación mantienen su significado; no calcula plazos legales. 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.

Consultar cartera judicial POST

Busca en la cartera elegida por identificador o carátula. El nombre no identifica inequívocamente a una persona. La inactividad observada no implica abandono ni incumplimiento. 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.