Skip to content
Find file
Latest commit 7272218 @badboy Return error if any
Failed to load latest commit information.
contrib Add contrib/.
lib Return error if any
spec VCR macros are deprecated (and were not in use here anyway)
.gitignore Ignore ctags file (but rake-generate it)
.travis.yml CI powered by travis Add rrbone hint.
Gemfile.lock Specify versions in Gemfile
Guardfile Add guard for automated testing.
LICENSE List InvoiceComment in README.
Rakefile Add contrib/.

BadBill - Billomat API Client

(developed for internal use at rrbone)

Simple but working API client for the Billomat API.

See the API documentation for full documentation of all resources.


  • Fast and easy access to all resources the API provides (not all resources are Ruby classes, yet)
  • Full documentation.
  • Test coverage as best as I can.
  • Production-ready (it's for a job project).

What's working right now

The basic BadBill class allows access to all resources. It includes no syntactic sugar to work with, instead it just returns the data as a hash. This works for basic usage.

The following resources are currently implemented as its own class:

Implementing new resources is easy. Pull Requests for others are welcome.



BadBill is just a gem install badbill away. Get an API key for the Billomat API on your profile page.


Basic Usage

bill = "billo", "18e40e14"
# => #<BadBill:0x00000001319d30 ...>
bill.get 'settings'
# => {"settings"=>
#   {"invoice_intro"=>"",
#    "invoice_note"=>"",
#    ...}}
bill.put 'settings', settings: { invoice_intro: "Intro" }
# => {"settings"=>
#   {"invoice_intro"=>"Intro",
#    "invoice_note"=>"",
#    ...}}

Using defined resource classes "billo", "18e40e14"

# => [#<BadBill::Invoice:0x000000024caf98 @id="1" @data={...}>], ...]

invoice = BadBill::Invoice.find(1)
# => {"id"=>"1",
#     "created"=>"2012-09-17T13:58:42+02:00",
#     "invoice_id"=>"322791",
#     "filename"=>"Invoice 322791.pdf",
#     "mimetype"=>"application/pdf",
#     "filesize"=>"90811",
#     "base64file"=>"JVBERi0xLjM..."}
# => true

BadBill::Invoice.create client_id: 1, date: "2012-09-18", note: "Thank you for your order", ...


Documentation is online at

Generate locale documentation with rake doc (yard required). Required Parameters and possible values won't be documentated here. See the API documentation for that.


See for info.


See LICENSE for info.

Something went wrong with that request. Please try again.