# Sincronizar cartera de Poder Judicial

> Al conectar importa inicialmente las causas accesibles de Mis Causas Civil, Laboral, Corte de Apelaciones y Corte Suprema bajo los filtros publicados del portal y comienza su seguimiento.



{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}

|                     |                                                                    |
| ------------------- | ------------------------------------------------------------------ |
| **Tool ID**         | `pjud.conexion.sincronizar`                                        |
| **Nombre MCP**      | `pjud__conexion__sincronizar`                                      |
| **Conector**        | `pjud`                                                             |
| **Plano**           | `read`                                                             |
| **Alcances**        | `expedientes`                                                      |
| **Scope (permiso)** | `pjud:read`                                                        |
| **Auth**            | `connection_credentials`                                           |
| **Versión**         | `2`                                                                |
| **Sensible**        | sí                                                                 |
| **Deprecado**       | no                                                                 |
| **Comportamiento**  | readOnly=false, destructive=false, idempotent=true, openWorld=true |

> **Requiere conexión.** Indica cuál en cada llamada: header `X-Connect-Connection` en REST y campo `connectionId` en el `execute_write` 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`](/docs/referencia/conexiones/estado-consultar).

## Qué hace [#qué-hace]

Después respeta la selección manual, incluso vacía. Guarda actuaciones y documentos disponibles; consulta pjud.cartera.consultar para distinguir inventario, seguimiento, expedientes y competencias pendientes. No presenta escritos ni calcula plazos legales. El período organiza la ejecución de Emisso: no filtra la historia judicial.

## Entrada [#entrada]

| Campo      | Tipo                     | Requerido                      | Descripción                                        |                                                                                                                               |
| ---------- | ------------------------ | ------------------------------ | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `periodo`  | string \`^\d{4}-(0\[1-9] | 1\[0-2])$\`                    | no                                                 | Período de ejecución en AAAA-MM; si se omite, usa el mes actual en Santiago al ejecutar. No filtra la historia de las causas. |
| `alcances` | lista de string          | no · default `["expedientes"]` | Módulo judicial que se sincroniza en esta llamada. |                                                                                                                               |

<details>
  <summary>
    JSON Schema de entrada
  </summary>

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "periodo": {
        "description": "Período de ejecución en AAAA-MM; si se omite, usa el mes actual en Santiago al ejecutar. No filtra la historia de las causas.",
        "type": "string",
        "pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
      },
      "alcances": {
        "default": [
          "expedientes"
        ],
        "description": "Módulo judicial que se sincroniza en esta llamada.",
        "minItems": 1,
        "maxItems": 1,
        "type": "array",
        "items": {
          "type": "string",
          "const": "expedientes"
        }
      }
    },
    "additionalProperties": false
  }
  ```
</details>

## Salida [#salida]

| Campo                                     | Tipo                                                                                                 | Requerido | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `periodo`                                 | string                                                                                               | sí        | Período de ejecución en AAAA-MM.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `estado`                                  | `"encolado"` · `"completado"`                                                                        | sí        | 'encolado' = la sincronización quedó en cola y va a empezar enseguida; esta respuesta NO trae datos todavía, y el trabajo se sigue por 'jobId'. 'completado' = la sincronización ya corrió y su resumen por alcance viene en 'results'. Un cliente recibe siempre 'encolado': un sync consulta el sistema externo y puede tardar minutos, así que no se te hace esperar por él.                                                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `jobId`                                   | string                                                                                               | null      | no                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | El identificador de la sincronización encolada. Por la API REST, el avance se consulta en 'GET /v1/syncs/\{jobId}'; por MCP, búscalo en 'trabajos' de 'conexiones.estado.consultar' y revisa 'datosListos' ahí mismo. Es el mismo id que viaja en el webhook 'sync.succeeded' o 'sync.failed' si tu plan los incluye. Es null cuando 'estado' es 'completado', porque ahí el resultado ya está en la respuesta, y cuando 'yaEnCurso' es true y esa sincronización ya está corriendo. |
| `yaEnCurso`                               | booleano                                                                                             | no        | 'true' significa que ya había una sincronización viva para esa conexión y ese período, así que no se creó otra. No es un error ni un rechazo. Si esa sincronización sigue en cola, 'jobId' es el suyo; si ya está corriendo, 'jobId' llega null y su avance se ve en 'trabajos' de 'conexiones.estado.consultar'. Cubre el período, no necesariamente los alcances que pediste: si pediste otros, vuelve a pedirlos cuando termine. Ojo con el otro lado: 'false' NO garantiza que la hayas creado tú: dos llamadas a la vez pueden recibir las dos 'false' y el MISMO 'jobId'. Lo que sí vale siempre es que hay una sola sincronización activa por conexión y período.                                              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `results`                                 | lista de objeto                                                                                      | no        | El resumen por alcance, una fila por alcance sincronizado. AUSENTE cuando 'estado' es 'encolado': el trabajo todavía no corrió. Ausente no es lo mismo que vacío: un arreglo vacío significaría que se miró y no había nada.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `results[].alcance`                       | string                                                                                               | sí        | Módulo de expedientes judiciales.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `results[].status`                        | `"ok"` · `"partial"`                                                                                 | sí        | Partial indica que se guardaron avances con cobertura pendiente; no equivale a una revisión completa.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `results[].recordsSynced`                 | entero                                                                                               | sí        | Registros entregados a persistencia por esta ejecución; no es el total histórico de la conexión.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `results[].causasRevisadas`               | entero                                                                                               | sí        | Causas con una observación recuperada, aun cuando alguna sección quedó pendiente.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `results[].causasPendientes`              | entero                                                                                               | sí        | Causas elegidas cuya lectura no pudo completarse en esta ejecución.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `results[].competenciasPendientes`        | entero                                                                                               | sí        | Competencias de Mis Causas (Civil, Laboral, Corte de Apelaciones o Corte Suprema) cuyo inventario inicial sigue pendiente. No es un conteo de causas desconocidas.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `results[].documentosDescargados`         | entero                                                                                               | sí        | Originales recuperados e incluidos en el guardado de esta ejecución.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `results[].detalle`                       | string                                                                                               | sí        | Explicación de la cobertura o de una cartera sin selección.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `results[].lecturaPortalCompleta`         | booleano                                                                                             | no        | La lectura de esta ejecución terminó sin trabajo remoto pendiente ni errores. No acredita texto completo ni cobertura que OJV no publica; el procesamiento local de documentos se consulta en estadoCarga.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `results[].causasSinLectura`              | entero                                                                                               | no        | Solo durante la carga inicial importada de Mis Causas: causas en seguimiento que aún no tienen una primera lectura guardada, contando esta ejecución. Mientras el sync siga en cola con un valor mayor que cero, Emisso continúa la lectura en unos minutos dentro del mismo sync; si el sync terminó con causas pendientes, las leen las próximas sincronizaciones automáticas.                                                                                                                                                                                                                                                                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `results[].causasConDocumentosPendientes` | entero                                                                                               | no        | Solo durante la carga inicial importada de Mis Causas: causas ya leídas en las que quedan documentos por descargar o secciones por leer (cuadernos civiles o listas de anexos) que otra lectura puede completar, contando esta ejecución. Durante la carga inicial no se reintentan descargas que ya fallaron ni documentos sin acceso; los reintentan las sincronizaciones automáticas cuando termina la carga. Mientras el sync siga en cola con un valor mayor que cero, Emisso continúa en unos minutos dentro del mismo sync; si terminó, los completan las próximas sincronizaciones automáticas. Se omite cuando la ejecución no pudo contarlas, como una continuación que no alcanzó a revisar ninguna causa. |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `results[].documentosNuevos`              | entero                                                                                               | no        | Solo durante la carga inicial: originales descargados por primera vez. No cuenta revalidaciones ni nuevas descargas de documentos ya guardados.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `results[].seccionesNuevas`               | entero                                                                                               | no        | Solo durante la carga inicial: cuadernos civiles y listas de anexos leídos por primera vez.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `results[].detencion`                     | `"limite_tiempo"` · `"limite_trafico"` · `"lentitud"` · `"transporte"` · `"portal"` · `"acceso"` · … | no        | Por qué la ejecución dejó causas o documentos sin revisar: un límite propio de Emisso (limite\_tiempo, limite\_trafico), una respuesta que el portal no entregó a tiempo y se reintenta (lentitud), un corte de la conexión entre Emisso y el portal, que Emisso reintenta en minutos (transporte), una respuesta del portal como un rechazo, un límite o una verificación humana (portal), el acceso a la beta (acceso), la sesión (sesion) o un error de lectura (error). Se omite si no hubo corte.                                                                                                                                                                                                                |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

<details>
  <summary>
    JSON Schema de salida
  </summary>

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "periodo": {
        "type": "string",
        "description": "Período de ejecución en AAAA-MM."
      },
      "estado": {
        "type": "string",
        "enum": [
          "encolado",
          "completado"
        ],
        "description": "'encolado' = la sincronización quedó en cola y va a empezar enseguida; esta respuesta NO trae datos todavía, y el trabajo se sigue por 'jobId'. 'completado' = la sincronización ya corrió y su resumen por alcance viene en 'results'. Un cliente recibe siempre 'encolado': un sync consulta el sistema externo y puede tardar minutos, así que no se te hace esperar por él."
      },
      "jobId": {
        "description": "El identificador de la sincronización encolada. Por la API REST, el avance se consulta en 'GET /v1/syncs/{jobId}'; por MCP, búscalo en 'trabajos' de 'conexiones.estado.consultar' y revisa 'datosListos' ahí mismo. Es el mismo id que viaja en el webhook 'sync.succeeded' o 'sync.failed' si tu plan los incluye. Es null cuando 'estado' es 'completado', porque ahí el resultado ya está en la respuesta, y cuando 'yaEnCurso' es true y esa sincronización ya está corriendo.",
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ]
      },
      "yaEnCurso": {
        "description": "'true' significa que ya había una sincronización viva para esa conexión y ese período, así que no se creó otra. No es un error ni un rechazo. Si esa sincronización sigue en cola, 'jobId' es el suyo; si ya está corriendo, 'jobId' llega null y su avance se ve en 'trabajos' de 'conexiones.estado.consultar'. Cubre el período, no necesariamente los alcances que pediste: si pediste otros, vuelve a pedirlos cuando termine. Ojo con el otro lado: 'false' NO garantiza que la hayas creado tú: dos llamadas a la vez pueden recibir las dos 'false' y el MISMO 'jobId'. Lo que sí vale siempre es que hay una sola sincronización activa por conexión y período.",
        "type": "boolean"
      },
      "results": {
        "description": "El resumen por alcance, una fila por alcance sincronizado. AUSENTE cuando 'estado' es 'encolado': el trabajo todavía no corrió. Ausente no es lo mismo que vacío: un arreglo vacío significaría que se miró y no había nada.",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "alcance": {
              "type": "string",
              "const": "expedientes",
              "description": "Módulo de expedientes judiciales."
            },
            "status": {
              "type": "string",
              "enum": [
                "ok",
                "partial"
              ],
              "description": "Partial indica que se guardaron avances con cobertura pendiente; no equivale a una revisión completa."
            },
            "recordsSynced": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Registros entregados a persistencia por esta ejecución; no es el total histórico de la conexión."
            },
            "causasRevisadas": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Causas con una observación recuperada, aun cuando alguna sección quedó pendiente."
            },
            "causasPendientes": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Causas elegidas cuya lectura no pudo completarse en esta ejecución."
            },
            "competenciasPendientes": {
              "default": 0,
              "description": "Competencias de Mis Causas (Civil, Laboral, Corte de Apelaciones o Corte Suprema) cuyo inventario inicial sigue pendiente. No es un conteo de causas desconocidas.",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "documentosDescargados": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Originales recuperados e incluidos en el guardado de esta ejecución."
            },
            "detalle": {
              "type": "string",
              "description": "Explicación de la cobertura o de una cartera sin selección."
            },
            "lecturaPortalCompleta": {
              "description": "La lectura de esta ejecución terminó sin trabajo remoto pendiente ni errores. No acredita texto completo ni cobertura que OJV no publica; el procesamiento local de documentos se consulta en estadoCarga.",
              "type": "boolean"
            },
            "causasSinLectura": {
              "description": "Solo durante la carga inicial importada de Mis Causas: causas en seguimiento que aún no tienen una primera lectura guardada, contando esta ejecución. Mientras el sync siga en cola con un valor mayor que cero, Emisso continúa la lectura en unos minutos dentro del mismo sync; si el sync terminó con causas pendientes, las leen las próximas sincronizaciones automáticas.",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "causasConDocumentosPendientes": {
              "description": "Solo durante la carga inicial importada de Mis Causas: causas ya leídas en las que quedan documentos por descargar o secciones por leer (cuadernos civiles o listas de anexos) que otra lectura puede completar, contando esta ejecución. Durante la carga inicial no se reintentan descargas que ya fallaron ni documentos sin acceso; los reintentan las sincronizaciones automáticas cuando termina la carga. Mientras el sync siga en cola con un valor mayor que cero, Emisso continúa en unos minutos dentro del mismo sync; si terminó, los completan las próximas sincronizaciones automáticas. Se omite cuando la ejecución no pudo contarlas, como una continuación que no alcanzó a revisar ninguna causa.",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "documentosNuevos": {
              "description": "Solo durante la carga inicial: originales descargados por primera vez. No cuenta revalidaciones ni nuevas descargas de documentos ya guardados.",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "seccionesNuevas": {
              "description": "Solo durante la carga inicial: cuadernos civiles y listas de anexos leídos por primera vez.",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "detencion": {
              "description": "Por qué la ejecución dejó causas o documentos sin revisar: un límite propio de Emisso (limite_tiempo, limite_trafico), una respuesta que el portal no entregó a tiempo y se reintenta (lentitud), un corte de la conexión entre Emisso y el portal, que Emisso reintenta en minutos (transporte), una respuesta del portal como un rechazo, un límite o una verificación humana (portal), el acceso a la beta (acceso), la sesión (sesion) o un error de lectura (error). Se omite si no hubo corte.",
              "type": "string",
              "enum": [
                "limite_tiempo",
                "limite_trafico",
                "lentitud",
                "transporte",
                "portal",
                "acceso",
                "sesion",
                "error"
              ]
            }
          },
          "required": [
            "alcance",
            "status",
            "recordsSynced",
            "causasRevisadas",
            "causasPendientes",
            "competenciasPendientes",
            "documentosDescargados",
            "detalle"
          ],
          "additionalProperties": false
        }
      }
    },
    "required": [
      "periodo",
      "estado"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Errores de esta tool [#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.                                                   |
| `connection_not_found` | 404  | no           | Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada. |
| `alcance_not_enabled`  | 403  | no           | Habilita el alcance en /connections o quítalo del input de la sincronización.                                       |
| `too_many_pending`     | 429  | sí           | Deja terminar los trabajos en curso antes de encolar más.                                                           |

La llamada solo encola: las fallas del sistema externo (credencial, sesión, caída del portal) no llegan en esta respuesta, sino en el trabajo: en `outcomes` y `last_error` de `GET /v1/syncs/{jobId}`, o en los webhooks `sync.succeeded` (un alcance que falló junto a otros que terminaron) y `sync.failed`.

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](/docs/referencia/errores).

## Próximos pasos [#próximos-pasos]

* [`pjud.causas.consultar`](/docs/referencia/pjud/causas-consultar): lee el alcance `expedientes` que esta sincronización escribe.
* [`pjud.causas.detallar`](/docs/referencia/pjud/causas-detallar): lee el alcance `expedientes` que esta sincronización escribe.
* [`pjud.actuaciones.consultar`](/docs/referencia/pjud/actuaciones-consultar): lee el alcance `expedientes` que esta sincronización escribe.
* [`pjud.documentos.consultar`](/docs/referencia/pjud/documentos-consultar): lee el alcance `expedientes` que esta sincronización escribe.
* [`pjud.documentos.detallar`](/docs/referencia/pjud/documentos-detallar): lee el alcance `expedientes` que esta sincronización escribe.
* [`pjud.novedades.consultar`](/docs/referencia/pjud/novedades-consultar): lee el alcance `expedientes` que esta sincronización escribe.
* [`pjud.cartera.consultar`](/docs/referencia/pjud/cartera-consultar): lee el alcance `expedientes` que esta sincronización escribe.
* [`pjud.documentos.buscar_texto`](/docs/referencia/pjud/documentos-buscar_texto): lee el alcance `expedientes` que esta sincronización escribe.


---

Esta página es parte de la documentación de Emisso. El índice completo, con cada página y su descripción, está en https://connect.emisso.ai/llms.txt. Esta misma página en HTML: https://connect.emisso.ai/docs/referencia/pjud/conexion-sincronizar.
