[IMP] taxcloud: update TaxCloud documentation

This rewrites certain parts to be better English, updates the
documentation to reflect the latest TaxCloud website and flow and
clarifies some points.

Closes #326

accounting/others/taxes/taxcloud.rst

@@ -1,87 +1,72 @@
-=========================================================
+================================================================
-How to get correct tax rates in the US thanks to TaxCloud
+How to get correct tax rates in the United States using TaxCloud
-=========================================================
+================================================================
 
-The **TaxCloud** integration allows you to calculate the sales tax for every
+The **TaxCloud** integration allows you to correctly calculate the sales
-address in the United States and keeps track of which product types are
+tax for every address in the United States and keeps track of which products
-exempt from sales tax and in which states each exemption applies.
+are exempt from sales tax and in which states each exemption applies.
 TaxCloud calculates sales tax in real-time for every state, city, and
 special jurisdiction in the United States.
 
 Configuration
 =============
 
-In Tax Cloud
+In TaxCloud
-------------
+-----------
-* Create a free account on `*TaxCloud*
+* Create a free account on `TaxCloud
-  <https://taxcloud.net/#register>`__ website.
+  <https://taxcloud.com/#register>`__ website.
-* Register your website on TaxCloud to get an *API ID* and an *API Key*.
+* Register your Odoo website on TaxCloud to get an *API ID* and an *API Key*.
 
 .. image:: media/taxcloud01.png
   :align: center
 
+* In Settings on TaxCloud, click *Locations* to enter the location of your Office(s) & Warehouse(s).
+* In Settings on TaxCloud, click *Manage Tax States* to verify the states where you collect sales tax.
+
 In Odoo
 -------
-* Go to :menuselection:`Invoicing/Accounting --> Configuration --> Settings`
+* Go to :menuselection:`Invoicing / Accounting --> Configuration --> Settings`
-  and check *Compute sales tax automatically using TaxCloud*. Click *Apply*.
+  and check *TaxCloud - Compute tax rates based on U.S. ZIP codes*.
+* Enter your TaxCloud credentials.
+* Click SAVE to store your credentials.
 
 .. image:: media/taxcloud02.png
   :align: center
 
-* Still in those settings, enter your TaxCloud credentials.
+* Click the Refresh Icon next to *Default Category* to import the TIC product categories
-* Hit *Sync TaxCloud Categories (TIC)* to import TIC product categories
+  from TaxCloud (Taxability Information Codes). Some categories may imply specific rates.
-  from TaxCloud (Taxability Information Codes). Some categories may imply 
+* Select your default *TIC Code*. This will apply to any new
-  specific rates.
+  product created.
-
+* Set a specific TaxCloud Category on the *General Information* tab of the Product,
-.. image:: media/taxcloud03.png
+  or on the Product Category.
-  :align: center
+* Make sure your company address is complete (including the state
-
+  and the zip code). Go to :menuselection:`Settings --> Users & Companies --> Companies`
-* Set default *TIC Code* and taxe rates. This will apply to any new 
+  to open and edit your Company record.
-  product created. A default sales tax is needed to trigger the 
-  tax computation.
-
-* For products under a specific category, select it in its detail form 
-  (in *Sales* tab).
-
-* Make sure your company address is well defined (especially the state 
-  and the zip code). Go to :menuselection:`Settings --> General Settings` 
-  and click *Configure your company data*.
 
 How it works
 ============
 
-Automatic tax assignation works thanks to fiscal positions
+Salestax is calculated in Odoo based on fiscal positions
 (see :doc:`application`).
-A specific fiscal position is created when installing *TaxCloud*.
+A Fiscal Position for the United States is created when installing *TaxCloud*.
 Everything works out-of-the-box.
 
-This fiscal position is set on any sales order, web order, or invoice
+You can configure Odoo to automtically detect which Customers should use this fiscal
-when the customer country is *United States*. This is triggering the 
+position.  Go to :menuselection:`Accounting --> Configuration --> Fiscal Positions`
+to open and edit the record.
+
+.. image:: media/taxcloud03.png
+  :align: center
+
+Now, this fiscal position is automatically set on any sales order, web order, or invoice
+when the customer country is *United States*. This triggers the
 automated tax computation.
 
 .. image:: media/taxcloud04.png
   :align: center
 
-Add a product with a default sales tax. Odoo will automatically
+Add your product(s). You have two options to get Sales Tax on the Order.  You can confirm it,
-send a request to TaxCloud, get the correct tax percentage based on the
+or you can save it and from the *Action* Menu choose **Update Taxes with TaxCloud**.
-customer location (state and zip code) and product TIC category, create
-a new tax rate if that tax percentage does not already exist in 
-your system and return it in the order item line (e.g. 7.0%).
-
-.. image:: media/taxcloud05.png
-  :align: center
-
-How to create specific tax mappings using TaxCloud
-==================================================
-
-You can create several fiscal positions using TaxCloud.
-Check *Use TaxCloud API* to do so. Such fiscal postions can be
-assigned to customers in their detail form in order to get them by default
-whenever they buy you something.
-
-.. image:: media/taxcloud06.png
-  :align: center
 
 .. seealso::
-  * :doc:`default_taxes`
   * :doc:`application`