netsuite-soap 2025.2.3

data/spec/netsuite/records/translation_list_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+
+describe NetSuite::Records::TranslationList do
+  let(:list) { NetSuite::Records::TranslationList.new }
+
+  it 'has a translations attribute' do
+    expect(list.translations).to be_kind_of(Array)
+  end
+
+  describe '#to_record' do
+    before do
+      list.translations << NetSuite::Records::Translation.new(
+        locale: '_englishUK',
+        language: 'English (UK)',
+        display_name: 'display name',
+        sales_description: 'sales description'
+      )
+    end
+
+    it 'can represent itself as a SOAP record' do
+      record = {
+        "listAcct:translation" => [
+          {
+            "listAcct:locale" => "_englishUK",
+            "listAcct:language" => "English (UK)",
+            "listAcct:displayName" => "display name",
+            "listAcct:salesDescription" => "sales description"
+          }
+        ]
+      }
+      expect(list.to_record).to eql(record)
+    end
+  end
+end

data/spec/netsuite/records/translation_spec.rb

@@ -0,0 +1,28 @@
+require 'spec_helper'
+
+describe NetSuite::Records::Translation do
+  let(:translation) { NetSuite::Records::Translation.new }
+
+  it 'has dynamic fields' do
+    [
+      :description,
+      :display_name,
+      :featured_description,
+      :language,
+      :locale,
+      :locale_description,
+      :name,
+      :no_price_message,
+      :out_of_stock_message,
+      :page_title,
+      :replace_all,
+      :sales_description,
+      :specials_description,
+      :store_description,
+      :store_detailed_description,
+      :store_display_name
+    ].each do |field|
+      expect(translation).to have_field(field)
+    end
+  end
+end

data/spec/netsuite/records/units_type_spec.rb

@@ -0,0 +1,33 @@
+require 'spec_helper'
+
+describe NetSuite::Records::UnitsType do
+  let(:units_type) { described_class.new }
+
+  it 'has all the right fields' do
+    [
+      :is_inactive, :name
+    ].each do |field|
+      expect(units_type).to have_field(field)
+    end
+  end
+
+  describe '#uom_list' do
+    it 'can be set from attributes' do
+      attributes = [{
+        uom: {
+          abbreviation: '6 oz',
+          conversion_rate: 1.4
+        }
+      }]
+      units_type.uom_list.uom = attributes
+      expect(units_type.uom_list).to be_kind_of(NetSuite::Records::UnitsTypeUomList)
+      expect(units_type.uom_list.uom.length).to eql(1)
+    end
+
+    it 'can be set from a units_typeItemList object' do
+      item_list = NetSuite::Records::UnitsTypeUomList.new
+      units_type.uom_list = item_list
+      expect(units_type.uom_list).to eql(item_list)
+    end
+  end
+end

data/spec/netsuite/records/units_type_uom_list_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+describe NetSuite::Records::UnitsTypeUomList do
+  let(:list) { described_class.new }
+  let(:item) { NetSuite::Records::UnitsTypeUom.new }
+
+  it 'can have items be added to it' do
+    list.uom << item
+    item_list = list.uom
+    expect(item_list).to be_kind_of(Array)
+    expect(item_list.length).to eql(1)
+    item_list.each { |i| expect(i).to be_kind_of(NetSuite::Records::UnitsTypeUom) }
+  end
+
+  describe '#to_record' do
+    it 'can represent itself as a SOAP record' do
+      record = {
+        'listAcct:uom' => []
+      }
+      expect(list.to_record).to eql(record)
+    end
+  end
+end

data/spec/netsuite/records/units_type_uom_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+
+describe NetSuite::Records::UnitsTypeUom do
+  let(:uom) { described_class.new }
+
+  it 'has all the right fields' do
+    [
+      :abbreviation, :base_unit, :conversion_rate, :plural_abbreviation,
+      :plural_name, :unit_name
+    ].each do |field|
+      expect(uom).to have_field(field)
+    end
+  end
+end

data/spec/netsuite/records/vendor_bill_expense_list_spec.rb

@@ -0,0 +1,36 @@
+require 'spec_helper'
+
+describe NetSuite::Records::VendorBillExpenseList do
+  let(:expense_list) { NetSuite::Records::VendorBillExpenseList.new }
+  let(:expense) { NetSuite::Records::VendorBillExpense.new }
+
+  it 'can be initialized with a hash' do
+    expense_list = NetSuite::Records::VendorBillExpenseList.new(expense: {})
+    expect(expense_list.expenses).to be_kind_of(Array)
+    expect(expense_list.expenses.length).to eql(1)
+    expect(expense_list.expenses[0]).to be_kind_of(NetSuite::Records::VendorBillExpense)
+  end
+
+  it 'can be initialized with a hash list' do
+    expense_list = NetSuite::Records::VendorBillExpenseList.new(expense: [{}])
+    expect(expense_list.expenses).to be_kind_of(Array)
+    expect(expense_list.expenses.length).to eql(1)
+    expect(expense_list.expenses[0]).to be_kind_of(NetSuite::Records::VendorBillExpense)
+  end
+
+  it 'can have expenses be added to it' do
+    expense_list.expenses << expense
+    expect(expense_list.expenses).to be_kind_of(Array)
+    expect(expense_list.expenses.length).to eql(1)
+    expect(expense_list.expenses[0]).to be_kind_of(NetSuite::Records::VendorBillExpense)
+  end
+
+  describe '#to_record' do
+    it 'can represent itself as a SOAP record' do
+      record = {
+        'tranPurch:expense' => []
+      }
+      expect(expense_list.to_record).to eql(record)
+    end
+  end
+end

data/spec/netsuite/records/vendor_bill_expense_spec.rb

@@ -0,0 +1,72 @@
+require 'spec_helper'
+
+describe NetSuite::Records::VendorBillExpense do
+  let(:expense) { NetSuite::Records::VendorBillExpense.new }
+
+  it 'has the right fields' do
+    [
+      :amount, :amortization_end_date, :amortiz_start_date, :amortization_residual, :gross_amt, :is_billable,
+      :line, :memo, :order_doc, :order_line, :tax_1_amt, :tax_rate_1, :tax_rate_2
+    ].each do |field|
+      expect(expense).to have_field(field)
+    end
+  end
+
+  it 'has the right record_refs' do
+    [
+      :account, :amortization_sched, :klass, :category, :customer, :department, :location, :tax_code
+    ].each do |record_ref|
+      expect(expense).to have_record_ref(record_ref)
+    end
+  end
+
+  it 'can initialize from a record' do
+    record = NetSuite::Records::VendorBillExpense.new(:amount => 123)
+    expense = NetSuite::Records::VendorBillExpense.new(record)
+    expect(expense).to be_kind_of(NetSuite::Records::VendorBillExpense)
+    expect(expense.amount).to eql(123)
+  end
+
+  describe '#custom_field_list' do
+    it 'can be set from attributes' do
+      attributes = {
+        :custom_field => {
+          :value => 10,
+          :script_id => 'custfield_value'
+        }
+      }
+      expense.custom_field_list = attributes
+      expect(expense.custom_field_list).to be_kind_of(NetSuite::Records::CustomFieldList)
+      expect(expense.custom_field_list.custom_fields.length).to eql(1)
+      expect(expense.custom_field_list.custfield_value.attributes[:value]).to eq(10)
+    end
+
+    it 'can be set from a CustomFieldList object' do
+      custom_field_list = NetSuite::Records::CustomFieldList.new
+      expense.custom_field_list = custom_field_list
+      expect(expense.custom_field_list).to eql(custom_field_list)
+    end
+  end
+
+  describe '#to_record' do
+    before do
+      expense.amount = '123'
+      expense.memo = 'a memo'
+    end
+
+    it 'can represent itself as a SOAP record' do
+      record = {
+        'tranPurch:amount' => '123',
+        'tranPurch:memo' => 'a memo'
+      }
+      expect(expense.to_record).to eql(record)
+    end
+  end
+
+  describe '#record_type' do
+    it 'returns a string of the SOAP record type' do
+      expect(expense.record_type).to eql('tranPurch:VendorBillExpense')
+    end
+  end
+
+end

data/spec/netsuite/records/vendor_bill_item_list_spec.rb

@@ -0,0 +1,36 @@
+require 'spec_helper'
+
+describe NetSuite::Records::VendorBillItemList do
+  let(:item_list) { NetSuite::Records::VendorBillItemList.new }
+  let(:item) { NetSuite::Records::VendorBillItem.new }
+
+  it 'can be initialized with a hash' do
+    item_list = NetSuite::Records::VendorBillItemList.new(item: {})
+    expect(item_list.items).to be_kind_of(Array)
+    expect(item_list.items.length).to eql(1)
+    expect(item_list.items[0]).to be_kind_of(NetSuite::Records::VendorBillItem)
+  end
+
+  it 'can be initialized with a hash list' do
+    item_list = NetSuite::Records::VendorBillItemList.new(item: [{}])
+    expect(item_list.items).to be_kind_of(Array)
+    expect(item_list.items.length).to eql(1)
+    expect(item_list.items[0]).to be_kind_of(NetSuite::Records::VendorBillItem)
+  end
+
+  it 'can have items be added to it' do
+    item_list.items << item
+    expect(item_list.items).to be_kind_of(Array)
+    expect(item_list.items.length).to eql(1)
+    expect(item_list.items[0]).to be_kind_of(NetSuite::Records::VendorBillItem)
+  end
+
+  describe '#to_record' do
+    it 'can represent itself as a SOAP record' do
+      record = {
+          'tranPurch:item' => []
+      }
+      expect(item_list.to_record).to eql(record)
+    end
+  end
+end

data/spec/netsuite/records/vendor_bill_item_spec.rb

@@ -0,0 +1,118 @@
+require 'spec_helper'
+
+describe NetSuite::Records::VendorBillItem do
+  let(:item) { NetSuite::Records::VendorBillItem.new }
+
+  it 'has the right fields' do
+    [
+      :amortization_end_date, :amortization_residual, :amortiz_start_date, :bin_numbers,  :bill_variance_status,
+      :description, :expiration_date, :gross_amt, :inventory_detail, :is_billable, :landed_cost, :line,
+      :order_doc, :order_line, :quantity, :serial_numbers, :tax_rate_1, :tax_rate_2, :tax_1_amt, :vendor_name, :rate
+    ].each do |field|
+      expect(item).to have_field(field)
+    end
+  end
+
+  it 'has the right record_refs' do
+    [
+      :amortization_sched, :klass, :customer, :department, :item, :landed_cost_category, :location, :tax_code, :units
+    ].each do |record_ref|
+      expect(item).to have_record_ref(record_ref)
+    end
+  end
+
+  it 'has all the right read_only_fields' do
+    [
+      :amount
+    ].each do |field|
+      expect(NetSuite::Records::VendorBillItem).to have_read_only_field(field)
+    end
+  end
+
+  it 'can initialize from a record' do
+    record = NetSuite::Records::VendorBillItem.new(:gross_amt => 123, :description => 'some item')
+    item   = NetSuite::Records::VendorBillItem.new(record)
+    expect(item).to be_kind_of(NetSuite::Records::VendorBillItem)
+    expect(item.gross_amt).to eql(123)
+    expect(item.description).to eql('some item')
+  end
+
+  describe '#custom_field_list' do
+    it 'can be set from attributes' do
+      attributes = {
+        :custom_field => {
+          :value => 10,
+          :script_id => 'custfield_value'
+        }
+      }
+      item.custom_field_list = attributes
+      expect(item.custom_field_list).to be_kind_of(NetSuite::Records::CustomFieldList)
+      expect(item.custom_field_list.custom_fields.length).to eql(1)
+      expect(item.custom_field_list.custfield_value.attributes[:value]).to eq(10)
+    end
+
+    it 'can be set from a CustomFieldList object' do
+      custom_field_list = NetSuite::Records::CustomFieldList.new
+      item.custom_field_list = custom_field_list
+      expect(item.custom_field_list).to eql(custom_field_list)
+    end
+  end
+
+  describe '#options' do
+    it 'can be set from attributes' do
+      attributes = {
+        :custom_field => {
+          :value => 10,
+          :script_id => 'custfield_value'
+        }
+      }
+      item.options = attributes
+      expect(item.options).to be_kind_of(NetSuite::Records::CustomFieldList)
+      expect(item.options.custom_fields.length).to eql(1)
+      expect(item.options.custfield_value.attributes[:value]).to eq(10)
+    end
+
+    it 'can be set from a CustomFieldList object' do
+      custom_field_list = NetSuite::Records::CustomFieldList.new
+      item.custom_field_list = custom_field_list
+      expect(item.custom_field_list).to eql(custom_field_list)
+    end
+  end
+
+  describe '#bill_receipts_list' do
+    it 'can be set from attributes' do
+      attributes = {
+        :record_ref => {
+          :internal_id => 'some id',
+          :value => 'some value'
+        }
+      }
+      item.bill_receipts_list = attributes
+      expect(item.bill_receipts_list).to be_kind_of(NetSuite::Records::RecordRefList)
+      expect(item.bill_receipts_list.record_ref.length).to eql(1)
+      expect(item.bill_receipts_list.record_ref[0].value).to eq('some value')
+    end
+  end
+
+  describe '#to_record' do
+    before do
+      item.gross_amt = '123'
+      item.description = 'some item'
+    end
+
+    it 'can represent itself as a SOAP record' do
+      record = {
+        'tranPurch:grossAmt'   => '123',
+        'tranPurch:description' => 'some item'
+      }
+      expect(item.to_record).to eql(record)
+    end
+  end
+
+  describe '#record_type' do
+    it 'returns a string of the SOAP record type' do
+      expect(item.record_type).to eql('tranPurch:VendorBillItem')
+    end
+  end
+
+end

data/spec/netsuite/records/vendor_bill_spec.rb

@@ -0,0 +1,187 @@
+require 'spec_helper'
+
+describe NetSuite::Records::VendorBill do
+  let(:bill) { NetSuite::Records::VendorBill.new(external_id: 'some id') }
+  let(:vendor) { NetSuite::Records::Vendor.new }
+  let(:response) { NetSuite::Response.new(:success => true, :body => { :@internal_id => '1', :@external_id =>'some id' }) }
+
+  it 'has all the right fields' do
+    [
+      :created_date, :credit_limit, :currency_name, :discount_amount, :discount_date, :due_date, :exchange_rate,
+      :landed_costs_list, :landed_cost_method, :landed_cost_per_line, :last_modified_date, :memo, :tax_total,
+      :tax_2_total, :transaction_number, :tran_date, :tran_id, :user_total, :vat_reg_num
+    ].each do |field|
+      expect(bill).to have_field(field)
+    end
+  end
+
+  it 'has all the right read_only_fields' do
+    [
+      :status
+    ].each do |field|
+      expect(NetSuite::Records::VendorBill).to have_read_only_field(field)
+    end
+  end
+
+  it 'has the right record_refs' do
+    [
+      :custom_form, :account, :entity, :subsidiary, :approval_status, :next_approver, :posting_period, :terms,
+      :currency, :klass, :department, :location
+    ].each do |record_ref|
+      expect(bill).to have_record_ref(record_ref)
+    end
+  end
+
+  describe '#custom_field_list' do
+    it 'can be set from attributes' do
+      attributes = {
+        :custom_field => {
+          :amount => 10,
+          :internal_id => 'custfield_amount'
+        }
+      }
+      bill.custom_field_list = attributes
+      expect(bill.custom_field_list).to be_kind_of(NetSuite::Records::CustomFieldList)
+      expect(bill.custom_field_list.custom_fields.length).to eql(1)
+    end
+
+    it 'can be set from a CustomFieldList object' do
+      custom_field_list = NetSuite::Records::CustomFieldList.new
+      bill.custom_field_list = custom_field_list
+      expect(bill.custom_field_list).to eql(custom_field_list)
+    end
+  end
+
+  describe '#item_list' do
+    it 'can be set from attributes' do
+      attributes = {
+        :item => {
+          :amount => 10
+        }
+      }
+      bill.item_list = attributes
+      expect(bill.item_list).to be_kind_of(NetSuite::Records::VendorBillItemList)
+      expect(bill.item_list.items.length).to eql(1)
+    end
+
+    it 'can be set from a VendorBillItemList object' do
+      item_list = NetSuite::Records::VendorBillItemList.new
+      bill.item_list = item_list
+      expect(bill.item_list).to eql(item_list)
+    end
+  end
+
+  describe '#expense_list' do
+    it 'can be set from attributes' do
+      attributes = {
+        :expense => {
+          :gross_amt => 10
+        }
+      }
+      bill.expense_list = attributes
+      expect(bill.expense_list).to be_kind_of(NetSuite::Records::VendorBillExpenseList)
+      expect(bill.expense_list.expenses.length).to eql(1)
+    end
+
+    it 'can be set from a VendorBillExpenseList object' do
+      expense_list = NetSuite::Records::VendorBillExpenseList.new
+      bill.expense_list = expense_list
+      expect(bill.expense_list).to eql(expense_list)
+    end
+  end
+
+  describe '#purchase_order_list' do
+    it 'can be set from attributes' do
+      attributes = {
+        :record_ref => {
+          :internal_id => 'some id',
+          :value => 'some value'
+        }
+      }
+      bill.purchase_order_list = attributes
+      expect(bill.purchase_order_list).to be_kind_of(NetSuite::Records::RecordRefList)
+      expect(bill.purchase_order_list.record_ref.length).to eql(1)
+      expect(bill.purchase_order_list.record_ref[0].value).to eq('some value')
+    end
+  end
+
+  describe '.get' do
+    context 'when the response is successful' do
+      it 'returns an VendorBill instance populated with the data from the response object' do
+        expect(NetSuite::Actions::Get).to receive(:call).with([NetSuite::Records::VendorBill, external_id: 'some id'], {}).and_return(response)
+        bill = NetSuite::Records::VendorBill.get(external_id: 'some id')
+        expect(bill).to be_kind_of(NetSuite::Records::VendorBill)
+        expect(bill.internal_id).to eq('1')
+      end
+    end
+
+    context 'when the response is unsuccessful' do
+      let(:response) { NetSuite::Response.new(:success => false, :body => {}) }
+
+      it 'raises a RecordNotFound exception' do
+        expect(NetSuite::Actions::Get).to receive(:call).with([NetSuite::Records::VendorBill, external_id: 'some id'], {}).and_return(response)
+        expect {
+          NetSuite::Records::VendorBill.get(external_id: 'some id')
+        }.to raise_error(NetSuite::RecordNotFound,
+          /NetSuite::Records::VendorBill with OPTIONS=(.*) could not be found/)
+      end
+    end
+  end
+
+  describe '.initialize' do
+    context 'when the request is successful' do
+      it 'returns an initialized vendor bill from the vendor entity' do
+        expect(NetSuite::Actions::Initialize).to receive(:call).with([NetSuite::Records::VendorBill, vendor], {}).and_return(response)
+        bill = NetSuite::Records::VendorBill.initialize(vendor)
+        expect(bill).to be_kind_of(NetSuite::Records::VendorBill)
+      end
+    end
+
+    context 'when the response is unsuccessful' do
+      let(:response) { NetSuite::Response.new(:success => false, :body => {}) }
+
+      it 'raises a InitializationError exception' do
+        expect(NetSuite::Actions::Initialize).to receive(:call).with([NetSuite::Records::VendorBill, vendor], {}).and_return(response)
+        expect {
+          NetSuite::Records::VendorBill.initialize(vendor)
+        }.to raise_error(NetSuite::InitializationError,
+                         /NetSuite::Records::VendorBill.initialize with .+ failed./)
+      end
+    end
+  end
+
+  describe '#add' do
+    context 'when the response is successful' do
+      it 'returns true' do
+        expect(NetSuite::Actions::Add).to receive(:call).with([bill], {}).and_return(response)
+        expect(bill.add).to be_truthy
+        expect(bill.internal_id).to eq('1')
+      end
+    end
+
+    context 'when the response is unsuccessful' do
+      let(:response) { NetSuite::Response.new(:success => false, :body => {}) }
+      it 'returns false' do
+        expect(NetSuite::Actions::Add).to receive(:call).with([bill], {}).and_return(response)
+        expect(bill.add).to be_falsey
+      end
+    end
+  end
+
+  describe '#delete' do
+    context 'when the response is successful' do
+      it 'returns true' do
+        expect(NetSuite::Actions::Delete).to receive(:call).with([bill], {}).and_return(response)
+        expect(bill.delete).to be_truthy
+      end
+    end
+
+    context 'when the response is unsuccessful' do
+      let(:response) { NetSuite::Response.new(:success => false, :body => {}) }
+      it 'returns false' do
+        expect(NetSuite::Actions::Delete).to receive(:call).with([bill], {}).and_return(response)
+        expect(bill.delete).to be_falsey
+      end
+    end
+  end
+end

data/spec/netsuite/records/vendor_credit_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+describe NetSuite::Records::VendorCredit do
+  describe '.get' do
+    context 'when the response is successful' do
+      let(:response) { NetSuite::Response.new(:success => true, :body => { :@internal_id => '1', :@external_id =>'some_id' }) }
+
+      it 'returns a VendorCredit instance populated with the data from the response object' do
+        expect(NetSuite::Actions::Get).to receive(:call).with([NetSuite::Records::VendorCredit, external_id: 'some_id'], {}).and_return(response)
+        vendor_credit = NetSuite::Records::VendorCredit.get(external_id: 'some_id')
+        expect(vendor_credit).to be_kind_of(NetSuite::Records::VendorCredit)
+        expect(vendor_credit.internal_id).to eq('1')
+        expect(vendor_credit.external_id).to eq('some_id')
+      end
+    end
+
+    context 'when the response is unsuccessful' do
+      let(:response) { NetSuite::Response.new(:success => false, :body => {}) }
+
+      it 'raises a RecordNotFound exception' do
+        expect(NetSuite::Actions::Get).to receive(:call).with([NetSuite::Records::VendorCredit, external_id: 'some_id'], {}).and_return(response)
+        expect {
+          NetSuite::Records::VendorCredit.get(external_id: 'some_id')
+        }.to raise_error(NetSuite::RecordNotFound,
+          /NetSuite::Records::VendorCredit with OPTIONS=(.*) could not be found/)
+      end
+    end
+  end
+end

data/spec/netsuite/records/vendor_payment_apply_list_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+describe NetSuite::Records::VendorPaymentApplyList do
+  let(:list) { NetSuite::Records::VendorPaymentApplyList.new }
+  let(:apply) { NetSuite::Records::VendorPaymentApply.new }
+
+  it 'can have applies be added to it' do
+    list.applies << apply
+    apply_list = list.applies
+    expect(apply_list).to be_kind_of(Array)
+    expect(apply_list.length).to eql(1)
+    apply_list.each { |i| expect(i).to be_kind_of(NetSuite::Records::VendorPaymentApply) }
+  end
+
+  describe '#to_record' do
+    it 'can represent itself as a SOAP record' do
+      record = {
+          'tranPurch:apply' => [{},{}]
+      }
+      list.applies.concat([apply,apply])
+      expect(list.to_record).to eql(record)
+    end
+  end
+
+end

data/spec/netsuite/records/vendor_payment_apply_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+describe NetSuite::Records::VendorPaymentApply do
+  let(:apply) { NetSuite::Records::VendorPaymentApply.new }
+
+  it 'has all the right fields' do
+    [
+      :amount, :apply, :apply_date, :currency, :disc, :disc_amt, :disc_date, :doc, :due, :line,
+      :job, :ref_num, :total, :type
+    ].each do |field|
+      expect(apply).to have_field(field)
+    end
+  end
+
+end