Sincronizar conexión Itaú Corporate

Sincroniza los saldos, movimientos o nóminas que pidas para la empresa de esta conexión de Itaú Corporate. Pide el período corriente. 'saldos' trae los saldos actuales, incluida la cuenta dólar cuando corresponde. 'movimientos' trae los últimos 100 movimientos de cada cuenta, cada uno archivado bajo el mes de su fecha. 'nominas' trae las nóminas que Itaú informa para el mes y el detalle por beneficiario, incluso si falta la fecha de pago. Del día 1 al 10 se incluye también el mes anterior. Las nóminas nuevas se leen cualquiera sea su antigüedad. Las pendientes ya guardadas se actualizan hasta su estado final o hasta 90 días después de la creación, inclusive, según la fecha de Chile. Si sólo se conoce el mes, el plazo se cuenta desde su último día. Después se conserva el último detalle aunque la nómina siga visible. Con otro período el job termina fallido con 'validation_error' sin consultar el banco. Si el usuario opera varias empresas, la sincronización lee sólo la empresa de esta conexión y se detiene sin guardar nada si no puede seleccionarla.

POST
/v1/tools/itau_corporate.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_corporate.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  }}