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.

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 webhook events does BeeL. expose?

Four official events: invoice.emitted (invoice created and finalized), invoice.email.sent (invoice sent by email), invoice.cancelled (invoice cancelled), and verifactu.status.updated (Verifactu status accepted/rejected by AEAT).

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.

Digital Agency

Milestone completed, invoice issued

Plug the BeeL. API into your CRM or project manager. When you mark a deliverable as complete, the invoice is issued, delivered and registered with Verifactu — no one has to open a template.

7 days free · no card · Unlimited sandbox · Compatible with Notion, ClickUp, Monday, Asana and custom

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 automate invoicing at your agency

More creative work, less admin

Agencies live off billable time. Every minute your team spends editing an invoice is a minute they don't spend creating value.

Milestone and deliverable billing

Projects with advance, prototype and final delivery need one invoice per phase. The API emits each one when the milestone is marked done — no forgotten invoices, no mis-copied amounts.

Retainers and recurring services

For monthly maintenance or ongoing services, schedule a cron that calls /invoices on the 1st of every month. Your customers get their invoice on time without anyone remembering.

Subcontracting and collaborators

Invoice the end client for the full project in a single call. If you need it, use multiple API keys to separate legal entities when freelancers have their own billing.

Verifactu included

Every invoice complies with Royal Decree 1007/2023: chained hash, official QR, automatic delivery to the AEAT and verifactu.status.updated webhook to react to the verdict.

Faster cash flow

Cut the time between finishing work and getting paid from days to seconds. The invoice goes out when the milestone closes, not when someone in admin gets to their inbox.

Real-time financial visibility

GET /invoices with filters by customer, date and status. Build internal dashboards showing billed, outstanding and projected revenue without exporting anything to Excel.

Real code

From milestone completed to POST /invoices

The same endpoint works from your Notion webhook, your ClickUp action or your n8n workflow. Pass the milestone data and BeeL. handles the rest.

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. Idempotency-Key = milestone_id to avoid duplicates if the automation retries.

How you integrate the API with your workflow

Connect your CRM or project manager to BeeL. via webhooks, cron jobs or low-code platforms. You can have it running in an afternoon.

1
Define milestones and prices in your CRM
Each project has its own billable milestones (30% advance, 30% prototype, 40% final). You store BeeL.'s customer_id and each milestone's price in your database.
2
Your team marks the milestone as completed
When the deliverable ships, the change fires a webhook or automation (n8n, Make, Zapier) carrying the milestone data — customer_id, amount, description.

The automation calls POST /invoices

Your system makes the REST call to BeeL. with Idempotency-Key = milestone_id. BeeL. creates the invoice, assigns a number and registers it 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
Customer receives the PDF automatically
BeeL. emails a professional PDF with your branding to the customer. They can file it in seconds. You can include a payment link if you use Stripe or similar.
5
Your CRM is updated with the invoice_id
Store the invoice_id in your CRM linked to the milestone for traceability. Your dashboard moves from 'pending' to 'invoiced' and feeds your financial reports.

Frequently asked questions for agencies

The invoice goes out when the milestone closes

Stop wasting hours copying data between your CRM and your invoicing tool. BeeL. handles it — your team invoices from the same button where they mark work as done.

7 days free · no card · Email support

Milestone completed, invoice issued

Plug the BeeL. API into your CRM or project manager. When you mark a deliverable as complete, the invoice is issued, delivered and registered with Verifactu — no one has to open a template.

7 days free · no card · Unlimited sandbox · Compatible with Notion, ClickUp, Monday, Asana and custom

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"

Milestone completed, invoice issued

Milestone and deliverable billing

Retainers and recurring services

Subcontracting and collaborators

Verifactu included

Faster cash flow

Real-time financial visibility

From milestone completed to POST /invoices

How you integrate the API with your workflow

Define milestones and prices in your CRM

Your team marks the milestone as completed

The automation calls POST /invoices

Customer receives the PDF automatically

Your CRM is updated with the invoice_id

Are invoices created via API Verifactu-compliant?

How do I authenticate against the API?

Is there a test environment for the API?

Which webhook events does BeeL. expose?

Which official SDKs are available?

How does API pricing work?

The invoice goes out when the milestone closes

Milestone completed, invoice issued

Milestone and deliverable billing

Retainers and recurring services

Subcontracting and collaborators

Verifactu included

Faster cash flow

Real-time financial visibility

From milestone completed to POST /invoices

How you integrate the API with your workflow

Define milestones and prices in your CRM

Your team marks the milestone as completed

The automation calls POST /invoices

Customer receives the PDF automatically

Your CRM is updated with the invoice_id

Are invoices created via API Verifactu-compliant?

How do I authenticate against the API?

Is there a test environment for the API?

Which webhook events does BeeL. expose?

Which official SDKs are available?

How does API pricing work?

The invoice goes out when the milestone closes