Skip to navigation
Referencia APIConnected Accounts

Configurar la facturación de comisiones de una cuenta conectada

daily y none establecen un override para esta conexión; default elimina el override y vuelve a usar la configuración general. Cuando el modo efectivo pasa a daily debes enviar una API key live; la plataforma emisora debe estar lista para emitir FEL con INFILE y la cuenta conectada debe tener NIT y nombre fiscal verificados. Cambiar a none no borra ni modifica documentos existentes y deja que se drenen comisiones completadas antes de disabled_at.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Path parameters

connected_account_idstringRequired
ID de la cuenta conectada

Request

This endpoint expects an object.
modeenumRequired

daily o none establecen un override; default vuelve a heredar la configuración general

Allowed values:

Response

Configuración actualizada

modeenum

Modo efectivo después de aplicar el override o la configuración general

Allowed values:
override_modeenum or null

Override de esta conexión; null significa que hereda la configuración general

Allowed values:
default_modeenum

Configuración general de facturación de la plataforma

Allowed values:
timezoneenum
Allowed values:
enabled_atdatetime or nullOptional
Inicio del intervalo elegible
disabled_atdatetime or nullOptional

Fin exclusivo del intervalo elegible; las comisiones anteriores todavía se drenan

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error