Added recipe on tax exemptions

README.rst

@@ -59,6 +59,6 @@ companies, from large multinationals to small, boutique stores:
 * Carlsberg - Their global "We Deliver More" platform is powered by Oscar (but
   is a B2B site so it not browsable by the public).
 * Dolbeau - http://www.dolbeau.ca/
-* The UK Labour party - http://shop.labour.org.uk (will be live in early June)
+* The UK Labour party - http://shop.labour.org.uk
 
 Many more on the way.  If you use Oscar in production, please let us know.

docs/source/recipes.rst

@@ -36,6 +36,14 @@ Pricing, stock and availability
     recipes/enforcing_stock_rules
     recipes/how_to_configure_stock_messaging
 
+Tax
+---
+
+.. toctree::
+    :maxdepth: 1
+
+    recipes/how_to_apply_tax_exemptions
+
 Shipping
 --------
 

docs/source/recipes/how_to_apply_tax_exemptions.rst

@@ -0,0 +1,55 @@
+===========================
+How to apply tax exemptions
+===========================
+
+Problem
+=======
+The tax a customer pays depends on the shipping address of his/her
+order.  
+
+Solution
+========
+Use custom basket middleware to set the tax status of the basket.
+
+The default Oscar basket middleware is::
+
+    'oscar.apps.basket.middleware.BasketMiddleware'
+
+To alter the tax behaviour, replace this class with one within your own project
+that subclasses Oscar's and extends the ``get_basket`` method.  For example, use
+something like::
+
+    from oscar.apps.basket.middleware import BasketMiddleware
+    from oscar.apps.checkout.utils import CheckoutSessionData
+
+    class MyBasketMiddleware(BasketMiddleware):
+        
+        def get_basket(self, request):
+            basket = super(MyBasketMiddleware, self).get_basket(request)
+            if self.is_tax_exempt(request):
+                basket.set_as_tax_exempt()
+            return basket
+
+        def is_tax_exempt(self, request):
+            country = self.get_shipping_address_country(request)
+            if country is None:
+                return False
+            return country.iso_3166_1_a2 not in ('GB',)
+
+        def get_shipping_address_country(self, request):
+            session = CheckoutSessionData(request)
+            if not session.is_shipping_address_set():
+                return None
+            addr_id = session.shipping_user_address_id()
+            if addr_id:
+                # User shipping to address from address book
+                return UserAddress.objects.get(id=addr_id).country
+            else:
+                fields = session.new_shipping_address_fields()
+        
+Here we are using the checkout session wrapper to check if the user has set a
+shipping address.  If they have, we extract the country and check its ISO
+3166 code.
+
+It is straightforward to extend this idea to apply custom tax exemptions to the
+basket based of different criteria.

docs/source/recipes/how_to_configure_shipping.rst

@@ -32,7 +32,7 @@ Set a custom shipping methods
 -----------------------------
 
 To apply your domain logic for shipping, you will need to override
-the default repository class (see :doc:`recipes/how_to_override_a_core_class`) and alter
+the default repository class (see :doc:`how_to_override_a_core_class`) and alter
 the implementation of the ``get_shipping_methods`` method.  This method
 should return a list of "shipping method" classes already instantiated
 and holding a reference to the basket instance.

sandbox/settings.py

@@ -247,7 +247,7 @@ from oscar.defaults import *
 
 
 OSCAR_RECENTLY_VIEWED_PRODUCTS = 20
-OSCAR_ALLOW_ANON_CHECKOUT = False
+OSCAR_ALLOW_ANON_CHECKOUT = True
 OSCAR_INITIAL_ORDER_STATUS = 'Pending'
 OSCAR_INITIAL_LINE_STATUS = 'Pending'
 OSCAR_ORDER_STATUS_PIPELINE = {