Are invoices created via API Verifactu-compliant?

Yes, automatically. When you issue an invoice from a Spanish-registered account, BeeL. registers it with the Spanish tax authority (AEAT), generates the official QR code, and notifies you of the status (accepted/rejected) via the verifactu.status.updated webhook. No flags needed in the request body.

Can I migrate my customers from Holded?

Yes. There is a direct import endpoint from Holded that accepts up to 5,000 records per file and 5 imports per hour. You don't need to write any migration code.

How do I authenticate against the API?

Use the Authorization: Bearer header followed by your API key. For example: Authorization: Bearer beel_sk_live_... in production, or beel_sk_test_... in test mode.

Is there a test environment for the API?

Yes. The test environment is enabled by using an API key with the beel_sk_test_ prefix. The base URL is the same as production (https://app.beel.es/api/v1), so you can test the full functionality without emitting real invoices or sending anything to the Spanish tax authority.

Which official SDKs are available?

Node.js / TypeScript is already available. Java and Python are coming soon. In the meantime, you can integrate from any language via direct REST using the OpenAPI 3.0 spec published at docs.beel.es.

How does API pricing work?

Pricing is based on the monthly volume of invoices emitted. Plans range from 50 invoices/month to 5,000. Annual billing offers ~20% off monthly pricing. There is no per-call cost — only emitted invoices count, not test invoices or other endpoints.

CRM / ERP

Add invoicing to your CRM in days, not months

Plug the BeeL. API into your in-house CRM or ERP and get Verifactu, VAT, IRPF and sequential numbering without writing a single line of fiscal logic. Regulatory maintenance included.

7 days free · no card · Unlimited sandbox · REST + OpenAPI 3.0

cURL

curl -X POST https://app.beel.es/api/v1/invoices \
  -H "Authorization: Bearer beel_sk_test_a1b2c3d4e5f6g7h8" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "STANDARD",
    "recipient": { "customer_id": "550e8400-e29b-41d4-a716-446655440000" },
    "lines": [
      {
        "description": "Monthly subscription",
        "quantity": 1,
        "unit_price": 29.00,
        "discount_percentage": 0
      }
    ]
  }'

Why outsource invoicing

Don't build your own fiscal engine

Building invoicing in-house looks simple until you hit Verifactu, credit notes and yearly regulatory changes. BeeL. is the module you buy instead of building.

Full Verifactu compliance

Automatic registration with the AEAT, chained hash per RD 1007/2023, official QR and verifactu.status.updated webhook. No crypto to implement, no XSD to parse.

VAT, IRPF and special regimes

Standard, reduced, super-reduced, exempt, intra-community. IRPF withholdings for professionals and rentals. All computed by the API — your code just sends the lines.

Sequential numbering and series

Separate series for regular, rectifying and simplified invoices. BeeL. handles correct numbering per type, with no gaps and no duplicates.

Professional multi-language PDFs

landingUseCaseCrmErp.features.items.3.description

Integrates with your existing stack

REST + downloadable OpenAPI 3.0. Generate typed clients for TypeScript, Java, Python, Go or Rust. Zero lock-in: the API is standard HTTP/JSON.

Zero regulatory maintenance

When tax law changes (and it does every year), BeeL. updates the API without breaking backwards compatibility. Your code keeps working. No hidden compliance cost.

Real code

One POST /invoices and you're Verifactu-compliant

The same REST call works from any stack. BeeL. handles AEAT registration, the QR and the hash. You only send business data.

cURL

curl -X POST https://app.beel.es/api/v1/invoices \
  -H "Authorization: Bearer beel_sk_test_a1b2c3d4e5f6g7h8" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "STANDARD",
    "recipient": { "customer_id": "550e8400-e29b-41d4-a716-446655440000" },
    "lines": [
      {
        "description": "Monthly subscription",
        "quantity": 1,
        "unit_price": 29.00,
        "discount_percentage": 0
      }
    ]
  }'

Sandbox with beel_sk_test_ prefix. Same base URL in production — just change the key.

How you integrate invoicing into your CRM/ERP

An API-first process that fits any architecture. In a week you'll have the first POST /invoices running in production.

1
Sync your customers to BeeL.
When you create a customer in your CRM, call POST /customers and store the returned customer_id in your table. You keep the source of truth in your system.
2
Optional: map your product catalog
If you use a fixed catalog, create products with POST /products and reuse product_id on each invoice. If you sell ad-hoc services, pass free-form line items directly when invoicing.

Emit invoices from your sales flow

When closing an opportunity in your CRM, call POST /invoices with customer_id + lines + Idempotency-Key = opportunity_id. BeeL. validates, calculates, numbers and registers with Verifactu.

Node.js

import { BeeL } from '@beel_es/sdk';

const beel = new BeeL({ apiKey: process.env.BEEL_API_KEY! });

// Create a draft invoice
const invoice = await beel.invoices.create({
  type: 'STANDARD',
  recipient: { customer_id: '550e8400-e29b-41d4-a716-446655440000' },
  lines: [
    { description: 'Monthly subscription', quantity: 1, unit_price: 29.00, discount_percentage: 0 },
  ],
});

// Issue it to assign an invoice number and trigger VeriFactu
const issued = await beel.invoices.issue(invoice.id);
console.log(issued.invoice_number); // e.g. "A-2026/0001"

4
Download or send the PDF from your UI
landingUseCaseCrmErp.steps.steps.3.description
5
Reporting and reconciliation via API
GET /invoices with filters by customer, date and status feeds your dashboards, financial reports and accounting exports. Data ready for Sage, A3 or Holded.

Frequently asked questions about CRM/ERP integration

Plug-and-play fiscal invoicing

Save 3-6 months of development and avoid the perpetual regulatory maintenance. BeeL. is the invoicing module you connect to your CRM in one afternoon.

7 days free · no card · Email support

curl -X POST https://app.beel.es/api/v1/invoices \ -H "Authorization: Bearer beel_sk_test_a1b2c3d4e5f6g7h8" \ -H "Content-Type: application/json" \ -d '{ "type": "STANDARD", "recipient": { "customer_id": "550e8400-e29b-41d4-a716-446655440000" }, "lines": [ { "description": "Monthly subscription", "quantity": 1, "unit_price": 29.00, "discount_percentage": 0 } ] }'

import { BeeL } from '@beel_es/sdk'; const beel = new BeeL({ apiKey: process.env.BEEL_API_KEY! }); // Create a draft invoice const invoice = await beel.invoices.create({ type: 'STANDARD', recipient: { customer_id: '550e8400-e29b-41d4-a716-446655440000' }, lines: [ { description: 'Monthly subscription', quantity: 1, unit_price: 29.00, discount_percentage: 0 }, ], }); // Issue it to assign an invoice number and trigger VeriFactu const issued = await beel.invoices.issue(invoice.id); console.log(issued.invoice_number); // e.g. "A-2026/0001"

Add invoicing to your CRM in days, not months

Full Verifactu compliance

VAT, IRPF and special regimes

Sequential numbering and series

Professional multi-language PDFs

Integrates with your existing stack

Zero regulatory maintenance

One POST /invoices and you're Verifactu-compliant

How you integrate invoicing into your CRM/ERP

Sync your customers to BeeL.

Optional: map your product catalog

Emit invoices from your sales flow

Download or send the PDF from your UI

Reporting and reconciliation via API

Are invoices created via API Verifactu-compliant?

Can I migrate my customers from Holded?

How do I authenticate against the API?

Is there a test environment for the API?

Which official SDKs are available?

How does API pricing work?

Plug-and-play fiscal invoicing

Add invoicing to your CRM in days, not months

Full Verifactu compliance

VAT, IRPF and special regimes

Sequential numbering and series

Professional multi-language PDFs

Integrates with your existing stack

Zero regulatory maintenance

One POST /invoices and you're Verifactu-compliant

How you integrate invoicing into your CRM/ERP

Sync your customers to BeeL.

Optional: map your product catalog

Emit invoices from your sales flow

Download or send the PDF from your UI

Reporting and reconciliation via API

Are invoices created via API Verifactu-compliant?

Can I migrate my customers from Holded?

How do I authenticate against the API?

Is there a test environment for the API?

Which official SDKs are available?

How does API pricing work?

Plug-and-play fiscal invoicing