Class: Spree::Shipment
Instance Attribute Summary collapse
-
#special_instructions ⇒ Object
TODO remove the suppress_mailer temporary variable once we are calling ‘ship’ from outside of the state machine and can actually pass variables through.
-
#suppress_mailer ⇒ Object
TODO remove the suppress_mailer temporary variable once we are calling ‘ship’ from outside of the state machine and can actually pass variables through.
Instance Method Summary
collapse
money_methods
Methods inherited from Base
page
#default_preferences, #defined_preferences, #get_preference, #has_preference!, #has_preference?, #preference_default, #preference_type, #set_preference
Instance Attribute Details
#special_instructions ⇒ Object
TODO remove the suppress_mailer temporary variable once we are calling ‘ship’ from outside of the state machine and can actually pass variables through.
24
25
26
|
# File 'app/models/spree/shipment.rb', line 24
def special_instructions
@special_instructions
end
|
#suppress_mailer ⇒ Object
TODO remove the suppress_mailer temporary variable once we are calling ‘ship’ from outside of the state machine and can actually pass variables through.
24
25
26
|
# File 'app/models/spree/shipment.rb', line 24
def suppress_mailer
@suppress_mailer
end
|
Instance Method Details
#add_shipping_method(shipping_method, selected = false) ⇒ Object
92
93
94
|
# File 'app/models/spree/shipment.rb', line 92
def add_shipping_method(shipping_method, selected = false)
shipping_rates.create(shipping_method: shipping_method, selected: selected, cost: cost)
end
|
#after_cancel ⇒ Object
96
97
98
|
# File 'app/models/spree/shipment.rb', line 96
def after_cancel
manifest.each { |item| manifest_restock(item) }
end
|
#after_resume ⇒ Object
100
101
102
|
# File 'app/models/spree/shipment.rb', line 100
def after_resume
manifest.each { |item| manifest_unstock(item) }
end
|
#backordered? ⇒ Boolean
104
105
106
|
# File 'app/models/spree/shipment.rb', line 104
def backordered?
inventory_units.any? { |inventory_unit| inventory_unit.backordered? }
end
|
#can_transition_from_canceled_to_ready? ⇒ Boolean
84
85
86
|
# File 'app/models/spree/shipment.rb', line 84
def can_transition_from_canceled_to_ready?
can_transition_from_pending_to_ready?
end
|
#can_transition_from_pending_to_ready? ⇒ Boolean
79
80
81
82
|
# File 'app/models/spree/shipment.rb', line 79
def can_transition_from_pending_to_ready?
order.can_ship? && !inventory_units.any?(&:backordered?) &&
(order.paid? || !Spree::Config[:require_payment_to_ship])
end
|
#can_transition_from_pending_to_shipped? ⇒ Boolean
75
76
77
|
# File 'app/models/spree/shipment.rb', line 75
def can_transition_from_pending_to_shipped?
!requires_shipment?
end
|
#currency ⇒ Object
108
109
110
|
# File 'app/models/spree/shipment.rb', line 108
def currency
order ? order.currency : Spree::Config[:currency]
end
|
#determine_state(order) ⇒ Object
Determines the appropriate state
according to the following logic:
canceled if order is canceled pending unless order is complete and order.payment_state
is paid
shipped if already shipped (ie. does not change the state) ready all other cases
212
213
214
215
216
217
218
219
220
221
222
|
# File 'app/models/spree/shipment.rb', line 212
def determine_state(order)
return 'canceled' if order.canceled?
return 'pending' unless order.can_ship?
return 'pending' if inventory_units.any? &:backordered?
return 'shipped' if state == 'shipped'
if order.paid? || !Spree::Config[:require_payment_to_ship]
'ready'
else
'pending'
end
end
|
#discounted_cost ⇒ Object
Also known as:
discounted_amount
112
113
114
|
# File 'app/models/spree/shipment.rb', line 112
def discounted_cost
cost + promo_total
end
|
#editable_by?(user) ⇒ Boolean
118
119
120
|
# File 'app/models/spree/shipment.rb', line 118
def editable_by?(user)
!shipped?
end
|
#final_price ⇒ Object
122
123
124
|
# File 'app/models/spree/shipment.rb', line 122
def final_price
cost + adjustment_total
end
|
#final_price_with_items ⇒ Object
126
127
128
|
# File 'app/models/spree/shipment.rb', line 126
def final_price_with_items
item_cost + final_price
end
|
#finalize! ⇒ Object
130
131
132
133
|
# File 'app/models/spree/shipment.rb', line 130
def finalize!
InventoryUnit.finalize_units!(inventory_units)
manifest.each { |item| manifest_unstock(item) }
end
|
#include?(variant) ⇒ Boolean
135
136
137
|
# File 'app/models/spree/shipment.rb', line 135
def include?(variant)
inventory_units_for(variant).present?
end
|
#inventory_units_for(variant) ⇒ Object
139
140
141
|
# File 'app/models/spree/shipment.rb', line 139
def inventory_units_for(variant)
inventory_units.where(variant_id: variant.id)
end
|
#inventory_units_for_item(line_item, variant = nil) ⇒ Object
143
144
145
|
# File 'app/models/spree/shipment.rb', line 143
def inventory_units_for_item(line_item, variant = nil)
inventory_units.where(line_item_id: line_item.id, variant_id: line_item.variant.id || variant.id)
end
|
#item_cost ⇒ Object
147
148
149
|
# File 'app/models/spree/shipment.rb', line 147
def item_cost
line_items.map(&:final_amount).sum
end
|
#line_items ⇒ Object
151
152
153
|
# File 'app/models/spree/shipment.rb', line 151
def line_items
inventory_units.includes(:line_item).map(&:line_item).uniq
end
|
#manifest ⇒ Object
192
193
194
|
# File 'app/models/spree/shipment.rb', line 192
def manifest
@manifest ||= Spree::ShippingManifest.new(inventory_units: inventory_units).items
end
|
#ready_or_pending? ⇒ Boolean
159
160
161
|
# File 'app/models/spree/shipment.rb', line 159
def ready_or_pending?
self.ready? || self.pending?
end
|
#refresh_rates ⇒ Object
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
|
# File 'app/models/spree/shipment.rb', line 163
def refresh_rates
return shipping_rates if shipped? || order.completed?
return [] unless can_get_rates?
original_shipping_method_id = shipping_method.try!(:id)
new_rates = Stock::Estimator.new(order).shipping_rates(to_package)
selected_rate = new_rates.detect{ |rate| rate.shipping_method_id == original_shipping_method_id }
if selected_rate
new_rates.each do |rate|
rate.selected = (rate == selected_rate)
end
end
self.shipping_rates = new_rates
self.save!
shipping_rates
end
|
#requires_shipment? ⇒ Boolean
358
359
360
|
# File 'app/models/spree/shipment.rb', line 358
def requires_shipment?
!stock_location || stock_location.fulfillable?
end
|
#selected_shipping_rate ⇒ Object
188
189
190
|
# File 'app/models/spree/shipment.rb', line 188
def selected_shipping_rate
shipping_rates.detect(&:selected?)
end
|
#selected_shipping_rate_id ⇒ Object
196
197
198
|
# File 'app/models/spree/shipment.rb', line 196
def selected_shipping_rate_id
selected_shipping_rate.try(:id)
end
|
#selected_shipping_rate_id=(id) ⇒ Object
200
201
202
203
204
|
# File 'app/models/spree/shipment.rb', line 200
def selected_shipping_rate_id=(id)
shipping_rates.update_all(selected: false)
shipping_rates.update(id, selected: true)
self.save!
end
|
#set_up_inventory(state, variant, order, line_item) ⇒ Object
224
225
226
227
228
229
230
231
|
# File 'app/models/spree/shipment.rb', line 224
def set_up_inventory(state, variant, order, line_item)
self.inventory_units.create(
state: state,
variant_id: variant.id,
order_id: order.id,
line_item_id: line_item.id
)
end
|
#shipped=(value) ⇒ Object
233
234
235
236
|
# File 'app/models/spree/shipment.rb', line 233
def shipped=(value)
return unless value == '1' && shipped_at.nil?
self.shipped_at = Time.now
end
|
#shipping_method ⇒ Object
238
239
240
|
# File 'app/models/spree/shipment.rb', line 238
def shipping_method
selected_shipping_rate.try(:shipping_method) || shipping_rates.first.try(:shipping_method)
end
|
#tax_category ⇒ Object
242
243
244
|
# File 'app/models/spree/shipment.rb', line 242
def tax_category
selected_shipping_rate.try(:tax_rate).try(:tax_category)
end
|
#tax_total ⇒ Object
Only one of either included_tax_total or additional_tax_total is set This method returns the total of the two. Saves having to check if tax is included or additional.
249
250
251
|
# File 'app/models/spree/shipment.rb', line 249
def tax_total
included_tax_total + additional_tax_total
end
|
#to_package ⇒ Object
253
254
255
256
257
258
259
|
# File 'app/models/spree/shipment.rb', line 253
def to_package
package = Stock::Package.new(stock_location)
inventory_units.includes(:variant).joins(:variant).group_by(&:state).each do |state, state_inventory_units|
package.add_multiple state_inventory_units, state.to_sym
end
package
end
|
#to_param ⇒ Object
261
262
263
|
# File 'app/models/spree/shipment.rb', line 261
def to_param
number
end
|
#tracking_url ⇒ Object
265
266
267
|
# File 'app/models/spree/shipment.rb', line 265
def tracking_url
@tracking_url ||= shipping_method.build_tracking_url(tracking)
end
|
#transfer_to_location(variant, quantity, stock_location) ⇒ Object
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
|
# File 'app/models/spree/shipment.rb', line 322
def transfer_to_location(variant, quantity, stock_location)
if quantity <= 0
raise ArgumentError
end
transaction do
new_shipment = order.shipments.create!(stock_location: stock_location)
order.contents.remove(variant, quantity, {shipment: self})
order.contents.add(variant, quantity, {shipment: new_shipment})
refresh_rates
save!
new_shipment.save!
end
end
|
#transfer_to_shipment(variant, quantity, shipment_to_transfer_to) ⇒ Object
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
|
# File 'app/models/spree/shipment.rb', line 339
def transfer_to_shipment(variant, quantity, shipment_to_transfer_to)
quantity_already_shipment_to_transfer_to = shipment_to_transfer_to.manifest.find{|mi| mi.line_item.variant == variant}.try(:quantity) || 0
final_quantity = quantity + quantity_already_shipment_to_transfer_to
if (quantity <= 0 || self == shipment_to_transfer_to)
raise ArgumentError
end
transaction do
order.contents.remove(variant, quantity, {shipment: self})
order.contents.add(variant, quantity, {shipment: shipment_to_transfer_to})
refresh_rates
save!
shipment_to_transfer_to.refresh_rates
shipment_to_transfer_to.save!
end
end
|
#update!(order) ⇒ Object
Updates various aspects of the Shipment while bypassing any callbacks. Note that this method takes an explicit reference to the Order object. This is necessary because the association actually has a stale (and unsaved) copy of the Order and so it will not yield the correct results.
312
313
314
315
316
317
318
319
320
|
# File 'app/models/spree/shipment.rb', line 312
def update!(order)
old_state = state
new_state = determine_state(order)
update_columns(
state: new_state,
updated_at: Time.now,
)
after_ship if new_state == 'shipped' and old_state != 'shipped'
end
|
#update_amounts ⇒ Object
269
270
271
272
273
274
275
276
277
|
# File 'app/models/spree/shipment.rb', line 269
def update_amounts
if selected_shipping_rate
self.update_columns(
cost: selected_shipping_rate.cost,
adjustment_total: adjustments.additional.map(&:update!).compact.sum,
updated_at: Time.now,
)
end
end
|
#update_attributes_and_order(params = {}) ⇒ Object
Update Shipment and make sure Order states follow the shipment changes
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
|
# File 'app/models/spree/shipment.rb', line 280
def update_attributes_and_order(params = {})
if self.update_attributes params
if params.has_key? :selected_shipping_rate_id
self.update_amounts
order.updater.update_shipment_total
order.updater.update_payment_state
self.update_columns(
state: determine_state(order),
updated_at: Time.now
)
order.updater.update_shipment_state
order.updater.persist_totals
end
true
end
end
|