Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Python Billomat API Client Library

Project description

Billomat ( Online service for quoting, billing and more.

Invoices, estimates, reminders, credit notes, order confirmations, delivery notes,…

The billomat[API] is an open data and programming interface which enables you to access the data in your Billomat account.

python-billomat can be used in Google App Engine (GAE).


  • Can be used in Google App Engine (GAE)
  • Recurrings
    • Recurring-Items
    • Recurring-Tags
    • Recurring-Email-Receivers
  • Invoices
    • Invoice-Items
    • Invoice-Tags
    • Invoice-Payments
  • Clients
    • Client-Properties
    • Client-Tags
  • Contacts
  • Articles
    • Article-Properties
    • Article-Tags
  • Reminders
    • Reminder-Items
    • Reminder-Tags
  • Email-Templates
  • Reminder-Texts
  • Customfield for metadata for every Billomat object
  • Credit-Notes
    • Credit-Note-Items
    • Credit-Note-Tags


pip install python-billomat



import pybillomat

conn = pybillomat.Connection(
    billomat_id = "<BillomatId>",
    billomat_api_key = "<BillomatApiKey",

# Load one client
client = pybillomat.Client(conn = conn, id = 422909)
print client
# --> Client(id=422909, name=u'TESTFIRMA', ...)

# Iterate over ALL clients.
# It loads the clients gradually. In pages of 30 clients.
clients_iterator = pybillomat.ClientsIterator(conn = conn)
for client in clients_iterator:
    assert isinstance(client, pybillomat.Client)

# Iterate over the first 10 clients
clients_iterator = pybillomat.ClientsIterator(conn = conn, per_page = 10)
for client in clients_iterator[:10]:
    assert isinstance(client, pybillomat.Client)

# Create new client
client = pybillomat.Client.create(
    conn = conn,
    name = u"TEST-CUSTOMER with Umlauts ÖÄÜ",
    zip = u"6020",
    city = u"Innsbruck",
    country_code = u"AT",
    first_name = u"TEST-FIRSTNAME",
    last_name = u"TEST-LASTNAME",
    www = u""
assert isinstance(client, pybillomat.Client)
print, unicode(


import pybillomat

conn = pybillomat.Connection(
    billomat_id = "<BillomatId>",
    billomat_api_key = "<BillomatApiKey",

# Load one invoice
invoice = pybillomat.Invoice(conn = conn, id = 884447)
print invoice
# --> Invoice(address=u'TESTADRESSE', status=u'PAID', ...)

# Iterate over the last 10 invoices
invoices_iterator = pybillomat.InvoicesIterator(conn = conn, per_page = 10) = "id DESC")
for invoice in invoices_iterator[:10]:
    assert isinstance(invoice, pybillomat.Invoice)
    print invoice.invoice_number, invoice.status

# Iterate over all DRAFT-invoices
invoices_iterator = pybillomat.InvoicesIterator(conn = conn) = "DRAFT")
for invoice in invoices_iterator:
    assert isinstance(invoice, pybillomat.Invoice)
    print invoice.label, repr(invoice.address), invoice.open_amount

# Iterate over all DRAFT-invoices and complete all of them
invoices_iterator = pybillomat.InvoicesIterator(conn = conn)

# Search DRAFT-invoices = "DRAFT")
print "Found :", len(invoices_iterator)

# Complete all DRAFT-invoices
for invoice in invoices_iterator:
    assert isinstance(invoice, pybillomat.Invoice)

# Search remaining DRAFT-invoices = "DRAFT")
print "Found:", len(invoices_iterator)


  • GNU Library or Lesser General Public License (LGPL)
  • MIT License

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for python-billomat, version 0.5.2
Filename, size File type Python version Upload date Hashes
Filename, size python_billomat-0.5.2-py2-none-any.whl (82.9 kB) File type Wheel Python version 2.7 Upload date Hashes View
Filename, size python-billomat-0.5.2.tar.gz (45.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page