netsuite 0.2.6 → 0.3.0

data/lib/netsuite/actions/add.rb

@@ -1,3 +1,4 @@
+# https://system.netsuite.com/help/helpcenter/en_US/Output/Help/SuiteCloudCustomizationScriptingWebServices/SuiteTalkWebServices/add.html
 module NetSuite
   module Actions
     class Add

data/lib/netsuite/actions/delete.rb

@@ -1,3 +1,4 @@
+# https://system.netsuite.com/help/helpcenter/en_US/Output/Help/SuiteCloudCustomizationScriptingWebServices/SuiteTalkWebServices/delete.html
 module NetSuite
   module Actions
     class Delete

data/lib/netsuite/actions/get.rb

@@ -1,3 +1,4 @@
+# https://system.netsuite.com/help/helpcenter/en_US/Output/Help/SuiteCloudCustomizationScriptingWebServices/SuiteTalkWebServices/get.html
 module NetSuite
   module Actions
     class Get

data/lib/netsuite/actions/get_all.rb

@@ -0,0 +1,67 @@
+# https://system.netsuite.com/help/helpcenter/en_US/Output/Help/SuiteCloudCustomizationScriptingWebServices/SuiteTalkWebServices/getAll.html
+module NetSuite
+  module Actions
+    class GetAll
+      include Support::Requests
+
+      def initialize(klass)
+        @klass   = klass
+      end
+
+      private
+
+      def request(credentials={})
+        NetSuite::Configuration.connection(
+          { element_form_default: :unqualified }, credentials
+        ).call(:get_all, message: request_body)
+      end
+
+      # <soap:Body>
+      #   <platformMsgs:getAll>
+      #     <record>
+      #       <recordType>salesTaxItem</recordType>
+      #     </record>
+      #   </platformMsgs:getAll>
+      # </soap:Body>
+      def request_body
+        type = @klass.to_s.split('::').last.sub(/[A-Z]/) { |m| m[0].downcase }
+
+        {
+          record: [
+            record_type: type
+          ]
+        }
+      end
+
+      def success?
+        @success ||= response_hash[:status][:@is_success] == 'true'
+      end
+
+      def response_body
+        @response_body ||= response_hash[:record_list][:record]
+      end
+
+      def response_hash
+        @response_hash = @response.body[:get_all_response][:get_all_result]
+      end
+
+      module Support
+
+        def self.included(base)
+          base.extend(ClassMethods)
+        end
+
+        module ClassMethods
+          def get_all(credentials = {})
+            response = NetSuite::Actions::GetAll.call([self], credentials)
+            if response.success?
+              response.body.map { |attr| new(attr) }
+            else
+              raise RecordNotFound, "#{self} with OPTIONS=#{options.inspect} could not be found"
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/netsuite/actions/get_list.rb

@@ -1,3 +1,4 @@
+# https://system.netsuite.com/help/helpcenter/en_US/Output/Help/SuiteCloudCustomizationScriptingWebServices/SuiteTalkWebServices/getList.html
 module NetSuite
   module Actions
     class GetList
@@ -87,4 +88,4 @@ module NetSuite
       end
     end
   end
-end
+end

data/lib/netsuite/actions/get_select_value.rb

@@ -1,3 +1,4 @@
+# https://system.netsuite.com/help/helpcenter/en_US/Output/Help/SuiteCloudCustomizationScriptingWebServices/SuiteTalkWebServices/getSelectValue.html
 module NetSuite
   module Actions
     class GetSelectValue

data/lib/netsuite/actions/initialize.rb

@@ -1,3 +1,4 @@
+# https://system.netsuite.com/help/helpcenter/en_US/Output/Help/SuiteCloudCustomizationScriptingWebServices/SuiteTalkWebServices/initializeinitializeList.html
 module NetSuite
   module Actions
     class Initialize

data/lib/netsuite/actions/login.rb

@@ -1,3 +1,4 @@
+# https://system.netsuite.com/help/helpcenter/en_US/Output/Help/SuiteCloudCustomizationScriptingWebServices/SuiteTalkWebServices/login.html
 module NetSuite
   module Actions
     class Login
@@ -6,6 +7,7 @@ module NetSuite
         passport = NetSuite::Configuration.auth_header.dup
         passport['platformMsgs:passport']['platformCore:email'] = credentials[:email] || ''
         passport['platformMsgs:passport']['platformCore:password'] = credentials[:password] || ''
+        passport['platformMsgs:passport']['platformCore:role'] = credentials[:role] || ''
 
         begin
           response = NetSuite::Configuration.connection(soap_header: {}).call :login, message: passport

data/lib/netsuite/actions/search.rb

@@ -1,3 +1,4 @@
+# https://system.netsuite.com/help/helpcenter/en_US/Output/Help/SuiteCloudCustomizationScriptingWebServices/SuiteTalkWebServices/search.html
 module NetSuite
   module Actions
     class Search
@@ -21,7 +22,7 @@ module NetSuite
         # https://system.netsuite.com/help/helpcenter/en_US/Output/Help/SuiteCloudCustomizationScriptingWebServices/SuiteTalkWebServices/SettingSearchPreferences.html
         # https://webservices.netsuite.com/xsd/platform/v2012_2_0/messages.xsd
 
-        preferences = NetSuite::Configuration.auth_header(credentials).update(
+        preferences = NetSuite::Configuration.auth_header(credentials).merge(
           (@options.delete(:preferences) || {}).inject({'platformMsgs:SearchPreferences' => {}}) do |h, (k, v)|
             h['platformMsgs:SearchPreferences'][k.to_s.lower_camelcase] = v
             h
@@ -116,7 +117,7 @@ module NetSuite
                 'platformCore:customField' => custom_field_list,
                 :attributes! => {
                   'platformCore:customField' => {
-                    'internalId' => condition[:value].map { |h| h[:field] },
+                    'scriptId' => condition[:value].map { |h| h[:field] },
                     'operator' => condition[:value].map { |h| h[:operator] },
                     'xsi:type' => condition[:value].map { |h| "platformCore:#{h[:type]}" }
                   }

data/lib/netsuite/actions/update.rb

@@ -1,8 +1,11 @@
+# https://system.netsuite.com/help/helpcenter/en_US/Output/Help/SuiteCloudCustomizationScriptingWebServices/SuiteTalkWebServices/update.html
 module NetSuite
   module Actions
     class Update
       include Support::Requests
 
+      attr_reader :response_hash
+
       def initialize(klass, attributes)
         @klass      = klass
         @attributes = attributes
@@ -48,15 +51,30 @@ module NetSuite
         @response_body ||= response_hash[:base_ref]
       end
 
+      def response_errors
+        if response_hash[:status] && response_hash[:status][:status_detail]
+          @response_errors ||= errors
+        end
+      end
+
       def response_hash
         @response_hash ||= @response.to_hash[:update_response][:write_response]
       end
 
+      def errors
+        error_obj = response_hash[:status][:status_detail]
+        error_obj = [error_obj] if error_obj.class == Hash
+        error_obj.map do |error|
+          NetSuite::Error.new(error)
+        end
+      end
+
       module Support
         def update(options = {}, credentials={})
           options.merge!(:internal_id => internal_id) if respond_to?(:internal_id) && internal_id
           options.merge!(:external_id => external_id) if respond_to?(:external_id) && external_id
           response = NetSuite::Actions::Update.call([self.class, options], credentials)
+          @errors = response.errors
           response.success?
         end
       end

data/lib/netsuite/actions/upsert.rb

@@ -1,3 +1,4 @@
+# https://system.netsuite.com/help/helpcenter/en_US/Output/Help/SuiteCloudCustomizationScriptingWebServices/SuiteTalkWebServices/upsert.html
 module NetSuite
   module Actions
     class Upsert

data/lib/netsuite/actions/upsert_list.rb

@@ -0,0 +1,114 @@
+# https://system.netsuite.com/help/helpcenter/en_US/Output/Help/SuiteCloudCustomizationScriptingWebServices/SuiteTalkWebServices/upsertList.html
+module NetSuite
+  module Actions
+    class UpsertList
+      include Support::Requests
+
+      def initialize(*objects)
+        @objects = objects
+      end
+
+      private
+
+      def request(credentials={})
+        NetSuite::Configuration.connection(
+          { element_form_default: :unqualified }, credentials
+        ).call(:upsert_list, message: request_body)
+      end
+
+      # <soap:Body>
+      #   <upsertList>
+      #     <record xsi:type="listRel:Customer" externalId="ext1">
+      #       <listRel:entityId>Shutter Fly</listRel:entityId>
+      #       <listRel:companyName>Shutter Fly, Inc</listRel:companyName>
+      #     </record>
+      #     <record xsi:type="listRel:Customer" externalId="ext2">
+      #       <listRel:entityId>Target</listRel:entityId>
+      #       <listRel:companyName>Target</listRel:companyName>
+      #     </record>
+      #   </upsertList>
+      # </soap:Body>
+      def request_body
+        attrs = @objects.map do |o|
+          hash = o.to_record.merge({
+            '@xsi:type' => o.record_type
+          })
+
+          if o.respond_to?(:external_id) && o.external_id
+            hash['@externalId'] = o.external_id
+          end
+
+          hash
+        end
+
+        { 'record' => attrs }
+      end
+
+      def response_hash
+        @response_hash ||= Array[@response.body[:upsert_list_response][:write_response_list][:write_response]].flatten
+      end
+
+      def response_body
+        @response_body ||= response_hash.map { |h| h[:base_ref] }
+      end
+
+      def response_errors
+        if response_hash.any? { |h| h[:status] && h[:status][:status_detail] }
+          @response_errors ||= errors
+        end
+      end
+
+      def errors
+        errors = response_hash.select { |h| h[:status] && h[:status][:status_detail] }.map do |obj|
+          error_obj = obj[:status][:status_detail]
+          error_obj = [error_obj] if error_obj.class == Hash
+          errors = error_obj.map do |error|
+            NetSuite::Error.new(error)
+          end
+
+          [obj[:base_ref][:@external_id], errors]
+        end
+        Hash[errors]
+      end
+
+      def success?
+        @success ||= response_hash.all? { |h| h[:status][:@is_success] == 'true' }
+      end
+
+      module Support
+
+        def self.included(base)
+          base.extend(ClassMethods)
+        end
+
+        module ClassMethods
+          def upsert_list(records, credentials = {})
+            netsuite_records = records.map do |r|
+              if r.kind_of?(self)
+                r
+              else
+                self.new(r)
+              end
+            end
+
+            response = NetSuite::Actions::UpsertList.call(netsuite_records, credentials)
+
+            if response.success?
+              response.body.map do |attr|
+                record = netsuite_records.find do |r|
+                  r.external_id == attr[:@external_id]
+                end
+
+                record.instance_variable_set('@internal_id', attr[:@internal_id])
+              end
+
+              netsuite_records
+            else
+              false
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/netsuite/configuration.rb

@@ -101,8 +101,13 @@ module NetSuite
         'xmlns:listAcct'       => "urn:accounting_#{api_version}.lists.webservices.netsuite.com",
         'xmlns:tranBank'       => "urn:bank_#{api_version}.transactions.webservices.netsuite.com",
         'xmlns:tranCust'       => "urn:customers_#{api_version}.transactions.webservices.netsuite.com",
+        'xmlns:tranInvt'       => "urn:inventory_#{api_version}.transactions.webservices.netsuite.com",
         'xmlns:listSupport'    => "urn:support_#{api_version}.lists.webservices.netsuite.com",
         'xmlns:tranGeneral'    => "urn:general_#{api_version}.transactions.webservices.netsuite.com",
+        'xmlns:listMkt'        => "urn:marketing_#{api_version}.lists.webservices.netsuite.com",
+        'xmlns:listWebsite'    => "urn:website_#{api_version}.lists.webservices.netsuite.com",
+        'xmlns:fileCabinet'    => "urn:filecabinet_#{api_version}.documents.webservices.netsuite.com",
+        'xmlns:listEmp'        => "urn:employees_#{api_version}.lists.webservices.netsuite.com"
       }
     end
 

data/lib/netsuite/namespaces/file_cabinet.rb

@@ -0,0 +1,11 @@
+module NetSuite
+  module Namespaces
+    module FileCabinet
+
+      def record_namespace
+        'fileCabinet'
+      end
+
+    end
+  end
+end

data/lib/netsuite/namespaces/list_emp.rb

@@ -0,0 +1,12 @@
+module NetSuite
+  module Namespaces
+    module ListEmp
+
+      # https://webservices.sandbox.netsuite.com/xsd/lists/v2013_2_0/employees.xsd
+      def record_namespace
+        'listEmp'
+      end
+
+    end
+  end
+end

data/lib/netsuite/namespaces/list_mkt.rb

@@ -0,0 +1,12 @@
+module NetSuite
+  module Namespaces
+    module ListMkt
+
+      # https://webservices.sandbox.netsuite.com/xsd/lists/v2013_2_0/marketing.xsd
+      def record_namespace
+        'listMkt'
+      end
+
+    end
+  end
+end

data/lib/netsuite/namespaces/list_website.rb

@@ -0,0 +1,11 @@
+module NetSuite
+  module Namespaces
+    module ListWebsite
+
+      def record_namespace
+        'listWebsite'
+      end
+
+    end
+  end
+end

data/lib/netsuite/namespaces/tran_invt.rb

@@ -0,0 +1,11 @@
+module NetSuite
+  module Namespaces
+    module TranInvt
+
+      def record_namespace
+        'tranInvt'
+      end
+
+    end
+  end
+end

data/lib/netsuite/records/accounting_period.rb

@@ -6,7 +6,7 @@ module NetSuite
       include Support::Actions
       include Namespaces::ListAcct
 
-      actions :get, :add, :delete, :search
+      actions :get, :add, :delete, :upsert, :search
 
       fields :allow_non_gl_changes, :end_date, :is_adjust, :is_quarter, :is_year, :period_name, :start_date
 

data/lib/netsuite/records/assembly_item.rb

@@ -7,14 +7,14 @@ module NetSuite
       include Support::Actions
       include Namespaces::ListAcct
 
-      actions :get, :add, :delete
+      actions :get, :get_list, :get_select_value, :add, :delete, :update, :upsert, :upsert_list, :search
 
-      fields :auto_lead_time, :auto_preferred_stock_level, :auto_reorder_point, :available_to_partners, :average_cost,
+      fields :auto_lead_time, :auto_preferred_stock_level, :auto_reorder_point, :available_to_partners, :average_cost, :build_entire_assembly,
         :copy_description, :cost, :cost_estimate, :cost_estimate_type, :cost_estimate_units, :cost_units, :costing_method,
-        :costing_method_display, :country_of_manufacture, :created_date, :currency, :date_converted_to_inv,
+        :costing_method_display, :country_of_manufacture, :created_date, :currency, :date_converted_to_inv, :description,
         :default_return_cost, :demand_modifier, :display_name, :dont_show_price, :enforce_min_qty_internally,
         :exclude_from_sitemap, :featured_description, :fixed_lot_size, :handling_cost, :handling_cost_units, :include_children,
-        :is_donation_item, :is_drop_ship_item, :is_gco_compliant, :is_inactive, :is_online, :is_special_order_item, :is_taxable,
+        :is_donation_item, :is_drop_ship_item, :is_gco_compliant, :is_inactive, :is_online, :is_special_order_item, :is_special_work_order_item, :is_taxable,
         :item_id, :last_modified_date, :last_purchase_price, :lead_time, :manufacturer, :manufacturer_addr1, :manufacturer_city,
         :manufacturer_state, :manufacturer_tariff, :manufacturer_tax_id, :manufacturer_zip, :match_bill_to_receipt,
         :matrix_type, :max_donation_amount, :meta_tag_html, :minimum_quantity, :minimum_quantity_units, :mpn,
@@ -43,6 +43,8 @@ module NetSuite
       field :custom_field_list, CustomFieldList
       field :bin_number_list, BinNumberList
       field :pricing_matrix, PricingMatrix
+      field :member_list, MemberList
+      field :subsidiary_list, RecordRefList
 
       attr_reader :internal_id
       attr_accessor :external_id
@@ -52,6 +54,10 @@ module NetSuite
         @external_id = attributes.delete(:external_id) || attributes.delete(:@external_id)
         initialize_from_attributes_hash(attributes)
       end
+
+      def self.search_class_name
+        "Item"
+      end
     end
   end
 end

data/lib/netsuite/records/billing_schedule.rb

@@ -0,0 +1,33 @@
+module NetSuite
+  module Records
+    class BillingSchedule
+      include Support::Fields
+      include Support::RecordRefs
+      include Support::Records
+      include Support::Actions
+      include Namespaces::ListAcct
+
+      actions :get, :add, :delete, :upsert, :search
+
+      fields :bill_for_actuals, :day_period, :frequency, :in_arrears, :initial_amount, :is_inactive,
+        :is_public, :month_dom, :month_dow, :month_dowim, :month_mode, :name,
+        :number_remaining, :recurrence_dow_mask_list, :repeat_every, :schedule_type, 
+        :series_start_date, :year_dom, :year_dow, :year_dowim, :year_dowim_month, 
+        :year_mode, :year_month
+
+      record_refs :initial_terms, :project, :recurrence_terms, :transaction
+
+      attr_reader :internal_id
+      attr_accessor :external_id
+
+      field :milestone_list,  BillingScheduleMilestoneList
+      field :recurrence_list, BillingScheduleRecurrenceList
+
+      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