netsuite 0.2.3 → 0.2.4

checksums.yaml

@@ -1,7 +1,15 @@
 ---
-SHA1:
-  metadata.gz: c137a01aff81975a25856d832bc61d90b37468c5
-  data.tar.gz: afbbaf1726823511a72bef89702f09011c87ceb0
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    MTRlZDk0NGYwODZlOTA3OGZmMGQ2MDllMTdmNDNlZDI5YmY4ODNjYw==
+  data.tar.gz: !binary |-
+    ZTA3YTgyYTE5ZDAxNWUyY2ZiNmViODlmNGE1NTY4MjFlY2U2OGI5Ng==
 SHA512:
-  metadata.gz: ec904bf4c128f98da10e50688e3b2ffbfc81fe933c96001fce48f9e9788c1d2df5067206ce19a129296930447b8560de4204776f3c8da4489676c4d57a88be68
-  data.tar.gz: 8b1d944d17d8af49ce0fee65a965166766e50645ee1c3c759c8178fcfbb094f22e5d83f83cb1e1a8b15a3c614a84630cd5ab15acff64574d77fb5094264ba62f
+  metadata.gz: !binary |-
+    ZWI1MDEyYWRjNmY3YzNlYWY2ZmUzNDlkNjYzZDgyNGI1YzA5OTg5ZjA0YzQ2
+    N2I3YzUzNDU3NGRjYjA2NjQ0MjZmMWY4ZmNjYTc0MzM4N2UxNjVlMWExZWUy
+    ODUwYzBjM2QzNTI1NGZkNDZiNWM1ODE5M2FmZGVkNWYwNWU0NmQ=
+  data.tar.gz: !binary |-
+    OTI5Mzc5MWE1NTg1YjUxZWUzYjhlMWIxYmNiZjZkMmVmODUxNDMzOGFkMTg0
+    OGFmZjc5NmMyOGNhZGE0NzJlZTVkYjU2ZWU5YTQwMWYwNmU2NjU2NmExYWNl
+    NDAwZWNmMzk2ZTEzOWM3ZWRhOWJjODg4OTljN2ZkMzU4ZmYwM2Y=

data/README.md

@@ -265,4 +265,13 @@ NetSuite::Records::BaseRefList.get_select_value(
     '@xsi:type' => 'customRecord'
   }
 )
+
+# updating a custom field list
+# you need to push ALL the values of ALL of the custom fields that you want set on the record
+# you can't just push the values of the fields that you want to update: all of the values of
+# other fields will then fall back to their default values
+contact = NetSuite::Records::Contact.get(12345)
+contact.custom_field_list.custentity_alistfield = { internal_id: 1 }
+contact.custom_field_list.custentity_abooleanfield = true
+contact.update(custom_field_list: contact.custom_field_list)
 ```

data/lib/netsuite.rb

@@ -3,6 +3,7 @@ require 'set'
 require 'savon'
 require 'netsuite/version'
 require 'netsuite/errors'
+require 'netsuite/utilities'
 require 'netsuite/core_ext/string/lower_camelcase'
 
 module NetSuite
@@ -16,6 +17,7 @@ module NetSuite
     autoload :ListSupport,    'netsuite/namespaces/list_support'
     autoload :PlatformCommon, 'netsuite/namespaces/platform_common'
     autoload :PlatformCore,   'netsuite/namespaces/platform_core'
+    autoload :TranBank,       'netsuite/namespaces/tran_bank'
     autoload :TranCust,       'netsuite/namespaces/tran_cust'
     autoload :TranGeneral,    'netsuite/namespaces/tran_general'
     autoload :TranSales,      'netsuite/namespaces/tran_sales'
@@ -40,6 +42,7 @@ module NetSuite
     autoload :GetSelectValue,   'netsuite/actions/get_select_value'
     autoload :Initialize,       'netsuite/actions/initialize'
     autoload :Update,           'netsuite/actions/update'
+    autoload :Upsert,           'netsuite/actions/upsert'
     autoload :Search,           'netsuite/actions/search'
     autoload :SearchMoreWithId, 'netsuite/actions/search_more_with_id'
   end
@@ -78,6 +81,9 @@ module NetSuite
     autoload :ContactList,                'netsuite/records/contact_list'
     autoload :Contact,                    'netsuite/records/contact'
     autoload :Department,                 'netsuite/records/department'
+    autoload :Deposit,                    'netsuite/records/deposit'
+    autoload :DepositPayment,             'netsuite/records/deposit_payment'
+    autoload :DepositPaymentList,         'netsuite/records/deposit_payment_list'
     autoload :Duration,                   'netsuite/records/duration'
     autoload :InventoryItem,              'netsuite/records/inventory_item'
     autoload :Invoice,                    'netsuite/records/invoice'

data/lib/netsuite/actions/upsert.rb

@@ -0,0 +1,89 @@
+module NetSuite
+  module Actions
+    class Upsert
+      include Support::Requests
+
+      attr_reader :response_hash
+
+      def initialize(object = nil)
+        @object = object
+      end
+
+      private
+
+      def request
+        NetSuite::Configuration.connection.call :upsert, :message => request_body
+      end
+
+      # <soap:Body>
+      #   <platformMsgs:upsert>
+      #     <platformMsgs:record xsi:type="listRel:Customer">
+      #       <listRel:entityId>Shutter Fly</listRel:entityId>
+      #       <listRel:companyName>Shutter Fly, Inc</listRel:companyName>
+      #     </platformMsgs:record>
+      #   </platformMsgs:upsert>
+      # </soap:Body>
+
+      def request_body
+        hash = {
+          'platformMsgs:record' => {
+            :content! => @object.to_record,
+            '@xsi:type' => @object.record_type
+          }
+        }
+
+        if @object.respond_to?(:internal_id) && @object.internal_id
+          hash['platformMsgs:record']['@platformMsgs:internalId'] = @object.internal_id
+        end
+
+        if @object.respond_to?(:external_id) && @object.external_id
+          hash['platformMsgs:record']['@platformMsgs:externalId'] = @object.external_id
+        end
+
+        hash
+      end
+
+      def success?
+        @success ||= response_hash[:status][:@is_success] == 'true'
+      end
+
+      def response_body
+        @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[:upsert_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 upsert
+          response = NetSuite::Actions::Upsert.call(self)
+
+          @errors = response.errors
+
+          if response.success?
+            @internal_id = response.body[:@internal_id]
+            true
+          else
+            false
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/netsuite/configuration.rb

@@ -86,6 +86,7 @@ module NetSuite
         'xmlns:actSched'       => "urn:scheduling_#{api_version}.activities.webservices.netsuite.com",
         'xmlns:setupCustom'    => "urn:customization_#{api_version}.setup.webservices.netsuite.com",
         '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:listSupport'    => "urn:support_#{api_version}.lists.webservices.netsuite.com",
         'xmlns:tranGeneral'    => "urn:general_#{api_version}.transactions.webservices.netsuite.com",

data/lib/netsuite/namespaces/tran_bank.rb

@@ -0,0 +1,11 @@
+module NetSuite
+  module Namespaces
+    module TranBank
+
+      def record_namespace
+        'tranBank'
+      end
+
+    end
+  end
+end

data/lib/netsuite/records/credit_memo.rb

@@ -7,7 +7,7 @@ module NetSuite
       include Support::Actions
       include Namespaces::TranCust
 
-      actions :get, :add, :initialize, :delete, :update
+      actions :get, :add, :initialize, :delete, :update, :upsert
 
       fields :alt_handling_cost, :alt_shipping_cost, :amount_paid, :amount_remaining, :auto_apply, :balance,
         :bill_address, :contrib_pct, :created_date, :currency_name, :deferred_revenue, :discount_rate, :email,

data/lib/netsuite/records/customer.rb

@@ -7,7 +7,7 @@ module NetSuite
       include Support::Actions
       include Namespaces::ListRel
 
-      actions :get, :get_list, :add, :update, :delete, :search
+      actions :get, :get_list, :add, :update, :upsert, :delete, :search
 
       fields :access_role, :account_number, :aging, :alt_email, :alt_name, :alt_phone, :bill_pay,
         :buying_reason, :buying_time_frame, :campaign_category, :category, :click_stream, :comments, :company_name,

data/lib/netsuite/records/deposit.rb

@@ -0,0 +1,32 @@
+module NetSuite
+  module Records
+    class Deposit
+      include Support::Fields
+      include Support::RecordRefs
+      include Support::Records
+      include Support::Actions
+      include Namespaces::TranBank
+
+      actions :get, :add, :delete
+
+      fields :created_date, :last_modified_date, :currency_name, :tran_id, :total, :tran_date, :memo, :to_be_printed
+
+      record_refs :custom_form, :account, :posting_period, :subsidiary, :department, :klass, :location
+
+      field :payment_list,      DepositPaymentList
+      # field :other_list, DepositOtherList
+      # field :cash_back_list, DepositCashBackList
+      field :custom_field_list, CustomFieldList
+
+      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/deposit_payment.rb

@@ -0,0 +1,48 @@
+module NetSuite
+  module Records
+    class DepositPayment
+      include Support::Fields
+      include Support::RecordRefs
+      include Support::Records
+      include Namespaces::TranBank
+
+      # <element name="deposit" type="xsd:boolean" minOccurs="0"/>
+      # <element name="id" type="xsd:long" minOccurs="0"/>
+      # <element name="docDate" type="xsd:dateTime" minOccurs="0"/>
+      # <element name="type" type="xsd:string" minOccurs="0"/>
+      # <element name="docNumber" type="xsd:string" minOccurs="0"/>
+      # <element name="memo" type="xsd:string" minOccurs="0"/>
+      # <element name="paymentMethod" type="platformCore:RecordRef" minOccurs="0"/>
+      # <element name="refNum" type="xsd:string" minOccurs="0"/>
+      # <element name="entity" type="platformCore:RecordRef" minOccurs="0"/>
+      # <element name="currency" type="platformCore:RecordRef" minOccurs="0"/>
+      # <element name="transactionAmount" type="xsd:double" minOccurs="0"/>
+      # <element name="paymentAmount" type="xsd:double" minOccurs="0"/>
+
+      fields :deposit, :id, :doc_date, :type, :doc_number, :memo, :ref_num, :transaction_amount, :payment_amount
+
+      record_refs :entity, :currency, :payment_method
+
+      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
+
+      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/deposit_payment_list.rb

@@ -0,0 +1,32 @@
+module NetSuite
+  module Records
+    class DepositPaymentList
+      include Support::Fields
+      include Namespaces::TranBank
+
+      fields :deposit_payment
+
+      def initialize(attributes = {})
+        initialize_from_attributes_hash(attributes)
+      end
+
+      def payment=(payments)
+        case payments
+        when Hash
+          self.payments << DepositPayment.new(payments)
+        when Array
+          payments.each { |p| self.payments << DepositPayment.new(p) }
+        end
+      end
+
+      def payments
+        @payments ||= []
+      end
+
+      def to_record
+        { "#{record_namespace}:depositPayment" => payments.map(&:to_record) }
+      end
+
+    end
+  end
+end

data/lib/netsuite/records/inventory_item.rb

@@ -20,7 +20,7 @@ module NetSuite
       #     }
       #  ]
       #
-      actions :get, :add, :delete, :search, :update
+      actions :get, :add, :delete, :search, :update, :upsert
 
       fields :auto_lead_time, :auto_preferred_stock_level, :auto_reorder_point, :available_to_partners, :average_cost,
         :copy_description, :cost, :cost_estimate, :cost_estimate_type, :cost_estimate_units, :cost_units, :costing_method,

data/lib/netsuite/records/invoice.rb

@@ -7,7 +7,7 @@ module NetSuite
       include Support::Actions
       include Namespaces::TranSales
 
-      actions :get, :initialize, :add, :delete
+      actions :get, :initialize, :add, :delete, :upsert
 
       fields :balance, :bill_address,
         :billing_schedule, :contrib_pct, :created_date, :currency_name, :custom_field_list,

data/lib/netsuite/records/item_fulfillment.rb

@@ -1,16 +1,17 @@
 module NetSuite
   module Records
-  	class ItemFulfillment
-		include Support::Fields
-		include Support::RecordRefs
-		include Support::Records
-		include Support::Actions
-		include Namespaces::TranSales
+    class ItemFulfillment
+      include Support::Fields
+      include Support::RecordRefs
+      include Support::Records
+      include Support::Actions
+      include Namespaces::TranSales
 
-  		actions :get, :add, :initialize, :delete
+      actions :get, :add, :initialize, :delete, :search
 
       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_addr2, :ship_city, :ship_state, :ship_zip, :ship_phone, :ship_is_residential,
+        :ship_status
 
       read_only_fields :handling_cost
 
@@ -39,6 +40,9 @@ module NetSuite
         rec
       end
 
-  	end
+      def self.search_class_name
+        "Transaction"
+      end
+    end
   end
-end
+end

data/lib/netsuite/records/item_fulfillment_package_list.rb

@@ -5,23 +5,23 @@ module NetSuite
       include Support::Records
       include Namespaces::TranSales
 
-      fields :item
+      fields :package
 
       def initialize(attributes = {})
         initialize_from_attributes_hash(attributes)
       end
 
-      def item=(items)
-        case items
+      def package=(packages)
+        case packages
         when Hash
-          self.items << ItemFulfillmentPackage.new(items)
+          self.packages << ItemFulfillmentPackage.new(packages)
         when Array
-          items.each { |item| self.items << ItemFulfillmentPackage.new(item) }
+          packages.each { |package| self.packages << ItemFulfillmentPackage.new(package) }
         end
       end
 
-      def items
-        @items ||= []
+      def packages
+        @packages ||= []
       end
 
       def to_record

data/lib/netsuite/records/job.rb

@@ -7,7 +7,7 @@ module NetSuite
       include Support::Actions
       include Namespaces::ListRel
 
-      actions :get, :add, :delete, :update
+      actions :get, :add, :delete, :update, :upsert
 
       fields :account_number, :allocate_payroll_expenses, :allow_all_resources_for_tasks, :allow_expenses, :allow_time,
         :alt_name, :alt_phone, :bill_pay, :calculated_end_date, :calculated_end_date_baseline, :comments, :company_name,

data/lib/netsuite/records/phone_call.rb

@@ -7,7 +7,7 @@ module NetSuite
       include Support::Actions
       include Namespaces::ActSched
 
-      actions :get, :add, :delete, :update
+      actions :get, :add, :delete, :update, :upsert
 
       fields :title, :message, :phone, :status, :priority, :start_date, :end_date,
         :start_time, :end_time, :completed_date, :timed_event, :access_level, :timed_event

data/lib/netsuite/records/sales_order.rb

@@ -7,7 +7,7 @@ module NetSuite
       include Support::Actions
       include Namespaces::TranSales
 
-      actions :get, :add, :initialize, :delete, :update, :search
+      actions :get, :add, :initialize, :delete, :update, :upsert, :search
 
       fields :alt_handling_cost, :alt_shipping_cost, :amount_paid, :amount_remaining, :auto_apply, :balance,
         :bill_address, :contrib_pct, :created_date, :currency_name, :deferred_revenue, :discount_rate, :email, :end_date,

data/lib/netsuite/records/support_case.rb

@@ -7,7 +7,7 @@ module NetSuite
       include Support::Actions
       include Namespaces::ListSupport
 
-      actions :get, :add, :delete, :update
+      actions :get, :add, :delete, :update, :upsert
 
       fields :end_date, :incoming_message, :outgoing_message, :search_solution, :email_form, 
              :internal_only, :title, :case_number, :start_date, :email, :phone, :inbound_email, 

data/lib/netsuite/records/task.rb

@@ -7,7 +7,7 @@ module NetSuite
       include Support::Actions
       include Namespaces::ActSched
 
-      actions :get, :add, :search, :delete, :update
+      actions :get, :add, :search, :delete, :update, :upsert
 
       fields :title, :send_email, :message, :status, :access_level, :reminder_type,
              :reminder_minutes, :start_date, :end_date, :due_date, :timed_event,

data/lib/netsuite/response.rb

@@ -6,7 +6,7 @@ module NetSuite
       @success  = attributes[:success]
       @header   = attributes[:header]
       @body     = attributes[:body]
-      @errors   = attributes[:errors]
+      @errors   = attributes[:errors] || []
     end
 
     def success!
@@ -16,6 +16,5 @@ module NetSuite
     def success?
       @success
     end
-
   end
 end

data/lib/netsuite/support/actions.rb

@@ -30,6 +30,8 @@ module NetSuite
             self.send(:include, NetSuite::Actions::SearchMoreWithId::Support)
           when :add
             self.send(:include, NetSuite::Actions::Add::Support)
+          when :upsert
+            self.send(:include, NetSuite::Actions::Upsert::Support)
           when :delete
             self.send(:include, NetSuite::Actions::Delete::Support)
           when :update

data/lib/netsuite/utilities.rb

@@ -0,0 +1,34 @@
+module NetSuite
+  module Utilities
+
+    # Warning this was developed with a Web Services user whose time zone was set to CST
+    # the time zone setting of the user seems to effect how times work in NS
+
+    # modifying time without rails:
+    # http://stackoverflow.com/questions/238684/subtract-n-hours-from-a-datetime-in-ruby
+
+    # converting between time and datetime:
+    # http://stackoverflow.com/questions/279769/convert-to-from-datetime-and-time-in-ruby
+
+    # use when sending times to NS
+    def self.normalize_datetime_to_netsuite(datetime)
+      # normalize the time to UCT0
+      # add 6 hours (21600 seconds) of padding (CST offset)
+      # to force the same time to be displayed in the NS UI
+
+      is_dst = Time.parse(datetime.to_s).dst?
+
+      datetime.new_offset(0) + datetime.offset + Rational(is_dst ? 5 : 6, 24)
+    end
+
+    # use when displaying times from a NS record
+    def self.normalize_datetime_from_netsuite(datetime)
+      # the code below eliminates the TimeZone offset then shifts the date forward 2 hours (7200 seconds)
+      # this ensures that ActiveRecord is given a UTC0 DateTime with the exact hour that
+      # was displayed in the NS UI (CST time zone), which will result in the correct display on the web side
+
+      datetime.new_offset(0) + datetime.offset + Rational(2, 24)
+    end
+
+  end
+end

data/lib/netsuite/version.rb

@@ -1,3 +1,3 @@
 module Netsuite
-  VERSION = '0.2.3'
+  VERSION = '0.2.4'
 end

data/spec/netsuite/actions/upsert_spec.rb

@@ -0,0 +1,117 @@
+require 'spec_helper'
+
+describe NetSuite::Actions::Upsert do
+  before(:all) { savon.mock! }
+  after(:all) { savon.unmock! }
+
+  context 'Customer' do
+    let(:customer) do
+      NetSuite::Records::Customer.new(:entity_id => 'Shutter Fly', :company_name => 'Shutter Fly, Inc.')
+    end
+
+    before do
+      savon.expects(:upsert).with(:message => {
+        'platformMsgs:record' => {
+          :content! => {
+            'listRel:entityId'    => 'Shutter Fly',
+            'listRel:companyName' => 'Shutter Fly, Inc.'
+          },
+          '@xsi:type' => 'listRel:Customer'
+        },
+      }).returns(File.read('spec/support/fixtures/upsert/upsert_customer.xml'))
+    end
+
+    it 'makes a valid request to the NetSuite API' do
+      NetSuite::Actions::Upsert.call(customer)
+    end
+
+    it 'returns a valid Response object' do
+      response = NetSuite::Actions::Upsert.call(customer)
+      response.should be_kind_of(NetSuite::Response)
+      response.should be_success
+    end
+  end
+
+  context 'Invoice' do
+    let(:invoice) do
+      NetSuite::Records::Invoice.new(:source => 'Google', :total => 100.0)
+    end
+
+    context 'when successful' do
+      before do
+        savon.expects(:upsert).with(:message => {
+          'platformMsgs:record' => {
+            :content! => {
+              'tranSales:source' => 'Google'
+            },
+            '@xsi:type' => 'tranSales:Invoice'
+          },
+        }).returns(File.read('spec/support/fixtures/upsert/upsert_invoice.xml'))
+      end
+
+      it 'makes a valid request to the NetSuite API' do
+        NetSuite::Actions::Upsert.call(invoice)
+      end
+
+      it 'returns a valid Response object' do
+        response = NetSuite::Actions::Upsert.call(invoice)
+        response.should be_kind_of(NetSuite::Response)
+        response.should be_success
+      end
+    end
+
+    context 'when not successful' do
+      before do
+        savon.expects(:upsert).with(:message => {
+          'platformMsgs:record' => {
+            :content! => {
+              'tranSales:source' => 'Google'
+            },
+            '@xsi:type' => 'tranSales:Invoice'
+          },
+        }).returns(File.read('spec/support/fixtures/upsert/upsert_invoice_error.xml'))
+      end
+
+      it 'provides an error method on the object with details about the error' do
+        invoice.upsert
+        error = invoice.errors.first
+
+        error.should be_kind_of(NetSuite::Error)
+        error.type.should eq('ERROR')
+        error.code.should eq('INVALID_KEY_OR_REF')
+        error.message.should eq('The specified key is invalid.')
+      end
+
+      it 'provides an error method on the response' do
+        response = NetSuite::Actions::Upsert.call(invoice)
+        response.errors.first.should be_kind_of(NetSuite::Error)
+      end
+    end
+
+    context 'when not successful with multiple errors' do
+      before do
+        savon.expects(:upsert).with(:message => {
+          'platformMsgs:record' => {
+            :content! => {
+              'tranSales:source' => 'Google'
+            },
+            '@xsi:type' => 'tranSales:Invoice'
+          },
+        }).returns(File.read('spec/support/fixtures/upsert/upsert_invoice_multiple_errors.xml'))
+      end
+
+      it 'provides an error method on the object with details about the error' do
+        invoice.upsert
+        invoice.errors.length.should eq(2)
+
+        error = invoice.errors.first
+
+        error.should be_kind_of(NetSuite::Error)
+        error.type.should eq('ERROR')
+        error.code.should eq('ERROR')
+        error.message.should eq('Some message')
+      end
+    end
+  end
+
+end

data/spec/netsuite/records/deposit_spec.rb

@@ -0,0 +1,146 @@
+require 'spec_helper'
+
+describe NetSuite::Records::Deposit do
+  let(:deposit) { NetSuite::Records::Deposit.new }
+  let(:customer) { NetSuite::Records::Customer.new }
+  let(:response) { NetSuite::Response.new(:success => true, :body => { :internal_id => '1' }) }
+
+  it 'has all the right fields' do
+    [
+      :created_date, :last_modified_date, :currency_name, :tran_id, :total, :tran_date, :memo, :to_be_printed
+    ].each do |field|
+      deposit.should have_field(field)
+    end
+  end
+
+  it 'has all the right record refs' do
+    [
+      :custom_form, :account, :posting_period, :subsidiary, :department, :klass, :location
+    ].each do |record_ref|
+      deposit.should have_record_ref(record_ref)
+    end
+  end
+
+  describe '#item_list' do
+    it 'can be set from attributes' do
+      attributes = {
+        payment: {
+          deposit: true,
+          id: '941',
+          type: 'CashSale'
+        }
+      }
+      deposit.payment_list.payment = attributes
+      deposit.payment_list.should be_kind_of(NetSuite::Records::DepositPaymentList)
+      deposit.payment_list.payments.length.should eql(1)
+    end
+
+    it 'can be set from a DepositItemList object' do
+      item_list = NetSuite::Records::DepositPaymentList.new
+      deposit.payment_list = item_list
+      deposit.payment_list.should eql(item_list)
+    end
+  end
+
+  describe '.get' do
+    context 'when the response is successful' do
+      let(:response) { NetSuite::Response.new(:success => true, :body => { :alt_shipping_cost => 100 }) }
+
+      it 'returns a Deposit instance populated with the data from the response object' do
+        NetSuite::Actions::Get.should_receive(:call).with(NetSuite::Records::Deposit, :external_id => 1).and_return(response)
+        deposit = NetSuite::Records::Deposit.get(:external_id => 1)
+        deposit.should be_kind_of(NetSuite::Records::Deposit)
+        deposit.alt_shipping_cost.should eql(100)
+      end
+    end
+
+    context 'when the response is unsuccessful' do
+      let(:response) { NetSuite::Response.new(:success => false, :body => {}) }
+
+      it 'raises a RecordNotFound exception' do
+        NetSuite::Actions::Get.should_receive(:call).with(NetSuite::Records::Deposit, :external_id => 1).and_return(response)
+        lambda {
+          NetSuite::Records::Deposit.get(:external_id => 1)
+        }.should raise_error(NetSuite::RecordNotFound,
+          /NetSuite::Records::Deposit with OPTIONS=(.*) could not be found/)
+      end
+    end
+  end
+
+  describe '#add' do
+    let(:test_data) { { :email => 'test@example.com', :fax => '1234567890' } }
+
+    context 'when the response is successful' do
+      let(:response) { NetSuite::Response.new(:success => true, :body => { :internal_id => '1' }) }
+
+      it 'returns true' do
+        deposit = NetSuite::Records::Deposit.new(test_data)
+        NetSuite::Actions::Add.should_receive(:call).
+            with(deposit).
+            and_return(response)
+        deposit.add.should be_true
+      end
+    end
+
+    context 'when the response is unsuccessful' do
+      let(:response) { NetSuite::Response.new(:success => false, :body => {}) }
+
+      it 'returns false' do
+        deposit = NetSuite::Records::Deposit.new(test_data)
+        NetSuite::Actions::Add.should_receive(:call).
+            with(deposit).
+            and_return(response)
+        deposit.add.should be_false
+      end
+    end
+  end
+
+  describe '#delete' do
+    let(:test_data) { { :internal_id => '1' } }
+
+    context 'when the response is successful' do
+      let(:response) { NetSuite::Response.new(:success => true, :body => { :internal_id => '1' }) }
+
+      it 'returns true' do
+        deposit = NetSuite::Records::Deposit.new(test_data)
+        NetSuite::Actions::Delete.should_receive(:call).
+            with(deposit).
+            and_return(response)
+        deposit.delete.should be_true
+      end
+    end
+
+    context 'when the response is unsuccessful' do
+      let(:response) { NetSuite::Response.new(:success => false, :body => {}) }
+
+      it 'returns false' do
+        deposit = NetSuite::Records::Deposit.new(test_data)
+        NetSuite::Actions::Delete.should_receive(:call).
+            with(deposit).
+            and_return(response)
+        deposit.delete.should be_false
+      end
+    end
+  end
+
+  describe '#to_record' do
+    before do
+      deposit.email   = 'something@example.com'
+      deposit.tran_id = '4'
+    end
+    it 'can represent itself as a SOAP record' do
+      record = {
+        'tranBank:email'  => 'something@example.com',
+        'tranBank:tranId' => '4'
+      }
+      deposit.to_record.should eql(record)
+    end
+  end
+
+  describe '#record_type' do
+    it 'returns a string representation of the SOAP type' do
+      deposit.record_type.should eql('tranBank:Deposit')
+    end
+  end
+
+end

data/spec/support/fixtures/upsert/upsert_customer.xml

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <soapenv:Header>
+    <platformMsgs:documentInfo xmlns:platformMsgs="urn:messages_2014_1.platform.webservices.netsuite.com">
+      <platformMsgs:nsId>WEBSERVICES_3392464_1220201115821392011296470399_67055c545d0</platformMsgs:nsId>
+    </platformMsgs:documentInfo>
+  </soapenv:Header>
+  <soapenv:Body>
+    <upsertResponse xmlns="urn:messages_2014_1.platform.webservices.netsuite.com">
+      <writeResponse xmlns="urn:messages_2014_1.platform.webservices.netsuite.com">
+        <platformCore:status xmlns:platformCore="urn:core_2014_1.platform.webservices.netsuite.com" isSuccess="true"/>
+        <baseRef xmlns:platformCore="urn:core_2014_1.platform.webservices.netsuite.com" internalId="979" externalId="cu241" type="customer" xsi:type="platformCore:RecordRef"/>
+      </writeResponse>
+    </upsertResponse>
+  </soapenv:Body>
+</soapenv:Envelope>

data/spec/support/fixtures/upsert/upsert_invoice.xml

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <soapenv:Header>
+    <platformMsgs:documentInfo xmlns:platformMsgs="urn:messages_2014_1.platform.webservices.netsuite.com">
+      <platformMsgs:nsId>WEBSERVICES_3392464_1220201115821392011296470399_67055c545d0</platformMsgs:nsId>
+    </platformMsgs:documentInfo>
+  </soapenv:Header>
+  <soapenv:Body>
+    <upsertResponse xmlns="urn:messages_2014_1.platform.webservices.netsuite.com">
+      <writeResponse xmlns="urn:messages_2014_1.platform.webservices.netsuite.com">
+        <platformCore:status xmlns:platformCore="urn:core_2014_1.platform.webservices.netsuite.com" isSuccess="true"/>
+        <baseRef xmlns:platformCore="urn:core_2014_1.platform.webservices.netsuite.com" internalId="979" externalId="in241" type="invoice" xsi:type="platformCore:RecordRef"/>
+      </writeResponse>
+    </upsertResponse>
+  </soapenv:Body>
+</soapenv:Envelope>

data/spec/support/fixtures/upsert/upsert_invoice_error.xml

@@ -0,0 +1,20 @@
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
+  <soapenv:Header>
+    <platformMsgs:documentInfo xmlns:platformMsgs="urn:messages_2014_1.platform.webservices.netsuite.com">
+      <platformMsgs:nsId>WEBSERVICES_TSTDRV1141558_0120201413459254121612426069_c2488</platformMsgs:nsId>
+    </platformMsgs:documentInfo>
+  </soapenv:Header>
+  <soapenv:Body>
+    <upsertResponse xmlns="urn:messages_2014_1.platform.webservices.netsuite.com">
+      <writeResponse>
+        <platformCore:status xmlns:platformCore="urn:core_2014_1.platform.webservices.netsuite.com" isSuccess="false">
+          <platformCore:statusDetail type="ERROR">
+            <platformCore:code>INVALID_KEY_OR_REF</platformCore:code>
+            <platformCore:message>The specified key is invalid.</platformCore:message>
+          </platformCore:statusDetail>
+        </platformCore:status>
+        <baseRef xmlns:platformCore="urn:core_2014_1.platform.webservices.netsuite.com" externalId="in_334" type="invoice" xsi:type="platformCore:RecordRef"/>
+      </writeResponse>
+    </upsertResponse>
+  </soapenv:Body>
+</soapenv:Envelope>

data/spec/support/fixtures/upsert/upsert_invoice_multiple_errors.xml

@@ -0,0 +1,24 @@
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
+  <soapenv:Header>
+    <platformMsgs:documentInfo xmlns:platformMsgs="urn:messages_2014_1.platform.webservices.netsuite.com">
+      <platformMsgs:nsId>WEBSERVICES_TSTDRV1141558_0120201413459254121612426069_c2488</platformMsgs:nsId>
+    </platformMsgs:documentInfo>
+  </soapenv:Header>
+  <soapenv:Body>
+    <upsertResponse xmlns="urn:messages_2014_1.platform.webservices.netsuite.com">
+      <writeResponse>
+        <platformCore:status xmlns:platformCore="urn:core_2014_1.platform.webservices.netsuite.com" isSuccess="false">
+          <platformCore:statusDetail type="ERROR">
+            <platformCore:code>ERROR</platformCore:code>
+            <platformCore:message>Some message</platformCore:message>
+          </platformCore:statusDetail>
+          <platformCore:statusDetail type="ERROR">
+            <platformCore:code>ERROR</platformCore:code>
+            <platformCore:message>Some message 2</platformCore:message>
+          </platformCore:statusDetail>
+        </platformCore:status>
+        <baseRef internalId="999" type="invoice" xsi:type="ns2:RecordRef" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns2="urn:core_2_5.platform.webservices.netsuite.com"/>
+      </writeResponse>
+    </upsertResponse>
+  </soapenv:Body>
+</soapenv:Envelope>

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: netsuite
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.4
 platform: ruby
 authors:
 - Ryan Moran
@@ -9,36 +9,36 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-04-14 00:00:00.000000000 Z
+date: 2014-04-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: savon
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 2.3.0
-  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: 2.3.0
+  name: savon
+  type: :runtime
 - !ruby/object:Gem::Dependency
-  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '2.10'
-  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '2.10'
+  name: rspec
+  type: :development
 description: NetSuite SuiteTalk API Wrapper
 email:
 - ryan.moran@gmail.com
@@ -47,8 +47,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".rspec"
+- .gitignore
+- .rspec
 - Gemfile
 - LICENSE
 - README.md
@@ -63,6 +63,7 @@ files:
 - lib/netsuite/actions/search.rb
 - lib/netsuite/actions/search_more_with_id.rb
 - lib/netsuite/actions/update.rb
+- lib/netsuite/actions/upsert.rb
 - lib/netsuite/configuration.rb
 - lib/netsuite/core_ext/string/lower_camelcase.rb
 - lib/netsuite/errors.rb
@@ -73,6 +74,7 @@ files:
 - lib/netsuite/namespaces/platform_common.rb
 - lib/netsuite/namespaces/platform_core.rb
 - lib/netsuite/namespaces/setup_custom.rb
+- lib/netsuite/namespaces/tran_bank.rb
 - lib/netsuite/namespaces/tran_cust.rb
 - lib/netsuite/namespaces/tran_general.rb
 - lib/netsuite/namespaces/tran_sales.rb
@@ -109,6 +111,9 @@ files:
 - lib/netsuite/records/customer_refund_deposit.rb
 - lib/netsuite/records/customer_refund_deposit_list.rb
 - lib/netsuite/records/department.rb
+- lib/netsuite/records/deposit.rb
+- lib/netsuite/records/deposit_payment.rb
+- lib/netsuite/records/deposit_payment_list.rb
 - lib/netsuite/records/duration.rb
 - lib/netsuite/records/inventory_item.rb
 - lib/netsuite/records/invoice.rb
@@ -150,6 +155,7 @@ files:
 - lib/netsuite/support/records.rb
 - lib/netsuite/support/requests.rb
 - lib/netsuite/support/search_result.rb
+- lib/netsuite/utilities.rb
 - lib/netsuite/version.rb
 - netsuite.gemspec
 - spec/netsuite/actions/add_spec.rb
@@ -158,6 +164,7 @@ files:
 - spec/netsuite/actions/initialize_spec.rb
 - spec/netsuite/actions/search_spec.rb
 - spec/netsuite/actions/update_spec.rb
+- spec/netsuite/actions/upsert_spec.rb
 - spec/netsuite/configuration_spec.rb
 - spec/netsuite/records/account_spec.rb
 - spec/netsuite/records/accounting_period_spec.rb
@@ -183,6 +190,7 @@ files:
 - spec/netsuite/records/customer_refund_spec.rb
 - spec/netsuite/records/customer_spec.rb
 - spec/netsuite/records/department_spec.rb
+- spec/netsuite/records/deposit_spec.rb
 - spec/netsuite/records/duration_spec.rb
 - spec/netsuite/records/inventory_item_spec.rb
 - spec/netsuite/records/invoice_item_list_spec.rb
@@ -229,6 +237,10 @@ files:
 - spec/support/fixtures/search/saved_search_joined_custom_customer.xml
 - spec/support/fixtures/update/update_customer.xml
 - spec/support/fixtures/update/update_invoice.xml
+- spec/support/fixtures/upsert/upsert_customer.xml
+- spec/support/fixtures/upsert/upsert_invoice.xml
+- spec/support/fixtures/upsert/upsert_invoice_error.xml
+- spec/support/fixtures/upsert/upsert_invoice_multiple_errors.xml
 - spec/support/read_only_field_matcher.rb
 - spec/support/record_ref_matcher.rb
 - spec/support/savon.rb
@@ -243,17 +255,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.0
+rubygems_version: 2.1.11
 signing_key: 
 specification_version: 4
 summary: NetSuite SuiteTalk API (SOAP) Wrapper
@@ -264,6 +276,7 @@ test_files:
 - spec/netsuite/actions/initialize_spec.rb
 - spec/netsuite/actions/search_spec.rb
 - spec/netsuite/actions/update_spec.rb
+- spec/netsuite/actions/upsert_spec.rb
 - spec/netsuite/configuration_spec.rb
 - spec/netsuite/records/account_spec.rb
 - spec/netsuite/records/accounting_period_spec.rb
@@ -289,6 +302,7 @@ test_files:
 - spec/netsuite/records/customer_refund_spec.rb
 - spec/netsuite/records/customer_spec.rb
 - spec/netsuite/records/department_spec.rb
+- spec/netsuite/records/deposit_spec.rb
 - spec/netsuite/records/duration_spec.rb
 - spec/netsuite/records/inventory_item_spec.rb
 - spec/netsuite/records/invoice_item_list_spec.rb
@@ -335,6 +349,10 @@ test_files:
 - spec/support/fixtures/search/saved_search_joined_custom_customer.xml
 - spec/support/fixtures/update/update_customer.xml
 - spec/support/fixtures/update/update_invoice.xml
+- spec/support/fixtures/upsert/upsert_customer.xml
+- spec/support/fixtures/upsert/upsert_invoice.xml
+- spec/support/fixtures/upsert/upsert_invoice_error.xml
+- spec/support/fixtures/upsert/upsert_invoice_multiple_errors.xml
 - spec/support/read_only_field_matcher.rb
 - spec/support/record_ref_matcher.rb
 - spec/support/savon.rb