Ir al contenido

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.

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ó

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.

Ventana de terminal
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 (24079 son 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 en rectifies.
  • Los borradores de factura no se listan.

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