Conectar un sistema que no pide clave

Crea la conexión de un sistema público que no pide credenciales (hoy Mercado Público) para una empresa, y devuelve su connectionId. La conexión se cobra como cualquier otra del plan de la organización: créala sólo si la persona quiere usar ese sistema. Si esa empresa ya tiene una conexión activa con el sistema, devuelve la misma y no crea otra. Para los sistemas que piden clave usa conexiones.enlace.crear.

POST
/v1/tools/conexiones.conexion.crear/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

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/conexiones.conexion.crear/execute" \  -H "Content-Type: application/json" \  -d '{    "input": {      "sistema": "string",      "empresaRut": "string"    }  }'
{  "data": {    "id": "string",    "sistema": "string",    "sistemaNombre": "string",    "nombre": "string",    "empresaRut": "string",    "creada": true  },  "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 BICE Empresas 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 ya sincronizados de esta conexión de BICE Empresas, con el snapshot más reciente primero. Lectura pura: NO contacta al banco ni dispara una sincronización. Si nunca se sincronizó, devuelve una lista vacía. Para traer datos nuevos, usa 'bice_empresas.conexion.sincronizar' primero. Los saldos son un snapshot POR DÍA, así que sin filtro de fecha la primera página ya son los saldos más recientes que hay guardados. Los dos saldos vienen como NÚMERO y conservan su signo: un sobregiro es negativo. Un saldo no lleva 'type' (no es una operación). Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas: reenvía ese valor tal cual; 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.

Deshabilitar una conexión POST

Pausa una conexión de esta organización: deja de sincronizar, sus herramientas responden 'connection_disabled' y deja de sumarse a los próximos cobros. No borra nada: la credencial, los datos ya sincronizados y el historial se conservan, y conexiones.conexion.habilitar la reanuda. Úsala sólo si la persona pidió pausar esa conexión. Si ya estaba deshabilitada, no cambia nada y responde 'cambiada' en false.