3 \)@sXddlmZddlmZddlmZddlm Z e ddZ e ddZ Gdd d e Z d S) )Decimal) gettext_lazy) exceptions) get_modelorderShippingEventQuantityPaymentEventQuantityc@seZdZdZd"ddZddZd#ddZd$d d Zd d Zd%d dZ ddZ ddZ ddZ d&ddZ d'ddZddZd(ddZddZd)d d!ZdS)* EventHandlerz Handle requested order events. This is an important class: it houses the core logic of your shop's order processing pipeline. NcCs ||_dS)N)user)selfr r 6/var/www/html/oscar2019/oscar/apps/order/processing.py__init__szEventHandler.__init__cKs(|j||||f||j||||f|S)a Handle a shipping event for a given order. This is most common entry point to this class - most of your order processing should be modelled around shipping events. Shipping events can be used to trigger payment and communication events. You will generally want to override this method to implement the specifics of you order processing pipeline. )validate_shipping_eventcreate_shipping_event)r r event_typelinesline_quantitieskwargsr r r handle_shipping_events z"EventHandler.handle_shipping_eventcKs,|j|||||f||j|||||f|S)ap Handle a payment event for a given order. These should normally be called as part of handling a shipping event. It is rare to call to this method directly. It does make sense for refunds though where the payment event may be unrelated to a particular shipping event and doesn't directly correspond to a set of lines. )validate_payment_eventcreate_payment_event)r rramountrrrr r r handle_payment_event,s z!EventHandler.handle_payment_eventcCs|j||r|j||dS)a  Handle a requested order status change This method is not normally called directly by client code. The main use-case is when an order is cancelled, which in some ways could be viewed as a shipping event affecting all lines. N) set_status create_note)r r new_statusnote_msgr r r handle_order_status_change;s z'EventHandler.handle_order_status_changec Ks\g}x>t||D]0\}}|j||stdd|ji} |j| qW|rXtjdj|dS)zp Test if the requested shipping event is permitted. If not, raise InvalidShippingEvent z8The selected quantity for line #%(line_id)s is too largeline_idz, N)zipis_shipping_event_permitted_idappendrInvalidShippingEventjoin) r rrrrrerrorslineqtymsgr r r rJs  z$EventHandler.validate_shipping_eventc Ksd|r`|r`g}x>t||D]0\}} |j|| stdd|ji} |j| qW|r`tjdj|dS)Nz8The selected quantity for line #%(line_id)s is too largerz, )r is_payment_event_permittedr"r#r$rInvalidPaymentEventr&) r rrrrrrr'r(r)r*r r r r]s  z#EventHandler.validate_payment_eventcCs.x(t||D]\}}|j||kr dSq WdS)a Test whether the passed lines and quantities have been through the specified shipping event. This is useful for validating if certain shipping events are allowed (ie you can't return something before it has shipped). FT)r shipping_event_quantity)r rrrrr(Zline_qtyr r r have_lines_passed_shipping_eventms z-EventHandler.have_lines_passed_shipping_eventc Cstd}xt||D]\}}|j|}|||jkr:tjd}xh|jjjdD]T} ||kr^P| j|} | dkr||| j8}qPt ||| } || | j 7}d}|| 7}qPWqW|S)ai Calculate the total charge for the passed event type, lines and line quantities. This takes into account the previous prices that have been charged for this event. Note that shipping is not including in this subtotal. You need to subclass and extend this method if you want to include shipping costs. z0.00rr#) Dr payment_event_quantityquantityrr,pricesallorder_byminprice_incl_tax) r rrrtotalr(Zqty_to_consumeZ qty_to_skipZ qty_consumedpriceZ qty_availableZqty_to_includer r r calculate_payment_event_subtotal~s$     z-EventHandler.calculate_payment_event_subtotalcCs@x:t||D],\}}|j}|s"dS|js*q |j|s dSq WdS)a Check whether stock records still have enough stock to honour the requested allocations. Lines whose product doesn't track stock are disregarded, which means this method will return True if only non-stock-tracking-lines are passed. This means you can just throw all order lines to this method, without checking whether stock tracking is enabled or not. This is okay, as calling consume_stock_allocations() has no effect for non-stock-tracking lines. FT)r stockrecordcan_track_allocations"is_allocation_consumption_possible)r rrr(r)recordr r r are_stock_allocations_availables  z,EventHandler.are_stock_allocations_availablecCsN|s|jj}|s dd|D}x(t||D]\}}|jr,|jj|q,WdS)z Consume the stock allocations for the passed lines. If no lines/quantities are passed, do it for all lines. cSsg|] }|jqSr )r1).0r(r r r sz:EventHandler.consume_stock_allocations..N)rr3r r:consume_allocation)r rrrr(r)r r r consume_stock_allocationss z&EventHandler.consume_stock_allocationscCsN|s|jj}|s dd|D}x(t||D]\}}|jr,|jj|q,WdS)z Cancel the stock allocations for the passed lines. If no lines/quantities are passed, do it for all lines. cSsg|] }|jqSr )r1)r?r(r r r r@sz9EventHandler.cancel_stock_allocations..N)rr3r r:cancel_allocation)r rrrr(r)r r r cancel_stock_allocationss z%EventHandler.cancel_stock_allocationsc Ksn|jdd}|jj||d}y,x&t||D]\}} |jj|| dq*WWn tjk rh|jYnX|S)N reference)rnotes)r(r1)getshipping_eventscreater rrr%delete) r rrrrrrEeventr(r1r r r rs  z"EventHandler.create_shipping_eventc KsR|jdd}|jj|||d}|rN|rNx&t||D]\} } |jj| | dq2W|S)NrErF)rrrE)r(r1)rHpayment_eventsrJr r) r rrrrrrrErLr(r1r r r rs  z!EventHandler.create_payment_eventcCs|jj|dS)N)r)communication_eventsrJ)r rrr r r create_communication_eventsz'EventHandler.create_communication_eventSystemcCs|jj|||jdS)N)message note_typer )rGrJr )r rrQrRr r r rszEventHandler.create_note)N)NN)N)NN)NN)NN)NN)rP)__name__ __module__ __qualname____doc__rrrrrrr.r9r>rBrDrrrOrr r r r r s&    5   r N)decimalrr/django.utils.translationrr"oscar.apps.orderroscar.core.loadingrrrobjectr r r r r s