netsuite-soap 2025.2.3

data/lib/netsuite/support/country.rb

@@ -0,0 +1,289 @@
+module NetSuite
+  module Support
+    class Country
+
+      ISO_TO_NETSUITE = {
+        'AF' => '_afghanistan',
+        'AX' => '_alandIslands',
+        'AL' => '_albania',
+        'DZ' => '_algeria',
+        'AS' => '_americanSamoa',
+        'AD' => '_andorra',
+        'AO' => '_angola',
+        'AI' => '_anguilla',
+        'AQ' => '_antarctica',
+        'AG' => '_antiguaAndBarbuda',
+        'AR' => '_argentina',
+        'AM' => '_armenia',
+        'AW' => '_aruba',
+        'AU' => '_australia',
+        'AT' => '_austria',
+        'AZ' => '_azerbaijan',
+        'BS' => '_bahamas',
+        'BH' => '_bahrain',
+        'BD' => '_bangladesh',
+        'BB' => '_barbados',
+        'BY' => '_belarus',
+        'BE' => '_belgium',
+        'BZ' => '_belize',
+        'BJ' => '_benin',
+        'BM' => '_bermuda',
+        'BT' => '_bhutan',
+        'BO' => '_bolivia',
+        'BQ' => '_bonaireSaintEustatiusAndSaba',
+        'BA' => '_bosniaAndHerzegovina',
+        'BW' => '_botswana',
+        'BV' => '_bouvetIsland',
+        'BR' => '_brazil',
+        'IO' => '_britishIndianOceanTerritory',
+        'BN' => '_bruneiDarussalam',
+        'BG' => '_bulgaria',
+        'BF' => '_burkinaFaso',
+        'BI' => '_burundi',
+        'KH' => '_cambodia',
+        'CM' => '_cameroon',
+        'CA' => '_canada',
+        'IC' => '_canaryIslands',
+        'CV' => '_capeVerde',
+        'KY' => '_caymanIslands',
+        'CF' => '_centralAfricanRepublic',
+        'EA' => '_ceutaAndMelilla',
+        'TD' => '_chad',
+        'CL' => '_chile',
+        'CN' => '_china',
+        'CX' => '_christmasIsland',
+        'CC' => '_cocosKeelingIslands',
+        'CO' => '_colombia',
+        'KM' => '_comoros',
+        'CD' => '_congoDemocraticPeoplesRepublic',
+        'CG' => '_congoRepublicOf',
+        'CK' => '_cookIslands',
+        'CR' => '_costaRica',
+        'CI' => '_coteDIvoire',
+        'HR' => '_croatiaHrvatska',
+        'CU' => '_cuba',
+        'CW' => '_curacao',
+        'CY' => '_cyprus',
+        'CZ' => '_czechRepublic',
+        'DK' => '_denmark',
+        'DJ' => '_djibouti',
+        'DM' => '_dominica',
+        'DO' => '_dominicanRepublic',
+        'TL' => '_eastTimor',
+        'EC' => '_ecuador',
+        'EG' => '_egypt',
+        'SV' => '_elSalvador',
+        'GQ' => '_equatorialGuinea',
+        'ER' => '_eritrea',
+        'EE' => '_estonia',
+        'ET' => '_ethiopia',
+        'FK' => '_falklandIslands',
+        'FO' => '_faroeIslands',
+        'FJ' => '_fiji',
+        'FI' => '_finland',
+        'FR' => '_france',
+        'GF' => '_frenchGuiana',
+        'PF' => '_frenchPolynesia',
+        'TF' => '_frenchSouthernTerritories',
+        'GA' => '_gabon',
+        'GM' => '_gambia',
+        'GE' => '_georgia',
+        'DE' => '_germany',
+        'GH' => '_ghana',
+        'GI' => '_gibraltar',
+        'GR' => '_greece',
+        'GL' => '_greenland',
+        'GD' => '_grenada',
+        'GP' => '_guadeloupe',
+        'GU' => '_guam',
+        'GT' => '_guatemala',
+        'GG' => '_guernsey',
+        'GN' => '_guinea',
+        'GW' => '_guineaBissau',
+        'GY' => '_guyana',
+        'HT' => '_haiti',
+        'HM' => '_heardAndMcDonaldIslands',
+        'VA' => '_holySeeCityVaticanState',
+        'HN' => '_honduras',
+        'HK' => '_hongKong',
+        'HU' => '_hungary',
+        'IS' => '_iceland',
+        'IN' => '_india',
+        'ID' => '_indonesia',
+        'IR' => '_iranIslamicRepublicOf',
+        'IQ' => '_iraq',
+        'IE' => '_ireland',
+        'IM' => '_isleOfMan',
+        'IL' => '_israel',
+        'IT' => '_italy',
+        'JM' => '_jamaica',
+        'JP' => '_japan',
+        'JE' => '_jersey',
+        'JO' => '_jordan',
+        'KZ' => '_kazakhstan',
+        'KE' => '_kenya',
+        'KI' => '_kiribati',
+        'KP' => '_koreaDemocraticPeoplesRepublic',
+        'KR' => '_koreaRepublicOf',
+        'XK' => '_kosovo',
+        'KW' => '_kuwait',
+        'KG' => '_kyrgyzstan',
+        'LA' => '_laoPeoplesDemocraticRepublic',
+        'LV' => '_latvia',
+        'LB' => '_lebanon',
+        'LS' => '_lesotho',
+        'LR' => '_liberia',
+        'LY' => '_libya',
+        'LI' => '_liechtenstein',
+        'LT' => '_lithuania',
+        'LU' => '_luxembourg',
+        'MO' => '_macau',
+        'MK' => '_macedonia',
+        'MG' => '_madagascar',
+        'MW' => '_malawi',
+        'MY' => '_malaysia',
+        'MV' => '_maldives',
+        'ML' => '_mali',
+        'MT' => '_malta',
+        'MH' => '_marshallIslands',
+        'MQ' => '_martinique',
+        'MR' => '_mauritania',
+        'MU' => '_mauritius',
+        'YT' => '_mayotte',
+        'MX' => '_mexico',
+        'FM' => '_micronesiaFederalStateOf',
+        'MD' => '_moldovaRepublicOf',
+        'MC' => '_monaco',
+        'MN' => '_mongolia',
+        'ME' => '_montenegro',
+        'MS' => '_montserrat',
+        'MA' => '_morocco',
+        'MZ' => '_mozambique',
+        'MM' => '_myanmar',
+        'NA' => '_namibia',
+        'NR' => '_nauru',
+        'NP' => '_nepal',
+        'NL' => '_netherlands',
+        'NC' => '_newCaledonia',
+        'NZ' => '_newZealand',
+        'NI' => '_nicaragua',
+        'NE' => '_niger',
+        'NG' => '_nigeria',
+        'NU' => '_niue',
+        'NF' => '_norfolkIsland',
+        'MP' => '_northernMarianaIslands',
+        'NO' => '_norway',
+        'OM' => '_oman',
+        'PK' => '_pakistan',
+        'PW' => '_palau',
+        'PS' => '_stateOfPalestine',
+        'PA' => '_panama',
+        'PG' => '_papuaNewGuinea',
+        'PY' => '_paraguay',
+        'PE' => '_peru',
+        'PH' => '_philippines',
+        'PN' => '_pitcairnIsland',
+        'PL' => '_poland',
+        'PT' => '_portugal',
+        'PR' => '_puertoRico',
+        'QA' => '_qatar',
+        'RE' => '_reunionIsland',
+        'RO' => '_romania',
+        'RU' => '_russianFederation',
+        'RW' => '_rwanda',
+        'BL' => '_saintBarthelemy',
+        'SH' => '_saintHelena',
+        'KN' => '_saintKittsAndNevis',
+        'LC' => '_saintLucia',
+        'MF' => '_saintMartin',
+        'VC' => '_saintVincentAndTheGrenadines',
+        'SM' => '_sanMarino',
+        'ST' => '_saoTomeAndPrincipe',
+        'SA' => '_saudiArabia',
+        'SN' => '_senegal',
+        'RS' => '_serbia',
+        'SC' => '_seychelles',
+        'SL' => '_sierraLeone',
+        'SG' => '_singapore',
+        'SX' => '_sintMaarten',
+        'SK' => '_slovakRepublic',
+        'SI' => '_slovenia',
+        'SB' => '_solomonIslands',
+        'SO' => '_somalia',
+        'ZA' => '_southAfrica',
+        'GS' => '_southGeorgia',
+        'SS' => '_southSudan',
+        'ES' => '_spain',
+        'LK' => '_sriLanka',
+        'PM' => '_stPierreAndMiquelon',
+        'SD' => '_sudan',
+        'SR' => '_suriname',
+        'SJ' => '_svalbardAndJanMayenIslands',
+        'SZ' => '_swaziland',
+        'SE' => '_sweden',
+        'CH' => '_switzerland',
+        'SY' => '_syrianArabRepublic',
+        'TW' => '_taiwan',
+        'TJ' => '_tajikistan',
+        'TZ' => '_tanzania',
+        'TH' => '_thailand',
+        'TG' => '_togo',
+        'TK' => '_tokelau',
+        'TO' => '_tonga',
+        'TT' => '_trinidadAndTobago',
+        'TN' => '_tunisia',
+        'TR' => '_turkey',
+        'TM' => '_turkmenistan',
+        'TC' => '_turksAndCaicosIslands',
+        'TV' => '_tuvalu',
+        'UG' => '_uganda',
+        'UA' => '_ukraine',
+        'AE' => '_unitedArabEmirates',
+        'GB' => '_unitedKingdom',
+        'UK' => '_unitedKingdom',
+        'US' => '_unitedStates',
+        'UY' => '_uruguay',
+        'UM' => '_uSMinorOutlyingIslands',
+        'UZ' => '_uzbekistan',
+        'VU' => '_vanuatu',
+        'VE' => '_venezuela',
+        'VN' => '_vietnam',
+        'VG' => '_virginIslandsBritish',
+        'VI' => '_virginIslandsUSA',
+        'WF' => '_wallisAndFutunaIslands',
+        'EH' => '_westernSahara',
+        'WS' => '_samoa',
+        'YE' => '_yemen',
+        'ZM' => '_zambia',
+        'ZW' => '_zimbabwe'
+      }
+
+      def initialize(iso_or_name = '')
+        if iso_or_name =~ /^[A-Z]{2}/
+          @id = iso_to_netsuite.fetch(iso_or_name)
+        else
+          @id = iso_or_name
+        end
+      end
+
+      def ==(other)
+        other.class == self.class && other.to_iso == self.to_iso
+      end
+
+      alias :eql? :==
+
+      def to_iso
+        iso_to_netsuite.key(@id)
+      end
+
+      def to_record
+        @id
+      end
+
+      def iso_to_netsuite
+        ISO_TO_NETSUITE
+      end
+
+    end
+  end
+end

data/lib/netsuite/support/fields.rb

@@ -0,0 +1,86 @@
+module NetSuite
+  module Support
+    module Fields
+      include Attributes
+
+      def self.included(base)
+        base.send(:extend, ClassMethods)
+      end
+
+      module ClassMethods
+
+        def fields(*args)
+          if args.empty?
+             @fields ||= Set.new
+          else
+            args.each do |arg|
+              field arg
+            end
+          end
+        end
+
+        def field(name, klass = nil)
+          name_sym = name.to_sym
+          raise "#{name} already defined on #{self.name}" if fields.include?(name_sym)
+          raise "#{name} conflicts with a method defined on #{self.name}" if method_defined?(name_sym)
+
+          fields << name_sym
+          if klass
+            define_method(name_sym) do
+              attributes[name_sym] ||= klass.new
+            end
+
+            define_method("#{name_sym}=") do |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
+              attributes[name_sym]
+            end
+
+            define_method("#{name_sym}=") do |value|
+              attributes[name_sym] = value
+            end
+          end
+        end
+
+        def read_only_fields(*args)
+          if args.empty?
+             @read_only_fields ||= Set.new
+          else
+            args.each do |arg|
+              read_only_field arg
+            end
+          end
+        end
+
+        def read_only_field(name)
+          name_sym = name.to_sym
+          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
+  end
+end

data/lib/netsuite/support/record_refs.rb

@@ -0,0 +1,30 @@
+module NetSuite
+  module Support
+    module RecordRefs
+
+      def self.included(base)
+        base.extend(ClassMethods)
+      end
+
+      module ClassMethods
+
+        def record_refs(*names)
+          if names.empty?
+            @record_refs ||= Set.new
+          else
+            names.each do |name|
+              record_ref name
+            end
+          end
+        end
+
+        def record_ref(name)
+          record_refs << name
+          field name, NetSuite::Records::RecordRef
+        end
+
+      end
+
+    end
+  end
+end

data/lib/netsuite/support/records.rb

@@ -0,0 +1,89 @@
+module NetSuite
+  module Support
+    module Records
+      include Attributes
+      include Namespaces::PlatformCore
+
+      def to_record
+        attributes.reject { |k,v| self.class.read_only_fields.include?(k) || self.class.search_only_fields.include?(k) }.inject({}) do |hash, (k,v)|
+          kname = "#{v.is_a?(NetSuite::Records::NullFieldList) ? v.record_namespace : record_namespace}:"
+          kname += k == :klass ? 'class' : NetSuite::Utilities::Strings.lower_camelcase(k.to_s)
+
+          to_attributes!(hash, kname, v)
+
+          if Array === v
+            v = v.map { |i| i.respond_to?(:to_record) ? i.to_record : i }
+          elsif v.respond_to?(:to_record)
+            v = v.to_record
+          end
+
+          hash[kname] = v
+          hash
+        end
+      end
+
+      def to_attributes!(hash, kname, v)
+        if v.respond_to?(:internal_id) && v.internal_id
+          hash[:attributes!] ||= {}
+          hash[:attributes!][kname] ||= {}
+          hash[:attributes!][kname]['internalId'] = v.internal_id
+        end
+
+        if v.respond_to?(:external_id) && v.external_id
+          hash[:attributes!] ||= {}
+          hash[:attributes!][kname] ||= {}
+          hash[:attributes!][kname]['externalId'] = v.external_id
+        end
+
+        if v.kind_of?(NetSuite::Records::RecordRef) && v.type
+          hash[:attributes!] ||= {}
+          hash[:attributes!][kname] ||= {}
+          hash[:attributes!][kname]['type'] = NetSuite::Utilities::Strings.lower_camelcase(v.type)
+        end
+
+        if v.kind_of?(NetSuite::Records::CustomRecordRef) && v.type_id
+          hash[:attributes!] ||= {}
+          hash[:attributes!][kname] ||= {}
+          hash[:attributes!][kname]['typeId'] = NetSuite::Utilities::Strings.lower_camelcase(v.type_id)
+        end
+      end
+
+      def record_type
+        "#{record_namespace}:#{record_type_without_namespace}"
+      end
+
+      def netsuite_type
+        Records.netsuite_type(self)
+      end
+
+      def record_type_without_namespace
+        Records.record_type_without_namespace(self)
+      end
+
+      def refresh(credentials = {})
+        fresh_record = self.class.get(self.internal_id, credentials)
+
+        self.attributes = fresh_record.send(:attributes)
+
+        # gift cards do not have an external ID
+        if fresh_record.respond_to?(:external_id)
+          self.external_id = fresh_record.external_id
+        end
+
+        self.errors = nil
+
+        self
+      end
+
+      def self.netsuite_type(obj)
+        NetSuite::Utilities::Strings.lower_camelcase(record_type_without_namespace(obj))
+      end
+
+      def self.record_type_without_namespace(obj)
+        klass = obj.is_a?(Class) ? obj : obj.class
+        "#{klass.to_s.split('::').last}"
+      end
+
+    end
+  end
+end

data/lib/netsuite/support/requests.rb

@@ -0,0 +1,56 @@
+module NetSuite
+  module Support
+    module Requests
+
+      def self.included(base)
+        base.send(:extend, ClassMethods)
+      end
+
+      module ClassMethods
+
+        def call(options, credentials={})
+          raise ArgumentError, "options should be an array" unless options.is_a?(Array)
+          new(*options).call(credentials)
+        end
+
+      end
+
+      def call(credentials={})
+        @response = request(credentials)
+        build_response
+      end
+
+      private
+
+      def build_response
+        Response.new(success: success?, header: response_header, body: response_body, errors: response_errors)
+      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_errors
+        nil
+      end
+
+      def response_body
+        raise NotImplementedError, 'Please implement a #response_body method'
+      end
+
+      def array_wrap(object)
+        if object.is_a?(Array)
+          return object
+        end
+
+        [ object ]
+      end
+
+    end
+  end
+end