Sincronizar conexión Banco Itaú

Sincroniza los alcances solicitados (saldos, movimientos) de Banco Itaú Empresas en una sola sincronización, incluida la cuenta dólar cuando la empresa tiene una. 'saldos' es una foto del momento, no del período: sólo se sincroniza cuando se pide el período corriente. Los movimientos salen de la pantalla de cada cuenta, que publica sus últimos 100 movimientos (en una cuenta con mucho movimiento son pocos días): el período pedido etiqueta la corrida, pero cada movimiento queda archivado bajo el mes de SU fecha. La cuenta dólar suma además su última cartola mensual cerrada.

POST
/v1/tools/itau_empresas.conexion.sincronizar/execute
AuthorizationBearer <token>

API key de la organización, en 'Authorization: Bearer connect_sk_…'. Es la credencial para tu backend y tus agentes propios; se crea en el dashboard con permisos explícitos y su valor completo se muestra una sola vez. Autentica como agente: la bitácora atribuye la acción a la clave, nunca a la persona que la creó.

In: header

Header Parameters

X-Connect-Connection*string

Cuál conexión (conn_…) ejecuta esta llamada. Obligatoria en todo sistema conectable y sin resolución implícita, ni siquiera cuando la organización tiene una sola conexión activa: la conexión ES la empresa, y elegir por ti una que hoy acierta mañana acierta distinto sin que nadie cambie nada. Los ids salen de la tool 'conexiones.estado.consultar'. Si falta, la respuesta es 'validation_error' y no se contacta al sistema externo.

Match^conn_

Request Body

application/json

La entrada de la tool, envuelta en 'input'. Manda '{"input": {}}' cuando la tool no toma argumentos: el sobre es obligatorio aunque esté vacío.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/tools/itau_empresas.conexion.sincronizar/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {      "periodo": "string",      "alcances": [        "saldos"      ]    }  }'
{  "data": {    "periodo": "string",    "estado": "encolado",    "jobId": "string",    "yaEnCurso": true,    "results": [      {        "alcance": "string",        "marcador": "string",        "status": "ok",        "recordsSynced": -9007199254740991,        "error": "string",        "cuentasConsultadas": -9007199254740991,        "detalle": "string"      }    ]  },  "meta": {    "request_id": "string",    "operation_request_id": "733a3a71-b72d-4633-94b1-070c6664565f",    "tool_id": "string",    "plane": "action",    "latency_ms": 0,    "audit_status": "recorded",    "idempotency": "replayed"  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}

Consultar saldos de Itaú Corporate POST

Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar. Si sincronizarSirve es false, sigue hacer: las indicaciones para pedir datos nuevos que siguen no aplican hasta resolver esa atención. La consulta de datos ya guardados sigue disponible según el plan. Lee los saldos de Itaú Corporate YA sincronizados de esta conexión, del más reciente al más antiguo. Lectura pura: NO contacta al banco ni dispara una sincronización, así que si nunca se sincronizó devuelve una lista vacía. Para traer datos nuevos usa 'itau_corporate.conexion.sincronizar' primero. Hay una foto por cuenta y por día, incluida la cuenta dólar, y los montos vienen como NÚMERO conservando su signo. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas; reenvía ese valor tal cual y nunca lo construyas a mano. Trae una fila por cuenta, moneda y día, y cada fila indica su número de cuenta y su moneda. El orden es siempre el mismo: del día más reciente al más antiguo y, dentro de cada día, por número de cuenta y luego por moneda. Para obtener el saldo más reciente de una cuenta, filtra por 'numeroCuenta' y toma la primera fila de la moneda que buscas. Sin ese filtro, la primera fila es la cuenta de menor número, que puede no ser la que necesitas.

Verificar conexión Banco Itaú POST

Comprueba con Banco Itaú que las credenciales de la conexión funcionan. No sincroniza ni devuelve datos: solo confirma si las credenciales sirven.