BeeL Python SDK

Official Python SDK for the BeeL invoicing API. Fully typed.

Installation

pip install beel-sdk

Quick Start

from beel import BeeL

# The client validates your API key on construction
beel = BeeL('beel_sk_live_...')

# List invoices
invoices = beel.invoices.list()

# Get a specific invoice
invoice = beel.invoices.get('550e8400-e29b-41d4-a716-446655440000')

Usage

Invoices

# List with filters
invoices = beel.invoices.list(page=1, limit=20, status='paid')

# Create
from beel_generated.models import CreateInvoiceRequest, CreateInvoiceRequestLinesInner

invoice = beel.invoices.create(CreateInvoiceRequest(
    customer_id='uuid',
    issue_date='2026-03-10',
    lines=[CreateInvoiceRequestLinesInner(
        description='Service',
        quantity=1,
        unit_price=100
    )]
))

# Issue, send, mark paid
beel.invoices.issue('invoice-id')
beel.invoices.send_email('invoice-id', SendEmailRequest(to='client@example.com'))
beel.invoices.mark_paid('invoice-id', MarkInvoicePaidRequest(payment_date='2026-03-10'))

# Download PDF
pdf = beel.invoices.download_pdf('invoice-id')

Customers

customers = beel.customers.list()
created = beel.customers.create(CreateCustomerRequest(name='ACME', nif='B12345678'))
beel.customers.update('id', UpdateCustomerRequest(email='new@acme.com'))
beel.customers.delete('id')

Products

products = beel.products.list()
results = beel.products.search(q='hosting')

Series

series = beel.series.list()
beel.series.set_default('series-id')

Configuration

tax = beel.config.get_tax_configuration()
vf = beel.config.get_verifactu_configuration()

Error Handling

from beel import BeeL, BeeLError

try:
    beel = BeeL('invalid_key')
except BeeLError as e:
    print(e)              # "Invalid API key..."
    print(e.status_code)  # 401

Configuration

# Production (default)
beel = BeeL('beel_sk_live_...')

# Test environment
beel = BeeL('beel_sk_live_...', base_url='https://test.beel.es/api')

# Skip validation
beel = BeeL('beel_sk_live_...', skip_validation=True)

# Context manager
with BeeL('beel_sk_live_...') as beel:
    invoices = beel.invoices.list()

Requirements

• Python 3.9+

Links

• API Reference
• Website
• Support