BeeL × AmbactiBring BeeL into
the flow of work.
A little less busywork with BeeL.
Invoice16 capabilities+
- List the invoices of a company
Returns a paginated list of the invoices issued under this company (NIF), with the same filters as the flat route
- Create an invoice for a company
Creates a new invoice under this company (NIF)
- Get an invoice of a company
Retrieves the full details of an invoice of this company (NIF)
- Update an invoice of a company partially
Updates only the fields present in the body, leaving every other field of the invoice as it is
- Delete a draft invoice of a company
Deletes a draft invoice of this company
- Derive a draft invoice from an existing one
Creates a new draft invoice derived from an existing invoice of this company
- Issue an invoice (DRAFT → ISSUED)
Finalizes a draft invoice of this company: assigns its definitive number from the configured series and makes it immutable
- Void an issued invoice
Voids an issued invoice of this company
- Create a corrective invoice
Issues a corrective invoice that amends the invoice in the path
- Set the status of an invoice
Sets the commercial status of an invoice: paid, sent, or back to issued
- Get the scheduling of an invoice
Returns the date and generation mode currently scheduled for this invoice
- Schedule or reschedule an invoice
Replaces the scheduling of a draft invoice, whether it had one or not: scheduling for the first time and moving an existing schedule are the same act on the same sub-resource
- Remove the scheduling of an invoice
Removes the scheduling of an invoice, leaving it as a plain draft
- Send an invoice by email
Sends the invoice by email, attaching its PDF by default
- Convert a proforma into an invoice
Converts an accepted proforma of this company into a real invoice
- Download an invoice PDF
Download the invoice PDF as binary data
Customer5 capabilities+
- List the customers of a company
Returns a paginated list of the customers of this company (NIF), with optional filters
- Create a customer for a company
Creates a new customer under this company (NIF)
- Get a customer of a company
Retrieves the complete details of a customer of this company (NIF)
- Update a customer of a company partially
Updates only the fields present in the body, leaving every other field of the customer as it is
- Delete a customer of a company
Deletes a customer of this company (NIF) that has no invoices
Product5 capabilities+
- List the products of a company
Returns a paginated list of the products/services of this company (NIF), with optional filters
- Create a product for a company
Creates a new product or service in the catalog of this company (NIF)
- Get a product of a company
Retrieves the details of a product of this company (NIF)
- Update a product of a 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`
- Delete a product of a company
Deletes a product from the catalog of this company (NIF)
Series8 capabilities+
- List the invoice series of a company
Retrieves the invoice series of this company (NIF)
- Create an invoice series for a company
Creates a new invoice series under this company (NIF)
- Get one invoice series of a company
Retrieves a single invoice series of this company (NIF)
- Update an invoice series of a company partially
Updates only the fields present in the body, leaving every other field of the series as it is
- Delete an invoice series of a company
Soft-deletes an invoice series
- Mark a series as the default of a company
Marks an invoice series as the default of this company (NIF)
- Get the default series of a company, per document type
Reports, for each `DocumentType` relevant to automatic invoicing flows (Stripe Connect, etc.), whether this company (NIF) has a default invoice series and which one
- Ensure the company has a default series for every document type
Idempotently ensures this company (NIF) has a default invoice series for each relevant `DocumentType` (STANDARD, SIMPLIFIED, CORRECTIVE) in the current environment
Recurring Invoice11 capabilities+
- List the recurring invoices of a company
Lists the recurring invoice templates of this company (NIF), with filters and pagination
- Create a recurring invoice for a company
Creates a new recurring invoice template under this company (NIF) with all its template data (lines, recipient, series, payment) and recurrence configuration
- Get a recurring invoice of a company
Retrieves the full details of a recurring invoice template of this company (NIF), including its schedule, template lines and next generation date
- Update a recurring invoice of a company partially
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`
- Delete a recurring invoice of a company
Permanently deletes a recurring invoice template of this company (NIF) and cancels any pending scheduled generations
- Set the status of a recurring invoice
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
- Skip the next generation of a recurring invoice
Skips the next scheduled invoice generation and advances the generation date to the following period
- Generate an invoice now from a recurring template
Runs the generation of this recurring template immediately, out of its schedule
- Get the next occurrence of a recurring invoice
Returns the invoice that would be produced by the next generation of this recurring template, computed from the current issuer, recipient and series data
- Get the generation history of a recurring invoice
Returns the invoices previously generated from this recurring template, including their status and generation dates
- Derive a recurring invoice from an existing invoice
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
Configuration4 capabilities+
- Get the tax configuration of a company
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
- Get the VeriFactu configuration of a company
Retrieves the VeriFactu configuration of this company (NIF)
- List the tax types allowed in Spain
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...
- List invoice templates
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
NIF1 capabilities+
- Validate NIF against AEAT registry
**Public endpoint** to validate a NIF/CIF against the AEAT registry using VeriFactu
Company13 capabilities+
- Create a company
Creates a new NIF/company under the authenticated account
- List the companies (NIFs) of an account (paginated)
Returns a server-side page of the companies (NIFs) that belong to the given account, optionally filtered by `search` (NIF / legal name / trade name)
- Get company details
Returns details of a specific company (NIF), including its VeriFactu status
- Update company details
Updates editable fields of a company (same field set as the profile)
- Delete a company
Removes the NIF from your account: it stops appearing in the account and stops being billed
- Generate the representation document
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`
- Download the representation document
Returns a presigned URL, valid for 5 minutes, to download the representation PDF of this company (NIF)
- Get fiscal representation
Returns the state of the AEAT fiscal representation of this company (NIF): whether the document has been generated, signed, submitted, accepted or cancelled
- Cancel the fiscal representation
Cancels the active AEAT representation of this company (NIF)
- Get issuing readiness
Returns whether this company (NIF) can issue its STANDARD invoice right now, in this environment — and if not, exactly what is missing
- Per-company invoice aggregates
Returns invoice aggregates (count + last emission date) per company under the authenticated account
- Get the fiscal summary of a company for a period
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
- Submit the signed representation
Upload the signed representation PDF that registers the NIF with the AEAT
Account5 capabilities+
- Provision an account
Provisions a new account on BeeL
- List the accounts you provisioned, with lifecycle status
Returns the accounts you provisioned, each with its lifecycle `status` (`PROVISIONED` → `CLAIMED` → `ACTIVE`) and the access you hold
- Get a provisioned account's authoritative status
Returns the current lifecycle status and access for one account you provisioned
- Provisioning usage of your own account
Returns how many accounts you have provisioned and how many NIFs (companies) they hold — the billable figure for your offline B2B invoice
- Issue a claim token for an account you provisioned
Issues a single-use `claim_token` for an account you provisioned, so its holder can set a password and take ownership
Payment Connection3 capabilities+
- List a NIF's payment connections
Lists the payment provider connections of a NIF (company) that your account **owns or manages**
- Open an authorization to connect a payment provider
Opens an authorization session so the holder of a NIF (company) your platform **manages** can connect a payment provider (`stripe`), white-label by API
- Disconnect a NIF's payment provider
Disconnects the payment provider connection (`stripe`) of a NIF (company) that your account **owns or manages**
Payment Event4 capabilities+
- List the payment events of a NIF's connection
Lists the payment events received through the payment provider connection of a NIF (company) that your account **owns or manages**, most recent first
- Get a payment event of a NIF's connection
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
- Retry a payment event of a NIF's connection
Reprocesses a payment event whose automatic invoicing did not complete, applying the current configuration of the NIF
- Create a draft invoice from a payment event of a NIF's connection
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
Frequently asked
questions.
What could an Ambacti integration do with BeeL?
The documented operations include Invoice: List the invoices of a company; Invoice: Create an invoice for a company; Invoice: Get an invoice of a company; Invoice: Update an invoice of a company partially.
Could I keep a workflow read-only?
For a read-only workflow, limit account permissions to reading data and exclude actions that create, update, or delete records.
Will every action run automatically?
Choose which steps could run on their own and which should pause for review. Changes should follow the permissions and approval rules you set.
Do I need to review actions in BeeL?
Decide which work could run on its own and which steps need your review.