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

{
  "id": "pci_ab12cd34",
  "connected_account_id": "ac_restaurant",
  "status": "draft",
  "billing_date": "2026-07-13",
  "currency": "GTQ",
  "amount_in_cents": 325,
  "description": "Comisiones de plataforma del 13/07/2026",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z",
  "fee_in_cents": 25,
  "tax_invoice_uuid": "string",
  "tax_invoice_url": "https://app.recurrente.com/f/340B4ACC-0435-4BE5-8EBD-9F4D92AED618",
  "issued_at": "2024-01-15T09:30:00Z",
  "lines": [
    {
      "transfer_setup_id": "string",
      "transfer_id": "string",
      "source_id": "string",
      "source_type": "Checkout",
      "amount_in_cents": 1,
      "currency": "GTQ",
      "completed_at": "2024-01-15T09:30:00Z",
      "created_at": "2024-01-15T09:30:00Z"
    }
  ]
}

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.

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

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

Allowed values:

billing_datedate

Día económico en America/Guatemala

currencyenum

Allowed values:

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"

Página de la factura en Recurrente, la representación gráfica del DTE con la marca del comercio. El documento con validez fiscal es el certificado ante la SAT, y la página enlaza a la copia del certificador. tax_invoice_uuid sigue siendo el número de autorización si necesitas construir ese enlace por tu cuenta.

issued_atdatetime or nullOptional

lineslist of objectsOptional

Solo se incluye en el endpoint de detalle

Errors

404

Not Found Error