@@ -100,3 +100,62 @@ value. To recalculate the taxes, click :guilabel:`Compute taxes using Avatax`.
100100
101101.. tip ::
102102 Tax calculation can even be done on negative subtotals and credit notes.
103+
104+ Logging
105+ =======
106+
107+ It is possible to log Avalara/*AvaTax * actions in Odoo for further analysis, or verification of
108+ functionality. Logging is accessible through the *AvaTax * settings.
109+
110+ To start logging *AvaTax * actions, first, navigate to the :menuselection: `Accounting app -->
111+ Configuration --> Settings `.
112+
113+ Then, in the :guilabel: `Taxes ` section, under the :guilabel: `AvaTax ` settings, click
114+ :guilabel: `Start logging for 30 minutes `.
115+
116+ Upon starting the log process, Odoo will log all Avalara/*AvaTax * actions performed in the database.
117+
118+ To view the logs, click on :guilabel: `Show logs ` to the right of the :guilabel: `Start logging for 30
119+ minutes `. This reveals a detailed list of Avalara/*AvaTax * actions. This list is sortable by the
120+ following columns:
121+
122+ - :guilabel: `Created on `: timestamp of the *AvaTax * calculation.
123+ - :guilabel: `Created by `: numeric value of the user in the database.
124+ - :guilabel: `Database name `: name of the database.
125+ - :guilabel: `Type `: two values can be chosen for this field, :guilabel: `Server ` or
126+ :guilabel: `Client `.
127+ - :guilabel: `Name `: Avalara service name. In this case, it will be *AvaTax *.
128+ - :guilabel: `Level `: by default, this will be `INFO `.
129+ - :guilabel: `Path `: indicates the path taken to make the calculation.
130+ - :guilabel: `Line `: indicates the line the calculation is made on.
131+ - :guilabel: `Function `: indicates the calculation taken on the line.
132+
133+ .. image :: avatax_use/logging.png
134+ :align: center
135+ :alt: Avalara logging page with top row of list highlighted.
136+
137+ Click into the log line to reveal another field, called :guilabel: `Message `.
138+
139+ This field populates a raw transcription of the transaction, which involves the creation (or
140+ adjustment) of a sales invoice using the Avalara *AvaTax * API.
141+
142+ The transaction includes details, such as addresses for shipping from and to, line items describing
143+ the products or services, tax codes, tax amounts, and other relevant information.
144+
145+ The :guilabel: `Message ` contains the calculated taxes for different jurisdictions and confirms the
146+ creation (or adjustment) of the transaction.
147+
148+ .. tip ::
149+ Custom fields can be made using Odoo *Studio *. Click the :icon: `fa-ellipsis-v `
150+ :guilabel: `(ellipsis) ` menu to the far-right of the header row. Then click :icon: `fa-plus `
151+ :guilabel: `Add custom field `. This action opens Odoo *Studio *.
152+
153+ .. important ::
154+ Odoo *Studio * requires a *custom * pricing plan. Consult the database's customer success manager
155+ for more information on switching plans. Or to see if Odoo *Studio * is included in the database's
156+ current pricing plan. See this documentation: :doc: `../../../../studio `.
157+
158+ .. seealso ::
159+ - :doc: `../avatax `
160+ - `US Tax Compliance: Avatax elearning video
161+ <https://www.odoo.com/slides/slide/us-tax-compliance-avatax-2858?fullscreen=1> `_
0 commit comments