Official Python client for the Invovate invoice API. Generate PDF, JSON, or UBL 2.1 invoices in 11 languages (incl. Arabic RTL, Japanese, Hindi, Cyrillic) from one call. Zero dependencies (standard library only).
pip install invovateimport os
from invovate import Invovate
# API key is OPTIONAL — JSON totals & PDF hosted-links work without one.
# Free key (inv_…) at https://invovate.com/auth enables direct PDF/UBL bytes.
client = Invovate(api_key=os.environ.get("INVOVATE_API_KEY"))
# 1) Compute totals (no key needed)
totals = client.calculate_totals(
from_={"name": "Acme LLC"},
to={"name": "Globex Corp"},
currency="USD",
items=[{"description": "Consulting", "quantity": 2, "unit_price": 150, "tax_rate": 10}],
)
print(totals["grand_total"]) # 330
# 2) Get a downloadable PDF link (works without a key)
link = client.create_pdf_link(
from_={"name": "Acme BV", "tax_id": "NL0012"},
to={"name": "Client KK"},
language="nl", currency="EUR", template="modern",
items=[{"description": "Onderhoud", "quantity": 1, "unit_price": 450, "tax_rate": 21}],
)
print(link["hosted_url"]) # https://invovate.com/api/i/... (renders the PDF, 7 days)Note:
fromis a Python keyword, so the SDK usesfrom_for the sender party.
pdf = client.create_pdf(from_={"name": "Acme"}, to={"name": "Client"},
items=[{"description": "Work", "quantity": 1, "unit_price": 100}])
open("invoice.pdf", "wb").write(pdf)
xml = client.create_ubl(from_={"name": "Acme"}, to={"name": "Client"},
items=[{"description": "Work", "quantity": 1, "unit_price": 100}])| Method | Returns | Key |
|---|---|---|
calculate_totals(...) |
dict of totals |
no |
create_pdf_link(...) |
{"hosted_url", "invoice"} |
no |
create_pdf(...) |
bytes (PDF) |
yes |
create_ubl(...) |
str (UBL 2.1 XML) |
yes |
batch([...]) |
batch result (≤ 50) | yes |
generate(..., output=, hosted_link=, idempotency_key=) |
low-level | — |
Each method accepts either a full invoice dict or the keyword shortcuts
from_=, to=, items= plus any other fields (currency, language, template,
payment, notes, …). Errors raise InvovateError (.status, .code, .request_id).
- Languages:
en, nl, de, fr, es, it, pt, ar, ja, ru, hi. Templates:classic, modern, bold, minimal, navy. - Not regulated e-invoicing. UBL is for interoperability/archival — no Peppol/Factur-X/XRechnung/NF-e compliance.
- API docs & OpenAPI: https://invovate.com/api · https://invovate.com/openapi.json
- MCP server (for Claude / Cursor AI agents — a separate package): https://www.npmjs.com/package/invovate-mcp-server
- JavaScript / Node SDK: https://www.npmjs.com/package/invovate
- All integrations (n8n, WordPress, Google Sheets, Postman, RapidAPI): https://invovate.com/integrations
- Source: https://github.com/LightSpeedPlusOne/invovate-python · AI-agent guide: https://invovate.com/invoice-api-for-ai-agents
MIT © Invovate