[IMP] finance: avatax version 17 updates
closes odoo/documentation#9341 Signed-off-by: Timothy Kukulka (tiku) <tiku@odoo.com>
@ -11,9 +11,9 @@ transactions.
|
|||||||
|
|
||||||
.. important::
|
.. important::
|
||||||
*AvaTax* is only available for integration with databases/companies that have locations in the
|
*AvaTax* is only available for integration with databases/companies that have locations in the
|
||||||
United States and Canada. This means the fiscal position/country of a database can only be set to
|
United States, Canada, and Brazil. This means the fiscal position/country of a database can only
|
||||||
the United States or Canada. For more information, reference this documentation:
|
be set to the United States, Canada, or Brazil. For more information, reference this
|
||||||
:ref:`avatax/fiscal_country`.
|
documentation: :ref:`avatax/fiscal_country`.
|
||||||
|
|
||||||
*AvaTax* accounts for location-based tax rates for each state, county, and city. It improves
|
*AvaTax* accounts for location-based tax rates for each state, county, and city. It improves
|
||||||
remittance accuracy by paying close attention to laws, rules, jurisdiction boundaries, and special
|
remittance accuracy by paying close attention to laws, rules, jurisdiction boundaries, and special
|
||||||
@ -125,7 +125,7 @@ To set the :guilabel:`Fiscal Country`, navigate to :menuselection:`Accounting ap
|
|||||||
:doc:`../../fiscal_localizations`
|
:doc:`../../fiscal_localizations`
|
||||||
|
|
||||||
Under the :guilabel:`Taxes` section, set the :guilabel:`Fiscal Country` feature to :guilabel:`United
|
Under the :guilabel:`Taxes` section, set the :guilabel:`Fiscal Country` feature to :guilabel:`United
|
||||||
States` or :guilabel:`Canada`. Then, click :guilabel:`Save`.
|
States`, :guilabel:`Canada`, or :guilabel:`Brazil`. Then, click :guilabel:`Save`.
|
||||||
|
|
||||||
Company settings
|
Company settings
|
||||||
----------------
|
----------------
|
||||||
@ -166,28 +166,50 @@ Next, ensure that the Odoo *AvaTax* module is installed. To do so, navigate to t
|
|||||||
* - :guilabel:`Avatax`
|
* - :guilabel:`Avatax`
|
||||||
- `account_avatax`
|
- `account_avatax`
|
||||||
- Default *AvaTax* module. This module adds the base *AvaTax* features for tax calculation.
|
- Default *AvaTax* module. This module adds the base *AvaTax* features for tax calculation.
|
||||||
|
* - :guilabel:`Avatax for geo localization`
|
||||||
|
- `account_avatax_geolocalize`
|
||||||
|
- This module includes the features required for integration of *AvaTax* into geo-localization
|
||||||
|
in Odoo.
|
||||||
* - :guilabel:`Avatax for SO`
|
* - :guilabel:`Avatax for SO`
|
||||||
- `account_avatax_sale`
|
- `account_avatax_sale`
|
||||||
- Includes the information needed for tax calculation on sales orders in Odoo.
|
- Includes the information needed for tax calculation on sales orders in Odoo.
|
||||||
* - :guilabel:`Avatax for Subscriptions`
|
* - :guilabel:`Avatax for Inventory`
|
||||||
- `account_avatax_sale_subscription`
|
- `account_avatax_stock`
|
||||||
- This module includes the features required for tax calculation on subscriptions in Odoo.
|
- Includes tax calculation in Odoo Inventory.
|
||||||
* - :guilabel:`Account Avatax - Ecommerce`
|
* - :guilabel:`Amazon/Avatax Bridge`
|
||||||
- `website_sale_account_avatax`
|
- `sale_amazon_avatax`
|
||||||
- Includes tax calculation features for the checkout process on Odoo eCommerce.
|
- Includes tax calculation features between the *Amazon Connector* and Odoo.
|
||||||
* - :guilabel:`Account AvaTax - Ecommerce - Delivery`
|
* - :guilabel:`Avatax Brazil`
|
||||||
- `website_sale_delivery_avatax`
|
- `l10n_br_avatax`
|
||||||
- Includes tax calculation features for the delivery process on Odoo eCommerce.
|
- Includes information for tax calculation in the Brazil localization.
|
||||||
|
* - :guilabel:`Avatax Brazil for Services`
|
||||||
|
- `l10n_br_avatax_services`
|
||||||
|
- This module includes the required features for tax calculation for services in the Brazil
|
||||||
|
localization.
|
||||||
|
* - :guilabel:`Avatax Brazil Sale for Services`
|
||||||
|
- `l10n_br_edi_sale_services`
|
||||||
|
- This module includes the required features for tax calculation for the sale of services in
|
||||||
|
the Brazil localization. This includes electronic data interchange (EDI).
|
||||||
|
* - :guilabel:`Test SOs for the Brazilian AvaTax`
|
||||||
|
- `l10n_br_test_avatax_sale`
|
||||||
|
- This module includes the required features for test sales orders in the Brazil localization.
|
||||||
|
|
||||||
Click the :guilabel:`Install` button on the module labeled :guilabel:`Avatax`: `account_avatax`.
|
Click the :guilabel:`Install` button on the module labeled, :guilabel:`Avatax`: `account_avatax`.
|
||||||
Doing so installs the following modules:
|
Doing so installs the following modules:
|
||||||
|
|
||||||
- :guilabel:`Avatax`: `account_avatax`
|
- :guilabel:`Avatax`: `account_avatax`
|
||||||
- :guilabel:`Avatax for SO`: `account_avatax_sale`
|
- :guilabel:`Avatax for SO`: `account_avatax_sale`
|
||||||
- :guilabel:`Account Avatax - Ecommerce`: `website_sale_account_avatax`
|
- :guilabel:`Avatax for Inventory`: `account_avatax_stock`
|
||||||
|
|
||||||
Should *AvaTax* be needed for Odoo *Subscriptions*, or for delivery tax in Odoo *eCommerce*, then
|
Should *AvaTax* be needed for geo-localization, or with the *Amazon Connector*, then install those
|
||||||
install those modules individually by clicking on :guilabel:`Install`.
|
modules individually by clicking on :guilabel:`Install` on :guilabel:`Avatax for geo localization`
|
||||||
|
and :guilabel:`Amazon/Avatax Bridge`, respectively.
|
||||||
|
|
||||||
|
.. seealso::
|
||||||
|
For localization specific *AvaTax* instructions, view the following :doc:`fiscal localization
|
||||||
|
<../../fiscal_localizations>` documentation:
|
||||||
|
|
||||||
|
- :doc:`../../fiscal_localizations/brazil`
|
||||||
|
|
||||||
.. _avatax/credentials:
|
.. _avatax/credentials:
|
||||||
|
|
||||||
@ -196,9 +218,13 @@ Odoo AvaTax settings
|
|||||||
|
|
||||||
To integrate the *AvaTax* :abbr:`API (application programming interface)` with Odoo, go to
|
To integrate the *AvaTax* :abbr:`API (application programming interface)` with Odoo, go to
|
||||||
:menuselection:`Accounting app --> Configuration --> Settings` section. The :guilabel:`AvaTax`
|
:menuselection:`Accounting app --> Configuration --> Settings` section. The :guilabel:`AvaTax`
|
||||||
fields in the :guilabel:`Taxes` section is where the *AvaTax* configurations are made and the
|
fields in the :guilabel:`Taxes` section is where the *AvaTax* configurations are made, and the
|
||||||
credentials are entered in.
|
credentials are entered in.
|
||||||
|
|
||||||
|
First, tick the checkbox to the left of the :guilabel:`AvaTax` settings, to activate *AvaTax* on the
|
||||||
|
database. This is a quick, convenient way to activate and deactivate *AvaTax* tax calculation on the
|
||||||
|
Odoo database.
|
||||||
|
|
||||||
.. image:: avatax/avatax-configuration-settings.png
|
.. image:: avatax/avatax-configuration-settings.png
|
||||||
:align: center
|
:align: center
|
||||||
:alt: Configure AvaTax settings
|
:alt: Configure AvaTax settings
|
||||||
@ -360,6 +386,12 @@ Tax mapping
|
|||||||
The *AvaTax* integration is available on sale orders and invoices with the included *AvaTax* fiscal
|
The *AvaTax* integration is available on sale orders and invoices with the included *AvaTax* fiscal
|
||||||
position.
|
position.
|
||||||
|
|
||||||
|
.. tip::
|
||||||
|
Additionally, there is a :guilabel:`Tax Mapping` tab and :guilabel:`Account Mapping` tab in the
|
||||||
|
:guilabel:`Automatic Tax Mapping (AvaTax)` fiscal position, where mapping for products can also
|
||||||
|
be configured. To access :guilabel:`Fiscal Positions` navigate to :menuselection:`Accounting app
|
||||||
|
--> Configuration --> Accounting: Fiscal Positions`.
|
||||||
|
|
||||||
Product category mapping
|
Product category mapping
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
Before Width: | Height: | Size: 32 KiB After Width: | Height: | Size: 19 KiB |
Before Width: | Height: | Size: 15 KiB After Width: | Height: | Size: 13 KiB |
@ -11,15 +11,15 @@ Tax calculation
|
|||||||
|
|
||||||
Automatically calculate taxes on Odoo quotations and invoices with AvaTax by confirming the
|
Automatically calculate taxes on Odoo quotations and invoices with AvaTax by confirming the
|
||||||
documents during the sales flow. Alternatively, calculate the taxes manually by clicking the
|
documents during the sales flow. Alternatively, calculate the taxes manually by clicking the
|
||||||
:guilabel:`Compute taxes using Avatax` button while these documents are in draft mode.
|
:guilabel:`Compute Taxes` button, while these documents are in draft stage.
|
||||||
|
|
||||||
.. tip::
|
.. tip::
|
||||||
Clicking the :guilabel:`Compute taxes using Avatax` button recalculates taxes if any product
|
Clicking the :guilabel:`Compute Taxes` button recalculates taxes, if any product lines are edited
|
||||||
lines are edited on the invoice.
|
on the invoice.
|
||||||
|
|
||||||
.. image:: avatax_use/calculate-avatax.png
|
.. image:: avatax_use/calculate-avatax.png
|
||||||
:align: center
|
:align: center
|
||||||
:alt: Sales quotation with the confirm and compute taxes using AvaTax buttons highlighted.
|
:alt: Sales quotation with the confirm and compute taxes button highlighted.
|
||||||
|
|
||||||
The tax calculation is triggered during the following :ref:`automatic trigger
|
The tax calculation is triggered during the following :ref:`automatic trigger
|
||||||
<avatax/automatic-triggers>` and :ref:`manual trigger <avatax/manual-triggers>` circumstances.
|
<avatax/automatic-triggers>` and :ref:`manual trigger <avatax/manual-triggers>` circumstances.
|
||||||
@ -43,8 +43,10 @@ Automatic triggers
|
|||||||
Manual triggers
|
Manual triggers
|
||||||
---------------
|
---------------
|
||||||
|
|
||||||
- :guilabel:`Compute taxes using Avatax` button at the bottom of the quote.
|
- :guilabel:`Compute Taxes` button at the bottom of the quote.
|
||||||
- :guilabel:`Compute taxes using Avatax` button at the top of the invoice.
|
- :guilabel:`Compute Taxes` button at the top of the invoice.
|
||||||
|
|
||||||
|
Use each of these buttons to manually re-calculate the sales tax.
|
||||||
|
|
||||||
.. tip::
|
.. tip::
|
||||||
Use the :guilabel:`Avalara Partner Code` field that is available on customer records, quotations,
|
Use the :guilabel:`Avalara Partner Code` field that is available on customer records, quotations,
|
||||||
@ -94,9 +96,9 @@ AvaTax portal.
|
|||||||
Fixed price discounts
|
Fixed price discounts
|
||||||
=====================
|
=====================
|
||||||
|
|
||||||
Add a fixed price discount to a valuable customer by click :guilabel:`Add a line` on the customer's
|
Add a fixed price discount to a valuable customer, by clicking :guilabel:`Add a line` on the
|
||||||
invoice. Add the product discount and set the :guilabel:`Price` to either a positive or negative
|
customer's invoice. Add the product discount, and set the :guilabel:`Price` to either a positive or
|
||||||
value. To recalculate the taxes, click :guilabel:`Compute taxes using Avatax`.
|
negative value. To recalculate the taxes, click :guilabel:`Compute Taxes`.
|
||||||
|
|
||||||
.. tip::
|
.. tip::
|
||||||
Tax calculation can even be done on negative subtotals and credit notes.
|
Tax calculation can even be done on negative subtotals and credit notes.
|
||||||
|
Before Width: | Height: | Size: 41 KiB After Width: | Height: | Size: 28 KiB |
Before Width: | Height: | Size: 27 KiB After Width: | Height: | Size: 34 KiB |
Before Width: | Height: | Size: 18 KiB After Width: | Height: | Size: 20 KiB |
Before Width: | Height: | Size: 36 KiB After Width: | Height: | Size: 35 KiB |