Invoices

Delete an invoice

Deletes a draft invoice. The record is marked as deleted rather than removed.

  • Deprecated: use DELETE /v1/companies/{company_id}/invoices/{invoice_id}, which behaves identically.
  • Proformas: if the draft came from converting a proforma, deleting it returns that proforma to ACTIVE.

Retires on 9 December 2026. See the migration guide for what moved where and what changes when you switch.

delete/v1/invoices/{invoice_id}

Request

  • Base URL: https://app.beel.es/api
  • URL: https://app.beel.es/api/v1/invoices/{invoice_id}
  • Auth: HTTP bearer

Path parameters

invoice_idstring uuid required

Universally Unique Identifier (UUID v4)

Example:550e8400-e29b-41d4-a716-446655440000

Invoice ID

Headers

BeeL-Active-Companystring uuid

Which company (tax ID) the request operates on.

An API key belongs to an account, and an account may hold several companies. Endpoints that read or write company-owned data — invoices, customers, products, series, tax and VeriFactu settings — resolve their target company from this header when the path does not already name one.

On a path that names the company, such as /v1/companies/{company_id}/invoices, the path is the target and this header is not read at all: it neither switches the target nor makes the request fail, so sending one that disagrees with the path is silently ignored rather than rejected. Prefer those paths whenever you need to be explicit about which tax ID you are operating on.

On an account holding a single company the header may be omitted — that company is used. On an account holding several it is required: the request fails with 403 ACTIVE_COMPANY_REQUIRED otherwise. A company-owned record always belongs to one tax ID, so operating on it without saying which one has no meaning.

The company does not have to belong to the API key's own account: one you manage works too, which is what makes the company_id returned by POST /v1/accounts usable here to invoice on a provisioned account's behalf. What you may do with it is then decided by your access level over that account, and issuing also requires a signed fiscal representation.

This header is how you operate on a company, never how you find one: a value you do not reach answers 403, the same as one that does not exist, so guessing reveals nothing. Get the company_id from the response that created the company.

Requires the companies:read scope. Returns 403 if the company is neither yours nor one you manage.

Response

Invoice deleted successfully

Changes

No recorded changes to this operation across all 1 revision of this API.