First-class Developer Experience
Tools, documentation and SDKs designed to make invoicing integration a pleasure, not a headache.
OpenAPI 3.0 Spec
The complete BeeL. API contract. Generate clients, validate requests and document your integration automatically.
Downloadable
Complete spec in YAML. Import into Postman, Insomnia, or generate clients for any language.
Client generation
Use openapi-generator or openapi-typescript to create typed clients automatically from the spec.
Interactive documentation
Test endpoints from the browser, view detailed schemas and copy ready-to-use snippets.
Java
es.beel:beel-sdk
TypeScript
@beel_es/sdk
Python
beel-sdk
SDKs in 3 languages
Official typed clients for Java, TypeScript and Python. Install, configure your API key and invoice.
Full type safety
Autocompletion, strict types and inline documentation in your IDE. No guessing parameters.
Automatic retries
Configurable exponential backoff. If the network fails, the SDK retries without losing data.
Webhook verification
Built-in helpers to validate HMAC-SHA256 signatures in all three languages.
POST /webhooks/beel HTTP/1.1
BeeL-Signature: t=1710...,v1=5257...
{
"event": "invoice.created",
"data": {
"id": "inv_abc123",
"number": "F-2026-0042",
"total": 290.40,
"status": "issued"
}
}Webhooks
Receive real-time notifications when invoices are created, modified or voided.
Real-time events
Receive a POST with invoice data the moment any change occurs.
HMAC-SHA256 signature
Each payload includes a cryptographic signature to verify it comes from BeeL. and hasn't been altered.
Automatic retries
If your server doesn't respond, we retry with exponential backoff up to 3 times.
llms.txt for AI agents
Standard file for any LLM to automatically discover and understand your API.
Complete documentation
The entire API described in AI-readable format: endpoints, authentication, errors, examples.
Compatible with any agent
Claude Code, ChatGPT, Cursor, Copilot — any agent that supports llms.txt.
Always up to date
Auto-generated from the OpenAPI spec. Every change is reflected instantly.
Developer Tools — FAQ frecuentes
Todo lo que necesitas saber sobre BeeL.es y Verifactu
Need help? Contact us
Have doubts? Looking for comfort because you pay too much in taxes?
Same here. 😢
We can't fix your tax return, but we can comfort you (and help with invoicing):
hola@beel.es