infusionsoft 1.0.2

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+log/*.log
+tmp/**/*
+.DS_Store
+rdoc/

data/LICENSE.md

@@ -0,0 +1,21 @@
+Copyright (c) 2011 Nathan Leavitt & Infused Systems
+
+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.md

@@ -0,0 +1,100 @@
+# The Infusionsoft Ruby Gem
+A Ruby wrapper for the Infusionsoft API
+
+## <a name="installation">Installation</a>
+    gem install infusionsoft
+
+## <a name="documentation">Documentation</a>
+documentation link here
+
+## <a name="setup">Setup & Configuration</a>
+For Rails, create an initilizer in `config\initilizers` called infusionsoft.rb and the following
+
+    Infusionsoft.configure do |config|
+      config.api_url = 'YOUR_INFUSIONSOFT_URL' # example infused.infusionsoft.com
+      config.api_key = 'YOUR_INFUSIONSOFT_API_KEY'
+    end
+
+## <a name="examples">Usage Examples</a>
+
+    # Get a users first and last name using the DataService
+    Infusionsoft.data_load('Contact', contact_id, [:FirstName, :LastName])
+
+    # Update a contact with specific field values 
+    Infusionsoft.contact_upudate(contact_id, { :FirstName => 'first_name', :Email => 'test@test.com' })
+
+    # Add a new Contact
+    Infusionsoft.contact_add({:FirstName => 'first_name', :LastName => 'last_name', :Email => 'test@test.com'})
+
+    # Create a blank Invoice
+    invoice_id = Infusionsoft.invoice_create_blank_order(contact_id, description, Date.today, lead_affiliate_id, sale_affiliate_id)
+
+    # Then add item to invoice
+    Infusionsoft.invoice_add_order_item(invoice_id, product_id, product_type, amount, quantity, description_here, notes)
+
+    # Then charge the invoice
+    Infusionsoft.invoice_charge_invoice(invoice_id, notes, credit_card_id, merchange_id, bypass_commissions)
+
+
+## <a name="contributing">Contributing</a>
+In the spirit of [free software](http://www.fsf.org/licensing/essays/free-sw.html), **everyone** is encouraged to help improve this project.
+
+Here are some ways *you* can contribute:
+
+* by using alpha, beta, and prerelease versions
+* by reporting bugs
+* by suggesting new features
+* by writing or editing documentation
+* by writing specifications
+* by writing code (**no patch is too small**: fix typos, add comments, clean up inconsistent whitespace)
+* by refactoring code
+* by closing [issues](https://github.com/nateleavitt/infusionsoft/issues)
+* by reviewing patches
+
+## <a name="issues">Submitting an Issue</a>
+We use the [GitHub issue tracker](https://github.com/nateleavitt/infusionsoft/issues) to track bugs and
+features. Before submitting a bug report or feature request, check to make sure it hasn't already
+been submitted. You can indicate support for an existing issuse by voting it up. When submitting a
+bug report, please include a [Gist](https://gist.github.com/) that includes a stack trace and any
+details that may be necessary to reproduce the bug, including your gem version, Ruby version, and
+operating system. Ideally, a bug report should include a pull request with failing specs.
+
+## <a name="pulls">Submitting a Pull Request</a>
+1. Fork the project.
+2. Create a topic branch.
+3. Implement your feature or bug fix.
+4. Add documentation for your feature or bug fix.
+5. Run <tt>bundle exec rake doc:yard</tt>. If your changes are not 100% documented, go back to step 4.
+6. Add specs for your feature or bug fix.
+7. Run <tt>bundle exec rake spec</tt>. If your changes are not 100% covered, go back to step 6.
+8. Commit and push your changes.
+9. Submit a pull request. Please do not include changes to the gemspec, version, or history file. (If you want to create your own version for some reason, please do so in a separate commit.)
+
+## <a name="rubies">Supported Rubies</a>
+This library aims to support the following Ruby implementations:
+
+* Ruby 1.8.7
+* Ruby 1.9.1
+* Ruby 1.9.2
+* [JRuby](http://www.jruby.org/)
+* [Rubinius](http://rubini.us/)
+* [Ruby Enterprise Edition](http://www.rubyenterpriseedition.com/)
+
+If something doesn't work on one of these interpreters, it should be considered
+a bug.
+
+This library may inadvertently work (or seem to work) on other Ruby
+implementations, however support will only be provided for the versions listed
+above.
+
+If you would like this library to support another Ruby version, you may
+volunteer to be a maintainer. Being a maintainer entails making sure all tests
+run and pass on that implementation. When something breaks on your
+implementation, you will be personally responsible for providing patches in a
+timely fashion. If critical issues for a particular implementation exist at the
+time of a major release, support for that Ruby version may be dropped.
+
+## <a name="copyright">Copyright</a>
+Copyright (c) 2011 Nathan Leavitt & Infused Systems
+See [LICENSE](https://github.com/nateleavitt/infusionsoft/blob/master/LICENSE.md) for details.
+

data/infusionsoft.gemspec

@@ -0,0 +1,18 @@
+# encoding: utf-8
+require File.expand_path('../lib/infusionsoft/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.name = 'infusionsoft'
+  gem.summary = %q{Ruby wrapper for the Infusionsoft API}
+  gem.description = 'A Ruby wrapper written for the Infusionsoft API'
+  gem.authors = ["Nathan Leavitt"]
+  gem.email = ['nate@infusedsystems.com']
+  gem.executables = `git ls-files -- bin/*`.split("\n").map{|f| File.basename(f)}
+  gem.files = `git ls-files`.split("\n")
+  gem.homepage = 'https://github.com/nateleavitt/infusionsoft'
+  gem.require_paths = ['lib']
+  gem.required_rubygems_version = Gem::Requirement.new('>= 1.3.6')
+
+  gem.version = Infusionsoft::VERSION.dup
+end
+

data/lib/infusionsoft.rb

@@ -0,0 +1,27 @@
+require 'infusionsoft/api'
+require 'infusionsoft/client'
+require 'infusionsoft/configuration'
+#require 'api_infusionsoft/error'
+
+module Infusionsoft
+  extend Configuration
+  class << self
+    # Alias for Infusionsoft::Client.new
+    #
+    # @return [Infusionsoft::Client]
+    def new(options={})
+      Infusionsoft::Client.new(options)
+    end
+
+    # Delegate to ApiInfusionsoft::Client
+    def method_missing(method, *args, &block)
+      return super unless new.respond_to?(method)
+      new.send(method, *args, &block)
+    end
+
+    def respond_to?(method, include_private = false)
+      new.respond_to?(method, include_private) || super(method, include_private)
+    end
+  end
+end
+

data/lib/infusionsoft/api.rb

@@ -0,0 +1,22 @@
+require 'infusionsoft/configuration'
+require 'infusionsoft/connection'
+require 'infusionsoft/request'
+
+module Infusionsoft
+
+  class Api
+    include Connection
+    include Request
+
+    attr_accessor *Configuration::VALID_OPTION_KEYS
+
+    def initialize(options={})
+      options = Infusionsoft.options.merge(options)
+      Configuration::VALID_OPTION_KEYS.each do |key|
+        send("#{key}=", options[key])
+      end
+    end
+
+  end
+
+end

data/lib/infusionsoft/client.rb

@@ -0,0 +1,25 @@
+module Infusionsoft
+  # Wrapper for the Infusionsoft API
+  #
+  # @note all services have been separated into different modules
+  class Client < Api
+    # Require client method modules after initializing the Client class in
+    # order to avoid a superclass mismatch error, allowing those modules to be
+    # Client-namespaced.
+    require 'infusionsoft/client/contact'
+    require 'infusionsoft/client/email'
+    require 'infusionsoft/client/invoice'
+    require 'infusionsoft/client/data'
+    require 'infusionsoft/client/affiliate'
+    require 'infusionsoft/client/file'
+    require 'infusionsoft/client/ticket'
+
+    include Infusionsoft::Client::Contact
+    include Infusionsoft::Client::Email
+    include Infusionsoft::Client::Invoice
+    include Infusionsoft::Client::Data
+    include Infusionsoft::Client::Affiliate
+    include Infusionsoft::Client::File
+    include Infusionsoft::Client::Ticket
+  end
+end

data/lib/infusionsoft/client/affiliate.rb

@@ -0,0 +1,52 @@
+module Infusionsoft
+  class Client
+    ########################
+    ### Affiliate Service ##
+    ########################
+    module Affiliate
+      # return all claw backs in a date range
+      #
+      # @affiliate_id [Integer]
+      # @start_date [Date]
+      # @end_date [Date]
+      def affiliate_clawbacks(affiliate_id, start_date, end_date)
+        response = get('APIAffiliateService', 'affClawbacks', affiliate_id, start_date, end_date)
+      end
+
+      # return all commissions in a date range
+      #
+      # @affiliate_id [Integer]
+      # @start_date [Date]
+      # @end_date [Date]
+      def affiliate_commissions(affiliate_id, start_date, end_date)
+        response = get('APIAffiliateService', 'affCommissions', affiliate_id, start_date, end_date)
+      end
+
+      # return all payouts in a date range
+      #
+      # @affiliate_id [Integer]
+      # @start_date [Date]
+      # @end_date [Date]
+      def affiliate_payouts(affiliate_id, start_date, end_date)
+        response = get('APIAffiliateService', 'affPayouts', affiliate_id, start_date, end_date)
+      end
+
+      # returns a list with each row representing a single affiliates totals represented by a map with key
+      # one of the names above, and value being the total for the variable
+      #
+      # @affiliate_list [Array]
+      def affiliate_running_totals(affiliate_list)
+        response = get('APIAffiliateService', 'affRunningTotals', affiliate_list)
+      end
+
+      # return how much the specified affiliates are owed
+      #
+      # @affiliate_list [Array]
+      # @start_date [Date]
+      # @end_date [Date]
+      def affiliate_summary(affiliate_list, start_date, end_date)
+        response = get('APIAffiliateService', 'affSummary', affiliate_list, start_date, end_date)
+      end
+    end
+  end
+end

data/lib/infusionsoft/client/contact.rb

@@ -0,0 +1,143 @@
+module Infusionsoft
+  class Client
+    ########################  
+    ### Contact Service  ###
+    ########################
+    module Contact
+      # Finds all contacts with the supplied email address in any of the three contact record email addresses
+      #
+      # @email [String]
+      # @selected_fields [Array]
+      def contact_find_by_email(email, selected_fields)
+        response = get('ContactService.findByEmail', email, selected_fields)
+      end
+
+      # Adds a contact to the database, then opts in the email address
+      #
+      # @data = [Hash]
+      # @example data = {:EmailAddress1 => 'test@test.com', :FirstName => 'first_name', :LastName => 'last_name'}
+      # @returns [Integer] This is the id of the newly added contact
+      def contact_add(data)
+        contact_id = get('ContactService.add', data)
+        if data.has_key?("Email"); api_email_optin(data["Email"], "requested information"); end
+        return contact_id
+      end
+
+      # Creates a new recurring order for a contact.
+      #
+      # @contact_id [Integer]
+      # @allow_duplicate [Boolean]
+      # @cprogram_id [Integer]
+      # @merchante_account_id [Integer]
+      # @credit_card_id [Integer]
+      # @affiliate_id [Integer]
+      def contact_add_recurring_order(contact_id, allow_duplicate, cprogram_id, merchant_account_id, credit_card_id, affiliate_id,
+                            days_till_charge)
+        response = get('ContactService','addRecurringOrder', contact_id, allow_duplicate, cprogram_id, 
+                            merchant_account_id, credit_card_id, affiliate_id, days_till_charge)
+      end
+
+      # Adds a contact to a group
+      #
+      # @contact_id [Integer]
+      # @group_id [Integer]
+      def contact_add_to_group(contact_id, group_id)
+        response = get('ContactService', 'addToGroup', contact_id, group_id)
+      end
+
+      def contact_link_contact(remoteApp, remoteId, localId)
+        response = get('ContactService', 'linkContact', remoteApp, remoteId, localId)
+      end
+
+      # Loads a contact from the database
+      #
+      # @id [Integer]
+      # @selected_fields [Array]
+      def contact_load(id, selected_fields)
+        response = get('ContactService', 'load', id, selected_fields)
+      end
+
+      def contact_locate_contact_link(locate_map_id)
+        response = get('ContactService', 'locateContactLink', locate_map_id)
+      end
+
+      def contact_mark_link_updated(locate_map_id)
+        response = get('ContactService', 'markLinkUpdated', locate_map_id)
+      end
+
+      # Adds a contact to a campaign.
+      #
+      # @contact_id [Integer]
+      # @campaign_id [Integer]
+      def contact_add_to_campaign(contact_id, campaign_id)
+        response = get('ContactService','addToCampaign', contact_id, campaign_id)
+      end
+
+      # Pauses a campaign for a given contact.
+      #
+      # @contact_id [Integer]
+      # @campaign_id [Integer]
+      def contact_pause_campaign(contact_id, campaign_id)
+        response = get('ContactService', 'pauseCampaign', contact_id, campaign_id)
+      end
+
+      # Removes a contact from a given campaign.
+      #
+      # @contact_id [Integer]
+      # @campaign_id [Integer]
+      def contact_remove_from_campaign(contact_id, campaign_id)
+        response = get('ContactService', 'removeFromCampaign', contact_id, campaign_id)
+      end
+
+      # returns the next step in a campaign
+      #
+      # @contact_id [Integer]
+      # @campaign_id [Integer]
+      def contact_get_next_campaign_step(contact_id, campaign_id)
+        response = get('ContactService', 'getNextCampaignStep', contact_id, campaign_id)
+      end
+
+      # Reschedules a campaign step for a list of contacts
+      #
+      # @list_of_contacts [Array]
+      # @campaign_id [Integer]
+      def contact_reschedule_campaign_step(list_of_contacts, campaign_id)
+        response = get('ContactService', 'reschedulteCampaignStep', list_of_contacts, campaign_id)
+      end
+
+      # Removes a contact from a given group.
+      #
+      # @contact_id [Integer]
+      # @group_id [Integer]
+      def contact_remove_from_group(contact_id, group_id)
+        response = get('ContactService', 'removeFromGroup', contact_id, group_id)
+      end
+
+      # Executes an action sequence for a given contact
+      def contact_run_action_set(contact_id, action_set_id)
+        response = get('ContactService', 'runActionSequence', contact_id, action_set_id)
+      end
+
+      # Executes an action sequence for a given contact, passing in
+      # runtime params for running affiliate signup actions, etc
+      #
+      # @contact_id [Integer]
+      # @action_set_id [Integer]
+      # @params [Hash]
+      def contact_run_action_set_with_params(contact_id, action_set_id, params)
+        response = get('ContactService', 'runActionSequence', contact_id, action_set_id, params)
+      end
+
+      # Updates a contact in the database.
+      #
+      # @contact_id [Integer]
+      # @data [Hash]
+      # @example {:FirstName => 'first_name', :StreetAddress1 => '123 N Street'}
+      def contact_update(contact_id, data)
+        bool = get('ContactService', 'update', contact_id, data)
+        if data.has_key?("Email"); api_email_optin(data["Email"], "requested information"); end
+        return bool
+      end
+    end
+  end
+end

data/lib/infusionsoft/client/data.rb

@@ -0,0 +1,90 @@
+module Infusionsoft
+  class Client
+    ########################
+    ###   Data Service   ###
+    ########################
+    module Data
+      # Adds a record to the database. If you attempt to set fields that are marked read-only
+      # by the Data Spec, this operation will simply ignore those fields - not throw an error
+      #
+      # @table [String]
+      # @values [Hash]
+      def data_add(table, values)
+        response = get('DataService.add', table, values)
+      end
+
+      # This will locate all records in a given table that match the criteria for a given field.
+      #
+      # @table [String]
+      # @limit [Integer]
+      # @page [Integer]
+      # @field_name [String]
+      # @field_value [String]
+      # @selected_fields [Array]
+      def data_find_by_field(table, limit, page, field_name, field_value, selected_fields)
+        response = get('DataService.findByField', table, limit, page, field_name,
+                       field_value, selected_fields)
+      end
+
+      # This method will load a record from the database given the primary key
+      #
+      # @table [String]
+      # @id [Integer]
+      # @selected_fields [Array]
+      def data_load(table, id, selected_fields)
+        response = get('DataService.load', table, id, selected_fields)
+      end
+
+      # Queries records in a given table to find matches on certain fields
+      #
+      # @table [String]
+      # @limit [Integer]
+      # @page [Integer]
+      # @data [Hash] The data you would like to query on. { :FirstName => 'first_name' }
+      # @selected_fields [Array]
+      def data_query(table, limit, page, data, selected_fields)
+        response = get('DataService.query', table, limit, page, data, selected_fields)
+      end
+
+      # Updates a given record to the database
+      #
+      # @table [String]
+      # @id [Integer]
+      # @values [Hash] This is the fields and values you would like to update
+      # @example { :FirstName => 'first_name', :EmailAddress1 => 'test@test.com' }
+      def data_update(table, id, values)
+        response = get('DataService.update', table, id, values)
+      end
+
+      # Adds a custom field to Infusionsoft
+      #
+      # @context [String]
+      # @label [String]
+      # @data_type [String]
+      # @group_id [Integer]
+      def data_add_custom_field(context, label, data_type, group_id)
+        response = get('DataService.addCustomField', context, label, data_type, group_id)
+      end
+
+      # Updates a custom field
+      #
+      # @field_id [Integer]
+      # @field_value
+      def data_update_custom_field(field_id, field_value)
+        response = get('DataService.updateCustomField', field_id, field_value)
+      end
+
+      # Authenticates a user account in Infusionsoft
+      #
+      # @username [String]
+      # @password [String]
+      def data_authenticate_user(username, password)
+        response = get('DataService.authenticateUser', username, password)
+      end
+
+      def data_echo(text)
+        response = get('DataService.echo', text)
+      end
+    end
+  end
+end

data/lib/infusionsoft/client/email.rb

@@ -0,0 +1,91 @@
+module Infusionsoft
+  class Client
+    ########################
+    ###  Email Service   ###
+    ########################
+    module Email
+      # Enables you to opt contacts in
+      #
+      # @email [String]
+      # @reason [String]
+      def email_optin(email, reason)
+        response = get('APIEmailService', 'optIn', email, reason)
+      end
+
+      # Enables you to opt contacts out
+      #
+      # @email [String]
+      # @reason [String]
+      def email_optout(email, reason)
+        response = get('APIEmailService', 'optOut', email, reason)
+      end
+
+      # Sends an email through infusion
+      #
+      # @contact_list [Array] List of contact ids you want to send this email to
+      # @from_address [String]
+      # @to_address [String]
+      # @cc_address [String]
+      # @bcc_address [String]
+      # @content_type [String] this must be one of the following Text, HTML, or Multipart
+      # @subject [String]
+      # @html_body [Text]
+      # @text_body [Text]
+      def email_send(contact_list, from_address, to_address, cc_addresses, bcc_addresses, content_type, subject, html_body, text_body)
+        response = get('APIEmailService', 'sendEmail', contact_list, from_address, to_address, cc_addresses, bcc_addresses, content_type, subject, html_body, text_body)
+      end
+
+      # adds an email template for future use
+      #
+      # @title [String]
+      # @categories [String] a comma separated list of the categories you wan this template in Infusionsoft
+      # @content_type [String] can be Text, HTML, Multipart
+      # @text_body [Text]
+      # @html_body [Text]
+      # @merge_context [String] can be Contact, ServiceCall, Opportunity, CreditCard
+      def email_add(title, categories, from, to, cc, bcc, subject, text_body, html_body, content_type, merge_context)
+        response = get('APIEmailService', 'addEmailTemplate', title, categories, from, to, cc, bcc, subject, text_body, html_body, content_type, merge_context)
+      end
+
+      # Attaches an email to a contact record
+      def email_attach(contact_id, from_name, from_address, to_address, cc_addresses, bcc_addresses, content_type, subject, html_body, txt_body, header, receive_date, send_date)
+        response = get('APIEmailService', 'attachEmail', contact_id, from_name, from_address, to_address, cc_addresses, bcc_addresses, content_type, subject, html_body, txt_body, header, receive_date, send_date)
+      end
+
+      # Creates an email template
+      def email_create_template(title, user_id, from_address, to_addres, cc_addresses, bcc_addresses, content_type, subject, html_body, txt_body)
+        response = get('APIEmailService', 'createEmailTemplate', title, user_id, from_address, to_addres, cc_addresses, bcc_addresses, content_type, subject, html_body, txt_body)
+      end
+
+      # updates an email template for future use
+      #
+      # @categories [String] a comma separated list of the categories you wan this template in Infusionsoft
+      # @content_type [String] can be Text, HTML, Multipart
+      # @merge_context [String] can be Contact, ServiceCall, Opportunity, CreditCard
+      def email_update_template(id, title, categories, from, to, cc, bcc, subject, text_body, html_body, content_type, merge_context)
+        response = get('APIEmailService', 'updateEmailTemplate', title, categories, from, to, cc, bcc, subject, text_body, html_body, content_type)
+      end
+
+      # returns an email template
+      def email_get_template(id)
+        response = get('APIEmailService', 'getEmailTemplate', id)
+      end
+
+      # gets the opt-in status of the provided email address
+      #
+      # email_address [String]
+      # @returns 0 = opted out; 1 = single opt-in; 2 = double opt-in
+      def email_get_opt_status(email_address)
+        response = get('APIEmailService', 'getOptStatus', email_address)
+      end
+
+      # returns a string of merge fields for a given context
+      #
+      # @merge_context [String] could include Contact, ServiceCall, Opportunity, CreditCard
+      def email_get_available_merge_fields(merge_context)
+        response = get('APIEmailService', 'getAvailableMergeFields', merge_context)
+      end
+
+    end
+  end
+end

data/lib/infusionsoft/client/file.rb

@@ -0,0 +1,29 @@
+module Infusionsoft
+  class Client
+    ########################
+    ###  File Service  ###
+    ########################
+    module File
+      def file_upload(contact_id, file_name, encoded_file_base64)
+        response = get('FileService', 'uploadFile', contact_id, file_name, encoded_file_base64)
+      end
+
+      # returns the Base64 encoded file contents
+      def file_get(id)
+        response = get('FileService', 'getFile', id)
+      end
+
+      def file_url(id)
+        response = get('FileService', 'getDownloadUrl', id)
+      end
+
+      def file_rename(id, new_name)
+        response = get('FileService', 'renameFile', id, new_name)
+      end
+
+      def file_replace(id, encoded_file_base64)
+        response = get('FileService', 'replaceFile', id, encoded_file_base64)
+      end
+    end
+  end
+end

data/lib/infusionsoft/client/invoice.rb

@@ -0,0 +1,128 @@
+module Infusionsoft
+  class Client
+    ########################  
+    ### Invoice Service  ###
+    ########################
+    module Invoice
+      def invoice_update_recurring_next_bill_date(job_recurring_id, new_bill_date) 
+        response = get('InvoiceService', 'updateJobRecurringNextBillDate', job_recurring_id, new_bill_date)
+      end
+
+      # Adds a payment to an invoice without actually processing a charge through a merchant. 
+      #
+      # @invoice_id [Integer]
+      # @amount [Float]
+      # @date [Date]
+      # @type [String] Cash, Check, Credit Card, Money Order, PayPal, etc.
+      # @description [String]
+      # @bypass_commissions [Boolean]
+      # @return [Boolean]
+      def invoice_add_manual_payment(invoice_id, amount, date, type, description, bypass_commissions)
+        response = get('InvoiceService', 'addManualPayment', invoice_id, amount, date, type, 
+                       description, bypass_commissions)
+      end
+
+      # Adds a commission override to a one time order, using a combination of percentage and hard-coded amounts.
+      def invoice_add_order_commission_override(invoice_id, affiliate_id, product_id, percentage, amount, payout_type, 
+                                     description, date)
+        response = get('InvoiceService', 'addOrderCommissionOverride', invoice_id, affiliate_id, product_id, 
+                       percentage, amount, payout_type, description, date)
+      end
+
+      # Adds an item to an existing order.
+      #
+      # @order_id [Integer] This is the invoice id
+      # @product_id [Integer]
+      # @type [Integer] UNKNOWN = 0, SHIPPING = 1, TAX = 2, SERVICE = 3, PRODUCT = 4, UPSELL = 5, FINANCECHARGE = 6, SPECIAL = 7
+      # @price [Float]
+      # @quantity [Integer]
+      # @description [String]
+      # @notes [String]
+      # @return [Boolean] returns true or false if it was added successfully or not
+      def invoice_add_order_item(order_id, product_id, type, price, quantity, description, notes)
+        response = get('InvoiceService', 'addOrderItem', order_id, product_id, type, price,
+                       quantity, description, notes)
+      end
+
+      # Adds a payment plan to an existing invoice.
+      def invoice_add_payment_plan(order_id, auto_charge, credit_card_id, merchant_account_id, days_between_retry, max_retry,
+                         initial_payment_amount, plan_start_date, number_of_payments, days_between_payments)
+        response = get('InvoiceService', 'addPaymentPlan', order_id, auto_charge, credit_card_id, merchant_account_id, 
+                       days_between_retry, max_retry, initial_payment_amount, plan_start_date, number_of_payments, 
+                       days_between_payments)
+      end
+
+      # Adds a commission override to a recurring order.
+      def invoice_add_recurring_commission_override(recurringorder_id, affiliate_id, amount, payout_type, description)
+        response = get('InvoiceService', 'addRecurringCommissionOverride', recurringorder_id, affiliate_id, amount, 
+                       payout_type, description)
+      end
+
+      # Adds a recurring order to the database.
+      def invoice_add_recurring_order(contact_id, allow_duplicate, cprogram_id, merchant_account_id, credit_card_id, affiliate_id,
+                            days_till_charge)
+        response = get('InvoiceService', 'addRecurringOrder', contact_id, allow_duplicate, cprogram_id, 
+                       merchant_account_id, credit_card_id, affiliate_id, days_till_charge)
+      end
+      
+      # Adds a recurring order to the database.
+      def invoice_add_recurring_order_with_price(contact_id, allow_duplicate, cprogram_id, qty, price, allow_tax, merchant_account_id, credit_card_id, affiliate_id, days_till_charge)
+        response = get('InvoiceService', 'addRecurringOrder', contact_id, allow_duplicate, cprogram_id, qty, price, allow_tax, merchant_account_id, credit_card_id, affiliate_id, days_till_charge)
+      end
+
+      # Calculates the amount owed for a given invoice.
+      def invoice_calculate_amount_owed(invoice_id)
+        response = get('InvoiceService', 'calculateAmountOwed', invoice_id)
+      end
+
+      # Will charge an invoice with the amount currently due on it.
+      #
+      # @invoice_id [Integer]
+      # @notes [String]
+      # @credit_card_id [Integer]
+      # @merchant_account_id [Integer]
+      # @bypass_commission [Boolean] 
+      # @return [Hash] containing the following keys 
+      # {'Successful => [Boolean], 'Code' => [String], 'RefNum' => [String], 'Message' => [String]}
+      def invoice_charge_invoice(invoice_id, notes, credit_card_id, merchant_account_id, bypass_commissions)
+        response = get('InvoiceService', 'chargeInvoice', invoice_id, notes, credit_card_id, 
+                            merchant_account_id, bypass_commissions)
+      end
+
+      # returns the invoice id from a one time order
+      def invoice_get_invoice_id(order_id)
+        response = get('InvoiceService', 'getinvoice_id', order_id)
+      end
+
+      # Creates a blank order with no items.
+      #
+      # @return [Integer] returns the invoice id
+      def invoice_create_blank_order(contact_id, description, order_date, lead_affiliate_id, sale_affiliate_id)
+        response = get('InvoiceService', 'createBlankOrder', contact_id, description, order_date, 
+                            lead_affiliate_id, sale_affiliate_id)
+      end
+
+      # This will create an invoice for all charges due on a recurring order.
+      def invoice_create_invoice_for_recurring(recurringorder_id)
+        response = get('InvoiceService', 'createInvoiceForRecurring', recurringorder_id)
+      end
+
+      # Locates an existing card in the system for a contact, using the
+      def invoice_locate_existing_card(contact_id, last4)
+        # last 4 digits of the card.
+        response = get('InvoiceService', 'locateExistingCard', contact_id, last4)
+      end
+
+      # This will validate a credit card in the system.
+      def invoice_validate_card(credit_card_id)
+        response = get('InvoiceService', 'validateCreditCard', credit_card_id)
+      end
+
+      # This will validate a credit card by passing in values of the
+      # card directly (this card doesn't have to be added to the system)
+      def invoice_validate_card(creditCard)
+        response = get('InvoiceService', 'validateCreditCard', creditCard)
+      end
+    end
+  end
+end

data/lib/infusionsoft/client/ticket.rb

@@ -0,0 +1,18 @@
+module Infusionsoft
+  class Client
+    ########################  
+    ###  Ticket Service  ###
+    ########################
+    module Ticket
+      # add move notes to existing tickets
+      def ticket_add_move_notes(ticket_list, move_notes, move_to_stage_id, notify_ids)
+        response = get('ServiceCallService', 'addMoveNotes', ticket_list, move_notes, move_to_stage_id, notify_ids)
+      end
+
+      # add move notes to existing tickets
+      def ticket_move_stage(ticket_id, ticket_stage, move_notes, notify_ids)
+        response = get('ServiceCallService', 'moveTicketStage', ticket_id, ticket_stage, move_notes, notify_ids)
+      end
+    end
+  end
+end

data/lib/infusionsoft/client/version.rb

@@ -0,0 +1,5 @@
+module Infusionsoft
+  # The version of the gem
+  VERSION = '1.0.0'.freeze unless defined?(::Infusionsoft::VERSION)
+end
+

data/lib/infusionsoft/configuration.rb

@@ -0,0 +1,36 @@
+module Infusionsoft
+
+  module Configuration
+    VALID_OPTION_KEYS = [
+      :api_url,
+      :api_key
+    ].freeze
+
+    # @private
+    attr_accessor *VALID_OPTION_KEYS
+
+    # When this module is extended, set all configuration options to their default values
+    #def self.extended(base)
+      #base.reset
+    #end
+
+    # Convenience method to allow configuration options to be set in a block
+    def configure
+      yield self
+    end
+
+    # Create a hash of options and their values
+    def options
+      options = {}
+      VALID_OPTION_KEYS.each{|k| options[k] = send(k)}
+      options
+    end
+
+    #def reset
+      #self.url = ''
+      #self.api_key = 'na'
+    #end
+
+  end
+
+end

data/lib/infusionsoft/connection.rb

@@ -0,0 +1,48 @@
+require "xmlrpc/client"
+
+module Infusionsoft
+  module Connection
+    private
+
+    def connection(service_call, *args)
+      server = XMLRPC::Client.new3({
+        'host' => api_url, 
+        'path' => "/api/xmlrpc", 
+        'port' => 443, 
+        'use_ssl' => true
+      })
+      begin 
+      result = server.call("#{service_call}", api_key, *args)
+      rescue XMLRPC::FaultException => e
+          puts "*** INFUSION API ERROR: #{e.faultCode} - #{e.faultString} ***"
+      end
+      return result
+    end
+
+    #end
+        #if result.nil?; raise RetryException.new(true, @retry_count), "transient read error" end
+      #rescue RetryException => detail
+        ## Catch for transietn Infusionsoft connection errors
+        #puts "*** INFUSION API ERROR: Transient read error *** retrying: #{@retry_count}"
+        #self.retry_count += 1
+        #retry if detail.ok_to_retry
+      #rescue XMLRPC::FaultException => e
+        #puts "*** INFUSION API ERROR: #{e.faultCode} - #{e.faultString} ***"
+      #rescue Timeout::Error
+        #detail = RetryException.new(true, @retry_count)
+        #puts "*** INFUSION API ERROR: Timeout *** retrying #{@retry_count}"
+        #@retry_count += 1
+        #retry if detail.ok_to_retry
+      #rescue
+        #detail = RetryException.new(true, @retry_count)
+        ## This is most likely a catch for the infamous Content-Type bug from Infusionsoft.
+        ## Their response has an issue where it isn't sending back a Content-Type in the header,
+        ## which throws an nill error in the xml-rpc client in Ruby.
+        ## see xmlrcp/client.rb:552 and xmlrpc/utils.rb:159 in Ruby Standard Library.
+        #puts "*** INFUSION API ERROR: Content Type is nil back from Infusionsoft *** retrying: #{@retry_count}"
+        #@retry_count += 1
+        #retry if detail.ok_to_retry
+      #end
+
+  end
+end

data/lib/infusionsoft/request.rb

@@ -0,0 +1,33 @@
+module Infusionsoft
+  module Request
+    # Perform an GET request
+    def get(service_call, *args)
+      request(:get, service_call, *args)
+    end
+
+    def post(path, params={}, options={})
+      request(:post, path, params, options)
+    end
+
+    # Perform an HTTP PUT request
+    def put(path, params={}, options={})
+      request(:put, path, params, options)
+    end
+
+    # Perform an HTTP DELETE request
+    def delete(path, params={}, options={})
+      request(:delete, path, params, options)
+    end
+
+
+    private
+
+    # Perform request
+    def request(method, service_call, *args)
+      case method.to_sym
+      when :get
+        response = connection(service_call, *args)
+      end
+    end
+  end
+end

data/lib/infusionsoft/version.rb

@@ -0,0 +1,4 @@
+module Infusionsoft
+  # The version of the gem
+  VERSION = '1.0.2'.freeze unless defined?(::Infusionsoft::VERSION)
+end

data/test/api_infusion_test.rb

@@ -0,0 +1,8 @@
+require 'test/unit'
+
+class ApiInfusionTest < Test::Unit::TestCase
+  # Replace this with your real tests.
+  def test_this_plugin
+    flunk # will implement later :(
+  end
+end

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification 
+name: infusionsoft
+version: !ruby/object:Gem::Version 
+  hash: 19
+  prerelease: 
+  segments: 
+  - 1
+  - 0
+  - 2
+  version: 1.0.2
+platform: ruby
+authors: 
+- Nathan Leavitt
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-09-26 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: A Ruby wrapper written for the Infusionsoft API
+email: 
+- nate@infusedsystems.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- LICENSE.md
+- README.md
+- infusionsoft.gemspec
+- lib/infusionsoft.rb
+- lib/infusionsoft/api.rb
+- lib/infusionsoft/client.rb
+- lib/infusionsoft/client/affiliate.rb
+- lib/infusionsoft/client/contact.rb
+- lib/infusionsoft/client/data.rb
+- lib/infusionsoft/client/email.rb
+- lib/infusionsoft/client/file.rb
+- lib/infusionsoft/client/invoice.rb
+- lib/infusionsoft/client/ticket.rb
+- lib/infusionsoft/client/version.rb
+- lib/infusionsoft/configuration.rb
+- lib/infusionsoft/connection.rb
+- lib/infusionsoft/request.rb
+- lib/infusionsoft/version.rb
+- test/api_infusion_test.rb
+has_rdoc: true
+homepage: https://github.com/nateleavitt/infusionsoft
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 23
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.5.0
+signing_key: 
+specification_version: 3
+summary: Ruby wrapper for the Infusionsoft API
+test_files: []
+