netsuite 0.0.10 → 0.0.11

data/lib/netsuite.rb

@@ -1,14 +1,23 @@
 require 'set'
 
+require 'netsuite/version'
 require 'netsuite/configuration'
 require 'netsuite/errors'
 require 'netsuite/response'
-require 'netsuite/version'
-require 'netsuite/attribute_support'
-require 'netsuite/field_support'
-require 'netsuite/record_support'
-require 'netsuite/savon_support'
-require 'netsuite/record_ref_support'
+
+# NAMESPACES
+require 'netsuite/namespaces/platform_core'
+require 'netsuite/namespaces/platform_common'
+require 'netsuite/namespaces/list_acct'
+require 'netsuite/namespaces/list_rel'
+require 'netsuite/namespaces/tran_sales'
+
+# SUPPORT
+require 'netsuite/support/attributes'
+require 'netsuite/support/fields'
+require 'netsuite/support/record_refs'
+require 'netsuite/support/records'
+require 'netsuite/support/requests'
 
 # ACTIONS
 require 'netsuite/actions/add'
@@ -23,7 +32,9 @@ require 'netsuite/records/invoice'
 require 'netsuite/records/record_ref'
 require 'netsuite/records/ship_address'
 require 'netsuite/records/non_inventory_sale_item'
+require 'netsuite/records/invoice_item'
 require 'netsuite/records/invoice_item_list'
+require 'netsuite/records/classification'
 
 module NetSuite
 

data/lib/netsuite/actions/add.rb

@@ -1,7 +1,7 @@
 module NetSuite
   module Actions
     class Add
-      include SavonSupport
+      include Support::Requests
 
       def initialize(obj = nil)
         @obj = obj
@@ -11,9 +11,12 @@ module NetSuite
 
       def request
         connection.request :platformMsgs, :add do
-          soap.namespaces['xmlns:platformMsgs'] = 'urn:messages_2011_2.platform.webservices.netsuite.com'
-          soap.namespaces['xmlns:platformCore'] = 'urn:core_2011_2.platform.webservices.netsuite.com'
-          soap.namespaces['xmlns:listRel']      = 'urn:relationships_2011_2.lists.webservices.netsuite.com'
+          soap.namespaces['xmlns:platformMsgs']   = 'urn:messages_2011_2.platform.webservices.netsuite.com'
+          soap.namespaces['xmlns:platformCore']   = 'urn:core_2011_2.platform.webservices.netsuite.com'
+          soap.namespaces['xmlns:listRel']        = 'urn:relationships_2011_2.lists.webservices.netsuite.com'
+          soap.namespaces['xmlns:tranSales']      = 'urn:sales_2011_2.transactions.webservices.netsuite.com'
+          soap.namespaces['xmlns:platformCommon'] = 'urn:common_2011_2.platform.webservices.netsuite.com'
+          soap.namespaces['xmlns:listAcct']       = 'urn:accounting_2011_2.lists.webservices.netsuite.com'
           soap.header = auth_header
           soap.body   = request_body
         end

data/lib/netsuite/actions/get.rb

@@ -1,7 +1,7 @@
 module NetSuite
   module Actions
     class Get
-      include SavonSupport
+      include Support::Requests
 
       def initialize(id, klass)
         @id    = id

data/lib/netsuite/actions/initialize.rb

@@ -1,7 +1,7 @@
 module NetSuite
   module Actions
     class Initialize
-      include SavonSupport
+      include Support::Requests
 
       def initialize(obj)
         @obj = obj

data/lib/netsuite/namespaces/list_acct.rb

@@ -0,0 +1,11 @@
+module NetSuite
+  module Namespaces
+    module ListAcct
+
+      def record_namespace
+        'listAcct'
+      end
+
+    end
+  end
+end

data/lib/netsuite/namespaces/list_rel.rb

@@ -0,0 +1,11 @@
+module NetSuite
+  module Namespaces
+    module ListRel
+
+      def record_namespace
+        'listRel'
+      end
+
+    end
+  end
+end

data/lib/netsuite/namespaces/platform_common.rb

@@ -0,0 +1,11 @@
+module NetSuite
+  module Namespaces
+    module PlatformCommon
+
+      def record_namespace
+        'platformCommon'
+      end
+
+    end
+  end
+end

data/lib/netsuite/namespaces/platform_core.rb

@@ -0,0 +1,11 @@
+module NetSuite
+  module Namespaces
+    module PlatformCore
+
+      def record_namespace
+        'platformCore'
+      end
+
+    end
+  end
+end

data/lib/netsuite/namespaces/tran_sales.rb

@@ -0,0 +1,11 @@
+module NetSuite
+  module Namespaces
+    module TranSales
+
+      def record_namespace
+        'tranSales'
+      end
+
+    end
+  end
+end

data/lib/netsuite/records/bill_address.rb

@@ -1,7 +1,9 @@
 module NetSuite
   module Records
     class BillAddress
-      include FieldSupport
+      include Support::Fields
+      include Support::Records
+      include Namespaces::PlatformCommon
 
       fields :bill_attention, :bill_addressee, :bill_phone, :bill_addr1, :bill_addr2,
         :bill_addr3, :bill_city, :bill_state, :bill_zip, :bill_country

data/lib/netsuite/records/classification.rb

@@ -0,0 +1,27 @@
+module NetSuite
+  module Records
+    class Classification
+      include Support::Fields
+
+      fields :name, :include_children, :is_inactive, :class_translation_list, :subsidiary_list, :custom_field_list
+
+      attr_reader :internal_id, :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(id)
+        response = Actions::Get.call(id, self)
+        if response.success?
+          new(response.body)
+        else
+          raise RecordNotFound, "#{self} with ID=#{id} could not be found"
+        end
+      end
+
+    end
+  end
+end

data/lib/netsuite/records/customer.rb

@@ -1,9 +1,10 @@
 module NetSuite
   module Records
     class Customer
-      include FieldSupport
-      include RecordSupport
-      include RecordRefSupport
+      include Support::Fields
+      include Support::RecordRefs
+      include Support::Records
+      include Namespaces::ListRel
 
       fields :access_role, :account_number, :addressbook_list, :aging, :alt_email, :alt_name, :alt_phone, :balance, :bill_pay,
         :buying_reason, :buying_time_frame, :campaign_category, :category, :click_stream, :comments, :company_name,

data/lib/netsuite/records/customer_addressbook_list.rb

@@ -1,8 +1,9 @@
 module NetSuite
   module Records
     class CustomerAddressbookList
-      include FieldSupport
-      include RecordSupport
+      include Support::Fields
+      include Support::Records
+      include Namespaces::ListRel
 
       fields :default_shipping, :default_billing, :is_residential, :label, :attention, :addressee,
         :phone, :addr1, :addr2, :addr3, :city, :zip, :country, :addr_text, :override, :state

data/lib/netsuite/records/invoice.rb

@@ -1,32 +1,35 @@
 module NetSuite
   module Records
     class Invoice
-      include FieldSupport
-      include RecordSupport
-      include RecordRefSupport
+      include Support::Fields
+      include Support::RecordRefs
+      include Support::Records
+      include Namespaces::TranSales
 
       fields :alt_handling_cost, :alt_shipping_cost, :amount_paid, :amount_remaining, :balance, :bill_address,
         :billing_schedule, :contrib_pct, :created_date, :created_from, :currency_name, :custom_field_list,
         :deferred_revenue, :department, :discount_amount, :discount_date, :discount_item, :discount_rate,
-        :discount_total, :due_date, :email, :end_date, :est_gross_profit, :est_gross_profit_percent, :exchange_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,
         :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, :klass, :last_modified_date,
+        :item_cost_tax_code, :item_cost_tax_rate_1, :item_cost_tax_rate_2, :job, :last_modified_date,
         :lead_source, :linked_tracking_numbers, :location, :memo, :message, :message_sel, :on_credit_hold, :opportunity,
         :other_ref_name, :partner, :partners_list, :promo_code, :recognized_revenue, :rev_rec_end_date,
         :rev_rec_on_rev_commitment, :rev_rec_schedule, :rev_rec_start_date, :revenue_status, :sales_effective_date,
         :sales_group, :sales_rep, :sales_team_list, :ship_address, :ship_date, :ship_group_list,
         :ship_method, :shipping_cost, :shipping_tax_1_rate, :shipping_tax_2_rate, :shipping_tax_code, :source, :start_date,
-        :status, :sub_total, :subsidiary, :sync_partner_teams, :sync_sales_teams, :tax_2_total, :tax_item, :tax_rate,
+        :status, :subsidiary, :sync_partner_teams, :sync_sales_teams, :tax_2_total, :tax_item, :tax_rate,
         :tax_total, :terms, :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, :total_cost_estimate, :tracking_numbers, :tran_date, :tran_id, :tran_is_vsoe_bundle,
+        :to_be_printed, :total_cost_estimate, :tracking_numbers, :tran_date, :tran_id, :tran_is_vsoe_bundle,
         :transaction_bill_address, :transaction_ship_address, :vat_reg_num, :vsoe_auto_calc
 
-      record_refs :account, :bill_address_list, :custom_form, :entity, :posting_period, :ship_address_list
+      read_only_fields :sub_total, :discount_total, :total
+
+      record_refs :account, :bill_address_list, :custom_form, :entity, :klass, :posting_period, :ship_address_list
 
       attr_reader :internal_id, :external_id
 
@@ -44,13 +47,8 @@ module NetSuite
         attributes[:transaction_ship_address] = ShipAddress.new(attrs)
       end
 
-      def item_list=(attrs)
-        attributes[:item_list] = case attrs[:item]
-                                 when Hash
-                                   InvoiceItemList.new(attrs[:item])
-                                 when Array
-                                   attrs[:item].map { |item| InvoiceItemList.new(item) }
-                                 end
+      def item_list
+        attributes[:item_list] ||= InvoiceItemList.new
       end
 
       def self.get(id)
@@ -76,6 +74,11 @@ module NetSuite
         response.success?
       end
 
+      def to_record
+        attributes.delete(:custom_field_list)
+        super
+      end
+
     end
   end
 end

data/lib/netsuite/records/invoice_item.rb

@@ -0,0 +1,34 @@
+module NetSuite
+  module Records
+    class InvoiceItem
+      include Support::Fields
+      include Support::RecordRefs
+      include Support::Records
+      include Namespaces::TranSales
+
+      fields :amount, :amount_ordered, :bin_numbers, :cost_estimate, :cost_estimate_type, :current_percent, :custom_field_list,
+        :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,
+        :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, :serial_numbers, :ship_group,
+        :tax1_amt, :tax_rate1, :tax_rate2, :vsoe_allocation, :vsoe_amount, :vsoe_deferral, :vsoe_delivered,
+        :vsoe_permit_discount, :vsoe_price
+
+      record_refs :department, :item, :job, :location, :price, :rev_rec_schedule, :ship_address, :ship_method, :tax_code, :units
+
+      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
+
+      def initialize_from_record(record)
+        self.attributes = record.send(:attributes)
+      end
+
+    end
+  end
+end

data/lib/netsuite/records/invoice_item_list.rb

@@ -1,21 +1,20 @@
 module NetSuite
   module Records
     class InvoiceItemList
-      include FieldSupport
-      include RecordRefSupport
+      include Namespaces::TranSales
 
-      fields :amount, :amount_ordered, :bin_numbers, :cost_estimate, :cost_estimate_type, :current_percent, :custom_field_list,
-        :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,
-        :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, :serial_numbers, :ship_group,
-        :tax1_amt, :tax_rate1, :tax_rate2, :vsoe_allocation, :vsoe_amount, :vsoe_deferral, :vsoe_delivered,
-        :vsoe_permit_discount, :vsoe_price
+      def items
+        @items ||= []
+      end
+      private :items
 
-      record_refs :department, :item, :job, :location, :price, :rev_rec_schedule, :ship_address, :ship_method, :tax_code, :units
+      def add_item(item, attributes = {})
+        attributes.merge!(:item => item)
+        items << InvoiceItem.new(attributes)
+      end
 
-      def initialize(attributes = {})
-        initialize_from_attributes_hash(attributes)
+      def to_record
+        { "#{record_namespace}:item" => items.map(&:to_record) }
       end
 
     end

data/lib/netsuite/records/non_inventory_sale_item.rb

@@ -1,8 +1,10 @@
 module NetSuite
   module Records
     class NonInventorySaleItem
-      include FieldSupport
-      include RecordRefSupport
+      include Support::Fields
+      include Support::RecordRefs
+      include Support::Records
+      include Namespaces::ListAcct
 
       fields :available_to_partners, :cost_estimate, :cost_estimate_type, :cost_estimate_units, :country_of_manufacture,
         :created_date, :custom_field_list, :display_name, :dont_show_price, :enforce_min_qty_internally, :exclude_from_sitemap,

data/lib/netsuite/records/record_ref.rb

@@ -1,16 +1,22 @@
 module NetSuite
   module Records
     class RecordRef
-      include AttributeSupport
+      include Support::Fields
+      include Support::Records
+      include Namespaces::PlatformCore
 
-      attr_reader :internal_id
+      attr_reader :internal_id, :type
 
       def initialize(attributes_or_record = {})
         case attributes_or_record
         when Hash
           attributes_or_record.delete(:"@xmlns:platform_core")
           @internal_id = attributes_or_record.delete(:internal_id) || attributes_or_record.delete(:@internal_id)
+          @type        = attributes_or_record.delete(:type) || attributes_or_record.delete(:@type)
           @attributes  = attributes_or_record
+        else
+          @internal_id = attributes_or_record.internal_id if attributes_or_record.respond_to?(:internal_id)
+          @type        = attributes_or_record.class.to_s.split('::').last.lower_camelcase
         end
       end
 

data/lib/netsuite/records/ship_address.rb

@@ -1,7 +1,9 @@
 module NetSuite
   module Records
     class ShipAddress
-      include FieldSupport
+      include Support::Fields
+      include Support::Records
+      include Namespaces::PlatformCommon
 
       fields :ship_attention, :ship_addressee, :ship_phone, :ship_addr1, :ship_addr2,
         :ship_addr3, :ship_city, :ship_state, :ship_zip, :ship_country, :ship_is_residential

data/lib/netsuite/support/attributes.rb

@@ -0,0 +1,22 @@
+module NetSuite
+  module Support
+    module Attributes
+
+      def attributes
+        @attributes ||= {}
+      end
+
+      def attributes=(attributes)
+        @attributes = attributes
+      end
+
+      def initialize_from_attributes_hash(attributes = {})
+        attributes.select { |k,v| self.class.fields.include?(k) }.each do |k,v|
+          send("#{k}=", v)
+        end
+        self.klass = attributes[:class] if attributes[:class]
+      end
+
+    end
+  end
+end

data/lib/netsuite/support/fields.rb

@@ -0,0 +1,54 @@
+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)
+          name_sym = name.to_sym
+          fields << name_sym
+          define_method(name_sym) do
+            attributes[name_sym]
+          end
+
+          define_method("#{name_sym}=") do |value|
+            attributes[name_sym] = value
+          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
+
+      end
+
+    end
+  end
+end