From 41afe0ddf92b6f36873754f1bb9e804d38c8c998 Mon Sep 17 00:00:00 2001 From: tiku-odoo Date: Wed, 8 May 2024 10:38:04 -0400 Subject: [PATCH] [IMP] finance: avatax use add logging closes odoo/documentation#9271 X-original-commit: 314ddb2de36a05aea2db2ae0d85527c4f8c391ff Signed-off-by: Timothy Kukulka (tiku) --- .../accounting/taxes/avatax/avatax_use.rst | 59 ++++++++++++++++++ .../taxes/avatax/avatax_use/logging.png | Bin 0 -> 18858 bytes 2 files changed, 59 insertions(+) create mode 100644 content/applications/finance/accounting/taxes/avatax/avatax_use/logging.png diff --git a/content/applications/finance/accounting/taxes/avatax/avatax_use.rst b/content/applications/finance/accounting/taxes/avatax/avatax_use.rst index 39bf5ba1e..781f57817 100644 --- a/content/applications/finance/accounting/taxes/avatax/avatax_use.rst +++ b/content/applications/finance/accounting/taxes/avatax/avatax_use.rst @@ -100,3 +100,62 @@ value. To recalculate the taxes, click :guilabel:`Compute taxes using Avatax`. .. tip:: Tax calculation can even be done on negative subtotals and credit notes. + +Logging +======= + +It is possible to log Avalara/*AvaTax* actions in Odoo for further analysis, or verification of +functionality. Logging is accessible through the *AvaTax* settings. + +To start logging *AvaTax* actions, first, navigate to the :menuselection:`Accounting app --> +Configuration --> Settings`. + +Then, in the :guilabel:`Taxes` section, under the :guilabel:`AvaTax` settings, click +:guilabel:`Start logging for 30 minutes`. + +Upon starting the log process, Odoo will log all Avalara/*AvaTax* actions performed in the database. + +To view the logs, click on :guilabel:`Show logs` to the right of the :guilabel:`Start logging for 30 +minutes`. This reveals a detailed list of Avalara/*AvaTax* actions. This list is sortable by the +following columns: + +- :guilabel:`Created on`: timestamp of the *AvaTax* calculation. +- :guilabel:`Created by`: numeric value of the user in the database. +- :guilabel:`Database name`: name of the database. +- :guilabel:`Type`: two values can be chosen for this field, :guilabel:`Server` or + :guilabel:`Client`. +- :guilabel:`Name`: Avalara service name. In this case, it will be *AvaTax*. +- :guilabel:`Level`: by default, this will be `INFO`. +- :guilabel:`Path`: indicates the path taken to make the calculation. +- :guilabel:`Line`: indicates the line the calculation is made on. +- :guilabel:`Function`: indicates the calculation taken on the line. + +.. image:: avatax_use/logging.png + :align: center + :alt: Avalara logging page with top row of list highlighted. + +Click into the log line to reveal another field, called :guilabel:`Message`. + +This field populates a raw transcription of the transaction, which involves the creation (or +adjustment) of a sales invoice using the Avalara *AvaTax* API. + +The transaction includes details, such as addresses for shipping from and to, line items describing +the products or services, tax codes, tax amounts, and other relevant information. + +The :guilabel:`Message` contains the calculated taxes for different jurisdictions and confirms the +creation (or adjustment) of the transaction. + +.. tip:: + Custom fields can be made using Odoo *Studio*. Click the :icon:`fa-ellipsis-v` + :guilabel:`(ellipsis)` menu to the far-right of the header row. Then click :icon:`fa-plus` + :guilabel:`Add custom field`. This action opens Odoo *Studio*. + +.. important:: + Odoo *Studio* requires a *custom* pricing plan. Consult the database's customer success manager + for more information on switching plans. Or to see if Odoo *Studio* is included in the database's + current pricing plan. See this documentation: :doc:`../../../../studio`. + +.. seealso:: + - :doc:`../avatax` + - `US Tax Compliance: Avatax elearning video + `_ diff --git a/content/applications/finance/accounting/taxes/avatax/avatax_use/logging.png b/content/applications/finance/accounting/taxes/avatax/avatax_use/logging.png new file mode 100644 index 0000000000000000000000000000000000000000..c573d5c00bec403d5e9eebeacefa5b3cd093b824 GIT binary patch literal 18858 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 literal 0 HcmV?d00001