BeeL. API

Invoicing API for freelancers and small businesses in Spain with VeriFactu compliance.

Overview

BeeL. is an invoicing platform built for self-employed professionals (autónomos) and small businesses in Spain. The API lets you programmatically manage the full invoice lifecycle — from creation to payment — with built-in VeriFactu compliance.


Base URL	`https://app.beel.es/api/v1`
Auth	API Key via `Authorization: Bearer` header
Format	JSON (REST)
Environments	Production (`beel_sk_live_`) and Sandbox (`beel_sk_test_`) — same base URL, the key determines the environment

Developer Plan required: Full API access, webhooks, and idempotency support are available exclusively with the Developer Plan. Start with a 7-day free trial.

Capabilities

Invoicing

Create, issue, send, and manage standard, corrective, and simplified invoices.

Customers

Full CRUD with bulk operations, CSV import, and Holded migration.

Products

Reusable product and service catalog for faster invoice creation.

Tax Configuration

Configure IVA, IGIC, IPSI, IRPF withholding, and equivalence surcharge defaults.

More Features

Invoice Series

Configurable numbering formats with sequential integrity.

VeriFactu

Automated submission to the Spanish Tax Agency (AEAT) with cryptographic chaining.

PDF & Email

On-demand PDF rendering and direct email delivery to customers.

Stripe Integration

Auto-generate official invoices from Stripe payments.

Webhooks

Real-time notifications for VeriFactu status updates and more.

SDKs

Node.js, Java, and Python SDKs with fluent builders and webhook verification.

Quick Start

# List your invoices
curl https://app.beel.es/api/v1/invoices \
  -H "Authorization: Bearer beel_sk_test_your_key_here"

The Sandbox environment is a full copy of the API with no real fiscal effects — use it freely for development and testing. Invoices created in Sandbox don't count towards your monthly limit.

All creation endpoints support the Idempotency-Key header to prevent duplicates on retries. See the Idempotency guide for details.

Getting Started

Authentication — Get your API Key and make your first authenticated request
Pricing — Choose your Developer Plan tier based on invoice volume
SDKs — Use our Node.js, Java, or Python SDKs for faster integration
Guides — Learn about idempotency, HTTP methods, and fiscal terms
Webhooks — Set up real-time VeriFactu status notifications

Features

🧾 Complete Invoicing

Standard invoices - Regular B2B and B2C invoices
Corrective invoices - Handle refunds and corrections
Simplified invoices - Quick receipts for consumers
Recurring invoices - Schedule automatic invoice generation
Multi-series - Organize invoices by type, client, or project

🇪🇸 Spanish Compliance

VeriFactu - Automatic submission to AEAT (optional until 2027)
Tax support - IVA (21%, 10%, 4%, exempt), IGIC (Canary Islands), IPSI (Ceuta/Melilla), IRPF withholding
NIF/CIF validation - Verify Spanish tax IDs automatically
Equivalence surcharge - Recargo de equivalencia for retailers