API Pricing

BeeL. has two pricing models, one per integration path:

• REST API — pay-as-you-go, priced per NIF (tax ID). This is the plan for integrating invoicing into your own product.
• Stripe connector + dashboard — the no-code path, priced by invoice volume (the Stripe plan).

In both cases the sandbox is free and unlimited, and there is no lock-in. All prices exclude VAT.

API plan (REST) — per-NIF pricing

The API plan is billed per NIF per month, on a graduated scale. You pay 19€/month for the first NIF, and each additional NIF is billed at the rate of the bracket it falls into:

Each NIF includes up to 250 production invoices/month. Beyond that, extra invoices are 0,01€ each. The counter resets on the 1st of each month, per NIF.

Examples

• 1 NIF → 19€/month. 250 production invoices included.
• 3 NIFs → 19€ + 2 × 15€ = 49€/month. 750 invoices included (250 per NIF).
• 10 NIFs → 19€ + 4 × 15€ + 5 × 13€ = 144€/month. 2.500 invoices included.
• 25 NIFs → 19€ + 4 × 15€ + 5 × 13€ + 10 × 10,50€ + 5 × 8€ = 289€/month. 6.250 invoices included.

Need more than 400 NIFs, or a higher included-invoice allowance? Contact us for custom pricing.

Stripe plan (no-code) — volume tiers

If you connect Stripe or invoice from the dashboard instead of integrating the API, billing is by invoice volume rather than per NIF. Annual billing saves ~20%; all prices exclude VAT.

Going over your included volume never interrupts invoicing. Invoices beyond your tier keep being issued normally and are billed automatically at your tier's per-invoice price. Overage is billed monthly — also on annual plans, where it arrives as a separate monthly charge apart from your annual renewal. You'll get an email notice when you reach 80% and 100% of your included volume, and you can follow your usage anytime from Settings → Subscription.

Need more than 5.000 invoices/month? Contact us for custom Enterprise pricing.

How billing works

This section explains the mechanics behind both plans — what counts, how the graduated math computes, and how overage is charged.

What counts as an invoice?

• ✅ Counts: any invoice emitted in the production environment — standard, corrective, simplified, recurring.
• ❌ Doesn't count: draft invoices, sandbox invoices, deleted invoices.
• Allowances and overage reset on the 1st of each month (per NIF on the API plan).

Sandbox invoices are completely free and unlimited — test as much as you need before activating production.

API plan: base + overage

Your monthly API bill is:

1. Per-NIF base — 19€ for the first NIF, plus each additional NIF at its graduated band rate (table above). The rate is marginal: crossing into a cheaper band only lowers the price of the NIFs in that band, not the ones already billed in higher bands.
2. Invoice overage — only for a NIF that exceeds its 250 included production invoices that month, at 0,01€ per extra invoice.

Worked example — 10 NIFs, one of them busy. Base = 19€ + 4 × 15€ + 5 × 13€ = 144€. If one NIF issues 400 production invoices (150 over its 250 allowance), overage = 150 × 0,01€ = 1,50€. That month's bill = 145,50€. The other NIFs' unused allowance is not pooled — each NIF's 250 is independent.

Stripe plan: tier + overage

1. Tier fee — a fixed monthly (or annual) fee for your included volume.
2. Invoice overage — every invoice above your tier's included volume, at that tier's per-invoice rate (0,08€ → 0,02€, cheaper on higher tiers).

Worked example — Pro tier. 64,90€/month includes 1.000 invoices. Issue 1.150 → 150 extra × 0,04€ = 6€ overage → 70,90€ that month. On annual billing the 6€ overage arrives as a separate monthly charge, apart from your annual renewal.

What's Included

Both plans include VeriFactu-compliant invoicing; the API plan adds full programmatic access:

API & Integration

• Full REST API — Complete programmatic access to invoices, customers, products, series, and tax configuration
• Webhooks — Real-time notifications for invoice events and VeriFactu status updates
• Sandbox environment — Isolated test environment with no fiscal effects, free and unlimited
• Idempotency support — Safe request retries with Idempotency-Key header
• Multi-NIF — Operate on any owned company (NIF) from one API key via the Beel-Active-Company header — see the Multi-NIF guide
• OpenAPI 3.0 specification — Auto-generate clients in any language
• Official SDKs — Node.js (available now); Java and Python coming soon

Invoicing Features

• Electronic invoicing — VeriFactu compliance with AEAT
• Professional PDFs — Automatic generation with customizable templates
• Email delivery — Send invoices directly to customers
• Multiple invoice series — Organize invoices by type or client
• Recurring & scheduled invoices — Automate generation and future emission dates
• Corrective invoices — Handle refunds and corrections

Data & Support

• Unlimited customers and products
• NIF/CIF validation — Automatic Spanish tax ID verification
• Bulk imports — CSV upload
• Priority email support — it@beel.es

Rate Limits

API requests are rate-limited per API key:

See the Rate Limits guide for response headers and best practices. Need higher limits? Contact us at it@beel.es.

Webhooks

Webhooks are included at no additional cost.

Available events:

• invoice.emitted — Invoice created and finalized
• invoice.email.sent — Invoice sent by email
• invoice.cancelled — Invoice cancelled
• verifactu.status.updated — VeriFactu registration accepted/rejected by AEAT

See the Webhooks documentation for setup and payload details.

Enterprise & custom pricing

For more than 400 NIFs, more than 5.000 invoices/month, or a higher included-invoice allowance, we offer:

• Custom pricing based on volume
• Dedicated support with SLA guarantees
• Custom integrations and development

Contact us at it@beel.es to discuss your needs.

Next Steps

1. Start in sandbox — free and unlimited, no card required
2. Set up authentication — Get your API key
3. Explore the SDKs — Node.js, Java, and Python
4. Set up webhooks — Get real-time notifications

Questions? Email us at it@beel.es.