Skip to main content
The billing operations read what Brelio’s Facturación screen shows: invoices, what each patient owes (charges), money received (receipts), their balance and their bonos. For now they are read-only; recording payments, creating invoices and selling bonos come later. Issuing invoices (numbering, VeriFactu and TicketBAI) stays in the web.

​
Before you start

  • The clinic’s billing data area is on. It is off by default; otherwise every call answers 403 DATA_AREA_OFF.
  • Your key has billing.invoices.read for invoices, billing.payments.read for charges, receipts and balances, and billing.packages.read for bonos.
  • Responses name the patient by id only, never by name or fiscal data. For the name, read the patient with GET /patients/{id} (area patients).
  • Every amount is in cents, with its currency (usually EUR).

​
Does this patient owe anything?

Response
pending is what they owe and credit is money they paid that is not applied to anything yet. They are reported apart, never netted, as on the patient’s record. uninvoiced is the total of their open charges that no invoice documents yet, collected or not.

​
What they owe, session by session

Each priced session, bono sale or loose concept is a charge. Its settlement derives from what was collected: pending, partial or settled.
Also filter by uninvoiced=true (what is left to invoice) or by service date with from and to (YYYY-MM-DD). A voided charge (status: "voided") owes nothing: courtesy, recording error, cancelled appointment or covered by a bono.

​
Receipts

Each receipt says how much was received, by which method (cash, card, bizum, transfer, other) and which charges it paid (applications). A corrected receipt is reversed and counts for nothing; it only appears with includeReversed=true. The receipt’s internal notes never leave through the API.

​
Invoices

A draft has number: null; the fiscal number is given on issue. pending is what is left to collect. A rectificativa (series R) points to the invoice it corrects with correctsInvoiceId. Voided invoices only appear with includeVoided=true. To read the lines:
Each line carries its concept, quantity, unit price before tax, discount, VAT rate and, when it documents a charge, its chargeId.

​
Bonos

remaining is the sessions left and total the sessions it was sold with. With a personal credential (MCP or a personal key) you read only the bonos of patients of your centers; the others answer 404, as if they did not exist.

​
From an assistant

Over MCP the same operations are brelio_list_invoices, brelio_get_invoices, brelio_list_charges, brelio_list_receipts, brelio_get_balances and brelio_list_packages. They appear only once the clinic turns Billing on and you hold the permission. Try: “Which sessions has Ana Pérez not paid yet?”: the assistant finds the patient and reads their charges.
Last modified on November 9, 2026