Billing & Payments ยท CONNECTIONCreate, issue and send VeriFactu-compliant Spanish invoices and manage customers, products, series, recurring invoices and companies (NIFs).
Explore 112 workflow actions for BeeL, including account permissions and operation limits.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Applies one operation to a set of invoices of this company and reports, invoice by invoice, which succeeded and which failed.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Cancels the active AEAT representation of a company.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Changes a member's account_role between ADMIN and MEMBER.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Updates the access_level you keep over an account you provisioned.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Converts an accepted proforma of this company into a real invoice.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Creates a company under the account the request resolves to.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Issues a corrective invoice that amends the invoice in the path.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Creates a new customer under this company.
A repeated request may repeat the external action. Review the previous result before retrying a write.
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.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Creates a product or service in the catalog of the company in the path and returns it with its id.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Creates a recurring invoice template under this company: the invoice data it repeats (lines, recipient, series, payment) plus the recurrence that drives it.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Creates an invoice for this company.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Creates an invoice series under a company.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Creates up to 500 customers of this company in a single call.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Creates up to 100 products in the catalog of this company.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Removes a company from the account: it stops appearing and stops being billed.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Deletes a customer of this company that has no invoices.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Deletes a draft invoice of this company.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Deletes a product from the catalog of this company.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Permanently deletes a recurring invoice template of this company and cancels any pending scheduled generations.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Permanently deletes a webhook subscription.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Soft-deletes an invoice series, deactivating it first if it is active.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Deletes the customers listed in ids from this company.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Deletes the products listed in ids from the catalog of this company, up to 100 IDs per request; send several requests for more.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Removes the logo of a company.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Creates a draft invoice derived from an existing invoice of this company.
A repeated request may repeat the external action. Review the previous result before retrying a write.
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.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Removes a payment event from the default list (soft delete).
A repeated request may repeat the external action. Review the previous result before retrying a write.
Disconnects the payment connection named by {connection_id} of a company that your account owns or manages.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Ends the management relationship over an account you provisioned: you lose access to it, and its NIFs stop counting towards your billable usage from the next billing cycle.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Ensures the company has a default invoice series for STANDARD, SIMPLIFIED and CORRECTIVE in the current environment, and returns the resulting set.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Issues a full invoice in exchange for one or more simplified invoices already issued, when the customer asks for an invoice with their details.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Runs the generation of this recurring template immediately, out of its schedule.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Generates the unsigned AEAT representation PDF of a company, the first step of the representation flow.
A repeated request may repeat the external action. Review the previous result before retrying a write.
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.
Retrieves the complete details of a customer of this company.
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.
Retrieves one product of the catalog of this company.
Retrieves the full details of a recurring invoice template of this company, including its schedule, template lines and next generation date.
Returns a single webhook subscription.
Returns one recorded email: recipients, subject, status, attachments and the invoices it carried (the message body is left out).
Retrieves the full details of an invoice of this 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.
Returns, for each company of the account, how many fiscal documents it has issued and when it last issued one.
Returns the identity of the authenticated principal: the account the credential belongs to, the person's email, name, logo and interface language, and a description of the.
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.
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.
Returns, for each related entity id given, how many emails the history holds for it, the status of the most recent one and when it was sent.
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.
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.
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.
Returns how the invoices of a company are rendered and delivered: PDF template, accent colour, invoice language, email language and current logo.
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 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 date and generation mode currently scheduled for this invoice.
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.
Retrieves the VeriFactu configuration of this company.
Returns how many accounts you have provisioned and the billable count that follows from them - the figure behind your offline B2B invoice.
Grants a MEMBER access to one company, or changes the access_level of an existing grant.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Finalizes a draft invoice of this company: assigns its definitive number from the configured series and makes it immutable.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Lists the companies (NIFs) granted to a MEMBER and the access_level of each.
Returns a paginated list of the invoices of this company, filterable by status, type, series, customer, date range and free text.
Lists the recurring invoice templates of this company, with filters and pagination.
Lists the invitations sent to join the account, whatever their status.
Lists the people with access to the account, each with their account_role and, for MEMBERs, the companies (NIFs) granted to them.
Returns the accounts you provisioned, newest first.
Returns the companies (NIFs) belonging to the account in the path, ordered with the primary company first.
Returns a paginated list of the customers of this company, with optional filters.
Returns the delivery attempts of this subscription, newest first.
Returns the emails the system recorded on behalf of the account in the path: invoice deliveries, verification, onboarding.
Returns the PDF templates a NIF can be rendered with.
Returns the invoice series of a company.
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.
Lists the payment events received through the payment provider connection of a NIF (company), most recent first.
Returns a paginated list of the products/services of this company, with optional filters.
Returns the tax regimes and percentages that BeeL accepts on an invoice.
Returns the VeriFactu records of this invoice, each with its own status, ordered by registered_at ascending: the registration first and, if the invoice was voided, its.
Returns the webhook subscriptions of the account in the path, active and inactive alike.
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.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Marks an invoice series as the default of its document type for this company, and unmarks the previous one.
A repeated request may repeat the external action. Review the previous result before retrying a write.
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.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Removes a member's access to the account.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Removes the scheduling of an invoice, returning it to a plain draft.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Reverses a previous discard, bringing a payment event back into the default list.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Returns one member of the account, with the same shape the list returns.
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.
Returns one invitation of the account, with the same shape the list returns.
Re-sends the original payload of a delivery immediately.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Reprocesses a payment event whose automatic invoicing did not complete, applying the configuration of the NIF as it stands now.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Revokes a MEMBER's access to one company.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Revokes a PENDING invitation, so its acceptance link stops working.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Replaces the scheduling of a draft invoice, whether it had one or not, moving it to SCHEDULED.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Sends a synthetic payload to the subscription's URL immediately, outside the normal delivery queue.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Sends the invoice by email, attaching its PDF by default.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Sends one email carrying the PDFs of several invoices of this company as attachments.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Sets the lifecycle status of a recurring invoice template.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Sets the commercial status of an invoice.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Skips the next scheduled invoice generation and advances the generation date to the following period.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Updates the editable fields of a company; the set is the one UpdateCompanyRequest declares.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Updates only the fields present in the body, leaving every other field of the customer as it is.
A repeated request may repeat the external action. Review the previous result before retrying a write.
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.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Updates only the fields present in the body, leaving every other field of the recurring invoice template as it is.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Updates only the fields present in the body, leaving every other field of the invoice as it is.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Updates only the fields present in the body, leaving every other field of the series as it is.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Updates the preferences of the authenticated person.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Updates how the invoices of a company are rendered and delivered: PDF template, accent colour, invoice language and email language.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Updates the auto-invoicing settings of the payment connection named by {connection_id} of a company your account owns or manages.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Updates only the fields present in the body of the scheduling of an invoice that is already SCHEDULED - same convention as PATCH .../{invoice_id} on the invoice itself.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Updates the tax configuration of a company.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Replaces the VeriFactu configuration of a company.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Checks a NIF or CIF against the AEAT register through VeriFactu and returns what the register says about it.
Voids an issued invoice of this company.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
Inspect step outputs and confirm the result in BeeL. A saved workflow is not a completed provider action.
