Class: Spree::InventoryUnit

Inherits:
Base
  • Object
show all
Defined in:
app/models/spree/inventory_unit.rb

Overview

Tracks the state of line items’ fulfillment.

Constant Summary collapse

PRE_SHIPMENT_STATES = 
%w(backordered on_hand)
POST_SHIPMENT_STATES = 
%w(returned)
CANCELABLE_STATES = 
['on_hand', 'backordered', 'shipped']

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Base

display_includes, page, preference, #preferences

Methods included from Core::Permalinks

#generate_permalink, #save_permalink

Class Method Details

.finalize_units!(inventory_units) ⇒ Object

Deprecated.

do not use this, use Spree::Stock::InventoryUnitsFinalizer.new(inventory_units).run!

Updates the given inventory units to not be pending.

Parameters:



69
70
71
72
73
74
75
76
77
78
79
80
81
82
 
# File 'app/models/spree/inventory_unit.rb', line 69

def self.finalize_units!(inventory_units)
  Spree::Deprecation.warn(
    "inventory_units.finalize_units!(inventory_units) is deprecated. Please
    use Spree::Stock::InventoryUnitsFinalizer.new(inventory_units).run!",
    caller
  )

  inventory_units.map do |iu|
    iu.update_columns(
      pending: false,
      updated_at: Time.current
    )
  end
end

Instance Method Details

#additional_tax_total ⇒ BigDecimal

Returns the portion of the additional tax on the line item this inventory unit belongs to that is associated with this individual inventory unit.

Returns:

  • (BigDecimal) —

    the portion of the additional tax on the line item this inventory unit belongs to that is associated with this individual inventory unit



100
101
102
 
# File 'app/models/spree/inventory_unit.rb', line 100

def additional_tax_total
  line_item.additional_tax_total * percentage_of_line_item
end

#allow_ship? ⇒ Boolean

Returns:

  • (Boolean) 


117
118
119
 
# File 'app/models/spree/inventory_unit.rb', line 117

def allow_ship?
  on_hand?
end

#backordered_for_stock_item(stock_item) ⇒ ActiveRecord::Relation<Spree::InventoryUnit>

Returns backordered inventory units for the given stock item.

Parameters:

  • stock_item (Spree::StockItem) —

    the stock item of the desired inventory units

Returns:

  • (ActiveRecord::Relation<Spree::InventoryUnit>) —

    backordered inventory units for the given stock item



54
55
56
57
 
# File 'app/models/spree/inventory_unit.rb', line 54

scope :backordered_for_stock_item, ->(stock_item) do
  backordered_per_variant(stock_item)
    .where(spree_shipments: { stock_location_id: stock_item.stock_location_id })
end

#current_or_new_return_item ⇒ Spree::ReturnItem

Returns a valid return item for this inventory unit if one exists, or a new one if one does not.

Returns:

  • (Spree::ReturnItem) —

    a valid return item for this inventory unit if one exists, or a new one if one does not



93
94
95
 
# File 'app/models/spree/inventory_unit.rb', line 93

def current_or_new_return_item
  Spree::ReturnItem.from_inventory_unit(self)
end

#exchange_requested? ⇒ Boolean

Returns true if this inventory unit has any return items which have requested exchanges.

Returns:

  • (Boolean) —

    true if this inventory unit has any return items which have requested exchanges



113
114
115
 
# File 'app/models/spree/inventory_unit.rb', line 113

def exchange_requested?
  return_items.not_expired.any?(&:exchange_requested?)
end

#find_stock_item ⇒ Spree::StockItem

Returns the first stock item from this shipment’s stock location that is associated with this inventory unit’s variant.

Returns:

  • (Spree::StockItem) —

    the first stock item from this shipment’s stock location that is associated with this inventory unit’s variant



86
87
88
89
 
# File 'app/models/spree/inventory_unit.rb', line 86

def find_stock_item
  Spree::StockItem.where(stock_location_id: shipment.stock_location_id,
    variant_id: variant_id).first
end

#included_tax_total ⇒ BigDecimal

Returns the portion of the included tax on the line item this inventory unit belongs to that is associated with this individual inventory unit.

Returns:

  • (BigDecimal) —

    the portion of the included tax on the line item this inventory unit belongs to that is associated with this individual inventory unit



107
108
109
 
# File 'app/models/spree/inventory_unit.rb', line 107

def included_tax_total
  line_item.included_tax_total * percentage_of_line_item
end

#order=(_) ⇒ Object 



23
24
25
 
# File 'app/models/spree/inventory_unit.rb', line 23

def order=(_)
  raise "The order association has been removed from InventoryUnit. The order is now determined from the shipment."
end