[IMP] finance: avatax version 17 updates

closes odoo/documentation#9341

Signed-off-by: Timothy Kukulka (tiku) <tiku@odoo.com>
This commit is contained in:
tiku-odoo 2024-05-14 11:18:26 -04:00
parent 7e37903b8f
commit f80a74f460
8 changed files with 61 additions and 27 deletions

View File

@ -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
~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~

Binary file not shown.

Before

Width:  |  Height:  |  Size: 32 KiB

After

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 15 KiB

After

Width:  |  Height:  |  Size: 13 KiB

View File

@ -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.

Binary file not shown.

Before

Width:  |  Height:  |  Size: 41 KiB

After

Width:  |  Height:  |  Size: 28 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 27 KiB

After

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 18 KiB

After

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 36 KiB

After

Width:  |  Height:  |  Size: 35 KiB