ReferenciaBanco de Chile Empresas

Sincronizar conexión Banco de Chile

Sincroniza los alcances solicitados (saldos, movimientos, movimientos de tarjetas y cartolas) para un período en una sola sincronización.

Tool IDbch_empresas.conexion.sincronizar
Nombre MCPbch_empresas__conexion__sincronizar
Conectorbch_empresas
Planoread
Alcancessaldos, movimientos, movimientos_tarjetas, cartolas
Scope (permiso)bch_empresas:read
Authconnection_credentials
Versión5
Sensiblesí
Deprecadono
ComportamientoreadOnly=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.

Qué hace

saldos es una foto del momento, no del período: solo se sincroniza cuando se pide el período corriente. cartolas son los extractos MENSUALES ya emitidos por el banco, un objeto propio que NO alimenta movimientos. movimientos sincroniza cuentas en pesos chilenos (CLP) y dólares estadounidenses (USD).

Entrada

CampoTipoRequeridoDescripción
periodostring ^\d{4}-\d{2}$síEl mes que se va a sincronizar, en formato AAAA-MM y en calendario chileno (por ejemplo '2026-07'). Traer varios meses son varias llamadas, una por mes. El mismo mes de una conexión se puede pedir una vez cada 10 minutos; antes responde 'rate_limited'.
alcanceslista de "saldos" · "movimientos" · "movimientos_tarjetas" · "cartolas"síQué módulos de datos traer en esta corrida, al menos uno. Todos se traen en la misma sincronización, así que pedir varios en una llamada cuesta menos que llamar una vez por cada uno. Un alcance debe estar habilitado en la conexión; si no lo está, la llamada responde 'alcance_not_enabled'.
JSON Schema de entrada
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "periodo": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}$",
      "description": "El mes que se va a sincronizar, en formato AAAA-MM y en calendario chileno (por ejemplo '2026-07'). Traer varios meses son varias llamadas, una por mes. El mismo mes de una conexión se puede pedir una vez cada 10 minutos; antes responde 'rate_limited'."
    },
    "alcances": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "saldos",
          "movimientos",
          "movimientos_tarjetas",
          "cartolas"
        ]
      },
      "description": "Qué módulos de datos traer en esta corrida, al menos uno. Todos se traen en la misma sincronización, así que pedir varios en una llamada cuesta menos que llamar una vez por cada uno. Un alcance debe estar habilitado en la conexión; si no lo está, la llamada responde 'alcance_not_enabled'."
    }
  },
  "required": [
    "periodo",
    "alcances"
  ]
}

Ejemplo

curl
curl -X POST https://connect.emisso.ai/api/v1/tools/bch_empresas.conexion.sincronizar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{"input":{"periodo":"2026-08","alcances":["saldos","movimientos"]}}'
MCP · meta-tool execute_write
{
  "tool": "bch_empresas.conexion.sincronizar",
  "params": {
    "periodo": "2026-08",
    "alcances": [
      "saldos",
      "movimientos"
    ]
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}

Salida esperada (200):

{
  "data": {
    "periodo": "2026-08",
    "estado": "encolado",
    "jobId": "sjb_2p8r4t6y0u1i3o5a7s9d1",
    "yaEnCurso": false
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "bch_empresas.conexion.sincronizar",
    "plane": "read",
    "latency_ms": 58240,
    "audit_status": "recorded"
  }
}

Una sola sincronización cubre los alcances pedidos. cartolas existe y se puede pedir junto con los otros dos, pero revisa que la conexión lo tenga habilitado: si no, esta llamada devuelve 403 alcance_not_enabled entera.

Salida

CampoTipoRequeridoDescripción
periodostringsíEco del período que se pidió, para poder correlacionar la respuesta sin guardarlo tú.
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.
jobIdstringnullno
yaEnCursobooleanono'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.
resultslista de objetonoEl 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[].alcancestringsíCuál de los alcances pedidos describe esta fila. Hay una fila por alcance solicitado, en el orden canónico del conector, no en el orden en que los pediste.
results[].marcadorstringnoUso interno de Emisso; no se publica. En GET /v1/syncs/{id}, la fila trae en su lugar 'motivo': qué pasó y quién tiene que actuar, de la lista cerrada del catálogo de errores.
results[].status"ok" · "partial" · "failed"sí'ok' = el alcance terminó bien; que 'recordsSynced' sea 0 no lo vuelve un fallo. 'failed' = no terminó bien, y la causa va en 'error'. Ojo con un 'failed': NO garantiza que no se haya escrito nada. Cuando el sistema externo trunca un listado, el alcance queda 'failed' con las filas que alcanzó en 'recordsSynced'. Mira siempre las dos cosas juntas. Y revisa fila por fila: un alcance puede fallar mientras los otros de la misma corrida terminan bien.
results[].completobooleanonofalse si la lectura del módulo quedó incompleta; ausente si el módulo no lo declara.
results[].recordsSyncedenterosíCuántos registros de este alcance escribió ESTA corrida. Es el trabajo de esta llamada, no el total acumulado que tienes guardado: para saber cuánto hay, consulta. Un 0 no significa por sí solo «no hay datos»; cuando el cero tiene una explicación, viene en 'detalle'.
results[].errorstringnoPor qué este alcance no terminó bien. Presente solo cuando 'status' es 'failed'. Normalmente es un código del catálogo de errores; cuando el sistema externo truncó el listado es una etiqueta de resultado ('movimientos_truncated', 'cartolas_truncated') que no está en ese catálogo y que significa «se escribió lo que alcanzó a venir». Decide por el valor, nunca por el texto libre.
results[].detallestringnoExplicación en lenguaje llano, presente solo cuando el resultado necesita una. Existe para que un cero se pueda transmitir tal cual en vez de concluir «no hay datos»: transmítelo a quien pregunte en lugar de resumir el número solo.
results[].diagnosticovalornullno
JSON Schema de salida
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "periodo": {
      "type": "string",
      "description": "Eco del período que se pidió, para poder correlacionar la respuesta sin guardarlo tú."
    },
    "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",
            "description": "Cuál de los alcances pedidos describe esta fila. Hay una fila por alcance solicitado, en el orden canónico del conector, no en el orden en que los pediste."
          },
          "marcador": {
            "description": "Uso interno de Emisso; no se publica. En GET /v1/syncs/{id}, la fila trae en su lugar 'motivo': qué pasó y quién tiene que actuar, de la lista cerrada del catálogo de errores.",
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "ok",
              "partial",
              "failed"
            ],
            "description": "'ok' = el alcance terminó bien; que 'recordsSynced' sea 0 no lo vuelve un fallo. 'failed' = no terminó bien, y la causa va en 'error'. Ojo con un 'failed': NO garantiza que no se haya escrito nada. Cuando el sistema externo trunca un listado, el alcance queda 'failed' con las filas que alcanzó en 'recordsSynced'. Mira siempre las dos cosas juntas. Y revisa fila por fila: un alcance puede fallar mientras los otros de la misma corrida terminan bien."
          },
          "completo": {
            "description": "false si la lectura del módulo quedó incompleta; ausente si el módulo no lo declara.",
            "type": "boolean"
          },
          "recordsSynced": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Cuántos registros de este alcance escribió ESTA corrida. Es el trabajo de esta llamada, no el total acumulado que tienes guardado: para saber cuánto hay, consulta. Un 0 no significa por sí solo «no hay datos»; cuando el cero tiene una explicación, viene en 'detalle'."
          },
          "error": {
            "description": "Por qué este alcance no terminó bien. Presente solo cuando 'status' es 'failed'. Normalmente es un código del catálogo de errores; cuando el sistema externo truncó el listado es una etiqueta de resultado ('movimientos_truncated', 'cartolas_truncated') que no está en ese catálogo y que significa «se escribió lo que alcanzó a venir». Decide por el valor, nunca por el texto libre.",
            "type": "string"
          },
          "detalle": {
            "description": "Explicación en lenguaje llano, presente solo cuando el resultado necesita una. Existe para que un cero se pueda transmitir tal cual en vez de concluir «no hay datos»: transmítelo a quien pregunte en lugar de resumir el número solo.",
            "type": "string"
          },
          "diagnostico": {
            "description": "Observaciones cerradas de este alcance incompleto. null significa que no hubo medición utilizable; no certifica cobertura del proveedor ni reconstruye intentos anteriores.",
            "anyOf": [
              {
                "oneOf": [
                  {
                    "type": "object",
                    "properties": {
                      "version": {
                        "type": "number",
                        "const": 1,
                        "description": "Versión del formato de este diagnóstico."
                      },
                      "tipo": {
                        "type": "string",
                        "const": "tarjetas",
                        "description": "Identifica el diagnóstico del catálogo de tarjetas."
                      },
                      "identidad": {
                        "type": "string",
                        "enum": [
                          "no_evaluada",
                          "coincide",
                          "no_coincide"
                        ],
                        "description": "Resultado de comparar la empresa del catálogo con la empresa de la conexión, sin publicar sus RUT."
                      },
                      "catalogo": {
                        "type": "object",
                        "properties": {
                          "productos": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Productos incluidos en el catálogo recibido del banco."
                          },
                          "tarjetasReconocidas": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Tarjetas que el lector reconoció en ese catálogo."
                          },
                          "tipo": {
                            "type": "object",
                            "properties": {
                              "ausente": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Productos sin el campo tipo."
                              },
                              "cadena_vacia": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Productos cuyo tipo queda vacío al quitar los espacios de los extremos."
                              },
                              "cadena_no_vacia": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Productos cuyo tipo contiene texto al quitar los espacios de los extremos."
                              }
                            },
                            "required": [
                              "ausente",
                              "cadena_vacia",
                              "cadena_no_vacia"
                            ],
                            "additionalProperties": false,
                            "description": "Conteos por presencia y forma del campo tipo de los productos."
                          },
                          "familia": {
                            "type": "object",
                            "properties": {
                              "ausente": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Productos sin el campo familia."
                              },
                              "nula": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Productos con el campo familia en null."
                              },
                              "cadena_vacia": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Productos cuya familia queda vacía al quitar los espacios de los extremos."
                              },
                              "cadena_no_vacia": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Productos cuya familia contiene texto al quitar los espacios de los extremos."
                              }
                            },
                            "required": [
                              "ausente",
                              "nula",
                              "cadena_vacia",
                              "cadena_no_vacia"
                            ],
                            "additionalProperties": false,
                            "description": "Conteos por presencia y forma del campo familia de los productos."
                          },
                          "etiquetasTipo": {
                            "type": "object",
                            "properties": {
                              "TARJETA": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Productos cuyo tipo coincide exactamente con TARJETA."
                              },
                              "CUENTA": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Productos cuyo tipo coincide exactamente con CUENTA."
                              },
                              "desconocida": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Productos cuyo tipo no coincide exactamente con ninguna de esas dos etiquetas."
                              }
                            },
                            "required": [
                              "TARJETA",
                              "CUENTA",
                              "desconocida"
                            ],
                            "additionalProperties": false,
                            "description": "Conteos de etiquetas conocidas de tipo, sin publicar las etiquetas desconocidas."
                          },
                          "etiquetasFamilia": {
                            "type": "object",
                            "properties": {
                              "TARJETA DE CREDITO": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Productos cuya familia coincide exactamente con TARJETA DE CREDITO."
                              },
                              "desconocida": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Productos cuya familia no coincide exactamente con esa etiqueta."
                              }
                            },
                            "required": [
                              "TARJETA DE CREDITO",
                              "desconocida"
                            ],
                            "additionalProperties": false,
                            "description": "Conteos de etiquetas de familia, sin publicar valores desconocidos."
                          }
                        },
                        "required": [
                          "productos",
                          "tarjetasReconocidas",
                          "tipo",
                          "familia",
                          "etiquetasTipo",
                          "etiquetasFamilia"
                        ],
                        "additionalProperties": false,
                        "description": "Conteos y formas del catálogo observado, sin cuentas ni referencias de tarjetas."
                      }
                    },
                    "required": [
                      "version",
                      "tipo",
                      "identidad",
                      "catalogo"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "version": {
                        "type": "number",
                        "const": 1,
                        "description": "Versión del formato de este diagnóstico."
                      },
                      "tipo": {
                        "type": "string",
                        "const": "cartolas",
                        "description": "Identifica el diagnóstico de lectura de cartolas MT940 o XLS."
                      },
                      "conteos": {
                        "type": "object",
                        "properties": {
                          "formasVerCartola": {
                            "type": "object",
                            "properties": {
                              "ausente": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Respuestas sin el indicador de habilitación de cartolas."
                              },
                              "nula": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Respuestas cuyo indicador de habilitación es null."
                              },
                              "booleano_true": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Respuestas cuyo indicador de habilitación es el booleano true."
                              },
                              "booleano_false": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Respuestas cuyo indicador de habilitación es el booleano false."
                              },
                              "cadena": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Respuestas cuyo indicador de habilitación es una cadena."
                              },
                              "numero": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Respuestas cuyo indicador de habilitación es un número."
                              },
                              "objeto": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Respuestas cuyo indicador de habilitación es un objeto, excluidas listas y null."
                              },
                              "lista": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Respuestas cuyo indicador de habilitación es una lista."
                              },
                              "otro": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991,
                                "description": "Respuestas cuyo indicador de habilitación tiene otro tipo."
                              }
                            },
                            "required": [
                              "ausente",
                              "nula",
                              "booleano_true",
                              "booleano_false",
                              "cadena",
                              "numero",
                              "objeto",
                              "lista",
                              "otro"
                            ],
                            "additionalProperties": false,
                            "description": "Conteos de las formas recibidas para el indicador de habilitación de cartolas."
                          },
                          "cuentas": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Cuentas en CLP y USD consideradas para la lectura de cartolas, incluidas las que quedaron pendientes por tiempo."
                          },
                          "cuentasSinFlag": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Cuentas consultadas cuyo indicador no habilitó la descarga MT940."
                          },
                          "cuentasSinFlagConIndices": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Cuentas con índices publicados aunque su indicador no habilitó la descarga MT940."
                          },
                          "indices": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Entradas recibidas en las listas de índices de cartolas, antes de validarlas."
                          },
                          "indicesInvalidos": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Listas de índices con forma inesperada o entradas sin una fecha de emisión válida."
                          },
                          "indicesSinDescargaPorFlag": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Índices válidos cuya descarga se omitió porque el indicador de la cuenta no la habilitó."
                          },
                          "descargasFallidas": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Intentos de descarga MT940 o XLS que terminaron en error."
                          },
                          "descargasXls": {
                            "description": "Descargas XLS intentadas cuando verCartola es false.",
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "cuerposSinXls": {
                            "description": "Archivos XLS rechazados por formato o contenido incompleto.",
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          "cuerposSinMt940": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Respuestas de descargas habilitadas donde no se reconoció ningún dato de extracto MT940."
                          },
                          "descartadas": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Índices descartados porque no se obtuvo ningún dato de extracto, incluida la descarga no habilitada."
                          },
                          "cuentasNoSoportadas": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Cuentas excluidas de la lectura por tener una moneda o un formato todavía no soportados."
                          },
                          "cuentasTruncadas": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Cuentas cuya lectura de cartolas quedó incompleta por agotarse el tiempo disponible."
                          },
                          "cartolas": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Registros de cartolas en CLP y USD recuperados para guardar en esta ejecución."
                          },
                          "registrosMonedaNoSoportada": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Registros recuperados que el filtro final descartó por tener una moneda distinta de CLP o USD."
                          }
                        },
                        "required": [
                          "formasVerCartola",
                          "cuentas",
                          "cuentasSinFlag",
                          "cuentasSinFlagConIndices",
                          "indices",
                          "indicesInvalidos",
                          "indicesSinDescargaPorFlag",
                          "descargasFallidas",
                          "cuerposSinMt940",
                          "descartadas",
                          "cuentasNoSoportadas",
                          "cuentasTruncadas",
                          "cartolas",
                          "registrosMonedaNoSoportada"
                        ],
                        "additionalProperties": false,
                        "description": "Conteos de cuentas, índices, descargas y descartes observados durante la lectura."
                      }
                    },
                    "required": [
                      "version",
                      "tipo",
                      "conteos"
                    ],
                    "additionalProperties": false
                  }
                ]
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "alcance",
          "status",
          "recordsSynced"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "periodo",
    "estado"
  ],
  "additionalProperties": false
}

Errores de esta tool

CódigoHTTPReintentableQué hacer
connection_disabled403noReactívala en /connections o usa otra conexión del mismo sistema.
connection_not_found404noUsa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada.
alcance_not_enabled403noHabilita el alcance en /connections o quítalo del input de la sincronización.
too_many_pending429sí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.

Próximos pasos

En esta página