# Sincronizar conexión BCI 360

> Sincroniza saldos actuales y movimientos mensuales de la empresa autorizada en BCI 360.



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

|                     |                                                                    |
| ------------------- | ------------------------------------------------------------------ |
| **Tool ID**         | `bci_360.conexion.sincronizar`                                     |
| **Nombre MCP**      | `bci_360__conexion__sincronizar`                                   |
| **Conector**        | `bci_360`                                                          |
| **Plano**           | `read`                                                             |
| **Alcances**        | `saldos`, `movimientos`                                            |
| **Scope (permiso)** | `bci_360: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, campo `connectionId` en el `execute_write` de MCP y en las opciones del SDK. 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`](../conexiones/estado-consultar).

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

Recorre todas las páginas y actualiza por ID bancario y cuenta, sin duplicar movimientos. No ejecuta pagos.

## Entrada [#entrada]

| Campo      | Tipo                                  | Requerido | Descripción                                      |
| ---------- | ------------------------------------- | --------- | ------------------------------------------------ |
| `periodo`  | string `^\d{4}-\d{2}$`                | sí        | Mes AAAA-MM que se sincronizará.                 |
| `alcances` | lista de `"saldos"` · `"movimientos"` | sí        | Módulos que se sincronizarán en la misma sesión. |

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

  ```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á."
      },
      "alcances": {
        "minItems": 1,
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "saldos",
            "movimientos"
          ]
        },
        "description": "Módulos que se sincronizarán en la misma sesión."
      }
    },
    "required": [
      "periodo",
      "alcances"
    ]
  }
  ```
</details>

## Ejemplo [#ejemplo]

```bash title="curl"
curl -X POST https://connect.emisso.ai/api/v1/tools/bci_360.conexion.sincronizar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{"input":{"periodo":"2026-09","alcances":["movimientos"]}}'
```

```ts title="SDK TypeScript"
const data = await connect.tools.bci_360.conexion.sincronizar({ periodo: "2026-09", alcances: ["movimientos"] }, { connectionId: "conn_9tKfR2mQx4Vb" });
```

```json title="MCP · meta-tool execute"
{
  "tool": "bci_360.conexion.sincronizar",
  "params": {
    "periodo": "2026-09",
    "alcances": [
      "movimientos"
    ]
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}
```

**Salida esperada (200):**

```json
{
  "data": {
    "periodo": "2026-09",
    "results": [
      {
        "alcance": "movimientos",
        "status": "ok",
        "recordsSynced": 17
      }
    ]
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "bci_360.conexion.sincronizar",
    "plane": "read",
    "latency_ms": 58240,
    "audit_status": "recorded"
  }
}
```

## Salida [#salida]

| Campo                     | Tipo                | Requerido | Descripción                                                  |
| ------------------------- | ------------------- | --------- | ------------------------------------------------------------ |
| `periodo`                 | string              | sí        | Mes solicitado.                                              |
| `results`                 | lista de objeto     | sí        | Resultado por módulo solicitado.                             |
| `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.                                   |

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

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "periodo": {
        "type": "string",
        "description": "Mes solicitado."
      },
      "results": {
        "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
        },
        "description": "Resultado por módulo solicitado."
      }
    },
    "required": [
      "periodo",
      "results"
    ],
    "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_credential_required` | 428  | no           | Crea un enlace con conexiones.enlace.crear (modo reconectar si la conexión ya existe) y pide a la persona que entregue la credencial de nuevo. No reintentes con la credencial anterior. |
| `connection_busy`                | 409  | sí           | Espera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez.                                                          |
| `upstream_error`                 | 502  | sí           | Reintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración.                                                                                          |
| `timeout`                        | 504  | sí           | Reintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo.                                                                                           |
| `connection_session_pending`     | 409  | sí           | Ejecuta la sincronización de esa conexión (ella acuña la sesión) o espera la programada, y reintenta.                                                                                    |
| `connection_sync_in_progress`    | 409  | sí           | Espera a que termine y reintenta, o consulta directamente: puede que ya haya datos.                                                                                                      |
| `too_many_pending`               | 429  | sí           | Deja terminar los trabajos en curso antes de encolar más.                                                                                                                                |

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

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

* [`bci_360.movimientos.consultar`](./movimientos-consultar): lee el alcance `movimientos` que esta sincronización escribe.
* [`bci_360.saldos.consultar`](./saldos-consultar): lee el alcance `saldos` que esta sincronización escribe.