Obtener una factura de comisiones y su reconciliación

GET

https://app.recurrente.com/api/connected_accounts/:connected_account_id/commission_invoices/:id

GET

/api/connected_accounts/:connected_account_id/commission_invoices/:id

$ curl https://app.recurrente.com/api/connected_accounts/connected_account_id/commission_invoices/id \
>      -H "X-SECRET-KEY: <apiKey>"

1 {
2   "id": "pci_ab12cd34",
3   "connected_account_id": "ac_restaurant",
4   "status": "draft",
5   "billing_date": "2026-07-13",
6   "currency": "GTQ",
7   "amount_in_cents": 325,
8   "description": "Comisiones de plataforma del 13/07/2026",
9   "created_at": "2024-01-15T09:30:00Z",
10   "updated_at": "2024-01-15T09:30:00Z",
11   "fee_in_cents": 25,
12   "tax_invoice_uuid": "string",
13   "tax_invoice_url": "string",
14   "issued_at": "2024-01-15T09:30:00Z",
15   "lines": [
16     {
17       "transfer_setup_id": "string",
18       "transfer_id": "string",
19       "source_id": "string",
20       "source_type": "Checkout",
21       "amount_in_cents": 1,
22       "currency": "GTQ",
23       "completed_at": "2024-01-15T09:30:00Z",
24       "created_at": "2024-01-15T09:30:00Z"
25     }
26   ]
27 }

Devuelve el DTE agregado y sus líneas internas inmutables. Cada línea referencia la configuración, transferencia y checkout o factura que originaron la comisión; no representa un nuevo movimiento de dinero. El emisor conserva acceso a este historial si la cuenta deja de estar conectada.

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.

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.

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

idstringRequired

ID de la factura de comisiones

Response

Factura de comisiones con líneas de reconciliación

idstring

ID de la factura diaria de comisiones

connected_account_idstring

Cuenta conectada que debe pagar la comisión

statusenum

Estado durable del documento fiscal

billing_datedate

Día económico en America/Guatemala

currencyenum

amount_in_centsinteger>=1

Suma exacta de las comisiones incluidas, en centavos

descriptionstring

created_atdatetime

updated_atdatetime

fee_in_centsinteger or nullOptional

Fee FEL debitado a la plataforma después de una emisión exitosa

tax_invoice_uuidstring or nullOptional

UUID del DTE emitido por INFILE

tax_invoice_urlstring or nullOptionalformat: "uri"

URL del DTE emitido

issued_atdatetime or nullOptional

lineslist of objectsOptional

Solo se incluye en el endpoint de detalle

Errors

404

Not Found Error