cheddargetter_client_ruby 0.1.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/Gemfile

@@ -0,0 +1,11 @@
+source "http://rubygems.org"
+gem "httparty", ">= 0.4.3"
+
+
+group :development do
+  gem "shoulda", ">= 0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.5.1"
+  gem "rcov", ">= 0"
+  gem "ruby-debug"
+end

data/Gemfile.lock

@@ -0,0 +1,32 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    columnize (0.3.2)
+    crack (0.1.8)
+    git (1.2.5)
+    httparty (0.6.1)
+      crack (= 0.1.8)
+    jeweler (1.5.1)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    linecache (0.43)
+    rake (0.8.7)
+    rcov (0.9.9)
+    ruby-debug (0.10.4)
+      columnize (>= 0.1)
+      ruby-debug-base (~> 0.10.4.0)
+    ruby-debug-base (0.10.4)
+      linecache (>= 0.3)
+    shoulda (2.11.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  httparty (>= 0.4.3)
+  jeweler (~> 1.5.1)
+  rcov
+  ruby-debug
+  shoulda

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2010 Expected Behavior, LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,68 @@
+= Cheddar Getter API Client for Ruby
+
+This is a Ruby wrapper for the CheddarGetter[http://cheddargetter.com] API.  
+It allows you to interface with the Cheddar Getter API using simple calls, i.e.:
+
+    client = CheddarGetter::Client.new(:product_code => "YOUR_PRODUCT_CODE",
+                                       :username => "your.username@example.com",
+                                       :password => "your.password")
+
+    client.new_customer(
+      :code      => 'EXAMPLE_CUSTOMER',
+      :firstName => 'Example',
+      :lastName  => 'Customer',
+      :email     => 'example_customer@example.com',
+      :subscription => {
+        :planCode     => 'THE_PLAN_CODE',
+        :ccFirstName  => 'Example',
+        :ccLastName'  => 'Customer',
+        :ccNumber'    => '4111111111111111',
+        :ccExpiration => '04/2011',
+        :ccZip'       => '90210'
+      }
+    )
+
+See the `example` directory for more usage examples. 
+It is modeled directly after cheddargetter-client-php[https://github.com/marcguyer/cheddargetter-client-php], the official PHP library, with a number of ruby-isms to make life easier.
+
+
+== Installation
+
+This library should be installed as a gem.  It is hosted on Gemcutter[http://gemcutter.org].
+
+If you don't have your system set up to use gemcutter, follow the instructions on their site, i.e.:
+
+    $ gem install gemcutter
+    $ gem tumble
+
+This will install Gemcutter and set your gem sources to search the gemcutter repos.
+
+Then you can install this library as a gem:
+
+    $ gem install cheddargetter_client_ruby
+
+
+=== Requirements
+
+This library requires HTTParty version 0.4.3 or greater.
+
+    $ gem install httparty
+
+
+=== Usage
+
+Simply require this library before you use it:
+
+    require 'cheddargetter_client_ruby'
+    
+
+If you're using Rails, you could include this gem in your configuration, i.e. in `environment.rb`
+
+    config.gem 'cheddargetter_client_ruby'
+
+Check out the example[https://github.com/expectedbehavior/cheddargetter_client_ruby/tree/master/example] to see usage details.  You can also check out the Cheddar Getter API documention[http://cheddargetter.com/developers].
+
+== Copyright
+
+Copyright (c) 2010 Expected Behavior. See LICENSE.txt for further details.
+

data/Rakefile

@@ -0,0 +1,49 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  gem.name = "cheddargetter_client_ruby"
+  gem.homepage = "http://github.com/expectedbehavior/cheddargetter_client_ruby"
+  gem.license = "MIT"
+  gem.summary = "A CheddarGetter API wrapper for Ruby"
+  gem.description = "A CheddarGetter API wrapper for Ruby"
+  gem.email = "support@expectedbehavior.com"
+  gem.authors = ["Expected Behavior"]
+  gem.add_runtime_dependency 'httparty', '>= 0.4.3'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+require 'rcov/rcovtask'
+Rcov::RcovTask.new do |test|
+  test.libs << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "cheddargetter_client_ruby #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/cheddargetter_client_ruby.gemspec

@@ -0,0 +1,79 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{cheddargetter_client_ruby}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Expected Behavior"]
+  s.date = %q{2010-12-09}
+  s.description = %q{A CheddarGetter API wrapper for Ruby}
+  s.email = %q{support@expectedbehavior.com}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "cheddargetter_client_ruby.gemspec",
+    "example/README",
+    "example/example.rb",
+    "lib/cheddar_getter/client.rb",
+    "lib/cheddar_getter/client_exception.rb",
+    "lib/cheddar_getter/response.rb",
+    "lib/cheddar_getter/response_exception.rb",
+    "lib/cheddargetter_client_ruby.rb",
+    "test/helper.rb",
+    "test/test_cheddargetter_client_ruby.rb"
+  ]
+  s.homepage = %q{http://github.com/expectedbehavior/cheddargetter_client_ruby}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{A CheddarGetter API wrapper for Ruby}
+  s.test_files = [
+    "test/helper.rb",
+    "test/test_cheddargetter_client_ruby.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<httparty>, [">= 0.4.3"])
+      s.add_development_dependency(%q<shoulda>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.5.1"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<ruby-debug>, [">= 0"])
+      s.add_runtime_dependency(%q<httparty>, [">= 0.4.3"])
+    else
+      s.add_dependency(%q<httparty>, [">= 0.4.3"])
+      s.add_dependency(%q<shoulda>, [">= 0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.5.1"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<ruby-debug>, [">= 0"])
+      s.add_dependency(%q<httparty>, [">= 0.4.3"])
+    end
+  else
+    s.add_dependency(%q<httparty>, [">= 0.4.3"])
+    s.add_dependency(%q<shoulda>, [">= 0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.5.1"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<ruby-debug>, [">= 0"])
+    s.add_dependency(%q<httparty>, [">= 0.4.3"])
+  end
+end
+

data/example/README

@@ -0,0 +1,9 @@
+The example script requires modification to work for your purposes.  
+
+The username, password and productCode must be customized.
+
+The script makes use of two different pricing plans:
+	* A free plan with code=FREE
+	* A paid plan with code=PREMIUM
+
+You must either create these pricing plans in the CG admin GUI or substitute your own plan codes

data/example/example.rb

@@ -0,0 +1,122 @@
+require 'rubygems'
+require 'cheddargetter_client_ruby'
+
+FREE_PLAN = "FREE"
+PAID_PLAN = "PREMIUM"
+
+client = CheddarGetter::Client.new(:product_code => "YOUR_PRODUCT_CODE",
+                                   :username => "your.username@example.com",
+                                   :password => "your.password")
+
+puts ""
+puts "********************************************************************"
+puts "** DELETING PREVIOUSLY CREATED EXAMPLE CUSTOMERS                  **"
+puts "********************************************************************"
+	
+# delete customers if they're already there
+response = client.delete_all_customers
+if response.valid?
+  puts "\tDeleted old customers"
+else
+  puts "\tERROR: #{response.error_message}"
+end
+	
+puts ""
+puts "********************************************************************"
+puts "** CREATE CUSTOMER ON THE FREE PLAN                               **"
+puts "********************************************************************"
+	
+# create a customer on a free plan
+data = {
+  :code      => 'MILTON_WADDAMS',
+  :firstName => 'Milton',
+  :lastName  => 'Waddams',
+  :email     => 'milt@initech.com',
+  :subscription => { 
+    :planCode => FREE_PLAN
+  }
+}
+
+response = client.new_customer(data)
+if response.valid?
+  puts "\tCreated Milton Waddams with code=MILTON_WADDAMS"
+else
+  puts "\tERROR: #{response.error_message}"
+end
+	
+puts ""
+puts "********************************************************************"
+puts "** SIMULATE ERROR CREATING CUSTOMER ON PAID PLAN                  **"
+puts "********************************************************************"
+	
+# try to create a customer on a paid plan (simulated error)
+data = {
+  :code      => 'BILL_LUMBERG',
+  :firstName => 'Bill',
+  :lastName  => 'Lumberg',
+  :email     => 'bill@initech.com',
+  :subscription => {
+    :planCode     => PAID_PLAN,
+    :ccNumber     => '4111111111111111',
+    :ccExpiration => '10/2014',
+    :ccCardCode   => '123',
+    :ccFirstName  => 'Bill',
+    :ccLastName   => 'Lumberg',
+    :ccZip        => '05003' # simulates an error of "Credit card type is not accepted"
+  }
+}
+
+response = client.new_customer(data)
+if response.valid?
+  puts "\tCreated Bill Lumberg with code=BILL_LUMBERG. (This should not have happened)"
+else
+  puts "\tExpect Error: #{response.error_message}"
+end
+
+puts ""
+puts "********************************************************************"
+puts "** CREATE CUSTOMER ON PAID PLAN AND GET CURRENT                   **"
+puts "** INVOICE INFORMATION                                            **"
+puts "********************************************************************"
+	
+data = {
+  :code      => 'BILL_LUMBERG',
+  :firstName => 'Bill',
+  :lastName  => 'Lumberg',
+  :email     => 'bill@initech.com',
+  :subscription => {
+    :planCode     => PAID_PLAN,
+    :ccNumber     => '4111111111111111',
+    :ccExpiration => '10/2014',
+    :ccCardCode   => '123',
+    :ccFirstName  => 'Bill',
+    :ccLastName   => 'Lumberg',
+    :ccZip        => '90210'
+  }
+}
+
+
+response = client.new_customer(data)
+if response.valid?
+  puts "\tCreated Bill Lumberg with code=BILL_LUMBERG"
+else
+  puts "\tERROR: #{response.error_message}"
+end
+	
+#get lumberg and display current details
+response = client.get_customer(:code => 'BILL_LUMBERG')
+if response.valid?
+  customer     = response.customer
+  subscription = response.customer_subscription
+	plan         = response.customer_plan
+	invoice      = response.customer_invoice
+		
+  puts "\t#{customer[:firstName]} #{customer[:lastName]}"
+	puts "\tPricing Plan: #{plan[:name]}"
+	puts "\tPending Invoice Scheduled: #{invoice[:billingDatetime].strftime('%m/%d/%Y')}"
+  invoice[:charges].each do |charge|
+    puts "\t\t(#{charge[:quantity]}) #{charge[:code]} $#{charge[:eachAmount]*charge[:quantity]}"
+  end
+else
+  puts "\tERROR: #{response.error_message}"
+end	

data/lib/cheddar_getter/client.rb

@@ -0,0 +1,385 @@
+module CheddarGetter
+  class Client
+    include HTTParty
+    
+    base_uri "https://cheddargetter.com/"
+    attr_accessor :product_code, :product_id, :username, :password
+    
+    #options:
+    #
+    #{
+    #  :username     => required, your CheddarGetter username
+    #  :password     => required, your CheddarGetter password
+    #  :product_id   => this or product_code is required
+    #  :product_code => this or product_id is required
+    #}
+    def initialize(options = { })
+      self.product_code = options[:product_code]
+      self.product_id   = options[:product_id]
+      self.username     = options[:username]
+      self.password     = options[:password]
+      
+      raise CheddarGetter::ClientException.new(":username is required") unless self.username
+      raise CheddarGetter::ClientException.new(":password is required") unless self.password
+      unless self.product_code || self.product_id
+        raise CheddarGetter::ClientException.new(":product_code or :product_id are required") 
+      end
+    end
+    
+    #https://cheddargetter.com/developers#all-plans
+    def get_plans
+      do_request(:item => :plans, :action => :get)
+    end
+
+    #https://cheddargetter.com/developers#single-plan
+    #
+    #id_hash: {:code => plan_code} OR {:id => plan_id}
+    def get_plan(id_hash = { })
+      do_request(:item => :plans, :action => :get, :id_hash => id_hash)
+    end
+
+    #https://cheddargetter.com/developers#all-customers
+    #
+    #Any, all, or none of this data hash can be given.
+    #It just filters the returned customers
+    #
+    #data:
+    #
+    #{
+    #  :subscriptionStatus => "activeOnly" or "canceledOnly",
+    #  :planCode           => plan_code, #can take an array of plan codes
+    #  :createdAfterDate	 => date,
+    #  :createdBeforeDate  => date,
+    #  :canceledAfterDate  => date,
+    #  :canceledBeforeDate =>	date,
+    #  :orderBy	           =>	"name" (default), "company", "plan", "billingDatetime" or "createdDatetime"
+    #  :orderByDirection   =>	"asc" (default) or "desc"
+    #  :search             =>	Tcustomer name, company, email address and last four digits of credit card.
+    #}
+    def get_customers(data = nil)
+      do_request(:item => :customers, :action => :get, :data => data)
+    end
+    
+    #https://cheddargetter.com/developers#single-customer
+    #
+    #id_hash: {:code => customer_code} OR {:id => customer_id}
+    def get_customer(id_hash = { })
+      do_request(:item => :customers, :action => :get, :id_hash => id_hash)
+    end
+    
+    #https://cheddargetter.com/developers#add-customer
+    #
+    #data:
+    #
+    #{ 
+    #  :code                 => required,
+    #  :firstName            => required,
+    #  :lastName             => required,
+    #  :email                => required,
+    #  :company              => not_required,
+    #  :isVatExempt          => not_required,
+    #  :vatNumber            => not_required,
+    #  :notes                => not_required,
+    #  :firstContactDatetime => not_required,
+    #  :referer              => not_required,
+    #  :campaignTerm         => not_required,
+    #  :campaignName         => not_required,
+    #  :campaignSource       => not_required,
+    #  :campaignMedium       => not_required,
+    #  :campaignContent      => not_required,
+    #  :metaData => { #not_required
+    #    :any_user_defined_value => not_required
+    #  },
+    #  :subscription => { #required
+    #    :planCode        => required,
+    #    :initialBillDate => not_required,
+    #    :ccNumber        => required_if_not_free,
+    #    :ccExpiration    => required_if_not_free,
+    #    :ccCardCode      => required_if_not_free,
+    #    :ccFirstName     => required_if_not_free,
+    #    :ccLastName      => required_if_not_free,
+    #    :ccCompany       => not_required,
+    #    :ccCountry       => not_required,
+    #    :ccAddress       => not_required,
+    #    :ccCity          => not_required,
+    #    :ccState         => not_required,
+    #    :ccZip           => required_if_not_free
+    #  },
+    #  :charges => { #not required
+    #    :user_defined => { 
+    #      :chargeCode  => required_if_adding_a_charge,
+    #      :quantity    => required_if_adding_a_charge,
+    #      :eachAmount  => required_if_adding_a_charge,
+    #      :description => not_required
+    #    }
+    #  },
+    #  :items => { #not required
+    #    :user_defined => { 
+    #      :itemCode => required_if_setting_an_item,
+    #      :quantity => required_if_setting_an_item
+    #    }
+    #  }
+    #}
+    def new_customer(data = { })
+      do_request(:item => :customers, :action => :new, :data => data)
+    end
+    
+    #https://cheddargetter.com/developers#update-customer-subscription
+    #
+    #id_hash: {:code => customer_code} OR {:id => customer_id}
+    #
+    #data:
+    #
+    #{ 
+    #  :firstName            => not_required,
+    #  :lastName             => not_required,
+    #  :email                => not_required,
+    #  :company              => not_required,
+    #  :isVatExempt          => not_required,
+    #  :vatNumber            => not_required,
+    #  :notes                => not_required,
+    #  :firstContactDatetime => not_required,
+    #  :referer              => not_required,
+    #  :campaignTerm         => not_required,
+    #  :campaignName         => not_required,
+    #  :campaignSource       => not_required,
+    #  :campaignMedium       => not_required,
+    #  :campaignContent      => not_required,
+    #  :metaData => { #not_required
+    #    :any_user_defined_value => not_required
+    #  },
+    #  :subscription => { #not_required
+    #    :planCode        => not_required,
+    #    :changeBillDate  => not_required,
+    #    :ccNumber        => not_required_unless_plan_change_from_free_to_paid,
+    #    :ccExpiration    => not_required_unless_plan_change_from_free_to_paid,
+    #    :ccCardCode      => not_required_unless_plan_change_from_free_to_paid,
+    #    :ccFirstName     => not_required_unless_plan_change_from_free_to_paid,
+    #    :ccLastName      => not_required_unless_plan_change_from_free_to_paid,
+    #    :ccCompany       => not_required,
+    #    :ccCountry       => not_required,
+    #    :ccAddress       => not_required,
+    #    :ccCity          => not_required,
+    #    :ccState         => not_required,
+    #    :ccZip           => not_required_unless_plan_change_from_free_to_paid
+    #  },
+    #}
+    def edit_customer(id_hash = { }, data = { })
+      do_request(:item => :customers, :action => :edit, :id_hash => id_hash, :data => data)
+    end
+    
+    #https://cheddargetter.com/developers#update-customer
+    #
+    #id_hash: {:code => customer_code} OR {:id => customer_id}
+    #
+    #data:
+    #
+    #{ 
+    #  :firstName            => not_required,
+    #  :lastName             => not_required,
+    #  :email                => not_required,
+    #  :company              => not_required,
+    #  :notes                => not_required,
+    #  :metaData => { #not_required
+    #    :any_user_defined_value => not_required
+    #  },
+    #}
+    def edit_customer_only(id_hash = { }, data = { })
+      do_request(:item => :customers, :action => "edit-customer", :id_hash => id_hash, :data => data)
+    end
+    
+    #https://cheddargetter.com/developers#delete-customer
+    #
+    #id_hash: {:code => customer_code} OR {:id => customer_id}
+    def delete_customer(id_hash = { })
+      do_request(:item => :customers, :action => :delete, :id_hash => id_hash)
+    end
+    
+    #https://cheddargetter.com/developers#delete-all-customers
+    def delete_all_customers
+      do_request(:item => :customers, :action => "delete-all/confirm/1")
+    end
+    
+    #https://cheddargetter.com/developers#update-subscription
+    #
+    #id_hash: {:code => customer_code} OR {:id => customer_id}
+    #
+    #data:
+    #
+    #{
+    #  :planCode        => not_required,
+    #  :changeBillDate  => not_required,
+    #  :ccNumber        => not_required_unless_plan_change_from_free_to_paid,
+    #  :ccExpiration    => not_required_unless_plan_change_from_free_to_paid,
+    #  :ccCardCode      => not_required_unless_plan_change_from_free_to_paid,
+    #  :ccFirstName     => not_required_unless_plan_change_from_free_to_paid,
+    #  :ccLastName      => not_required_unless_plan_change_from_free_to_paid,
+    #  :ccCompany       => not_required,
+    #  :ccCountry       => not_required,
+    #  :ccAddress       => not_required,
+    #  :ccCity          => not_required,
+    #  :ccState         => not_required,
+    #  :ccZip           => not_required_unless_plan_change_from_free_to_paid
+    #}
+    def edit_subscription(id_hash = { }, data = { })
+      do_request(:item => :customers, :action => "edit-subscription", :id_hash => id_hash, :data => data)
+    end
+    
+    #https://cheddargetter.com/developers#cancel-subscription
+    #
+    #id_hash: {:code => customer_code} OR {:id => customer_id}
+    def cancel_subscription(id_hash = { })
+      do_request(:item => :customers, :action => :cancel, :id_hash => id_hash)
+    end
+    
+    #https://cheddargetter.com/developers#add-item-quantity
+    #
+    #id_hash: 
+    #
+    #{
+    #  :code => Either code or id are required (this is the customer code)
+    #  :id => Either code or id are required (this is the customer id)
+    #  :item_code => Either item code or item id are required
+    #  :item_id => Either item code or item id are required
+    #}
+    #
+    #data: (not required)
+    #
+    #{ :quantity => treated_as_1_if_not_set }
+    def add_item_quantity(id_hash = { }, data = { })
+      do_request(:item => :customers, :action => "add-item-quantity", :id_hash => id_hash, 
+                 :data => data, :add_item_id => true)
+    end
+    
+    #https://cheddargetter.com/developers#remove-item-quantity
+    #
+    #id_hash: 
+    #
+    #{
+    #  :code => Either code or id are required (this is the customer code)
+    #  :id => Either code or id are required (this is the customer id)
+    #  :item_code => Either item code or item id are required
+    #  :item_id => Either item code or item id are required
+    #}
+    #
+    #data: (not required)
+    #
+    #{ :quantity => treated_as_1_if_not_set }
+    def remove_item_quantity(id_hash = { }, data = { })
+      do_request(:item => :customers, :action => "remove-item-quantity", :id_hash => id_hash, 
+                 :data => data, :add_item_id => true)
+    end
+    
+    #https://cheddargetter.com/developers#set-item-quantity
+    #
+    #id_hash: 
+    #
+    #{
+    #  :code => Either code or id are required (this is the customer code)
+    #  :id => Either code or id are required (this is the customer id)
+    #  :item_code => Either item code or item id are required
+    #  :item_id => Either item code or item id are required
+    #}
+    #
+    #data: { :quantity => required }
+    def set_item_quantity(id_hash = { }, data = { })
+      do_request(:item => :customers, :action => "set-item-quantity", :id_hash => id_hash, 
+                 :data => data, :add_item_id => true)
+    end
+    
+    #https://cheddargetter.com/developers#add-charge
+    #
+    #id_hash: {:code => customer_code} OR {:id => customer_id}
+    #
+    #data:
+    #
+    #{
+    #  :chargeCode  => required,
+    #  :quantity    => required,
+    #  :eachAmount  => required,
+    #  :description => not_required
+    #}
+    def add_charge(id_hash = { }, data = { })
+      do_request(:item => :customers, :action => "add-charge", :id_hash => id_hash, :data => data)
+    end
+    
+    private
+    def get_identifier_string(type, id_hash)
+      code = type ? "#{type}_code".to_sym : :code
+      id = type ? "#{type}_id".to_sym : :id
+      
+      if id_hash[code]
+        str = type ? "#{type}Code" : "code"
+        "/#{str}/#{CGI.escape(id_hash[code].to_s)}"
+      elsif id_hash[id]
+        str = type ? "#{type}Id" : "id"
+        "/#{str}/#{CGI.escape(id_hash[id].to_s)}"
+      else
+        raise CheddarGetter::ClientException.new("Either a :#{code} or :#{id} is required")
+      end
+    end
+    
+    def do_request(options)
+      data = options[:data]
+      deep_fix_request_data!(data)
+      
+      path = "/xml/#{options[:item]}/#{options[:action]}"
+      path += get_identifier_string(nil, options[:id_hash]) if options[:id_hash]
+      path += get_identifier_string("item", options[:id_hash]) if options[:add_item_id]
+      path += if product_code
+                "/productCode/#{CGI.escape(product_code.to_s)}"
+              elsif product_id
+                "/productId/#{CGI.escape(product_id.to_s)}"
+              else
+                raise CheddarGetter::ClientException.new("A product code or id is required to make requests.")
+              end
+      
+      response = if data
+                   CheddarGetter::Client.post(path, :body => data, :basic_auth => { 
+                                                :username => self.username, 
+                                                :password => self.password
+                                              })
+                 else
+                   CheddarGetter::Client.get(path, :basic_auth => { 
+                                               :username => self.username, 
+                                               :password => self.password
+                                             }) 
+                 end
+      
+      CheddarGetter::Response.new(response)
+    end
+    
+    FIX_UP_KEYS = { 
+      :ccExpiration => :month_year,
+      :isVatExempt => :boolean,
+      :initialBillDate => :year_month_day,
+      :createdAfterDate => :year_month_day,
+      :createdBeforeDate => :year_month_day,
+      :canceledAfterDate => :year_month_day,
+      :canceledBeforeDate => :year_month_day
+    }
+    
+    def deep_fix_request_data!(data)
+      if data.is_a?(Array)
+        data.each do |v|
+          deep_fix_request_data!(v) 
+        end
+      elsif data.is_a?(Hash)
+        data.each do |k, v|
+          deep_fix_request_data!(v)
+          type = FIX_UP_KEYS[k]
+          if type
+            data[k] = case type
+                        when :month_year then v.respond_to?(:strftime) ? v.strftime("%m/%Y") : v
+                        when :boolean then v ? "1" : "0"
+                        when :year_month_day then v.respond_to?(:strftime) ? v.strftime("%Y/%m/%d") : v
+                        else v
+                        end
+          end
+        end
+      end
+    end
+    
+  end
+end
+