Integrate BeeL with

1000+ apps and services

Returns a paginated list of the customers of this company, with optional filters

Creates a new customer under this company

Retrieves the complete details of a customer of this company

Updates only the fields present in the body, leaving every other field of the customer as it is

Deletes a customer of this company that has no invoices

Returns a paginated list of the products/services of this company, with optional filters

Creates a product or service in the catalog of the company in the path and returns it with its `id`

Retrieves one product of the catalog of this company

Updates only the fields present in the body, leaving every other field of the product as it is — in particular `main_tax`, `irpf_rate` and `equivalence_surcharge_rate`

Deletes a product from the catalog of this company

Returns the invoice series of a company

Creates an invoice series under a company

Returns one invoice series of a company, with its code, format, counter state, document type and whether it is the default of that type

Updates only the fields present in the body, leaving every other field of the series as it is

Soft-deletes an invoice series, deactivating it first if it is active

Marks an invoice series as the default of its document type for this company, and unmarks the previous one

Reports, for each `DocumentType` used by automatic invoicing flows, whether the company (NIF) has a default invoice series and which one: `exists`, plus the `series_id` when there is one

Ensures the company has a default invoice series for `STANDARD`, `SIMPLIFIED` and `CORRECTIVE` in the current environment, and returns the resulting set

Lists the recurring invoice templates of this company, with filters and pagination

Creates a recurring invoice template under this company: the invoice data it repeats (lines, recipient, series, payment) plus the recurrence that drives it

Retrieves the full details of a recurring invoice template of this company, including its schedule, template lines and next generation date

Updates only the fields present in the body, leaving every other field of the recurring invoice template as it is

Permanently deletes a recurring invoice template of this company and cancels any pending scheduled generations

Sets the lifecycle status of a recurring invoice template

Skips the next scheduled invoice generation and advances the generation date to the following period

Runs the generation of this recurring template immediately, out of its schedule

Returns the invoice that would be produced by the next generation of this recurring template, computed from the current issuer, recipient and series data

Returns **every entry** in this schedule's history, newest first: the invoices it generated and, just as important, the periods it did **not** — a failed unattended run, a slot a user skipped, or the schedule being paused

How many recurring schedules this company has alive, what they add up to per month, and how much invoicing is stopped because the unattended generation broke

Creates a recurring invoice template of this company taking its lines, recipient, series and payment data from an existing invoice, so only the recurrence has to be described

Returns the tax configuration of a company: its default main tax (`IVA`, `IGIC`, `IPSI` or `OTHER`) with the default percentage and regime key, the default exemption reason, its IRPF and equivalence surcharge settings, and the default payment method and payment term

Retrieves the VeriFactu configuration of this company

Returns the tax regimes and percentages that BeeL accepts on an invoice

Returns the PDF templates a NIF can be rendered with

Checks a NIF or CIF against the AEAT register through VeriFactu and returns what the register says about it

Creates a company under the account the request resolves to

Returns the companies (NIFs) belonging to the account in the path, ordered with the primary company first

Returns the identity and activation state of a company: its fiscal data, whether it is switched on in Test and in Live, and its VeriFactu registration state

Updates the editable fields of a company; the set is the one `UpdateCompanyRequest` declares

Removes a company from the account: it stops appearing and stops being billed

Generates the unsigned AEAT representation PDF of a company, the first step of the representation flow

Returns a presigned URL, valid for 5 minutes, to download the representation PDF of a company

Returns the state of the AEAT fiscal representation of a company: whether the document has been generated, signed and submitted, and whether AEAT accepted it or it was cancelled

Cancels the active AEAT representation of a company

Returns whether a company can issue its STANDARD invoice right now in the environment of the request, and the `blockers` that stop it otherwise

Returns, for each company of the account, how many fiscal documents it has issued and when it last issued one

Returns the VAT and IRPF summary of the invoices issued under this company over the requested period, together with the annual IRPF projection and its progressive bracket breakdown

Upload the signed representation PDF that registers the NIF with the AEAT

Provisions a new account on BeeL and, when it is born with a holder, returns a single-use `claim_token` to deliver so they can set a password and take ownership

Returns the accounts you provisioned, newest first

Returns one account you provisioned, with the same shape the list returns: its lifecycle `status`, the `access_level` you hold, the state of its claim link and its `company_id` when the account holds exactly one company

Returns how many accounts you have provisioned and the billable count that follows from them — the figure behind your offline B2B invoice

Issues a single-use `claim_token`, and the `claim_url` built from it, so the account's holder can set a password and take ownership

Returns the payment provider connections of a company your account **owns or manages**, with the provider-side account each one points at and its `status`

Opens an authorization session so the holder of a company your account **manages** can connect a payment provider (`stripe`), and returns the `authorization_url` where they authorize it

Updates the auto-invoicing settings of the payment connection named by `{connection_id}` of a company your account **owns or manages**

Disconnects the payment connection named by `{connection_id}` of a company that your account **owns or manages**

Lists the payment events received through the payment provider connection of a NIF (company), most recent first

Retrieves a single payment event of the NIF's connection, including the outcome of its automatic invoicing and, when it failed, the stable failure code you can act on

Reprocesses a payment event whose automatic invoicing did not complete, applying the configuration of the NIF as it stands now

Builds a draft invoice from a payment event that could not be invoiced automatically, applying the same recipient resolution and tax treatment the automatic flow would have applied, under the NIF in the path

Marks a payment event as resolved outside BeeL, for example when the invoice was issued through another tool or the situation was otherwise handled by hand

Removes a payment event from the default list (soft delete)

Reverses a previous discard, bringing a payment event back into the default list