Add the page cookbook in the documentation

docs/cookbook.rst

@@ -0,0 +1,53 @@
+.. cookbook:
+
+========
+Cookbook
+========
+
+------
+Orders
+------
+
+We'll assume there is an order with one order line with the following parameters and values:
+
+================ ============
+Parameter        Value
+================ ============
+OrderNumber      ORDER_NUMBER
+SellerProductId  SKU
+ProductCondition AverageState
+================ ============
+
+Accept the order
+----------------
+
+::
+
+    accepted_by_seller = {'CarrierName': 'Colissimo',
+                          'OrderState': 'AcceptedBySeller',
+                          'OrderNumber': 'ORDER_NUMBER', 
+                          'OrderLineList': [{
+                          'AcceptationState': 'AcceptedBySeller',
+                          'SellerProductId': 'SKU',
+                          'ProductCondition': 'AverageState'}]}
+    validations = api.orders.prepare_validations([accepted_by_seller])
+    response = api.orders.validate_order_list(**validations)
+
+
+Refuse the shipment of an order
+-------------------------------
+
+After the order is accepted, if for some reason, you can't ship it to your
+customer, you can refuse the shipment.
+
+::
+
+    shipment_refused_by_seller = {'OrderNumber': 'ORDER_NUMBER',
+                                  'OrderState': 'ShipmentRefusedBySeller',
+                                  'OrderLineList': [{
+                                  'AcceptationState': 'ShipmentRefusedBySeller',
+                                  'SellerProductId': 'SKU',
+                                  'ProductCondition': 'AverageState'}]}      
+
+    validations = api.orders.prepare_validations([shipment_refused_by_seller])
+    response = api.orders.validate_order_list(**validations)

docs/index.rst

@@ -11,6 +11,7 @@ Welcome to CdiscountAPI's documentation!
 
    quickstart
    advanced_usage
+   cookbook
    api
    CHANGELOG