NewThe global rate limit drops to 1000 requests per minute
BeeL
Get StartedMulti-NIFVeriFactuStripeAPI ReferenceChangelog

Suplidos: bill back payments made on behalf of your client

Invoice lines now carry a line_type. Set it to SUPLIDO to pass through amounts you paid in your client's name (art. 78.Tres.3 LIVA). Suplidos stay out of the taxable base, VAT and VeriFactu, and add to a new total_to_pay alongside the fiscal invoice_total.

Changelog

Invoice lines now carry a line_type. Set it to SUPLIDO to pass through amounts you paid in your client's name (art. 78.Tres.3 LIVA). Suplidos stay out of the taxable base, VAT and VeriFactu, and add to a new total_to_pay alongside the fiscal invoice_total.

What else changed

  • line_type on every invoice line (NORMAL | SUPLIDO, defaults to NORMAL). A SUPLIDO line is excluded from the taxable base, VAT and VeriFactu.
  • source_invoice_reference (required on SUPLIDO lines) references the original third-party invoice issued in the client's name.
  • source_invoice_ids optionally links the BeeL. invoices that make up the disbursement, for audit traceability.
  • New totals total_disbursements (sum of suplido lines) and total_to_pay (invoice_total + total_disbursements), which is the amount printed on the PDF and charged to the client.
  • The fiscal invoice_total and all tax breakdowns are unchanged: VeriFactu only ever sees invoice_total.

Where to go next

Suplidos guideCreate invoice

external_reference — tie an invoice to your order and dedupe by it

Invoices now accept an optional external_reference — your own order / cart / contract id — that BeeL. stores, returns, lets you filter by, and enforces as a business-uniqueness key. It's the right tool for "one invoice per order", separate from the Idempotency-Key (which guards request retries).

Read your API request logs

A new Request Logs endpoint family lets you inspect the requests your own API keys have made (live + test) — method, path, status, timing, and the full request/response detail — so you can correlate and debug integrations without leaving your stack.