Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Ruby wrapper for the FastBill Automatic API
Branch: master

bump version

latest commit 3ebf7e01df
Raphael Randschau authored


Ruby wrapper for the FastBill Automatic API, Version 1.5 (05.08.2013). Please note that there are major differences between the Fastbill and Fastbill Automatic API, and this Gem only works for Fastbill Automatic.


Add fastbill-automatic gem to your application's Gemfile

gem 'fastbill-automatic'

or install it

$ gem install fastbill-automatic


Before working with Customer, Invoice etc. you have to create a working client instance:

require 'fastbill-automatic'
::FastbillAutomatic.client ="<>", "<apikey>")

Afterwards you can easily start using all available classes etc.

include ::FastbillAutomatic::Resources
customers = Customer.all()
invoices = Invoice.all()
subscriptions = Subscription.all()

At the time of writing you can use this library to manage customers, create invoices and to create and manage subscriptions. See below for a list of not implemented API features.

A more detailed usage example is included in RDoc.


This gem makes use of the minitest framework and takes advantage of the guard adaption minitest-guard running tests automatically when files are modified. Run all tests with Rake test or run minitest-guard through Bundler with

$ bundle exec guard


This gem is documented using RDoc. You can generated the entire documentation locally using bundle exec rake rdoc.

Contributing to fastbill-automatic

  • Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
  • Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
  • Fork the project.
  • Start a feature/bugfix branch.
  • Make sure to add tests for it.


  • add support for item.get and item.delete. Items are managed by the Invoice right now, and some users might want more granular control.
  • add support for invoice.sign You can not sign your invoice using this gem ATM
  • add support for invoice.sendbypost Invoices can only be delivered by email right now
  • add support for invoice.setpaid


This gem is released under the MIT License.

Something went wrong with that request. Please try again.