Brivio SDK for Python

Official Python client for the Brivio API — invoicing, e-Factura, contacts, articles and more, for the Romanian market.

pip install brivio

Quick start

from brivio import Brivio

client = Brivio(api_key="brivio_sk_live_…")

# Verify the key and see which organization it belongs to.
print(client.me())

# One page, with pagination metadata.
page = client.contacts.list(search="srl")
print(f"{len(page)} of {page.total} contacts")

# Or walk every page lazily — no manual page arithmetic.
for contact in client.contacts.iterate(search="srl"):
    print(contact["name"])

Invoicing

invoice = client.invoices.create(
    {
        "contactId": "ct_123",
        "currency": "RON",
        "lines": [{"description": "Consultanță", "quantity": 1, "unitPrice": 1000, "vatRate": 21}],
    },
    # Safe to retry: the same key never creates a second invoice.
    idempotency_key="order-42",
)

client.invoices.send(invoice["id"])
client.invoices.submit_efactura(invoice["id"])
print(client.invoices.efactura_status(invoice["id"]))

Errors

Every failure raises BrivioError:

from brivio import Brivio, BrivioError

try:
    client.contacts.create({})
except BrivioError as err:
    print(err.code)     # "VALIDATION_ERROR"
    print(err.status)   # 422
    print(err.details)  # {"name": ["required"]}

status == 0 means the request never reached the API (DNS, connection reset, timeout) rather than the API rejecting it.

Retries and timeouts

Transient failures (429, 502, 503, 504, network errors) are retried automatically — twice by default — with exponential backoff plus jitter, and Retry-After is honoured on 429. Other 4xx responses are not retried: they fail identically every time.

client = Brivio(
    api_key="…",
    max_retries=5,   # 0 disables
    timeout=10.0,    # seconds; 0 disables
    base_url="https://api.brivio.ro/v1",
)

Endpoints without a helper

The typed resources cover the common surface. Anything else is one call away and still gets retries, error mapping and envelope unwrapping:

zones = client.request("GET", "/dns/zones")

Typed models

Generated Pydantic models for every schema in the API live under brivio._generated.models:

from brivio._generated.models.contact import Contact

contact = Contact.from_dict(client.contacts.get("ct_123"))
print(contact.name)

How this SDK is built

Models and operation signatures are generated from the published OpenAPI spec; the transport (retries, errors, pagination, idempotency) is hand-written so every official Brivio SDK behaves identically. See SDK_CONTRACT.md.

Links

• API reference — https://brivio.ro/developers/docs
• Other SDKs — TypeScript, PHP

MIT © Brivio