Facturación
Tus cuentas de facturación, facturas y facturas rectificativas, y los servicios que contrataste.
Los endpoints de facturación devuelven las empresas a cuyo nombre se te factura, las facturas y facturas rectificativas emitidas a esas empresas y los servicios que contrataste. Necesitan el permiso billing:read.
| Endpoint | Ruta | Permiso |
|---|---|---|
| Listar cuentas de facturación | GET /v1/billing/accounts |
billing:read |
| Una cuenta de facturación | GET /v1/billing/accounts/{account_id} |
billing:read |
| Listar facturas | GET /v1/billing/invoices |
billing:read |
| Una factura | GET /v1/billing/invoices/{invoice_id} |
billing:read |
| Listar servicios | GET /v1/billing/services |
billing:read |
La facturación es de todo el cliente: una clave limitada a algunos locales recibe 403 insufficient_scope. Todas las listas admiten limit (de 1 a 100, 50 por defecto), cursor y customer_id. En los ejemplos, $BASE es https://api.bookline.ai/v1 y $BOOKLINE_API_KEY tu clave, como en los primeros pasos.
Cuentas de facturación
Sección titulada «Cuentas de facturación»GET /v1/billing/accounts devuelve las empresas a cuyo nombre se factura tu cuenta; GET /v1/billing/accounts/{account_id}, una de ellas.
| Campo | Qué es |
|---|---|
id |
El identificador de la cuenta de facturación |
legal_name |
La razón social que aparece en sus facturas |
legal_id |
El identificador fiscal de la empresa, tal como aparece en sus facturas |
country |
El país de la dirección de facturación, p. ej. SPAIN, MEXICO |
notification_language |
El idioma de las facturas y los avisos de pago, p. ej. SPANISH, ENGLISH; null si no se eligió ninguno |
created_at |
Cuándo se creó |
Facturas
Sección titulada «Facturas»GET /v1/billing/invoices devuelve las facturas y facturas rectificativas emitidas a tus cuentas de facturación, de la más reciente a la más antigua. Añade account_id para obtener solo las de una cuenta. GET /v1/billing/invoices/{invoice_id} devuelve una.
curl -s -H "apikey: $BOOKLINE_API_KEY" "$BASE/billing/invoices?account_id=<account_id>"{ "data": [ { "id": "…", "account_id": "…", "number": "F2026-0153", "type": "invoice", "currency": "EUR", "issued_on": "2026-11-01", "due_on": "2026-11-15", "status": "OPEN", "subtotal_cents": 19900, "tax_cents": 4179, "total_cents": 24079, "rectifies": null } ], "meta": { "limit": 50, "next_cursor": null }}| Campo | Qué es |
|---|---|
id |
El identificador de la factura |
account_id |
La cuenta de facturación a la que se emite |
number |
El número de factura |
type |
invoice, o credit_note para una factura rectificativa de otra |
currency |
Código ISO 4217 de todos los importes, p. ej. EUR |
issued_on, due_on |
Fechas de emisión y de vencimiento |
status |
OPEN, PAID o VOID |
subtotal_cents, tax_cents, total_cents |
Base imponible, impuestos y total, en unidades menores de currency (ver abajo) |
rectifies |
En una rectificativa: el id de la factura que corrige |
- Los importes van en unidades menores. Siguen el exponente ISO 4217 de la moneda: céntimos en EUR, MXN o COP (
24079son 240,79 €), unidades enteras en CLP o PYG. Nunca dividas entre 100 un importe en CLP o PYG. - Facturas rectificativas. Una rectificativa que anula una factura por completo deja las dos en
VOID. Una parcial deja la factura con su total completo: resta el total de la rectificativa a la factura que indica enrectifies. - Los borradores de factura no se listan.
Servicios
Sección titulada «Servicios»GET /v1/billing/services devuelve los servicios que contrataste: qué cubre cada uno, su estado hoy y su cuenta de facturación.
| Campo | Qué es |
|---|---|
id |
El identificador del servicio |
account_id |
La cuenta de facturación a la que se factura; null hasta que se asigna una |
type |
VOICE_ASSISTANT, WHATSAPP_BOT, PBX, MESSAGES, CRM_MARKETING u OTHER |
status |
DRAFT, TRIAL, ENROLLED, EXEMPT, OFF_SEASON, SCHEDULED, PAUSED, CANCELLED o TRIAL_ENDED |
currency |
Código ISO 4217 en el que tiene el precio |
venue_id, venue_group_id, agent_id |
El local, el grupo de locales o el agente que cubre, si tiene |
started_at |
Cuándo empezó a funcionar |
ended_at |
Cuándo se dio de baja, si se dio |
Reglas de los datos
Sección titulada «Reglas de los datos»- Solo los campos de esta página. Los métodos de pago, los precios y los descuentos no forman parte de la API.
- Solo lectura. Los datos de facturación se cambian en el portal.
Relacionado
Sección titulada «Relacionado»- Facturación: la facturación en el portal.
- Errores y límites de uso.
