infusion-api 1.0.1 → 1.0.2

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    MmJlYmM2OTg1YTlmNDViNGNiZDc2YjdhMTg3YWRmYzgwYzRkZjYzZA==
+    Mjc3MTM4Y2M4NWJhZWM0MWRlYjI4YjY2YjMwMTFlNGE3MzcwMDVlNg==
   data.tar.gz: !binary |-
-    NjkxMWY5OWIxMGU2ZmQ5OGM5NWFjNzVjMThjNmEyZmNiMWQ2NzlhYQ==
+    ZTJkMzIwMjUyMTU5YmRjOTE1ZTJlMTM5Y2JlZjgyNmFmYzYwOTZhYw==
 !binary "U0hBNTEy":
   metadata.gz: !binary |-
-    ZjMxNzg2YmU3OWNiMmEwY2NmZjFmNjkzNTBiNTc2ZDRkOGJjNTFmMjhlNjQ4
-    OGZmODc1NmQ1MGY0NWNlMmQ5MjI4ZjdjYjEzZmNhY2E5MDhiM2M3YWFhNzli
-    NGM3ZTIwMTI3Yzk0ODQ0YjEyOWI2MTA4YjE4MTk4NjM1Y2UxMjk=
+    ZTk1ZjQ4MjI4Y2Y2MTQwMDY0MDBjOGZmODA2ZDE0ZDQ0MjM3NzFhZjZiYjA1
+    OGQzNGI5NWRlZmEzMDI4YTVjMjc0YTcwYWE5NDBhMzlmZTRmOTBhY2Y3NWNi
+    YTBjMjk4NzQ1MWM5NDg3YWE1M2FjNTYyOTJiOTAxYTdmYmUyZjI=
   data.tar.gz: !binary |-
-    Y2EyNjYxZjhiOTIzNjE2YzdkYzQwY2VjNGYxMzNmNTM2N2ZjMWI0MzZlZTdm
-    MGQzM2M1MDhjNDM3NTNkMmJhNWQwMzE3M2M2ZTc1MTZmYTllYzFlZTk0YTA2
-    ZmM3MzdhYzZiMGNlNzdkY2QzNzgwN2M5OWQ1ZDE0ZmQxMmM2ODM=
+    ZjU3YjczN2U2MDNhMzNhOThhNmYxMjNjZWI0MWU2YjI0M2M5ZDU1MDUwNDBi
+    YTRkMzMzNjRlMTI2MzFiODVmNjliOTYwZWExMTVkNDVhYmQ5ODAxZTE1YmY1
+    Mzc3M2YxYmJjMTMwZDRjYTAxNzE0ZDAxYjIwYTNiMTZlOTJkMmI=

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,111 @@
+# The Infusionsoft Ruby Gem
+A Ruby wrapper for the Infusionsoft API
+
+**This is a complete rewrite and has been implemented as a RubyGem**
+All previous versions will need to update their calls to follow the new schema
+
+## <a name="installation">Installation</a>
+    gem install infusionsoft
+
+## <a name="documentation">Documentation</a>
+[http://rubydoc.info/gems/infusionsoft/frames](http://rubydoc.info/gems/infusionsoft/frames)
+
+## <a name="setup">Setup & Configuration</a>
+1. **Rails 2.3** - add `config.gem 'infusionsoft'` **Rails 3** - add `'infusionsoft'` to your `Gemfile`
+2. Then create an initializer in `config\initializers` called infusionsoft.rb and the following
+
+<b></b>
+
+    # Added to your config\initializers file
+    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_update(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="todos">Todos</a>
+* Need to fully implement testing
+* Need to add a history log for additional contributers
+
+## <a name="copyright">Copyright</a>
+Copyright (c) 2012 Nathan Leavitt
+See [LICENSE](https://github.com/nateleavitt/infusionsoft/blob/master/LICENSE.md) for details.
+

data/infusion-api.gemspec

@@ -0,0 +1,18 @@
+# encoding: utf-8
+require File.expand_path('../lib/infusion-api/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.name = 'infusion-api'
+  gem.summary = %q{Ruby wrapper for the Infusionsoft API - Forked from Nathan Leavitt}
+  gem.description = 'A Ruby wrapper written for the Infusionsoft API. Forked from Nathan Leavitt'
+  gem.authors = ["Updated by Raj Shah"]
+  gem.email = ['drrajshah@me.com']
+  gem.executables = `git ls-files -- bin/*`.split("\n").map{|f| File.basename(f)}
+  gem.files = `git ls-files`.split("\n")
+  gem.homepage = 'http://rubygems.org/gems/infusion-api'
+  gem.require_paths = ['lib']
+  gem.required_rubygems_version = Gem::Requirement.new('>= 1.3.6')
+
+  gem.version = Infusionsoft::VERSION.dup
+end
+

data/lib/infusion-api/api.rb

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

data/lib/infusion-api/client/affiliate.rb

@@ -0,0 +1,62 @@
+module Infusionsoft
+  class Client
+    # The Affiliate service is used to pull commission data and activities for affiliates.
+    # With this service, you have access to Clawbacks, Commissions, Payouts, Running Totals,
+    # and the Activity Summary. The methods in the Affiliate service mirror the reports
+    # produced inside Infusionsoft.
+    #
+    # @note To manage affiliate information (ie Name, Phone, etc.) you will need to use the Data service.
+    module Affiliate
+      # Used when you need to retrieve all clawed back commissions for a particular affiliate.
+      #
+      # @param [Integer] affiliate_id
+      # @params [Date] start_date
+      # @end_date [Date] end_date
+      # @return [Array] all claw backs for the given affiliate that have occurred within the date
+      #   range specified
+      def affiliate_clawbacks(affiliate_id, start_date, end_date)
+        response = get('APIAffiliateService.affClawbacks', affiliate_id, start_date, end_date)
+      end
+
+      # Used to retrieve all commissions for a specific affiliate within a date range.
+      #
+      # @param [Integer] affiliate_id
+      # @param [Date] start_date
+      # @param [Date] end_date
+      # @return [Array] all sales commissions for the given affiliate earned within the date range
+      #   specified
+      def affiliate_commissions(affiliate_id, start_date, end_date)
+        response = get('APIAffiliateService.affCommissions', affiliate_id, start_date, end_date)
+      end
+
+      # Used to retrieve all payments for a specific affiliate within a date range.
+      #
+      # @param [Integer] affiliate_id
+      # @param [Date] start_date
+      # @param [Date] end_date
+      # @return [Array] a list of rows, each row is a single payout
+      def affiliate_payouts(affiliate_id, start_date, end_date)
+        response = get('APIAffiliateService.affPayouts', affiliate_id, start_date, end_date)
+      end
+
+      # This method is used to retrieve all commissions for a specific affiliate within a date range.
+      #
+      # @param [Array] affiliate_list
+      # @return [Array] all sales commissions for the given affiliate earned within the date range
+      #   specified
+      def affiliate_running_totals(affiliate_list)
+        response = get('APIAffiliateService.affRunningTotals', affiliate_list)
+      end
+
+      # Used to retrieve a summary of statistics for a list of affiliates.
+      #
+      # @param [Array] affiliate_list
+      # @param [Date] start_date
+      # @param [Date] end_date
+      # @return [Array<Hash>] a summary of the affiliates information for a specified date range
+      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/infusion-api/client/contact.rb

@@ -0,0 +1,187 @@
+module Infusionsoft
+  class Client
+    # Contact service is used to manage contacts. You can add, update and find contacts in
+    # addition to managing follow up sequences, tags and action sets.
+    module Contact
+      # Creates a new contact record from the data passed in the associative array.
+      #
+      # @param [Hash] data contains the mappable contact fields and it's data
+      # @return [Integer] the id of the newly added contact
+      # @example
+      #   { :Email => 'test@test.com', :FirstName => 'first_name', :LastName => 'last_name' }
+      def contact_add(data)
+        contact_id = get('ContactService.add', data)
+        if data.has_key?("Email"); email_optin(data["Email"], "requested information"); end
+        return contact_id
+      end
+
+      # Adds or updates a contact record based on matching data
+      #
+      # @param [Array<Hash>] data the contact data you want added
+      # @param [String] check_type available options are 'Email', 'EmailAndName',
+      #   'EmailAndNameAndCompany'
+      # @return [Integer] id of the contact added or updated
+      def contact_add_with_dup_check(data, check_type)
+        response = get('ContactService.addWithDupCheck', data, check_type)
+      end
+
+      # Updates a contact in the database.
+      #
+      # @param [Integer] contact_id
+      # @param [Hash] data contains the mappable contact fields and it's data
+      # @return [Integer] the id of the contact updated
+      # @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"); email_optin(data["Email"], "requested information"); end
+        return bool
+      end
+
+      # Loads a contact from the database
+      #
+      # @param [Integer] id
+      # @param [Array] selected_fields the list of fields you want back
+      # @return [Array] the fields returned back with it's data
+      # @example this is what you would get back
+      #   { "FirstName" => "John", "LastName" => "Doe" }
+      def contact_load(id, selected_fields)
+        response = get('ContactService.load', id, selected_fields)
+      end
+
+      # Finds all contacts with the supplied email address in any of the three contact record email
+      # addresses.
+      #
+      # @param [String] email
+      # @param [Array] selected_fields the list of fields you want with it's data
+      # @return [Array<Hash>] the list of contacts with it's fields and data
+      def contact_find_by_email(email, selected_fields)
+        response = get('ContactService.findByEmail', email, selected_fields)
+      end
+
+      # Adds a contact to a follow-up sequence (campaigns were the original name of follow-up sequences).
+      #
+      # @param [Integer] contact_id
+      # @param [Integer] campaign_id
+      # @return [Boolean] returns true/false if the contact was added to the follow-up sequence
+      #   successfully
+      def contact_add_to_campaign(contact_id, campaign_id)
+        response = get('ContactService.addToCampaign', contact_id, campaign_id)
+      end
+
+      # Returns the Id number of the next follow-up sequence step for the given contact.
+      #
+      # @param [Integer] contact_id
+      # @param [Integer] campaign_id
+      # @return [Integer] id number of the next unfishished step in the given follow up sequence
+      #   for the given contact
+      def contact_get_next_campaign_step(contact_id, campaign_id)
+        response = get('ContactService.getNextCampaignStep', contact_id, campaign_id)
+      end
+
+      # Pauses a follow-up sequence for the given contact record
+      #
+      # @param [Integer] contact_id
+      # @param [Integer] campaign_id
+      # @return [Boolean] returns true/false if the sequence was paused
+      def contact_pause_campaign(contact_id, campaign_id)
+        response = get('ContactService.pauseCampaign', contact_id, campaign_id)
+      end
+
+      # Removes a follow-up sequence from a contact record
+      #
+      # @param [Integer] contact_id
+      # @param [Integer] campaign_id
+      # @return [Boolean] returns true/false if removed
+      def contact_remove_from_campaign(contact_id, campaign_id)
+        response = get('ContactService.removeFromCampaign', contact_id, campaign_id)
+      end
+
+      # Resumes a follow-up sequence that has been stopped/paused for a given contact.
+      #
+      # @param [Integer] contact_id
+      # @param [Ingeger] campaign_id
+      # @return [Boolean] returns true/false if sequence was resumed
+      def contact_resume_campaign(contact_id, campaign_id)
+        response = get('ConactService.resumeCampaignForContact', contact_id, campaign_id)
+      end
+
+      # Immediately performs the given follow-up sequence step_id for the given contacts.
+      #
+      # @param [Array<Integer>] list_of_contacts
+      # @param [Integer] ) step_id
+      # @return [Boolean] returns true/false if the step was rescheduled
+      def contact_reschedule_campaign_step(list_of_contacts, step_id)
+        response = get('ContactService.reschedulteCampaignStep', list_of_contacts, step_id)
+      end
+
+      # Removes a tag from a contact (groups were the original name of tags).
+      #
+      # @param [Integer] contact_id
+      # @param [Integer] group_id
+      # @return [Boolean] returns true/false if tag was removed successfully
+      def contact_remove_from_group(contact_id, group_id)
+        response = get('ContactService.removeFromGroup', contact_id, group_id)
+      end
+
+      # Adds a tag to a contact
+      #
+      # @param [Integer] contact_id
+      # @param [Integer] group_id
+      # @return [Boolean] returns true/false if the tag was added successfully
+      def contact_add_to_group(contact_id, group_id)
+        response = get('ContactService.addToGroup', contact_id, group_id)
+      end
+
+      # Runs an action set on a given contact record
+      #
+      # @param [Integer] contact_id
+      # @param [Integer] action_set_id
+      # @return [Array<Hash>] A list of details on each action run
+      # @example here is a list of what you get back
+      #   [{ 'Action' => 'Create Task', 'Message' => 'task1 (Task) sent successfully', 'isError' =>
+      #   nil }]
+      def contact_run_action_set(contact_id, action_set_id)
+        response = get('ContactService.runActionSequence', contact_id, action_set_id)
+      end
+
+      def contact_link_contact(remoteApp, remoteId, localId)
+        response = get('ContactService.linkContact', remoteApp, remoteId, localId)
+      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
+
+      # Creates a new recurring order for a contact.
+      #
+      # @param [Integer] contact_id
+      # @param [Boolean] allow_duplicate
+      # @param [Integer] cprogram_id
+      # @param [Integer] merchant_account_id
+      # @param [Integer] credit_card_id
+      # @param [Integer] affiliate_id
+      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
+
+      # Executes an action sequence for a given contact, passing in runtime params
+      # for running affiliate signup actions, etc
+      #
+      # @param [Integer] contact_id
+      # @param [Integer] action_set_id
+      # @param [Hash] data
+      def contact_run_action_set_with_params(contact_id, action_set_id, data)
+        response = get('ContactService.runActionSequence', contact_id, action_set_id, data)
+      end
+
+    end
+  end
+end

data/lib/infusion-api/client/credit_card.rb

@@ -0,0 +1,24 @@
+module Infusionsoft
+  class Client
+    # CreditCardSubmission service is used to obtain a token that is to be submitted 
+    # through a form when adding a credit card. In accordance with PCI compliance, 
+    # adding credit cards through the API will no longer be supported.
+    module CreditCard
+
+      # This service will request a token that will be used when submitting
+      # a new credit card through a form
+      #
+      # @param [Integer] contact_id of the Infusionsoft contact
+      # @param [String] url that will be redirected to upon successfully adding card
+      # @param [String] url that will be redirected to when there is a failure upon adding card
+      def credit_card_request_token(contact_id, success_url, failure_url)
+        response = get('CreditCardSubmissionService.requestSubmissionToken', contact_id, success_url, failure_url)
+      end
+
+      def credit_card_lookup_by_token(token)
+        response = get('CreditCardSubmissionService.requestCreditCardId', token)
+      end
+
+    end
+  end
+end

data/lib/infusion-api/client/data.rb

@@ -0,0 +1,147 @@
+module Infusionsoft
+  class Client
+    # The Data service is used to manipulate most data in Infusionsoft. It permits you to
+    # work on any available tables and has a wide range of uses.
+    module Data
+      # Adds a record with the data provided.
+      #
+      # @param [String] table the name of the Infusiosoft database table
+      # @param [Hash] data the fields and it's data
+      # @return [Integer] returns the id of the record added
+      def data_add(table, data)
+        response = get('DataService.add', table, data)
+      end
+
+      # This method will load a record from the database given the primary key.
+      #
+      # @param [String] table
+      # @param [Integer] id
+      # @param [Array] selected_fields
+      # @return [Hash] the field names and their data
+      # @example
+      #   { "FirstName" => "John", "LastName" => "Doe" }
+      def data_load(table, id, selected_fields)
+        response = get('DataService.load', table, id, selected_fields)
+      end
+
+      # Updates the specified record (indicated by ID) with the data provided.
+      #
+      # @param [String] table
+      # @param [Integer] id
+      # @param [Hash] data this is the fields and values you would like to update
+      # @return [Integer] id of the record updated
+      # @example
+      #   { :FirstName => 'John', :Email => 'test@test.com' }
+      def data_update(table, id, data)
+        response = get('DataService.update', table, id, data)
+      end
+
+      # Deletes the record (specified by id) in the given table from the database.
+      #
+      # @param [String] table
+      # @param [Integer] id
+      # @return [Boolean] returns true/false if the record was successfully deleted
+      def data_delete(table, id)
+        response = get('DataService.delete', table, id)
+      end
+
+      # This will locate all records in a given table that match the criteria for a given field.
+      #
+      # @param [String] table
+      # @param [Integer] limit how many records you would like to return (max is 1000)
+      # @param [Integer] page the page of results (each page is max 1000 records)
+      # @param [String] field_name
+      # @param [String, Integer, Date] field_value
+      # @param [Array] selected_fields
+      # @return [Array<Hash>] returns the array of records with a hash of the fields and values
+      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
+
+      # Queries records in a given table to find matches on certain fields.
+      #
+      # @param [String] table
+      # @param [Integer] limit
+      # @param [Integer] page
+      # @param [Hash] data  the data you would like to query on. { :FirstName => 'first_name' }
+      # @param [Array] selected_fields the fields and values you want back
+      # @return [Array<Hash>] the fields and associated values
+      def data_query(table, limit, page, data, selected_fields)
+        response = get('DataService.query', table, limit, page, data, selected_fields)
+      end
+
+      # Queries records in a given table to find matches on certain fields.
+      #
+      # @param [String] table
+      # @param [Integer] limit
+      # @param [Integer] page
+      # @param [Hash] data  the data you would like to query on. { :FirstName => 'first_name' }
+      # @param [Array] selected_fields the fields and values you want back
+      # @param [String] field to order by
+      # @param [Boolean] ascending
+      # @return [Array<Hash>] the fields and associated values
+      def data_query_order_by(table, limit, page, data, selected_fields, by, ascending)
+        response = get('DataService.query', table, limit, page, data, selected_fields, by, ascending)
+      end
+
+
+      # Adds a custom field to Infusionsoft
+      #
+      # @param [String] field_type options include Person, Company, Affiliate, Task/Appt/Note,
+      #   Order, Subscription, or Opportunity
+      # @param [String] name
+      # @param [String] data_type the type of field Text, Dropdown, TextArea
+      # @param [Integer] header_id see notes here
+      #   http://help.infusionsoft.com/developers/services-methods/data/addCustomField
+      def data_add_custom_field(field_type, name, data_type, header_id)
+        response = get('DataService.addCustomField', field_type, name, data_type, header_id)
+      end
+
+      # Authenticate an Infusionsoft username and password(md5 hash). If the credentials match
+      # it will return back a User ID, if the credentials do not match it will send back an
+      # error message
+      #
+      # @param [String] username
+      # @param [String] password
+      # @return [Integer] id of the authenticated user
+      def data_authenticate_user(username, password)
+        response = get('DataService.authenticateUser', username, password)
+      end
+
+      # This method will return back the data currently configured in a user configured
+      # application setting.
+      #
+      # @param [String] module
+      # @param [String] setting
+      # @return [String] current values in given application setting
+      # @note to find the module and option names, view the HTML field name within the Infusionsoft
+      #   settings. You will see something such as name="Contact_WebModule0optiontypes" . The portion
+      #   before the underscore is the module name. "Contact" in this example. The portion after the
+      #   0 is the setting name, "optiontypes" in this example.
+      def data_get_app_setting(module_name, setting)
+        response = get('DataService.getAppSetting', module_name, setting)
+      end
+
+      # Returns a temporary API key if given a valid Vendor key and user credentials.
+      #
+      # @param [String] vendor_key
+      # @param [String] username
+      # @param [String] password_hash an md5 hash of users password
+      # @return [String] temporary API key
+      def data_get_temporary_key(vendor_key, username, password_hash)
+        response = get('DataService.getTemporaryKey', username, password_hash)
+      end
+
+      # Updates a custom field. Every field can have it’s display name and group id changed,
+      # but only certain data types will allow you to change values(dropdown, listbox, radio, etc).
+      #
+      # @param [Integer] field_id
+      # @param [Hash] field_values
+      # @return [Boolean] returns true/false if it was updated
+      def data_update_custom_field(field_id, field_values)
+        response = get('DataService.updateCustomField', field_id, field_values)
+      end
+    end
+  end
+end