# Sincronizar conexión Global66 > Sincroniza las cuentas (wallets por moneda) con su saldo disponible y todos los movimientos del período de cada cuenta, recorriendo todas las páginas. {/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */} | | | | ------------------- | ------------------------------------------------------------------ | | **Tool ID** | `global66.conexion.sincronizar` | | **Nombre MCP** | `global66__conexion__sincronizar` | | **Conector** | `global66` | | **Plano** | `read` | | **Alcances** | `saldos`, `movimientos`, `movimientos_tarjetas` | | **Scope (permiso)** | `global66:read` | | **Auth** | `connection_credentials` | | **Versión** | `1` | | **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] El acceso MCP sincroniza cuentas y saldos mediante get\_my\_accounts, y las compras con tarjeta del período. Actualiza por cuenta e ID de movimiento sin duplicar. Si una cuenta no se pudo leer entera, guarda las demás y el módulo queda failed. No ejecuta pagos. ## Entrada [#entrada] | Campo | Tipo | Requerido | Descripción | | ---------- | ---------------------------------------------------------------- | --------- | --------------------------------------------------- | | `periodo` | string `^\d{4}-\d{2}$` | sí | Mes AAAA-MM que se sincronizará (fechas UTC). | | `alcances` | lista de `"saldos"` · `"movimientos"` · `"movimientos_tarjetas"` | sí | Módulos que se sincronizarán en la misma ejecución. |
JSON Schema de entrada ```json { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "periodo": { "type": "string", "pattern": "^\\d{4}-\\d{2}$", "description": "Mes AAAA-MM que se sincronizará (fechas UTC)." }, "alcances": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "saldos", "movimientos", "movimientos_tarjetas" ] }, "description": "Módulos que se sincronizarán en la misma ejecución." } }, "required": [ "periodo", "alcances" ] } ```
## Ejemplo [#ejemplo] ```bash title="curl" curl -X POST https://connect.emisso.ai/api/v1/tools/global66.conexion.sincronizar/execute \ -H "Authorization: Bearer connect_sk_…" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Content-Type: application/json" \ -d '{"input":{"periodo":"2026-10","alcances":["saldos","movimientos"]}}' ``` ```json title="MCP · meta-tool execute_write" { "tool": "global66.conexion.sincronizar", "params": { "periodo": "2026-10", "alcances": [ "saldos", "movimientos" ] }, "connectionId": "conn_9tKfR2mQx4Vb" } ``` **Salida esperada (200):** ```json { "data": { "periodo": "2026-10", "estado": "encolado", "jobId": "sjb_1c3v5b7n9m2k4j6h8g0f1", "yaEnCurso": false }, "meta": { "request_id": "req_…", "tool_id": "global66.conexion.sincronizar", "plane": "read", "latency_ms": 58240, "audit_status": "recorded" } } ``` ## Salida [#salida] | Campo | Tipo | Requerido | Descripción | | | ------------------------- | ----------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `periodo` | string | sí | Mes solicitado. | | | `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 abre una sesión real contra 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 sincronizado. | | | `results[].status` | `"ok"` · `"failed"` | sí | Resultado del módulo; failed nunca implica cero movimientos. | | | `results[].recordsSynced` | entero | sí | Registros recibidos para persistir. | | | `results[].error` | string | no | Código de error del módulo. | | | `results[].detalle` | string | no | Explicación del resultado. | |
JSON Schema de salida ```json { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "periodo": { "type": "string", "description": "Mes solicitado." }, "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 abre una sesión real contra 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", "description": "Módulo sincronizado." }, "status": { "type": "string", "enum": [ "ok", "failed" ], "description": "Resultado del módulo; failed nunca implica cero movimientos." }, "recordsSynced": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "description": "Registros recibidos para persistir." }, "error": { "description": "Código de error del módulo.", "type": "string" }, "detalle": { "description": "Explicación del resultado.", "type": "string" } }, "required": [ "alcance", "status", "recordsSynced" ], "additionalProperties": false } } }, "required": [ "periodo", "estado" ], "additionalProperties": false } ```
## 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] * [`global66.movimientos.consultar`](/docs/referencia/global66/movimientos-consultar): lee el alcance `movimientos` que esta sincronización escribe. * [`global66.saldos.consultar`](/docs/referencia/global66/saldos-consultar): lee el alcance `saldos` que esta sincronización escribe. * [`global66.compras_tarjeta.consultar`](/docs/referencia/global66/compras_tarjeta-consultar): lee el alcance `movimientos_tarjetas` que esta sincronización escribe.