Centrum Faktur

Ruby client for Centrum Faktur API

Installation

gem install centrum_faktur

Configuration

require "centrum_faktur"

CentrumFaktur.configure do |config|
  config.login     = "your_login"
  config.subdomain = "your-subdomain"
  config.password  = "your-password"
end

Usage

Requests return Array or Hash, where keys are strings. When other format than json (default) or yaml is specified, response is not parsed. So for xml and pickle requests string is returned.

CentrumFaktur::Invoice.show("/api/1.0/invoices/1/", :format => :xml)

Writing invoice to pdf can be done as follows:

File.open("my-invoice.pdf", "w") { |file| file.write(CentrumFaktur::Invoice.show("/api/1.0/invoices/1/", :format => :pdf)) }

All params that respond to strftime (i.e. Date, Time) will be normalized to format required by API, that is: "YYYY-MM-DD"

Account

Only listing accounts is supported via API

CentrumFaktur::Account.list

Comment

Listing all comments:

CentrumFaktur::Comment.list

Or listing comments for given resource:

CentrumFaktur::Comment.list("/api/1.0/estimates/1/comments/")

Creating comment:

You must pass path to resource comment and required attributes:

CentrumFaktur::Comment.create("/api/1.0/estimates/1/comments/", {:body => "cool", :is_public => false})

Estimate

Listing all estimates:

CentrumFaktur::Estimate.list

Monitoring estimate changes (with optional filter param):

CentrumFaktur::Estimate.list_updates(:updated_since => "2012-01-12")

Creating estimate (check required attributes in API description):

CentrumFaktur::Estimate.create({})

Updating estimate:

CentrumFaktur::Estimate.update("/api/1.0/estimates/1/", {})

Removing estimate:

CentrumFaktur::Estimate.destroy("/api/1.0/estimates/1/")

Invoice

Listing all invoices:

CentrumFaktur::Invoice.list

Monitoring invoice changes:

CentrumFaktur::Invoice.list_updates

Displaying invoice:

CentrumFaktur::Invoice.show("/api/1.0/invoices/1/")

Creating invoice (check required attributes in API description):

CentrumFaktur::Invoice.create({})

Updating invoice:

CentrumFaktur::Invoice.update("/api/1.0/invoices/1/", {})

Removing invoice:

CentrumFaktur::Invoice.destroy("/api/1.0/invoices/1/")

User

Only listing users is supported via API

CentrumFaktur::User.list

Continuous Integration

Copyright

Created during development for Ragnarson

Copyright © 2011 Wojciech Wnętrzak. See LICENSE for details.