o ˷eU@sDdZddlmZddlZddlmZddlmZGdddeZdS)z The E-commerce Store Orders endpoint API endpoint Documentation: http://developer.mailchimp.com/documentation/mailchimp/reference/ecommerce/stores/orders/ Schema: https://api.mailchimp.com/schema/3.0/Ecommerce/Stores/Customers/Instance.json )unicode_literalsN)BaseApi)StoreOrderLinescsJeZdZdZfddZddZdddZd d Zd d Zd dZ Z S) StoreOrdersas Orders represent successful e-commerce transactions, and this data can be used to provide more detailed campaign reports, track sales, and personalize emails to your targeted consumers, and view other e-commerce data in your MailChimp account. .. note:: If a financial_status or fulfillment_status value is provided when creating or updating an order, it will trigger a notification email if they have been designed and enabled in your account. The following sets of statuses trigger the following notification types: financial_status = 'paid' -> Order Invoice financial_status = 'pending' -> Order Confirmation financial_status = 'refunded' -> Refund Confirmation financial_status = 'cancelled' -> Cancellation Confirmation fulfillment_status = 'shipped' -> Shipping Confirmation The current list of notification types and triggers can be found at http://developer.mailchimp.com/documentation/mailchimp/guides/getting-started-with-ecommerce/#order-notifications and should be consulted in the event of any changes cs6tt|j|i|d|_d|_d|_t||_dS)z) Initialize the endpoint zecommerce/storesN)superr__init__endpointstore_idorder_idrlines)selfargskwargs __class__V/var/www/ideatree/venv/lib/python3.10/site-packages/mailchimp3/entities/storeorders.pyr's zStoreOrders.__init__cCs||_d|vr tdd|vrtdd|dvrtdd|vr%tdtd|ds1td d |vr9td d |vrAtd |d D]*}d|vrOtdd|vrWtdd|vr_tdd|vrgtdd|vrotdqE|jj||d|d}|dur|d|_|Sd|_|S)a Add a new order to a store. :param store_id: The store id. :type store_id: :py:class:`str` :param data: The request body parameters :type data: :py:class:`dict` data = { "id": string*, "customer": object* { "'id": string* }, "curency_code": string*, "order_total": number*, "lines": array* [ { "id": string*, "product_id": string*, "product_variant_id": string*, "quantity": integer*, "price": number* } ] } idzThe order must have an idcustomerzThe order must have a customerz"The order customer must have an id currency_codez#The order must have a currency_codez ^[A-Z]{3}$zAThe currency_code must be a valid 3-letter ISO 4217 currency code order_totalz"The order must have an order_totalr z+The order must have at least one order linezEach order line must have an id product_idz&Each order line must have a product_idproduct_variant_idz.Each order line must have a product_variant_idquantityz$Each order line must have a quantitypricez!Each order line must have a priceordersurldataN) r KeyErrorrematch ValueError _mc_client_post _build_pathr )r r rlineresponserrrcreate2sB   zStoreOrders.createFcKsJ||_d|_|r|jdd||di|S|jjdd||di|S)u Get information about a store’s orders. :param store_id: The store id. :type store_id: :py:class:`str` :param get_all: Should the query get all results :type get_all: :py:class:`bool` :param queryparams: The query string parameters queryparams['fields'] = [] queryparams['exclude_fields'] = [] queryparams['count'] = integer queryparams['offset'] = integer queryparams['customer_id'] = string Nrrr)r r _iterater%r#_get)r r get_all queryparamsrrrallps zStoreOrders.allcKs,||_||_|jjdd||d|i|S)aq Get information about a specific order. :param store_id: The store id. :type store_id: :py:class:`str` :param order_id: The id for the order in a store. :type order_id: :py:class:`str` :param queryparams: The query string parameters queryparams['fields'] = [] queryparams['exclude_fields'] = [] rrNr)r r r#r*r%)r r r r,rrrgets  zStoreOrders.getcCs&||_||_|jj||d||dS)a2 Update a specific order. :param store_id: The store id. :type store_id: :py:class:`str` :param order_id: The id for the order in a store. :type order_id: :py:class:`str` :param data: The request body parameters :type data: :py:class:`dict` rr)r r r#_patchr%)r r r rrrrupdates zStoreOrders.updatecCs$||_||_|jj||d|dS)z Delete an order. :param store_id: The store id. :type store_id: :py:class:`str` :param order_id: The id for the order in a store. :type order_id: :py:class:`str` r)r)r r r#_deleter%)r r r rrrdeletes zStoreOrders.delete)F) __name__ __module__ __qualname____doc__rr(r-r.r0r2 __classcell__rrrrrs  >r) r6 __future__rr mailchimp3.baseapir#mailchimp3.entities.storeorderlinesrrrrrrs