Explore integrations

BeeL integration researchA little less busywork with BeeL.

Research only. Grunt is prelaunch, live service is paused, and live provider connections and outcomes remain unverified. The operations and examples below are not confirmed live Grunt features or approved supplier commitments.

Explore possible BeeL workflows with Grunt. Documented operations include Invoice: List the invoices of a company; Invoice: Create an invoice for a company; Invoice: Get an invoice of a company. Actions on this page are research candidates from public integration definitions, not confirmation that Grunt support is live.

Explore the simulation Explore the possibilities

Exploratory scope only: these candidates come from public integration definitions and are not confirmed as live Grunt features.

BeeL

“Explore whether a Grunt integration could list the invoices of a company, then create an invoice for a company in BeeL. Show me the result and wait for my approval before changing anything.”

A workflow idea to explore.

Illustrative steps and outcome; no real work is performed here.

01Invoice: List the invoices of a company
02Invoice: Create an invoice for a company
03Review the result before anything changes

A clearer next step, with the final say still yours.

Explore possibilities with BeeL.

Researched operations, not a list of enabled Grunt actions. Actual support, account permissions, supplier terms, and live acceptance require separate verification.

75 researched capabilities across 11 groups

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

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

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)

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

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

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

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

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

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**

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

Proposed setup considerations

The research notes below describe a possible setup. They are not instructions for an available Grunt connection; actual steps depend on supported operations and provider approval.

01
Start with a small, useful task.
Describe a routine step involving BeeL. Keep a first version easy to review and change.
02
Plan the account access.
Check which BeeL account, data, and permissions a safe connection would need. Start with the least access that can do the job.
03
Test the details together.
Validate a sample against a disposable account. Confirm which records are read, what could change, and how errors or duplicates are handled.
04
Keep the say-so.
Decide which steps could run on their own and which would need your review. Expand access only when the workflow needs it.

RESEARCH NOTES

Questions about the concept.

These notes describe possible uses. Customer availability remains unverified.

What could a Grunt 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. These are research candidates from public integration definitions and need validation and Grunt implementation before they can be treated as supported capabilities.

Could I keep a workflow read-only?

The research candidates do not confirm an implemented BeeL connection or a read-only access mode. If built, verify least-privilege scopes and reject writes at the app API boundary.

Will every action run automatically?

If a connection is built, 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?

A future integration should let you decide which work could run on its own and which steps need your review.

There’s a Grunt for that

A little less busywork.
A little more you.

Read the current prelaunch status and confirmed prices.

View pricing status Explore the simulation

BeeL integration researchA little less busywork with BeeL.

Explore possibilities with BeeL.

Invoice16 items

Customer5 items

Product5 items

Series8 items

Recurring Invoice11 items

Configuration4 items

NIF1 item

Company13 items

Account5 items

Payment Connection3 items

Payment Event4 items

Proposed setup considerations

Start with a small, useful task.

Plan the account access.

Test the details together.

Keep the say-so.

Questions about the concept.

A little less busywork.A little more you.

A little less busywork.
A little more you.