netsuite 0.0.49 → 0.0.50

data/README.md

@@ -2,7 +2,8 @@
 
 * This gem will act as a wrapper around the NetSuite SuiteTalk WebServices API. Wow, that is a mouthful.
 * The gem does not cover the entire API, only the subset that we have found useful to cover so far.
-* Extending the wrapper is pretty simple. See below for an example.
+* Extending the wrapper is pretty simple. Check out the [contribution help doc](https://github.com/RevolutionPrep/netsuite/wiki/Contributing-to-the-Supported-NetSuite-API)
+* NetSuite development is overall a pretty poor experience. We have a list of [NetSuite Development Resources](https://github.com/RevolutionPrep/netsuite/wiki/NetSuite-Development-Resources) that might make things a bit less painful.
 
 ## Installation
 
@@ -24,7 +25,7 @@ This gem is built for ruby 1.9.x, checkout the [1-8-stable](https://github.com/R
 Before contributing a patch make sure all existing tests pass.
 
 ```
-git clone git://github.com/iloveitaly/netsuite.git
+git clone git://github.com/RevolutionPrep/netsuite.git
 cd netsuite
 bundle
 bundle exec rspec
@@ -36,114 +37,57 @@ bundle exec rspec
 NetSuite.configure do
   reset!
   
+  # optional, defaults to 2011_2
   api_version	'2012_1'
   
-  # specify full wsdl URL for sandbox / production switching
+  # optionally specify full wsdl URL (to switch to sandbox, for example)
   wsdl          "https://webservices.sandbox.netsuite.com/wsdl/v#{api_version}_0/netsuite.wsdl"
   
+  # or specify the sandbox flag if you don't want to deal with specifying a full URL
+  sandbox	true
+  
+  # often the netsuite servers will hang which would cause a timeout exception to be raised
+  # if you don't mind waiting (e.g. processing NS via DJ), increasing the timeout should fix the issue
+  read_timeout  100000
+  
+  # you can specify a file or file descriptor to send the log output to (defaults to STDOUT)
+  log           File.join(Rails.root, 'log/netsuite.log')
+  
   # login information
-  email    		'email@domain.com'
-  password 		'password'
+  email    	'email@domain.com'
+  password 	'password'
   account   	'12345'
   role      	1111
 end
 ```
 
-### Customer
-
-* Initializing a customer can be done using a hash of attributes.
-
-### Get
-
-* Retrieves the customer by internalId.
-
-    ```Ruby
-    customer = NetSuite::Records::Customer.get(:internal_id => 4)
-    # => #<NetSuite::Records::Customer:0x1042f59b8>
-    customer.is_person
-    # => true
-    
-    # or
-    NetSuite::Records::Customer.get(4).is_person
-    ```
-
-## Additions
-
-* Please submit a pull request for any models or actions that you would like to be included. The API is quite large and so we will necessarily not cover all of it.
-* Records should go into the `lib/netsuite/records/` directory.
-* Actions should be placed in their respective subdirectory under `lib/netsuite/actions`.
-* Example:
-
-    ```Ruby
-    # lib/netsuite/actions/customer/add.rb
-
-    module NetSuite
-      module Actions
-        module Customer
-          class Add
-
-            def initialize(attributes = {})
-              @attributes = attributes
-            end
-
-            def self.call(attributes)
-              new(attributes).call
-            end
-
-            def call
-              response = NetSuite::Configuration.connection.request :add do
-                soap.header =  NetSuite::Configuration.auth_header
-                soap.body = {
-                  :entityId    => @attributes[:entity_id],
-                  :companyName => @attributes[:company_name],
-                  :unsubscribe => @attributes[:unsubscribe]
-                }
-              end
-              success = response.to_hash[:add_response][:write_response][:status][:@is_success] == 'true'
-              body    = response.to_hash[:add_response][:write_response][:base_ref]
-              NetSuite::Response.new(:success => success, :body => body)
-            end
-
-          end
-        end
-      end
-    end
-
-    response = NetSuite::Actions::Customer::Add.call(
-      :entity_id    => 'Shutter Fly',
-      :company_name => 'Shutter Fly, Inc.',
-      :unsubscribe  => false
-    )                 # => #<NetSuite::Response:0x1041f64b5>
-    response.success? # => true
-    response.body     # => { :internal_id => '979', :type => 'customer' }
-    ```
-
-## Gotchas
-
-  * The Initialize Action duck-punches the .initialize method on any class that includes it.
-    This has not proven to be a issue yet, but should be taken into account when analyzing any
-    strange issues with the gem.
-  * Some records define a 'class' field. Defining a 'class' field on a record overrides the
-    #class and #class= methods for this class. This is very obviously a problem.  You can,
-    instead, define a 'klass' field that will be turned into 'class' before being submitted
-    to the API. The Invoice record has an example of this.
-
-## Contributing
-
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Write new test and ensure that `bundle exec rspec` doesn't fail
-4. Commit your changes (`git commit -am 'Added some feature'`)
-5. Push to the branch (`git push origin my-new-feature`)
-6. Create new Pull Request
-
-## Fields and RecordRefs
-
-Note that some record attributes are specified as Fields while others are specified as RecordRefs. In some cases
-attributes are actually RecordRefs in the schema, but we indicate them as Fields. Our experience has shown
-this works as long as the attribute is only read from and is not written to. Writing a value for an attribute
-that has been wrongly specified will result in an error. Be careful when initializing objects from other objects --
-they may carry attributes that write to the new object.
-
-As we build up this gem we will replace these inconsistent Fields with RecordRefs. Feel free to contribute new Record 
-definitions to help us along.
+### Examples
+
+```ruby
+# retrieve a customer
+customer = NetSuite::Records::Customer.get(:internal_id => 4)
+customer.is_person
+
+# or
+NetSuite::Records::Customer.get(4).is_person
+
+# randomly assign a task
+customer_support_reps = [12345, 12346]
+
+task = NetSuite::Records::Task.new(
+	:title => 'Take Care of a Customer',
+	:assigned => NetSuite::Records::RecordRef.new(customer_support_reps.sample),
+	:due_date => DateTime.now + 1,
+	:message => "Take care of this"
+)
+
+task.add
+
+# this will only work on OS X, open a browser to the record that was just created
+`open https://system.sandbox.netsuite.com/app/crm/calendar/task.nl?id=#{invoice.internal_id}`
+
+task.update :message => 'New Message'
+```
+
+
+

data/lib/netsuite.rb

@@ -11,6 +11,7 @@ module NetSuite
   autoload :Response,      'netsuite/response'
 
   module Namespaces
+    autoload :ActSched,       'netsuite/namespaces/act_sched'
     autoload :ListAcct,       'netsuite/namespaces/list_acct'
     autoload :ListRel,        'netsuite/namespaces/list_rel'
     autoload :PlatformCommon, 'netsuite/namespaces/platform_common'
@@ -28,14 +29,17 @@ module NetSuite
     autoload :RecordRefs, 'netsuite/support/record_refs'
     autoload :Records,    'netsuite/support/records'
     autoload :Requests,   'netsuite/support/requests'
+    autoload :SearchResult, 'netsuite/support/search_result'
   end
 
   module Actions
-    autoload :Add,        'netsuite/actions/add'
-    autoload :Delete,     'netsuite/actions/delete'
-    autoload :Get,        'netsuite/actions/get'
-    autoload :Initialize, 'netsuite/actions/initialize'
-    autoload :Update,     'netsuite/actions/update'
+    autoload :Add,              'netsuite/actions/add'
+    autoload :Delete,           'netsuite/actions/delete'
+    autoload :Get,              'netsuite/actions/get'
+    autoload :Initialize,       'netsuite/actions/initialize'
+    autoload :Update,           'netsuite/actions/update'
+    autoload :Search,           'netsuite/actions/search'
+    autoload :SearchMoreWithId, 'netsuite/actions/search_more_with_id'
   end
 
   module Records
@@ -43,6 +47,7 @@ module NetSuite
     autoload :Account,                    'netsuite/records/account'
     autoload :AccountingPeriod,           'netsuite/records/accounting_period'
     autoload :BillAddress,                'netsuite/records/bill_address'
+    autoload :BinNumberList,              'netsuite/records/bin_number_list'
     autoload :Classification,             'netsuite/records/classification'
     autoload :CreditMemo,                 'netsuite/records/credit_memo'
     autoload :CreditMemoApply,            'netsuite/records/credit_memo_apply'
@@ -63,6 +68,8 @@ module NetSuite
     autoload :CustomerRefundApplyList,    'netsuite/records/customer_refund_apply_list'
     autoload :CustomerRefundDeposit,      'netsuite/records/customer_refund_deposit'
     autoload :CustomerRefundDepositList,  'netsuite/records/customer_refund_deposit_list'
+    autoload :ContactList,                'netsuite/records/contact_list'
+    autoload :Contact,                    'netsuite/records/contact'
     autoload :Department,                 'netsuite/records/department'
     autoload :Duration,                   'netsuite/records/duration'
     autoload :InventoryItem,              'netsuite/records/inventory_item'
@@ -73,6 +80,7 @@ module NetSuite
     autoload :JournalEntry,               'netsuite/records/journal_entry'
     autoload :JournalEntryLine,           'netsuite/records/journal_entry_line'
     autoload :JournalEntryLineList,       'netsuite/records/journal_entry_line_list'
+    autoload :KitItem,                    'netsuite/records/kit_item'
     autoload :Location,                   'netsuite/records/location'
     autoload :NonInventorySaleItem,       'netsuite/records/non_inventory_sale_item'
     autoload :PaymentMethod,              'netsuite/records/payment_method'
@@ -83,13 +91,15 @@ module NetSuite
     autoload :SalesOrderItem,             'netsuite/records/sales_order_item'
     autoload :SalesOrderItemList,         'netsuite/records/sales_order_item_list'
     autoload :ShipAddress,                'netsuite/records/ship_address'
+    autoload :Task,                       'netsuite/records/task'
     autoload :Term,                       'netsuite/records/term'
+    autoload :Transaction,                'netsuite/records/transaction'
   end
 
   def self.configure(&block)
     NetSuite::Configuration.instance_eval(&block)
     Savon.configure do |config|
-      config.logger = NetSuite::XmlLogger.new(STDOUT)
+      config.logger = NetSuite::Configuration.logger
     end
   end
 

data/lib/netsuite/actions/add.rb

@@ -17,6 +17,7 @@ module NetSuite
           soap.namespaces['xmlns:tranSales']      = "urn:sales_#{NetSuite::Configuration.api_version}.transactions.webservices.netsuite.com"
           soap.namespaces['xmlns:platformCommon'] = "urn:common_#{NetSuite::Configuration.api_version}.platform.webservices.netsuite.com"
           soap.namespaces['xmlns:listAcct']       = "urn:accounting_#{NetSuite::Configuration.api_version}.lists.webservices.netsuite.com"
+          soap.namespaces['xmlns:actSched']       = "urn:scheduling_#{NetSuite::Configuration.api_version}.activities.webservices.netsuite.com"
           soap.namespaces['xmlns:tranCust']       = "urn:customers_#{NetSuite::Configuration.api_version}.transactions.webservices.netsuite.com"
           soap.namespaces['xmlns:setupCustom']    = "urn:customization_#{NetSuite::Configuration.api_version}.setup.webservices.netsuite.com"
           soap.namespaces['xmlns:tranGeneral']    = "urn:general_#{NetSuite::Configuration.api_version}.transactions.webservices.netsuite.com"
@@ -69,6 +70,8 @@ module NetSuite
           if response.success?
             @internal_id = response.body[:@internal_id]
             true
+          else
+            false
           end
         end
       end

data/lib/netsuite/actions/search.rb

@@ -0,0 +1,126 @@
+# TODO: Tests
+module NetSuite
+  module Actions
+    class Search
+      include Support::Requests
+
+      def initialize(klass, options = { })
+        @klass = klass
+        @options = options
+      end
+
+      private
+
+      def request
+        # need to do this outside the block below because of variable scoping
+        preferences = (@options[:preferences] || {}).inject({}) do |h, (k, v)|
+          h[k.to_s.lower_camelcase] = v
+          h
+        end
+
+        connection.request(:search) do
+          soap.namespaces['xmlns:platformMsgs'] = "urn:messages_#{NetSuite::Configuration.api_version}.platform.webservices.netsuite.com"
+          soap.namespaces['xmlns:platformCore'] = "urn:core_#{NetSuite::Configuration.api_version}.platform.webservices.netsuite.com"
+          soap.namespaces['xmlns:platformCommon'] = "urn:common_#{NetSuite::Configuration.api_version}.platform.webservices.netsuite.com"
+          soap.namespaces['xmlns:listRel'] = "urn:relationships_#{NetSuite::Configuration.api_version}.lists.webservices.netsuite.com"
+          soap.namespaces['xmlns:tranSales'] = "urn:sales_#{NetSuite::Configuration.api_version}.transactions.webservices.netsuite.com"
+
+          # https://system.netsuite.com/help/helpcenter/en_US/Output/Help/SuiteFlex/WebServices/STP_SettingSearchPreferences.html#N2028598271-3
+          soap.header = auth_header.merge(preferences.empty? ? {} : { 'platformMsgs:searchPreferences' => preferences })
+
+          soap.body = request_body
+        end
+      end
+
+      # basic search XML
+
+      # <soap:Body>
+      # <platformMsgs:search>
+      # <searchRecord xsi:type="ContactSearch">
+      #   <customerJoin xsi:type="CustomerSearchBasic">
+      #     <email operator="contains" xsi:type="platformCore:SearchStringField">
+      #     <platformCore:searchValue>shutterfly.com</platformCore:searchValue>
+      #     <email>
+      #   <customerJoin>
+      # </searchRecord>
+      # </search>
+      # </soap:Body>
+
+      def request_body
+        criteria = @options[:criteria] || @options
+
+        # TODO wish there was a cleaner way to do this: we need the namespace of the record
+        example_instance = @klass.new
+        namespace = example_instance.record_namespace
+
+        # extract the class name without the module
+        class_name = @klass.to_s.split("::").last
+
+        search_record = {}
+
+        criteria.each_pair do |condition_category, conditions|
+          search_record["#{namespace}:#{condition_category}"] = conditions.inject({}) do |h, condition|
+            h["platformCommon:#{condition[:field]}"] = {
+              "platformCore:searchValue" => condition[:value]
+            }
+
+            (h[:attributes!] ||= {}).merge!({
+              "platformCommon:#{condition[:field]}" => {
+                'operator' => condition[:operator]
+              }
+            })
+
+            h
+          end
+        end
+
+        {
+          'searchRecord' => search_record,
+          :attributes! => {
+            'searchRecord' => {
+              'xsi:type' => "#{namespace}:#{class_name}Search"
+            },
+          }
+        }
+      end
+
+      def response_header
+        @response_header ||= response_header_hash
+      end
+
+      def response_header_hash
+        @response_header_hash = @response.header[:document_info]
+      end
+
+      def response_body
+        @response_body ||= search_result
+      end
+
+      def search_result
+        @search_result = @response[:search_response][:search_result]
+      end
+
+      def success?
+        @success ||= search_result[:status][:@is_success] == 'true'
+      end
+
+      module Support
+        def self.included(base)
+          base.extend(ClassMethods)
+        end
+
+        module ClassMethods
+          def search(options = { })
+            response = NetSuite::Actions::Search.call(self, options)
+
+            if response.success?
+              NetSuite::Support::SearchResult.new(response, self)
+            else
+              false
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/netsuite/actions/search_more_with_id.rb

@@ -0,0 +1,106 @@
+# TODO: Tests
+# TODO: DBC
+module NetSuite
+  module Actions
+    class SearchMoreWithId
+      include Support::Requests
+
+      def initialize(klass, options = { })
+        @klass = klass
+
+        @options = options
+      end
+
+      private
+
+      def request
+        connection.request(:search_more_with_id) do
+          soap.namespaces['xmlns:platformMsgs'] = "urn:messages_#{NetSuite::Configuration.api_version}.platform.webservices.netsuite.com"
+          soap.namespaces['xmlns:platformCore'] = "urn:core_#{NetSuite::Configuration.api_version}.platform.webservices.netsuite.com"
+          soap.namespaces['xmlns:platformCommon'] = "urn:common_#{NetSuite::Configuration.api_version}.platform.webservices.netsuite.com"
+          soap.namespaces['xmlns:listRel'] = "urn:relationships_#{NetSuite::Configuration.api_version}.lists.webservices.netsuite.com"
+          soap.namespaces['xmlns:tranSales'] = "urn:sales_#{NetSuite::Configuration.api_version}.transactions.webservices.netsuite.com"
+
+          soap.header = auth_header
+
+          soap.body = request_body
+        end
+      end
+
+      # TODO: Consistent use of namespace qualifying
+      def request_body
+        buffer = ''
+
+        xml = Builder::XmlMarkup.new(target: buffer)
+
+        xml.platformMsgs(:searchId, @options[:search_id])
+        xml.platformMsgs(:pageIndex, @options[:page].present? ? @options[:page] : 2)
+
+        buffer
+      end
+
+      def response_body
+        @response_body ||= response_body_hash
+      end
+
+      def response_body_hash
+        @response_body_hash = @response[:search_more_with_id_response][:search_result]
+      end
+
+      def success?
+        @success ||= response_body_hash[:status][:@is_success] == 'true'
+      end
+
+      # TODO: Refactor
+      def more?
+        @more ||= response_body_hash[:page_index] < response_body_hash[:total_pages]
+      end
+
+      module Support
+        def self.included(base)
+          base.extend(ClassMethods)
+        end
+
+        # TODO: Rename page_index to page
+        module ClassMethods
+          # Preconditions
+          # => options[:search_id] is a string
+          # => options[:page], optional, is an integer
+          # Postconditions
+          # => Hash with the following keys:
+          #      * page_index which is an integer
+          #      * total_pages which is an integer
+          #      * search_results containing array of SearchResult's
+          def search_more_with_id(options = { })
+            response = NetSuite::Actions::SearchMoreWithId.call(self, options)
+
+            response_hash = { }
+
+            if response.success?
+              search_results = []
+
+              if response.body[:search_row_list].present?
+                response.body[:search_row_list][:search_row].each do |record|
+                  search_result = NetSuite::Support::SearchResult.new(record)
+
+                  search_results << search_result
+                end
+              end
+
+              page_index = response.body[:page_index]
+              total_pages = response.body[:total_pages]
+
+              response_hash[:page_index] = page_index
+              response_hash[:total_pages] = total_pages
+              response_hash[:search_results] = search_results
+
+              response_hash
+            else
+              raise ArgumentError
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/netsuite/actions/update.rb

@@ -16,6 +16,7 @@ module NetSuite
           soap.namespaces['xmlns:tranSales']      = "urn:sales_#{NetSuite::Configuration.api_version}.transactions.webservices.netsuite.com"
           soap.namespaces['xmlns:platformCommon'] = "urn:common_#{NetSuite::Configuration.api_version}.platform.webservices.netsuite.com"
           soap.namespaces['xmlns:listAcct']       = "urn:accounting_#{NetSuite::Configuration.api_version}.lists.webservices.netsuite.com"
+          soap.namespaces['xmlns:actSched']       = "urn:scheduling_#{NetSuite::Configuration.api_version}.activities.webservices.netsuite.com"
           soap.namespaces['xmlns:tranCust']       = "urn:customers_#{NetSuite::Configuration.api_version}.transactions.webservices.netsuite.com"
           soap.namespaces['xmlns:setupCustom']    = "urn:customization_#{NetSuite::Configuration.api_version}.setup.webservices.netsuite.com"
           soap.header = auth_header

data/lib/netsuite/configuration.rb

@@ -11,9 +11,14 @@ module NetSuite
     end
 
     def connection
-      attributes[:connection] ||= Savon::Client.new(self.wsdl)
+      unless attributes[:connection]
+        attributes[:connection] = Savon::Client.new(self.wsdl)
+        attributes[:connection].http.read_timeout = read_timeout
+      end
+
+      attributes[:connection]
     end
-    
+
     def api_version(version = nil)
       if version
         self.api_version = version
@@ -26,6 +31,18 @@ module NetSuite
       attributes[:api_version] = version
     end
 
+    def sandbox=(flag)
+      attributes[:flag] = flag
+    end
+
+    def sandbox(flag = nil)
+      if flag.nil?
+        attributes[:flag] ||= false
+      else
+        self.sandbox = flag
+      end
+    end
+
     def wsdl=(wsdl)
       attributes[:wsdl] = wsdl
     end
@@ -34,7 +51,14 @@ module NetSuite
       if wsdl
         self.wsdl = wsdl
       else
-        attributes[:wsdl] ||= File.expand_path("../../../wsdl/#{api_version}.wsdl", __FILE__)
+        if sandbox
+          wsdl_path = "https://webservices.sandbox.netsuite.com/wsdl/v#{api_version}_0/netsuite.wsdl"
+        else
+          wsdl_path = File.expand_path("../../../wsdl/#{api_version}.wsdl", __FILE__)
+          wsdl_path = "https://webservices.netsuite.com/wsdl/v#{api_version}_0/netsuite.wsdl" unless File.exists? wsdl_path
+        end
+
+        attributes[:wsdl] ||= wsdl_path
       end
     end
 
@@ -106,5 +130,30 @@ module NetSuite
       end
     end
 
+    def read_timeout=(timeout)
+      attributes[:read_timeout] = timeout
+    end
+
+    def read_timeout(timeout = nil)
+      if timeout
+        self.read_timeout = timeout
+      else
+        attributes[:read_timeout] ||= 60
+      end
+    end
+
+    def log=(path)
+      attributes[:log] = path
+    end
+
+    def log(path = nil)
+      self.log = path if path
+      attributes[:log]
+    end
+
+    def logger
+      attributes[:logger] ||= NetSuite::XmlLogger.new (log && !log.empty?) ? log : STDOUT
+    end
+
   end
 end

data/lib/netsuite/namespaces/act_sched.rb

@@ -0,0 +1,11 @@
+module NetSuite
+  	module Namespaces
+    	module ActSched
+
+    		def record_namespace
+        		'actSched'
+      		end
+      		
+    	end
+	end
+end

data/lib/netsuite/records/assembly_item.rb

@@ -41,6 +41,8 @@ module NetSuite
         :supply_replenishment_method, :supply_type, :tax_schedule, :units_type, :vendor
 
       field :custom_field_list, CustomFieldList
+      field :bin_number_list, BinNumberList
+      field :pricing_matrix, PricingMatrix
 
       attr_reader :internal_id
       attr_accessor :external_id

data/lib/netsuite/records/bin_number_list.rb

@@ -0,0 +1,48 @@
+module NetSuite
+  module Records
+    # TODO this is fairly messy: shouldn't mix multiple classes in one file
+    # might be possible to trash the GenericField as well
+    
+    class GenericField
+      include Support::Attributes
+      include Support::Fields
+
+      def initialize(attributes = {})
+        self.attributes = attributes
+      end
+    end
+
+    class BinNumber < GenericField
+
+    end
+
+    class BinNumberList
+      include Support::Fields
+      include Namespaces::PlatformCore
+      # include Namespaces::ListAcct
+
+      fields :bin_number
+
+      def initialize(attributes = {})
+        initialize_from_attributes_hash(attributes)
+      end
+
+      def bin_number=(items)
+        case items
+        when Hash
+          self.bin_numbers << BinNumber.new(items)
+        when Array
+          items.each { |item| self.bin_numbers << BinNumber.new(item) }
+        end
+      end
+
+      def bin_numbers
+        @bin_numbers ||= []
+      end
+
+      def to_record
+        { "#{record_namespace}:item" => bin_numbers.map(&:to_record) }
+      end
+    end
+  end
+end

data/lib/netsuite/records/contact.rb

@@ -0,0 +1,44 @@
+module NetSuite
+  module Records
+    class Contact
+      include Support::Fields
+      include Support::RecordRefs
+      include Support::Records
+      include Support::Actions
+      include Namespaces::ListRel
+
+      actions :get, :add, :delete, :search
+
+      fields :salutation, :first_name, :middle_name, :last_name, :title, :phone, :fax, :email, :default_address,
+             :entity_id, :phonetic_name, :alt_email, :office_phone, :home_phone, :mobile_phone, :supervisor_phone,
+             :assistant_phone, :comments, :bill_pay, :is_private, :is_inactive
+
+      field :addressbook_list,  CustomerAddressbookList
+      field :custom_field_list, CustomFieldList
+      # field :subscriptions_list, SubscriptionsList
+      # field :category_list, CategoryList
+
+      read_only_fields :last_modified_date, :date_created
+
+      record_refs :custom_form, :company, :subsidiary, :supervisor, :assistant, :image, :global_subscription_status
+
+      attr_reader   :internal_id
+      attr_accessor :external_id
+
+      def initialize(attributes = {})
+        @internal_id = attributes.delete(:internal_id) || attributes.delete(:@internal_id)
+        @external_id = attributes.delete(:external_id) || attributes.delete(:@external_id)
+        initialize_from_attributes_hash(attributes)
+      end
+
+      def to_record
+        rec = super
+        if rec["#{record_namespace}:customFieldList"]
+          rec["#{record_namespace}:customFieldList!"] = rec.delete("#{record_namespace}:customFieldList")
+        end
+        rec
+      end
+
+    end
+  end
+end

data/lib/netsuite/records/contact_list.rb

@@ -0,0 +1,52 @@
+module NetSuite
+  module Records
+    class ContactList
+      include Namespaces::ActSched
+
+      def initialize(attributes = {})
+        # - the contact list on the NS GUI doesn't show the assigned contact which shows up in the XML
+        # - you can't add an arbitary number of contacts through the NS GUI
+
+        # TODO the contact list doesn't really work because of the strange XML below (2 assigned companies, one contact)
+        
+        # <actSched:contactList>
+        #   <actSched:contact>
+        #     <actSched:company xmlns:platformCore="urn:core_2012_1.platform.webservices.netsuite.com" internalId="12345">
+        #       <platformCore:name>10001 Another Customer</platformCore:name>
+        #     </actSched:company>
+        #   </actSched:contact>
+        #   <actSched:contact>
+        #     <actSched:company xmlns:platformCore="urn:core_2012_1.platform.webservices.netsuite.com" internalId="12346">
+        #       <platformCore:name>31500 A Customer</platformCore:name>
+        #     </actSched:company>
+        #     <actSched:contact xmlns:platformCore="urn:core_2012_1.platform.webservices.netsuite.com" internalId="12347">
+        #       <platformCore:name>A Person</platformCore:name>
+        #     </actSched:contact>
+        #   </actSched:contact>
+        # </actSched:contactList>
+
+        case attributes[:contact]
+        when Hash
+          contacts << Contact.new(attributes[:contact])
+        when Array
+          attributes[:contact].each { |contact| contacts << Contact.new(contact) }
+        end
+      end
+
+      def <<(contact)
+        @contacts << contact
+      end
+
+      def contacts
+        @contacts ||= []
+      end
+
+      def to_record
+        contacts.map do |contact|
+          { "#{record_namespace}:contact" => contact.to_record }
+        end
+      end
+
+    end
+  end
+end

data/lib/netsuite/records/custom_field.rb

@@ -12,6 +12,10 @@ module NetSuite
         self.attributes = attributes
       end
 
+      def value
+        attributes[:value]
+      end
+
       def to_record
         hash_rec = attributes.inject({}) do |hash, (k,v)|
           kname = "#{record_namespace}:#{k.to_s.lower_camelcase}"

data/lib/netsuite/records/custom_field_list.rb

@@ -6,9 +6,9 @@ module NetSuite
       def initialize(attributes = {})
         case attributes[:custom_field]
         when Hash
-          custom_fields << CustomField.new(attributes[:custom_field])
+          extract_custom_field(attributes[:custom_field])
         when Array
-          attributes[:custom_field].each { |custom_field| custom_fields << CustomField.new(custom_field) }
+          attributes[:custom_field].each { |custom_field| extract_custom_field(custom_field) }
         end
         
         @custom_fields_assoc = Hash.new
@@ -40,6 +40,15 @@ module NetSuite
         }.join
       end
 
+      private
+        def extract_custom_field(custom_field_data)
+          # TODO this needs to be cleaned up & tested; very messy
+          if custom_field_data[:"@xsi:type"] == "platformCore:SelectCustomFieldRef"
+            custom_field_data[:value] = CustomRecordRef.new(custom_field_data.delete(:value))
+          end
+
+          custom_fields << CustomField.new(custom_field_data)
+        end
     end
   end
 end

data/lib/netsuite/records/custom_record_ref.rb

@@ -8,6 +8,8 @@ module NetSuite
       attr_reader   :internal_id
       attr_accessor :external_id, :type_id
 
+      fields :name
+
       def initialize(attributes_or_record = {})
         case attributes_or_record
         when Hash

data/lib/netsuite/records/customer.rb

@@ -7,7 +7,7 @@ module NetSuite
       include Support::Actions
       include Namespaces::ListRel
 
-      actions :get, :add, :delete
+      actions :get, :add, :delete, :search
 
       fields :access_role, :account_number, :aging, :alt_email, :alt_name, :alt_phone, :bill_pay,
         :buying_reason, :buying_time_frame, :campaign_category, :category, :click_stream, :comments, :company_name,

data/lib/netsuite/records/inventory_item.rb

@@ -42,7 +42,9 @@ module NetSuite
 
       field :pricing_matrix, PricingMatrix
       field :custom_field_list, CustomFieldList
-
+      field :bin_number_list, BinNumberList
+      field :pricing_matrix, PricingMatrix
+      
       attr_reader :internal_id
       attr_accessor :external_id
 

data/lib/netsuite/records/invoice.rb

@@ -9,13 +9,13 @@ module NetSuite
 
       actions :get, :initialize, :add, :delete
 
-      fields :alt_handling_cost, :alt_shipping_cost, :balance, :bill_address,
+      fields :alt_handling_cost, :balance, :bill_address,
         :billing_schedule, :contrib_pct, :created_date, :currency_name, :custom_field_list,
         :deferred_revenue, :discount_amount, :discount_date, :discount_item, :discount_rate,
         :due_date, :email, :end_date, :est_gross_profit, :est_gross_profit_percent, :exchange_rate,
         :exclude_commission, :exp_cost_disc_amount, :exp_cost_disc_print, :exp_cost_disc_rate, :exp_cost_disc_tax_1_amt,
         :exp_cost_disc_taxable, :exp_cost_discount, :exp_cost_list, :exp_cost_tax_code, :exp_cost_tax_rate_1,
-        :exp_cost_tax_rate_2, :fax, :fob, :gift_cert_applied, :gift_cert_redemption_list, :handling_cost, :handling_tax_1_rate,
+        :exp_cost_tax_rate_2, :fax, :fob, :gift_cert_redemption_list, :handling_tax_1_rate,
         :handling_tax_2_rate, :handling_tax_code, :is_taxable, :item_cost_disc_amount, :item_cost_disc_print,
         :item_cost_disc_rate, :item_cost_disc_tax_1_amt, :item_cost_disc_taxable, :item_cost_discount, :item_cost_list,
         :item_cost_tax_code, :item_cost_tax_rate_1, :item_cost_tax_rate_2, :item_list, :job, :last_modified_date,
@@ -24,7 +24,7 @@ module NetSuite
         :rev_rec_on_rev_commitment, :rev_rec_schedule, :rev_rec_start_date, :revenue_status, :sales_effective_date,
         :sales_group, :sales_team_list, :ship_address, :ship_date, :ship_group_list,
         :shipping_cost, :shipping_tax_1_rate, :shipping_tax_2_rate, :shipping_tax_code, :source, :start_date,
-        :status, :subsidiary, :sync_partner_teams, :sync_sales_teams, :tax_2_total, :tax_rate,
+        :status, :subsidiary, :sync_partner_teams, :sync_sales_teams, :tax_2_total,
         :tax_total, :time_disc_amount, :time_disc_print, :time_disc_rate, :time_disc_tax_1_amt, :time_disc_taxable,
         :time_discount, :time_list, :time_tax_code, :time_tax_rate_1, :time_tax_rate_2, :to_be_emailed, :to_be_faxed,
         :to_be_printed, :total_cost_estimate, :tracking_numbers, :tran_date, :tran_id, :tran_is_vsoe_bundle,
@@ -35,7 +35,8 @@ module NetSuite
       field :item_list,                InvoiceItemList
       field :custom_field_list,        CustomFieldList
 
-      read_only_fields :sub_total, :discount_total, :total, :recognized_revenue, :amount_remaining, :amount_paid
+      read_only_fields :sub_total, :discount_total, :total, :recognized_revenue, :amount_remaining, :amount_paid,
+                       :alt_shipping_cost, :gift_cert_applied, :tax_rate, :handling_cost
 
       record_refs :account, :bill_address_list, :custom_form, :department, :entity, :klass,
                   :posting_period, :ship_address_list, :terms, :location, :sales_rep, :tax_item, :created_from,

data/lib/netsuite/records/invoice_item.rb

@@ -10,12 +10,14 @@ module NetSuite
         :defer_rev_rec, :description, :gift_cert_from, :gift_cert_message, :gift_cert_number, :gift_cert_recipient_email,
         :gift_cert_recipient_name, :gross_amt, :inventory_detail, :is_taxable, :item_is_fulfilled, :license_code, :line,
         :klass, :options, :order_line, :percent_complete, :quantity, :quantity_available, :quantity_fulfilled,
-        :quantity_on_hand, :quantity_ordered, :quantity_remaining, :rate, :rev_rec_end_date, :rev_rec_start_date,
+        :quantity_on_hand, :quantity_ordered, :rate, :rev_rec_end_date, :rev_rec_start_date,
         :serial_numbers, :ship_group, :tax1_amt, :tax_rate1, :tax_rate2, :vsoe_allocation, :vsoe_amount, :vsoe_deferral,
         :vsoe_delivered, :vsoe_permit_discount, :vsoe_price
 
       field :custom_field_list, CustomFieldList
 
+      read_only_fields :quantity_remaining
+
       record_refs :department, :item, :job, :location, :price, :rev_rec_schedule, :ship_address, :ship_method, :tax_code, :units, :klass
 
       def initialize(attributes_or_record = {})

data/lib/netsuite/records/kit_item.rb

@@ -0,0 +1,7 @@
+module NetSuite
+  module Records
+    class KitItem < InventoryItem
+
+    end
+  end
+end

data/lib/netsuite/records/non_inventory_sale_item.rb

@@ -32,6 +32,7 @@ module NetSuite
 
       field :pricing_matrix, PricingMatrix
       field :custom_field_list, CustomFieldList
+      field :pricing_matrix, PricingMatrix
       
       attr_reader   :internal_id
       attr_accessor :external_id

data/lib/netsuite/records/sales_order.rb

@@ -7,7 +7,7 @@ module NetSuite
       include Support::Actions
       include Namespaces::TranSales
 
-      actions :get, :add, :initialize, :delete, :update
+      actions :get, :add, :initialize, :delete, :update, :search
 
       fields :alt_handling_cost, :alt_shipping_cost, :amount_paid, :amount_remaining, :auto_apply, :balance,
         :bill_address, :contrib_pct, :created_date, :currency_name, :deferred_revenue, :discount_rate, :email, :end_date,

data/lib/netsuite/records/task.rb

@@ -0,0 +1,29 @@
+module NetSuite
+  module Records
+    class Task
+      include Support::Fields
+      include Support::RecordRefs
+      include Support::Records
+      include Support::Actions
+      include Namespaces::ActSched
+
+      actions :get, :add, :delete, :update
+
+      fields :title, :send_email, :message, :status, :access_level, :reminder_type,
+             :reminder_minutes, :start_date, :end_date, :due_date, :timed_event
+
+      field :contact_list, ContactList
+
+      record_refs :assigned, :owner, :company, :contact
+
+      attr_reader   :internal_id
+      attr_accessor :external_id
+
+      def initialize(attributes = {})
+        @internal_id = attributes.delete(:internal_id) || attributes.delete(:@internal_id)
+        @external_id = attributes.delete(:external_id) || attributes.delete(:@external_id)
+        initialize_from_attributes_hash(attributes)
+      end
+    end
+  end
+end

data/lib/netsuite/records/transaction.rb

@@ -0,0 +1,35 @@
+module NetSuite
+  module Records
+    class Transaction
+      include Support::Fields
+      include Support::RecordRefs
+      include Support::Records
+      include Support::Actions
+      include Namespaces::TranSales
+
+      actions :get, :search, :search_more_with_id, :initialize, :add, :delete
+
+      attr_reader   :internal_id
+      attr_accessor :external_id
+
+      def initialize(attributes = {})
+        @internal_id = attributes.delete(:internal_id) || attributes.delete(:@internal_id)
+        @external_id = attributes.delete(:external_id) || attributes.delete(:@external_id)
+        initialize_from_attributes_hash(attributes)
+      end
+
+      def self.custom_soap_advanced_search_record_type
+        'tranSales:TransactionSearchAdvanced'
+      end
+
+      def to_record
+        rec = super
+        if rec["#{record_namespace}:customFieldList"]
+          rec["#{record_namespace}:customFieldList!"] = rec.delete("#{record_namespace}:customFieldList")
+        end
+        rec
+      end
+
+    end
+  end
+end

data/lib/netsuite/response.rb

@@ -1,9 +1,10 @@
 module NetSuite
   class Response
-    attr_accessor :body
+    attr_accessor :header, :body
 
     def initialize(attributes = {})
       @success = attributes[:success]
+      @header = attributes[:header]
       @body    = attributes[:body]
     end
 

data/lib/netsuite/support/actions.rb

@@ -18,6 +18,10 @@ module NetSuite
           case name
           when :get
             self.send(:include, NetSuite::Actions::Get::Support)
+          when :search
+            self.send(:include, NetSuite::Actions::Search::Support)
+          when :search_more_with_id
+            self.send(:include, NetSuite::Actions::SearchMoreWithId::Support)
           when :add
             self.send(:include, NetSuite::Actions::Add::Support)
           when :delete

data/lib/netsuite/support/fields.rb

@@ -28,7 +28,11 @@ module NetSuite
             end
 
             define_method("#{name_sym}=") do |value|
-              attributes[name_sym] = value.kind_of?(klass) ? value : klass.new(value)
+              if value.nil?
+                attributes.delete(name_sym)
+              else
+                attributes[name_sym] = value.kind_of?(klass) ? value : klass.new(value)
+              end
             end
           else
             define_method(name_sym) do
@@ -57,6 +61,12 @@ module NetSuite
           field name
         end
 
+        # a bit of trickery: this is for classes which inherit from other classes
+        # i.e. the AssemblyItem, KitItem, etc; this copies the superclass's fields over
+        def inherited(klass)
+          klass.instance_variable_set("@fields", self.fields)
+          klass.instance_variable_set("@read_only_fields", self.read_only_fields)
+        end
       end
 
     end

data/lib/netsuite/support/requests.rb

@@ -34,13 +34,18 @@ module NetSuite
       end
 
       def build_response
-        Response.new(:success => success?, :body => response_body)
+        Response.new(:success => success?, header: response_header, :body => response_body)
       end
 
       def success?
         raise NotImplementedError, 'Please implement a #success? method'
       end
 
+      # Only care about headers in Search class for now
+      def response_header
+        nil
+      end
+
       def response_body
         raise NotImplementedError, 'Please implement a #response_body method'
       end

data/lib/netsuite/support/search_result.rb

@@ -0,0 +1,67 @@
+module NetSuite
+  module Support
+    class SearchResult
+      attr_accessor :response
+      attr_reader :total_records
+
+      # header from a basic customer search:
+
+      # <platformCore:searchResult xmlns:platformCore="urn:core_2012_1.platform.webservices.netsuite.com">
+      #   <platformCore:status isSuccess="true"/>
+      #   <platformCore:totalRecords>2770</platformCore:totalRecords>
+      #   <platformCore:pageSize>5</platformCore:pageSize>
+      #   <platformCore:totalPages>554</platformCore:totalPages>
+      #   <platformCore:pageIndex>1</platformCore:pageIndex>
+      #   <platformCore:searchId>WEBSERVICES_738944_SB2_03012013650784545962753432_28d96bd280</platformCore:searchId>
+
+      def initialize(response, result_class)
+        @response = response
+        @total_records = response.body[:total_records].to_i
+
+        if @total_records > 0
+          if @total_records == 1
+            [response.body[:record_list][:record]]
+          else
+            response.body[:record_list][:record]
+          end.each do |record|
+            results << result_class.new(record)
+          end
+        end
+
+        # search_results = []
+
+        # if !!response.body[:search_row_list] && !response.body[:search_row_list].empty?
+        #   response.body[:search_row_list][:search_row].each do |record|
+        #     search_result = NetSuite::Support::SearchResult.new(record)
+
+        #     search_results << search_result
+        #   end
+        # end
+
+        # search_id = response.header[:ns_id]
+        # page_index = response.body[:page_index]
+        # total_pages = response.body[:total_pages]
+
+        # response_hash[:search_id] = search_id
+        # response_hash[:page_index] = page_index
+        # response_hash[:total_pages] = total_pages
+        # response_hash[:search_results] = search_results
+        # puts response.body
+        # response_hash
+      end
+
+      def results
+        @results ||= []
+      end
+
+      def next_page
+        
+      end
+
+      def all_pages
+        
+      end
+
+    end
+  end
+end

data/lib/netsuite/version.rb

@@ -1,3 +1,3 @@
 module Netsuite
-  VERSION = '0.0.49'
+  VERSION = '0.0.50'
 end

data/spec/netsuite/configuration_spec.rb

@@ -38,6 +38,14 @@ describe NetSuite::Configuration do
         config.wsdl.should match(/.*\/netsuite\/wsdl\/2011_2\.wsdl/)
       end
     end
+
+    context 'when the wsdl has not been set, but the API has been set' do
+      it 'should correctly return the full HTTP sandbox URL' do
+        config.api_version '2013_1'
+        config.sandbox false
+        config.wsdl.should eql('https://webservices.netsuite.com/wsdl/v2013_1_0/netsuite.wsdl')
+      end
+    end
   end
 
   describe '#auth_header' do

data/spec/netsuite/records/non_inventory_sale_item_spec.rb

@@ -23,8 +23,9 @@ describe NetSuite::Records::NonInventorySaleItem do
       item.should have_field(field)
     end
 
-    item.pricing_matrix.class.should == NetSuite::Records::PricingMatrix
+    # TODO there is a probably a more robust way to test this
     item.custom_field_list.class.should == NetSuite::Records::CustomFieldList
+    item.pricing_matrix.class.should == NetSuite::Records::PricingMatrix
   end
 
   it 'has the right record_refs' do

data/spec/netsuite/support/record_refs_spec.rb

@@ -1,5 +1,14 @@
 require 'spec_helper'
 
 describe NetSuite::Support::RecordRefs do
-  pending
+  let(:klass) { Class.new.send(:include, NetSuite::Support::Fields) }
+  let(:instance) { klass.new }
+
+  context "assigning record reference" do
+    it 'assigns a nil value for a field with a specified class' do
+      klass.field(:record_test, NetSuite::Records::RecordRef)
+      instance.record_test = nil
+      instance.attributes.has_key?(:record_test).should be_false
+    end
+  end
 end

metadata

@@ -2,7 +2,7 @@
 name: netsuite
 version: !ruby/object:Gem::Version
   prerelease: 
-  version: 0.0.49
+  version: 0.0.50
 platform: ruby
 authors:
 - Ryan Moran
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-02-19 00:00:00.000000000 Z
+date: 2013-04-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   version_requirements: !ruby/object:Gem::Requirement
@@ -112,10 +112,13 @@ files:
 - lib/netsuite/actions/delete.rb
 - lib/netsuite/actions/get.rb
 - lib/netsuite/actions/initialize.rb
+- lib/netsuite/actions/search.rb
+- lib/netsuite/actions/search_more_with_id.rb
 - lib/netsuite/actions/update.rb
 - lib/netsuite/configuration.rb
 - lib/netsuite/core_ext/string/lower_camelcase.rb
 - lib/netsuite/errors.rb
+- lib/netsuite/namespaces/act_sched.rb
 - lib/netsuite/namespaces/list_acct.rb
 - lib/netsuite/namespaces/list_rel.rb
 - lib/netsuite/namespaces/platform_common.rb
@@ -128,7 +131,10 @@ files:
 - lib/netsuite/records/accounting_period.rb
 - lib/netsuite/records/assembly_item.rb
 - lib/netsuite/records/bill_address.rb
+- lib/netsuite/records/bin_number_list.rb
 - lib/netsuite/records/classification.rb
+- lib/netsuite/records/contact.rb
+- lib/netsuite/records/contact_list.rb
 - lib/netsuite/records/credit_memo.rb
 - lib/netsuite/records/credit_memo_apply.rb
 - lib/netsuite/records/credit_memo_apply_list.rb
@@ -158,6 +164,7 @@ files:
 - lib/netsuite/records/journal_entry.rb
 - lib/netsuite/records/journal_entry_line.rb
 - lib/netsuite/records/journal_entry_line_list.rb
+- lib/netsuite/records/kit_item.rb
 - lib/netsuite/records/location.rb
 - lib/netsuite/records/non_inventory_sale_item.rb
 - lib/netsuite/records/payment_method.rb
@@ -168,7 +175,9 @@ files:
 - lib/netsuite/records/sales_order_item.rb
 - lib/netsuite/records/sales_order_item_list.rb
 - lib/netsuite/records/ship_address.rb
+- lib/netsuite/records/task.rb
 - lib/netsuite/records/term.rb
+- lib/netsuite/records/transaction.rb
 - lib/netsuite/response.rb
 - lib/netsuite/support/actions.rb
 - lib/netsuite/support/attributes.rb
@@ -176,6 +185,7 @@ files:
 - lib/netsuite/support/record_refs.rb
 - lib/netsuite/support/records.rb
 - lib/netsuite/support/requests.rb
+- lib/netsuite/support/search_result.rb
 - lib/netsuite/version.rb
 - lib/netsuite/xml_logger.rb
 - netsuite.gemspec