Integrate BeeL with

1000+ apps and services

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

Creates a new customer under this company (NIF)

Retrieves the complete details of a customer of this company (NIF)

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

Deletes a customer of this company (NIF) that has no invoices

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

Creates a new product or service in the catalog of this company (NIF)

Retrieves the details of a product of this company (NIF)

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 (NIF)

Retrieves the invoice series of this company (NIF)

Creates a new invoice series under this company (NIF)

Retrieves a single invoice series of this company (NIF)

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

Soft-deletes an invoice series

Marks an invoice series as the default of this company (NIF)

Reports, for each `DocumentType` relevant to automatic invoicing flows (Stripe Connect, etc.), whether this company (NIF) has a default invoice series and which one

Idempotently ensures this company (NIF) has a default invoice series for each relevant `DocumentType` (STANDARD, SIMPLIFIED, CORRECTIVE) in the current environment

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

Creates a new recurring invoice template under this company (NIF) with all its template data (lines, recipient, series, payment) and recurrence configuration

Retrieves the full details of a recurring invoice template of this company (NIF), 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 as it is — in particular the recipient, which survives a change of `lines`

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

Sets the lifecycle status of a recurring invoice template, which is how generation is paused and resumed: - `PAUSED` stops automatic generation, keeping the schedule configuration intact

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 the invoices previously generated from this recurring template, including their status and generation dates

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

Retrieves the tax configuration of this company (NIF), including: - Default tax regime (VAT, IGIC, IPSI, OTHERS) - Default main tax percentage - IRPF and equivalence surcharge configuration The catalog of tax types this configuration draws from is not company data and lives outside this resource

Retrieves the VeriFactu configuration of this company (NIF)

Returns the tax regimes and percentages that Spanish law allows on an invoice: VAT (mainland), IGIC (Canary Islands), IPSI (Ceuta and Melilla), the withholding (IRPF) percentages, the equivalence surcharge that corresponds to each VAT rate, and the exemption reasons with the classification each o...

Returns the PDF templates a NIF can be rendered with, each one with a readable name and a short description, translated into the language of the user the credential belongs to

**Public endpoint** to validate a NIF/CIF against the AEAT registry using VeriFactu

Creates a new NIF/company under the authenticated account

Returns a server-side page of the companies (NIFs) that belong to the given account, optionally filtered by `search` (NIF / legal name / trade name)

Returns details of a specific company (NIF), including its VeriFactu status

Updates editable fields of a company (same field set as the profile)

Removes the NIF from your account: it stops appearing in the account and stops being billed

Generates the unsigned AEAT representation PDF for this company (NIF), which is the first step of the process: download it with `GET /v1/companies/{company_id}/representation/document`, sign it digitally and upload it back with `POST /v1/companies/{company_id}/representation/submit`

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

Returns the state of the AEAT fiscal representation of this company (NIF): whether the document has been generated, signed, submitted, accepted or cancelled

Cancels the active AEAT representation of this company (NIF)

Returns whether this company (NIF) can issue its STANDARD invoice right now, in this environment — and if not, exactly what is missing

Returns invoice aggregates (count + last emission date) per company under the authenticated account

Returns the VAT and IRPF summary of the invoices issued under this company (NIF) for 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

Returns the accounts you provisioned, each with its lifecycle `status` (`PROVISIONED` → `CLAIMED` → `ACTIVE`) and the access you hold

Returns the current lifecycle status and access for one account you provisioned

Returns how many accounts you have provisioned and how many NIFs (companies) they hold — the billable figure for your offline B2B invoice

Issues a single-use `claim_token` for an account you provisioned, so its holder can set a password and take ownership

Lists the payment provider connections of a NIF (company) that your account **owns or manages**

Opens an authorization session so the holder of a NIF (company) your platform **manages** can connect a payment provider (`stripe`), white-label by API

Disconnects the payment provider connection (`stripe`) of a NIF (company) that your account **owns or manages**

Lists the payment events received through the payment provider connection of a NIF (company) that your account **owns or manages**, 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 current configuration of the NIF

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