netsuite 0.8.4 → 0.8.8

data/lib/netsuite/records/item_fulfillment.rb

@@ -11,7 +11,7 @@ module NetSuite
 
       fields :tran_date, :tran_id, :shipping_cost, :memo, :ship_company, :ship_attention, :ship_addr1,
         :ship_addr2, :ship_city, :ship_state, :ship_zip, :ship_phone, :ship_is_residential,
-        :ship_status, :last_modified_date, :created_date
+        :ship_status, :last_modified_date, :created_date, :status
 
       read_only_fields :handling_cost
 

data/lib/netsuite/records/lot_numbered_inventory_item.rb

@@ -0,0 +1,116 @@
+module NetSuite
+  module Records
+    class LotNumberedInventoryItem
+      include Support::Fields
+      include Support::RecordRefs
+      include Support::Records
+      include Support::Actions
+      include Namespaces::ListAcct
+
+      # http://www.netsuite.com/help/helpcenter/en_US/srbrowser/Browser2018_2/schema/record/lotnumberedinventoryitem.html
+
+      # TODO
+      # countryOfManufacture	Country
+      # hazmatPackingGroup	HazmatPackingGroup
+      # accountingBookDetailList	ItemAccountingBookDetailList
+      # costEstimateType	ItemCostEstimateType
+      # costingMethod	ItemCostingMethod
+      # invtClassification	ItemInvtClassification
+      # matrixType	ItemMatrixType
+      # itemOptionsList	ItemOptionsList
+      # outOfStockBehavior	ItemOutOfStockBehavior
+      # overallQuantityPricingType	ItemOverallQuantityPricingType
+      # preferenceCriterion	ItemPreferenceCriterion
+      # itemVendorList	ItemVendorList
+      # weightUnit	ItemWeightUnit
+      # hierarchyVersionsList	LotNumberedInventoryItemHierarchyVersionsList
+      # numbersList	LotNumberedInventoryItemNumbersList
+      # periodicLotSizeType	PeriodicLotSizeType
+      # presentationItemList	PresentationItemList
+      # productFeedList	ProductFeedList
+
+      field :pricing_matrix, PricingMatrix
+      field :custom_field_list, CustomFieldList
+      field :bin_number_list, BinNumberList
+      field :locations_list, LocationsList
+      field :item_vendor_list, ItemVendorList
+      field :matrix_option_list, MatrixOptionList
+      field :subsidiary_list, RecordRefList
+
+      actions :get, :get_list, :add, :delete, :search, :update, :upsert, :update_list
+
+      record_refs :alternate_demand_source_item, :asset_account, :bill_exch_rate_variance_acct,
+                  :billing_schedule, :bill_price_variance_acct, :bill_qty_variance_acct,
+                  :klass, :cogs_account, :cost_category, :create_revenue_plans_on,
+                  :custom_form, :default_item_ship_method, :deferred_revenue_account,
+                  :demand_source, :department, :dropship_expense_account, :gain_loss_account,
+                  :income_account, :interco_cogs_account, :interco_income_account,
+                  :issue_product, :item_revenue_category, :location, :parent, :preferred_location,
+                  :pricing_group, :purchase_price_variance_acct, :purchase_tax_code, :purchase_unit,
+                  :quantity_pricing_schedule, :revenue_allocation_group, :revenue_recognition_rule,
+                  :rev_rec_forecast_rule, :rev_rec_schedule, :sales_tax_code, :sale_unit,
+                  :ship_package, :soft_descriptor, :stock_unit, :store_display_image,
+                  :store_display_thumbnail, :store_item_template, :supply_lot_sizing_method,
+                  :supply_replenishment_method, :supply_type, :tax_schedule, :units_type, :vendor
+
+      # TODO
+      # itemNumberOptionsList	RecordRefList
+      # itemShipMethodList	RecordRefList
+      # subsidiaryList	RecordRefList
+      # scheduleBCode	ScheduleBCode
+      # itemCarrier	ShippingCarrier
+      # siteCategoryList	SiteCategoryList
+      # sitemapPriority	SitemapPriority
+      # translationsList	TranslationList
+      # vsoeDeferral	VsoeDeferral
+      # vsoePermitDiscount	VsoePermitDiscount
+      # vsoeSopGroup	VsoeSopGroup
+
+      fields  :auto_lead_time, :auto_preferred_stock_level, :auto_reorder_point, :available_to_partners,
+              :copy_description, :direct_revenue_posting, :dont_show_price, :enforce_min_qty_internally,
+              :exclude_from_sitemap, :include_children, :is_donation_item, :is_drop_ship_item, :is_gco_compliant,
+              :is_hazmat_item, :is_inactive, :is_online, :is_special_order_item, :is_store_pickup_allowed,
+              :is_taxable, :match_bill_to_receipt, :mult_manufacture_addr, :offer_support, :on_special,
+              :prices_include_tax, :producer, :round_up_as_component, :seasonal_demand, :ship_individually,
+              :show_default_donation_amount, :track_landed_cost, :use_bins, :use_marginal_rates, :vsoe_delivered,
+              :created_date, :expiration_date, :last_invt_count_date, :last_modified_date, :next_invt_count_date,
+              :average_cost, :cost, :cost_estimate, :default_return_cost, :demand_modifier, :fixed_lot_size,
+              :handling_cost, :hazmat_item_units_qty, :last_purchase_price, :max_donation_amount,
+              :on_hand_value_mli, :preferred_stock_level, :preferred_stock_level_days, :purchase_order_amount,
+              :purchase_order_quantity, :purchase_order_quantity_diff, :quantity_available,
+              :quantity_back_ordered, :quantity_committed, :quantity_on_hand, :quantity_on_order,
+              :rate, :receipt_amount, :receipt_quantity, :receipt_quantity_diff, :reorder_point,
+              :safety_stock_level, :shipping_cost, :total_value, :transfer_price, :vsoe_price,
+              :weight, :backward_consumption_days, :demand_time_fence, :forward_consumption_days,
+              :invt_count_interval, :lead_time, :maximum_quantity, :minimum_quantity, :periodic_lot_size_days,
+              :reorder_multiple, :reschedule_in_days, :reschedule_out_days, :safety_stock_level_days,
+              :schedule_b_quantity, :shopzilla_category_id, :supply_time_fence, :costing_method_display,
+              :cost_units, :currency, :display_name, :featured_description, :handling_cost_units,
+              :hazmat_hazard_class, :hazmat_id, :hazmat_item_units, :hazmat_shipping_name, :item_id,
+              :manufacturer, :manufacturer_addr1, :manufacturer_city, :manufacturer_state,
+              :manufacturer_tariff, :manufacturer_tax_id, :manufacturer_zip, :matrix_item_name_template,
+              :meta_tag_html, :minimum_quantity_units, :mpn, :nex_tag_category, :no_price_message,
+              :out_of_stock_message, :page_title, :preferred_stock_level_units, :purchase_description,
+              :quantity_on_hand_units, :quantity_reorder_units, :related_items_description,
+              :reorder_point_units, :safety_stock_level_units, :sales_description, :schedule_b_number,
+              :search_keywords, :serial_numbers, :shipping_cost_units, :shopping_dot_com_category,
+              :specials_description, :stock_description, :store_description, :store_detailed_description,
+              :store_display_name, :upc_code, :url_component, :vendor_name, :weight_units
+
+
+      attr_reader :internal_id
+      attr_accessor :external_id, :search_joins
+
+      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.search_class_name
+        "Item"
+      end
+
+    end
+  end
+end

data/lib/netsuite/records/matrix_option_list.rb

@@ -15,10 +15,14 @@ module NetSuite
       #
       #   <listAcct:matrixOptionList>
       #     <listAcct:matrixOption internalId="45" scriptId="custitem13">
-      #       <platformCore:value internalId="4" typeId="28"/>
+      #       <platformCore:value internalId="4" typeId="28">
+      #         <platformCore:name>foo</platformCore:name>
+      #       </platformCore:value>
       #     </listAcct:matrixOption>
       #     <listAcct:matrixOption internalId="46" scriptId="custitem14">
-      #       <platformCore:value internalId="1" typeId="29"/>
+      #       <platformCore:value internalId="1" typeId="29">
+      #         <platformCore:name>bar</platformCore:name>
+      #       </platformCore:value>
       #     </listAcct:matrixOption>
       #   </listAcct:matrixOptionList>
       #
@@ -27,13 +31,17 @@ module NetSuite
         when Hash
           options << OpenStruct.new(
             type_id: attributes[:matrix_option][:value][:'@type_id'],
-            value_id: attributes[:matrix_option][:value][:'@internal_id']
+            value_id: attributes[:matrix_option][:value][:'@internal_id'],
+            script_id: attributes[:matrix_option][:@script_id],
+            name: attributes[:matrix_option][:value][:name]
           )
         when Array
           attributes[:matrix_option].each do |option|
             options << OpenStruct.new(
               type_id: option[:value][:'@type_id'],
-              value_id: option[:value][:'@internal_id']
+              value_id: option[:value][:'@internal_id'],
+              script_id: option[:@script_id],
+              name: option[:value][:name]
             )
           end
         end

data/lib/netsuite/records/message.rb

@@ -0,0 +1,30 @@
+module NetSuite
+  module Records
+    class Message
+      include Support::Fields
+      include Support::RecordRefs
+      include Support::Records
+      include Support::Actions
+      include Namespaces::CommGeneral
+
+      actions :get, :add, :delete, :search
+      
+      fields :bcc, :cc, :compress_attachments, :date_time, :emailed, :incoming,
+             :message, :record_name, :record_type_name, :subject
+
+      read_only_fields :last_modified_date, :message_date
+
+      record_refs :activity, :author, :recipient, :transaction
+
+      attr_reader :internal_id
+      attr_accessor :external_id
+
+      def initialize(attributes_or_record = {})
+        @internal_id = attributes_or_record.delete(:internal_id) || attributes_or_record.delete(:@internal_id)
+        @external_id = attributes_or_record.delete(:external_id) || attributes_or_record.delete(:@external_id)
+        initialize_from_attributes_hash(attributes_or_record)
+      end
+
+    end
+  end
+end

data/lib/netsuite/records/non_inventory_resale_item.rb

@@ -33,6 +33,7 @@ module NetSuite
       field :custom_field_list, CustomFieldList
       field :pricing_matrix, PricingMatrix
       field :subsidiary_list, RecordRefList
+      field :item_vendor_list, ItemVendorList
 
 
       attr_reader   :internal_id

data/lib/netsuite/records/non_inventory_sale_item.rb

@@ -10,7 +10,7 @@ module NetSuite
       actions :get, :get_list, :add, :delete, :search, :update, :upsert
 
       fields :available_to_partners, :cost_estimate, :cost_estimate_type, :cost_estimate_units, :country_of_manufacture,
-        :created_date, :display_name, :dont_show_price, :enforce_min_qty_internally, :exclude_from_sitemap,
+        :created_date, :direct_revenue_posting, :display_name, :dont_show_price, :enforce_min_qty_internally, :exclude_from_sitemap,
         :featured_description, :handling_cost, :handling_cost_units, :include_children, :is_donation_item, :is_fulfillable,
         :is_gco_compliant, :is_inactive, :is_online, :is_taxable, :item_id, :last_modified_date, :manufacturer,
         :manufacturer_addr1, :manufacturer_city, :manufacturer_state, :manufacturer_tariff, :manufacturer_tax_id,

data/lib/netsuite/records/other_charge_sale_item.rb

@@ -52,11 +52,11 @@ module NetSuite
                   :units_type, :sales_tax_code, :sale_unit, :tax_schedule, :parent
 
       field :custom_field_list, CustomFieldList
-      # :pricing_matrix,
+      field :pricing_matrix, PricingMatrix
       # :translations_list,
       # :matrix_option_list,
       # :item_options_list
-      # :subsidiary_list,
+      field :subsidiary_list, RecordRefList
 
       def initialize(attributes = {})
         @internal_id = attributes.delete(:internal_id) || attributes.delete(:@internal_id)

data/lib/netsuite/records/partner.rb

@@ -8,15 +8,17 @@ module NetSuite
       include Support::RecordRefs
       include Namespaces::ListRel
 
-      # https://system.netsuite.com/help/helpcenter/en_US/srbrowser/Browser2014_1/schema/record/partner.html
+      # https://system.netsuite.com/help/helpcenter/en_US/srbrowser/Browser2020_2/schema/record/partner.html
 
       actions :get, :get_list, :add, :update, :upsert, :upsert_list, :delete, :search
 
-      fields :phone, :home_phone, :first_name, :last_name, :alt_name, :is_inactive, :email, :give_access,
-             :partner_code, :is_person, :company_name, :eligible_for_commission, :entity_id, :last_modified_date,
-             :date_created, :title, :mobile_phone, :comments, :middle_name, :send_email, :password, :password2
+      fields :alt_email, :alt_name, :bcn, :comments, :company_name, :date_created, :default_address,
+             :eligible_for_commission, :email, :entity_id, :fax, :first_name, :give_access, :home_phone, :is_inactive,
+             :is_person, :last_modified_date, :last_name, :login_as, :middle_name, :mobile_phone, :partner_code,
+             :password, :password2, :phone, :phonetic_name, :print_on_check_as, :referring_url, :require_pwd_change,
+             :salutation, :send_email, :sub_partner_login, :tax_id_num, :title, :url, :vat_reg_number
 
-      record_refs :klass, :access_role, :department
+      record_refs :access_role, :klass, :custom_form, :default_tax_reg, :department, :image, :location, :parent, :subsidiary
 
       attr_reader   :internal_id
       attr_accessor :external_id

data/lib/netsuite/records/serialized_assembly_item.rb

@@ -61,7 +61,6 @@ module NetSuite
         :hazmat_packing_group,
         :hazmat_shipping_name,
         :include_children,
-        :income_account,
         :interco_cogs_account,
         :interco_income_account,
         :invt_classification,
@@ -209,6 +208,8 @@ module NetSuite
         :wip_acct,
         :wip_variance_acct
 
+      record_refs :income_account
+
       # accountingBookDetailList	ItemAccountingBookDetailList
       # binNumberList	InventoryItemBinNumberList
       # itemOptionsList	ItemOptionsList
@@ -220,6 +221,7 @@ module NetSuite
       # siteCategoryList	SiteCategoryList
       # translationsList	TranslationList
 
+      field :subsidiary_list, RecordRefList
       field :custom_field_list, CustomFieldList
 
       attr_reader :internal_id

data/lib/netsuite/records/service_resale_item.rb

@@ -9,7 +9,7 @@ module NetSuite
 
       actions :get, :get_list, :add, :update, :delete, :upsert, :search
 
-      fields :available_to_partners, :cost_estimate, :cost_estimate_type, :cost_estimate_units, :create_job, :created_date,
+      fields :available_to_partners, :cost, :cost_estimate, :cost_estimate_type, :cost_estimate_units, :create_job, :created_date,
         :display_name, :dont_show_price, :enforce_min_qty_internally, :exclude_from_sitemap, :featured_description,
         :include_children, :is_donation_item, :is_fulfillable, :is_gco_compliant, :is_inactive, :is_online, :is_taxable,
         :item_id, :last_modified_date, :matrix_option_list, :matrix_type, :max_donation_amount, :meta_tag_html,

data/lib/netsuite/records/support_case_type.rb

@@ -0,0 +1,26 @@
+module NetSuite
+  module Records
+    class SupportCaseType
+      include Support::Fields
+      include Support::RecordRefs
+      include Support::Records
+      include Support::Actions
+      include Namespaces::ListSupport
+
+      actions :get
+
+      fields :description, :is_inactive, :name
+      
+      record_refs :insert_before
+
+      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/tax_group.rb

@@ -7,8 +7,8 @@ module NetSuite
       include Support::Actions
       include Namespaces::ListAcct
 
-      # NOTE `get_all` is not available in recent API versions ~2017_2
-      #      `search` is only available in recent API versions
+      # NOTE `get_all` is not available API > 2017_1
+      #      `search` is available API > 2016_2
       actions :get, :get_list, :add, :initialize, :delete, :update, :upsert, :search, :get_all
 
       fields :city, :county, :description, :include_children, :is_default, :is_inactive,

data/lib/netsuite/records/vendor.rb

@@ -11,7 +11,7 @@ module NetSuite
 
       fields :account_number, :alt_email, :alt_name, :alt_phone, :balance,
              :balance_primary, :bcn, :bill_pay, :comments, :company_name, :credit_limit,
-             :currency_list, :date_created, :default_address, :eligible_for_commission,
+             :date_created, :default_address, :eligible_for_commission,
              :email, :email_preference, :email_transactions, :entity_id, :fax, :fax_transactions,
              :first_name, :give_access, :global_subscription_status, :home_phone, :is1099_eligible,
              :is_accountant, :is_inactive, :is_job_resource_vend, :is_person, :labor_cost,
@@ -22,6 +22,7 @@ module NetSuite
              :url, :vat_reg_number
 
       field :custom_field_list, CustomFieldList
+      field :currency_list, VendorCurrencyList
       # TODO should change name to VendorAddressBookList
       field :addressbook_list, CustomerAddressbookList
 

data/lib/netsuite/records/vendor_currency.rb

@@ -0,0 +1,26 @@
+module NetSuite
+  module Records
+    class VendorCurrency
+      include Support::Fields
+      include Support::RecordRefs
+      include Support::Records
+      include Namespaces::ListRel
+
+      fields :balance, :consol_balance, :consol_deposit_balance, :consol_overdue_balance,
+             :consol_unbilled_orders, :deposit_balance, :display_symbol, :overdue_balance,
+             :override_currency_format, :symbol_placement, :unbilled_orders
+
+      record_refs :currency
+
+      def initialize(attributes_or_record = {})
+        case attributes_or_record
+        when Hash
+          initialize_from_attributes_hash(attributes_or_record)
+        when self.class
+          initialize_from_record(attributes_or_record)
+        end
+      end
+
+    end
+  end
+end

data/lib/netsuite/records/vendor_currency_list.rb

@@ -0,0 +1,9 @@
+module NetSuite
+  module Records
+    class VendorCurrencyList < Support::Sublist
+      include Namespaces::ListRel
+
+      sublist :vendor_currency, NetSuite::Records::VendorCurrency
+    end
+  end
+end

data/lib/netsuite/support/fields.rb

@@ -60,6 +60,22 @@ module NetSuite
           read_only_fields << name_sym
           field name
         end
+
+        def search_only_fields(*args)
+          if args.empty?
+             @search_only_fields ||= Set.new
+          else
+            args.each do |arg|
+              search_only_field arg
+            end
+          end
+        end
+
+        def search_only_field(name)
+          name_sym = name.to_sym
+          search_only_fields << name_sym
+          field name
+        end
       end
 
     end

data/lib/netsuite/support/records.rb

@@ -5,7 +5,7 @@ module NetSuite
       include Namespaces::PlatformCore
 
       def to_record
-        attributes.reject { |k,v| self.class.read_only_fields.include?(k) }.inject({}) do |hash, (k,v)|
+        attributes.reject { |k,v| self.class.read_only_fields.include?(k) || self.class.search_only_fields.include?(k) }.inject({}) do |hash, (k,v)|
           kname = "#{record_namespace}:"
           kname += k == :klass ? 'class' : k.to_s.lower_camelcase
 

data/lib/netsuite/support/search_result.rb

@@ -29,8 +29,19 @@ module NetSuite
         if @total_records > 0
           if response.body.has_key?(:record_list)
             # basic search results
-            record_list = response.body[:record_list][:record]
-            record_list = [record_list] unless record_list.is_a?(Array)
+
+            #  `recordList` node can contain several nested `record` nodes, only one node or be empty
+            #  so we have to handle all these cases:
+            #    * { record_list: nil }
+            #    * { record_list: { record: => {...} } }
+            #    * { record_list: { record: => [{...}, {...}, ...] } }
+            record_list = if response.body[:record_list].nil?
+              []
+            elsif response.body[:record_list][:record].is_a?(Array)
+              response.body[:record_list][:record]
+            else
+              [response.body[:record_list][:record]]
+            end
 
             record_list.each do |record|
               results << result_class.new(record)
@@ -41,9 +52,6 @@ module NetSuite
             record_list = [record_list] unless record_list.is_a?(Array)
 
             record_list.each do |record|
-              # TODO because of customFieldList we need to either make this recursive
-              #      or handle the customFieldList as a special case
-
               record.each_pair do |search_group, search_data|
                 # skip all attributes: look for :basic and all :xxx_join
                 next if search_group.to_s.start_with?('@')
@@ -52,7 +60,25 @@ module NetSuite
                   # all return values are wrapped in a <SearchValue/>
                   # extract the value from <SearchValue/> to make results easier to work with
 
-                  if v.is_a?(Hash) && v.has_key?(:search_value)
+                  if k == :custom_field_list
+                    # Here's an example of a response
+
+                    # <platformCommon:customFieldList>
+                    #   <platformCore:customField internalId="1756" scriptId="custitem_stringfield" xsi:type="platformCore:SearchColumnStringCustomField">
+                    #     <platformCore:searchValue>sample string value</platformCore:searchValue>
+                    #   </platformCore:customField>
+                    #   <platformCore:customField internalId="1713" scriptId="custitem_apcategoryforsales" xsi:type="platformCore:SearchColumnSelectCustomField">
+                    #     <platformCore:searchValue internalId="4" typeId="464"/>
+                    #   </platformCore:customField>
+                    # </platformCommon:customFieldList>
+
+                    custom_field_list = v.fetch(:custom_field)
+                    custom_field_list = [custom_field_list] unless custom_field_list.is_a?(Array)
+                    record[search_group][k][:custom_field] = custom_field_list.map do |custom_field|
+                      custom_field[:value] = custom_field.fetch(:search_value)
+                      custom_field
+                    end
+                  elsif v.is_a?(Hash) && v.has_key?(:search_value)
                     # Here's an example of a record ref and string response
 
                     # <platformCommon:entity>
@@ -78,6 +104,10 @@ module NetSuite
                 record[:basic][:internal_id] = record[:basic][:internal_id][:@internal_id]
               end
 
+              if record[:basic][:external_id]
+                record[:basic][:external_id] = record[:basic][:external_id][:@external_id]
+              end
+
               result_wrapper = result_class.new(record.delete(:basic))
               result_wrapper.search_joins = record
               results << result_wrapper