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
or install it
$ gem install fastbill-automatic
Before working with
Invoice etc. you have to create a working client instance:
require 'fastbill-automatic' ::FastbillAutomatic.client = Client.new("<firstname.lastname@example.org>", "<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.