---
title: "Configurar la facturación de comisiones de una cuenta conectada"
method: PUT
path: "/connected_accounts/{connected_account_id}/commission_invoicing"
tags: ["connectedAccounts"]
---

# Configurar la facturación de comisiones de una cuenta conectada

`PUT /connected_accounts/{connected_account_id}/commission_invoicing`

## Request

- Base URL: `https://app.recurrente.com/api`
- URL: `https://app.recurrente.com/api/connected_accounts/{connected_account_id}/commission_invoicing`
- Auth: API key in header `X-SECRET-KEY`
- TypeScript: <https://skmtc.dev/recurrente/apis/referencia-api/docs/connected_accounts/:connected_account_id/commission_invoicing/put.ts> (a function with typed inputs; its response is checked against the schema)

`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`.

## Path parameters

- `connected_account_id` string, required

## Request body

- ConnectedAccountCommissionInvoicingUpdateRequest
  - `mode` 'default' | 'none' | 'daily', required: `daily` o `none` establecen un override; `default` vuelve a heredar la configuración general

## Response `200`

Configuración actualizada

- ConnectedAccountCommissionInvoicing
  - `mode` 'none' | 'daily', required: Modo efectivo después de aplicar el override o la configuración general
  - `override_mode` 'none' | 'daily', required: Override de esta conexión; `null` significa que hereda la configuración general
  - `default_mode` 'none' | 'daily', required: Configuración general de facturación de la plataforma
  - `enabled_at` string, date-time, nullable: Inicio del intervalo elegible
  - `disabled_at` string, date-time, nullable: Fin exclusivo del intervalo elegible; las comisiones anteriores todavía se drenan
  - `timezone` 'America/Guatemala', required

## Other responses

- `400`: La plataforma emisora o los datos fiscales del receptor no están listos
- `403`: Se intentó habilitar con una API key de prueba
- `404`: Cuenta conectada no encontrada

## Changes

- **2026-09-19** `33bad9197d59`: 4 breaking
  - added `#/components/schemas/ErrorErrors0` to the `errors` response property `oneOf` list for the response status `400`
  - added `#/components/schemas/ErrorErrors0` to the `errors` response property `oneOf` list for the response status `403`
  - the `errors/oneOf[subschema #1 -> subschema #2]/` response's property type changed from `object` to `array` for status `400`
  - the `errors/oneOf[subschema #1 -> subschema #2]/` response's property type changed from `object` to `array` for status `403`
- **2026-09-17** `3d76463f9fd8`: 1 warning, 1 info
  - deleted the `header` request parameter `X-SECRET-KEY`
  - the endpoint scheme security `secretKey` was added to the API
- **2026-09-12** `3f07af5cbba7`: 1 info
  - api operation id `update-connected-account-commission-invoicing` removed and replaced with `connectedAccounts_updateConnectedAccountCommissionInvoicing`

[Operation history](https://skmtc.dev/recurrente/apis/referencia-api/changes/connected_accounts/:connected_account_id/commission_invoicing/put.md)

---

[API](https://skmtc.dev/recurrente/apis/referencia-api.md) - [All operations](https://skmtc.dev/recurrente/apis/referencia-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recurrente/apis/referencia-api/revisions/1a3fc480dd94?raw)