NewProvince is only required for addresses in SpainDeprecated routes retire 9 December 2026Read the migration note

Get started Multi-NIF VeriFactu Rules Stripe API reference Changelog

FAQ

The questions integrators ask most — compliance, architecture, VeriFactu, webhooks, integration, sandbox and pricing — each answered in a few lines and linked to the section that explains it in full.

Compliance

Architecture and issuing

VeriFactu

Webhooks

Integration

Sandbox and pricing

Pricing

What the BeeL. API costs per NIF (tax ID), what each plan includes and what it doesn't, the Stripe plan's volume tiers, how billing works, and how to get a custom price for several NIFs.

Overview

The BeeL. developer ecosystem — REST API, SDKs, CLI, n8n node, MCP server, Claude Code plugin and machine-readable docs, all deriving from one OpenAPI contract.

FAQ

Compliance

If I integrate the API, who is the billing system (SIF) and who is its producer?

Who issues and signs the declaración responsable, and where can I get a copy?

Does software built on the API need its own declaración responsable?

Does the business that issues the invoices sign a declaración responsable?

Is BeeL. certified or homologated by AEAT?

Does BeeL. work in VERI*FACTU mode or as a "no VERI*FACTU" system?

Do I or my customers need a digital certificate?

What does BeeL. keep for each invoice, and how do I read it?

Architecture and issuing

Who generates the billing record, its hash and the chain?

Can my POS generate the hash and the chain, and BeeL. only sign and submit?

If the API is unreachable for a couple of hours, can my POS keep issuing?

What happens to my invoices when AEAT is down?

Can invoices carry my customer's identity, with BeeL. invisible to them and to their customers?

Does the API give me the QR or its URL, to print it on my own PDF?

Can one integration issue for many businesses, each with its own NIF, series and numbering?

Does it work with Stripe Connect Express?

VeriFactu

Does the API generate cancellation records and corrective invoices (R1–R5)?

How do I tell a cancellation requested from a cancellation accepted by AEAT?

Can an ACCEPTED invoice be rejected by AEAT later?

Can a REJECTED invoice change later?

Can a NIF issue outside VeriFactu?

What does each new issuer have to sign, and can onboarding be done entirely by API?

Webhooks

How often, and for how long, are failed webhooks retried?

My endpoint was down: how do I recover the events I missed, and until when can I?

Is each automatic webhook retry signed with a fresh timestamp?

Is every VeriFactu status change delivered as a webhook?

Integration

What are the API rate limits, and what happens when I exceed them?

How should I pace a job that polls invoice states?

If my system retries a request, can it issue a duplicate invoice?

Is there a status page?

Sandbox and pricing

Is there a sandbox, and does it cost anything or expire?

Can I build the whole integration in sandbox before going live?

What does the API cost for one NIF, and how many invoices does it include?

How much for several NIFs, for example 20 to 100 issuers?

Are prices with VAT, and is there a minimum commitment?

Do sandbox invoices or drafts count towards the included invoices?

On this page