netsuite-soap 2025.2.3

data/lib/netsuite/records/credit_memo_apply.rb

@@ -0,0 +1,16 @@
+module NetSuite
+  module Records
+    class CreditMemoApply
+      include Support::Fields
+      include Support::Records
+      include Namespaces::TranCust
+
+      fields :amount, :apply, :apply_date, :currency, :doc, :due, :job, :line, :ref_num, :total, :type
+
+      def initialize(attributes = {})
+        initialize_from_attributes_hash(attributes)
+      end
+
+    end
+  end
+end

data/lib/netsuite/records/credit_memo_apply_list.rb

@@ -0,0 +1,15 @@
+module NetSuite
+  module Records
+    class CreditMemoApplyList < Support::Sublist
+      include Namespaces::TranCust
+
+      sublist :apply, CreditMemoApply
+
+      # for backward compatibility
+      def applies
+        self.apply
+      end
+
+    end
+  end
+end

data/lib/netsuite/records/credit_memo_item.rb

@@ -0,0 +1,34 @@
+module NetSuite
+  module Records
+    class CreditMemoItem
+      include Support::Fields
+      include Support::RecordRefs
+      include Support::Records
+      include Namespaces::TranCust
+
+      fields :amount, :bin_numbers, :cost_estimate, :cost_estimate_type, :defer_rev_rec, :description, :gift_cert_from,
+        :gift_cert_message, :gift_cert_number, :gift_cert_recipient_email, :gift_cert_recipient_name, :gross_amt, :is_taxable,
+        :line, :order_line, :quantity, :rate, :rev_rec_end_date, :rev_rec_start_date, :rev_rec_term_in_months, :serial_numbers,
+        :tax1_amt, :tax_rate1, :tax_rate2, :vsoe_allocation, :vsoe_amount, :vsoe_deferral, :vsoe_delivered,
+        :vsoe_permit_discount, :vsoe_price
+
+      field :custom_field_list, CustomFieldList
+      field :inventory_detail,  InventoryDetail
+
+      record_refs :department, :item, :job, :klass, :location, :price, :rev_rec_schedule, :tax_code, :units
+
+      def initialize(attributes = {})
+        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/credit_memo_item_list.rb

@@ -0,0 +1,11 @@
+module NetSuite
+  module Records
+    class CreditMemoItemList < Support::Sublist
+      include Namespaces::TranCust
+
+      sublist :item, CreditMemoItem
+
+      alias :items :item
+    end
+  end
+end

data/lib/netsuite/records/currency.rb

@@ -0,0 +1,30 @@
+module NetSuite
+  module Records
+    class Currency
+      include Support::Records
+      include Support::Fields
+
+      include Support::Actions
+      include Support::RecordRefs
+      include Namespaces::ListAcct
+
+      # https://system.netsuite.com/help/helpcenter/en_US/srbrowser/Browser2014_1/schema/record/currency.html
+
+      actions :get, :get_list, :get_all, :add, :update, :upsert, :upsert_list, :delete
+
+      fields :name, :symbol, :is_base_currency, :is_inactive, :override_currency_format, :display_symbol, :symbol_placement,
+             :locale, :formatSample, :exchangeRate, :fx_rate_update_timezone, :incl_in_fx_rate_updates, :currency_precision
+
+      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/currency_rate.rb

@@ -0,0 +1,34 @@
+module NetSuite
+  module Records
+    class CurrencyRate
+      include Support::Records
+      include Support::Fields
+
+      include Support::Actions
+      include Support::RecordRefs
+      include Namespaces::ListAcct
+
+      # https://system.netsuite.com/help/helpcenter/en_US/srbrowser/Browser2014_1/schema/record/currencyrate.html
+
+      actions :get, :get_list, :search
+
+      fields :effective_date, :exchange_rate
+
+      record_refs :base_currency, :transaction_currency
+
+      #field :base_currency, Currency
+      #field :transaction_currency, Currency
+
+      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/custom_field.rb

@@ -0,0 +1,23 @@
+module NetSuite
+  module Records
+    class CustomField
+      include Support::Fields
+      include Support::Records
+
+      attr_reader :internal_id, :script_id
+      attr_accessor :type
+
+      def initialize(attributes = {})
+        @script_id   = attributes.delete(:script_id) || attributes.delete(:@script_id)
+        @internal_id = attributes.delete(:internal_id) || attributes.delete(:@internal_id)
+        @type        = attributes.delete(:type) || attributes.delete(:"@xsi:type")
+        self.attributes = attributes
+      end
+
+      def value
+        attributes[:value]
+      end
+
+    end
+  end
+end

data/lib/netsuite/records/custom_field_list.rb

@@ -0,0 +1,186 @@
+module NetSuite
+  module Records
+    class CustomFieldList
+      include Namespaces::PlatformCore
+
+      def initialize(attributes = {})
+        case attributes[:custom_field]
+        when Hash
+          extract_custom_field(attributes[:custom_field])
+        when Array
+          attributes[:custom_field].each { |custom_field| extract_custom_field(custom_field) }
+        end
+
+        @custom_fields_assoc = Hash.new
+        custom_fields.each do |custom_field|
+          # not all custom fields have an id
+          # https://github.com/NetSweet/netsuite/issues/182
+
+          if reference_id = custom_field.send(reference_id_type)
+            @custom_fields_assoc[reference_id.to_sym] = custom_field
+          end
+        end
+      end
+
+      def custom_fields
+        @custom_fields ||= []
+      end
+
+      def delete_custom_field(field)
+        custom_fields.delete_if do |c|
+          # https://github.com/NetSweet/netsuite/issues/325
+          c.send(reference_id_type) &&
+            c.send(reference_id_type).to_sym == field
+        end
+
+        @custom_fields_assoc.delete(field)
+      end
+
+      # In case you want to get only MultiSelectCustomFieldRef for example:
+      #
+      #   list.custom_fields_by_type "MultiSelectCustomFieldRef"
+      #
+      def custom_fields_by_type(type)
+        custom_fields.select { |field| field.type == "platformCore:#{type}" }
+      end
+
+      def method_missing(sym, *args, &block)
+        # read custom field if already set
+        if @custom_fields_assoc.include?(sym)
+          return @custom_fields_assoc[sym]
+        end
+
+        # write custom field
+        if sym.to_s.end_with?('=')
+          field_name = sym.to_s[0..-2]
+          delete_custom_field(field_name.to_sym)
+          return create_custom_field(field_name, args.first)
+        end
+
+        super(sym, *args, &block)
+      end
+
+      def respond_to?(sym, include_private = false)
+        return true if @custom_fields_assoc.include?(sym)
+        super
+      end
+
+      def to_record
+        {
+          "#{record_namespace}:customField" => custom_fields.map do |custom_field|
+            if custom_field.value.respond_to?(:to_record)
+              custom_field_value = custom_field.value.to_record
+            elsif custom_field.value.is_a?(Array)
+              custom_field_value = custom_field.value.map(&:to_record)
+            else
+              custom_field_value = custom_field.value.to_s
+            end
+
+            base = {
+              "platformCore:value" => custom_field_value,
+              '@xsi:type' => custom_field.type
+            }
+
+            # TODO this is broken in > 2013_1; need to conditionally change the synax here
+            # if NetSuite::Configuration.api_version < "2013_2"
+
+            if custom_field.internal_id
+              base['@internalId'] = custom_field.internal_id
+            end
+
+            if custom_field.script_id
+              base['@scriptId'] = custom_field.script_id
+            end
+
+            base
+          end
+        }
+      end
+
+      private
+
+        def reference_id_type
+          @reference_id_type ||= Configuration.api_version >= '2013_2' ? :script_id : :internal_id
+        end
+
+        def extract_custom_field(custom_field_data)
+          if custom_field_data.kind_of?(CustomField)
+            custom_fields << custom_field_data
+          else
+            attrs = custom_field_data.clone
+            type = (custom_field_data[:"@xsi:type"] || custom_field_data[:type])
+
+            case type
+            when "platformCore:SelectCustomFieldRef", "platformCore:SearchColumnSelectCustomField"
+              attrs[:value] = CustomRecordRef.new(custom_field_data[:value])
+            when 'platformCore:MultiSelectCustomFieldRef', 'platformCore:SearchColumnMultiSelectCustomField'
+              # if there is only a single selection, `:value` will be hash not an array
+              attrs[:value] = if custom_field_data[:value].is_a?(Array)
+                custom_field_data[:value]
+              else
+                [custom_field_data[:value]]
+              end.map do |entry|
+                CustomRecordRef.new(entry)
+              end
+            end
+
+            custom_fields << CustomField.new(attrs)
+          end
+        end
+
+        def create_custom_field(reference_id, field_value)
+          # all custom fields need types; infer type based on class sniffing
+          field_type = case
+          when field_value.is_a?(Array)
+            'MultiSelectCustomFieldRef'
+          when field_value.is_a?(Hash),
+               field_value.is_a?(NetSuite::Records::CustomRecordRef)
+            'SelectCustomFieldRef'
+          when field_value.is_a?(DateTime),
+               field_value.is_a?(Time),
+               field_value.is_a?(Date)
+            'DateCustomFieldRef'
+          when field_value.is_a?(FalseClass),
+               field_value.is_a?(TrueClass)
+            'BooleanCustomFieldRef'
+          else
+            'StringCustomFieldRef'
+          end
+
+          # TODO seems like DateTime doesn't need the iso8601 call
+          #      not sure if this is specific to my env though
+
+          custom_field_value = case
+          when field_value.is_a?(Hash)
+            CustomRecordRef.new(field_value)
+          when field_value.is_a?(Date)
+            field_value.to_datetime.iso8601
+          when field_value.is_a?(Time)
+            field_value.iso8601
+          when field_value.is_a?(Array)
+            # sniff the first element of the array; if an int or string then assume internalId
+            # and create record refs pointing to the given IDs
+
+            if !field_value.empty? && (field_value.first.is_a?(String) || field_value.first.kind_of?(Integer))
+              field_value.map do |v|
+                NetSuite::Records::CustomRecordRef.new(internal_id: v)
+              end
+            else
+              field_value
+            end
+          else
+            field_value
+          end
+
+          custom_field = CustomField.new(
+            reference_id_type => reference_id,
+            :value => custom_field_value,
+            :type  => "#{record_namespace}:#{field_type}"
+          )
+
+          custom_fields << custom_field
+          @custom_fields_assoc[reference_id.to_sym] = custom_field
+        end
+    end
+  end
+end

data/lib/netsuite/records/custom_list.rb

@@ -0,0 +1,27 @@
+module NetSuite
+  module Records
+    class CustomList
+      include Support::Fields
+      include Support::Records
+      include Support::Actions
+      include Namespaces::SetupCustom
+
+      actions :get, :update, :get_list, :add, :delete, :search, :upsert
+
+      # https://system.netsuite.com/help/helpcenter/en_US/srbrowser/Browser2014_1/schema/record/customlist.html
+      fields :description, :name, :is_ordered, :script_id, :convert_to_custom_record,
+             :is_inactive
+
+      field :custom_value_list, NetSuite::Records::CustomListCustomValueList
+
+      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/custom_list_custom_value.rb

@@ -0,0 +1,22 @@
+module NetSuite
+  module Records
+    class CustomListCustomValue
+      include Support::Records
+      include Support::Fields
+      include Namespaces::SetupCustom
+
+      # https://system.netsuite.com/help/helpcenter/en_US/srbrowser/Browser2014_1/schema/other/customlistcustomvalue.html?mode=package
+
+      fields :abbreviation, :value, :value_id, :is_inactive
+
+      # field valueLanguageValueList
+
+      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/custom_list_custom_value_list.rb

@@ -0,0 +1,13 @@
+module NetSuite
+  module Records
+    
+    class CustomListCustomValueList < Support::Sublist
+      include Namespaces::SetupCustom
+
+      # https://system.netsuite.com/help/helpcenter/en_US/srbrowser/Browser2014_1/schema/other/customlistcustomvaluelist.html?mode=package
+
+      sublist :custom_value, CustomListCustomValue
+    end
+
+  end
+end

data/lib/netsuite/records/custom_record.rb

@@ -0,0 +1,56 @@
+module NetSuite
+  module Records
+    class CustomRecord
+      include Support::Fields
+      include Support::RecordRefs
+      include Support::Records
+      include Support::Actions
+      include Namespaces::SetupCustom
+
+      actions :get, :update, :get_list, :add, :delete, :search, :upsert
+
+      fields :allow_attachments, :allow_inline_editing, :allow_numbering_override, :allow_quick_search, :alt_name, :auto_name,
+        :created, :custom_record_id, :description, :disclaimer, :enabl_email_merge, :enable_numbering, :include_name,
+        :is_available_offline, :is_inactive, :is_numbering_updateable, :is_ordered, :last_modified, :name,
+        :numbering_current_number, :numbering_init, :numbering_min_digits, :numbering_prefix, :numbering_suffix,
+        :record_name, :script_id, :show_creation_date, :show_creation_date_on_list, :show_id, :show_last_modified_on_list,
+        :show_last_modified, :show_notes, :show_owner, :show_owner_allow_change, :show_owner_on_list, :use_permissions
+
+      field :custom_field_list, CustomFieldList
+      field :translations_list, TranslationList
+
+      record_refs :custom_form, :owner, :rec_type, :parent
+
+      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.get(options = {})
+        options.merge!(:type_id => type_id) unless options[:type_id]
+        super(options.merge(:custom => true))
+      end
+
+      def delete
+        super(:custom => true)
+      end
+
+      def self.type_id(id = nil)
+        if id
+          @type_id = id
+        end
+
+        @type_id
+      end
+
+      def record_type
+        "#{record_namespace}:CustomRecord"
+      end
+
+    end
+  end
+end

data/lib/netsuite/records/custom_record_ref.rb

@@ -0,0 +1,50 @@
+module NetSuite
+  module Records
+    class CustomRecordRef
+      include Support::Fields
+      include Support::Records
+      include Namespaces::PlatformCore
+
+      attr_reader   :internal_id
+      attr_accessor :external_id, :type_id
+
+      fields :name
+
+      def initialize(attributes_or_record = {})
+        case attributes_or_record
+        when Hash
+          attributes = attributes_or_record.clone
+          attributes.delete(:"@xmlns:platform_core")
+          @internal_id = attributes.delete(:internal_id) || attributes.delete(:@internal_id)
+          @external_id = attributes.delete(:external_id) || attributes.delete(:@external_id)
+          @type_id     = attributes.delete(:type_id) || attributes.delete(:@type_id)
+          @type_id     = @type_id.to_s if @type_id
+          initialize_from_attributes_hash(attributes)
+        else
+          record = attributes_or_record
+          @internal_id = record.internal_id if record.respond_to?(:internal_id)
+          @external_id = record.external_id if record.respond_to?(:external_id)
+          @type_id     = record.class.type_id if record.class.respond_to?(:type_id) && record.class.type_id
+          @type_id     = @type_id.to_s if @type_id
+        end
+      end
+
+      def method_missing(m, *args, &block)
+        if attributes.keys.map(&:to_sym).include?(m.to_sym)
+          attributes[m.to_sym]
+        else
+          super
+        end
+      end
+
+      def to_record
+        rec = super
+        rec[:@internalId] = @internal_id if @internal_id
+        rec[:@externalId] = @external_id if @external_id
+        rec[:@typeId] = @type_id if @type_id
+        rec
+      end
+
+    end
+  end
+end

data/lib/netsuite/records/custom_record_type.rb

@@ -0,0 +1,30 @@
+module NetSuite
+  module Records
+    class CustomRecordType
+      include Support::Fields
+      include Support::RecordRefs
+      include Support::Actions
+
+      actions :get, :get_list, :add, :delete, :upsert
+
+      fields :allow_attachments, :allow_inline_editing, :allow_numbering_override, :allow_quick_search, :description,
+        :disclaimer, :enable_mail_merge, :enable_numbering, :include_name, :is_available_offline, :is_inactive,
+        :is_numbering_updateable, :is_ordered, :numbering_current_number, :numbering_init, :numbering_min_digits,
+        :numbering_prefix, :numbering_suffix, :record_name, :script_id, :show_creation_date, :show_creation_date_on_list,
+        :show_id, :show_last_modified, :show_last_modified_on_list, :show_notes, :show_owner, :show_owner_allow_change,
+        :show_owner_on_list, :use_permissions
+
+      record_ref :owner
+
+      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