View source for Avalara

{{Module Introduction|Avalara|Integrations}} is an add-on module that can be installed from the {{Module|Plugin}}. After installing the plugin, a new module is added that integrates with [https://www.avalara.com/products/sales-and-use-tax/avatax/ Avalara AvaTax]. Avalara takes the hassle out of managing the many complex taxing laws and automatically returns a total tax amount based on the product, price, and location.

{{Plugin Install|Avalara|Integrations}}

==Connect==

[[File:Avalara Connect.png|right]]
# In the {{Module|Avalara}}, enter the username and password used to log into Avalara.
# Alternatively, enter the '''Account Number''' and '''License Key''' which can be obtained by logging in at [https://admin.avalara.com/ https://admin.avalara.com/]. For more information, click [https://developer.avalara.com/api-documentation/avatax-15-api/getting-started/logins here].
# The other fields are Avalara options, such as the ability to mark transactions as '''Pending''' or '''Committed'''.
#* '''Commit Transactions''' - This marks all transactions that are sent to Avalara as Committed. Transactions that are committed are available to be reported to a tax authority by Avalara Managed Returns.
#* '''Send QuickBooks Class as AvaTax Location Code''' - This uses the QuickBooks class that was assigned to a transaction in Fishbowl when it is sent to Avalara for identifying it.
#* '''Use Customer Account Number instead of Customer Name''' - When this is checked, the customer’s identification in a transaction will be based on their account number rather than their name.
#* '''Use Shipment Number Prefix''' - This adds a prefix number to the shipment number to distinguish each transaction by its source.
# Click the '''Connect''' button in the {{Module|Avalara}} to verify that the connection is valid and then click '''Save'''.

==Process==

# All products must be marked as [[Product#General_tab|taxable in Fishbowl]] or they will not be sent to Avalara. Non-taxable products should have a non-taxable code assigned, but the [[Product#General_tab|taxable checkbox]] must still be enabled on the Fishbowl product. The taxable checkbox can also be changed on the sales order.
# The tax code for a product can be set on the {{ModuleTab|Product|Custom}}.
# To get a tax estimate, click the {{Button|Avalara}} on the [[Sales_Order#Module_buttons|Sales Order module toolbar]].<br>[[File:Avalara Tax Estimate.png]]
#*If any changes are made to the order (modified quantity, partial shipment, address change, etc.), the estimated amount may vary from the actual amount calculated during shipping.
#* In some cases, local laws and other complexities may also result in the actual tax being different from the estimate.
#*The tax estimate is stored on the {{ModuleTab|Sales Order|Details}}.
#* The '''Order Estimated Tax''' column can also be enabled on the [[Advanced_Reports#Sales_Order_Report|Sales Order report]].<br>[[File:Estimated Tax on report.png|link=Advanced_Reports#Sales_Order_Report]]
#*<u>The order total will not include tax until the order has been shipped</u>.
# Once an order has shipped, a line item will be added to the order with the actual tax amount.<br>[[File:Avalara Actual Amount.png]]
#*Below is an example of the data that is stored in Avalara when an order ships.<br>[[File:AvaTax details.png]]

Avalara will validate the '''Ship To''' address when requesting a tax estimate and when the order is shipped. An address can also be validated manually by clicking the {{Icon Button|Validate Address}} above the '''Ship To''' address.

==Notes==

When using Avalara, some orders need to be processed in a specific way to ensure that the correct calculations are made. Below are some notes that apply when using the Avalara integration.

* '''USA''' - Avalara is not configured for countries outside of the United States.
* '''Taxable vs. tax codes''' - All products must be marked as [[Product#General_tab|taxable in Fishbowl]] or they will not be sent to Avalara. Non-taxable products should have a non-taxable code assigned and the [[Product#General_tab|taxable]] box checked in Fishbowl.
* '''Shipping''' - If an order doesn't have anything to ship, a [[Part#Part_types|non-inventory]] item should be added to the order so that the order will be routed through the shipping process.
* '''Drop ship''' - [[Sales_Order#Drop_ship|Drop ship]] items should be received before shipping the last item on the order. A warning will be displayed when trying to ship an order with unreceived drop ship items.
* '''Duplicate''' - [[Sales_Order#Duplicate_a_sales_order|Duplicating a fulfilled sales order]] will also copy the Avalara line item tax to the new order. This item should be removed from the new order so that the tax on the new order is recalculated correctly.
* '''Returns''' - The {{Button|Receive}} at the top of the {{Module|Receiving|Module buttons}} should be used to receive all credit return items. The '''Receive''' button on the component toolbar to the right should only be used if there will be an [[Accounting_Integration#Export|accounting export]] after receiving each line item.
* '''Checkout''' - Orders with the AvaTax tax item cannot be processed in {{Module|Fishbowl Checkout|3=}} and will display an error.
* '''Miscellaneous items''' - A [[Sales_Order#Item_types|miscellaneous sale or credit]] should only be used if it has a $0 amount, because miscellaneous items do not have tax codes. Instead, new products should be created and associated with the correct tax codes. Alternatively, [[Sales_Order#Item_types|non-inventory]] items can be associated with the correct tax codes and the line item descriptions could be edited on each sales order as needed.
* '''Service''' - [[Part#Part_types|Service]] items must be combined with an item that will go through the shipping process. If service items are also combined with credit return or drop ship items, [[Sales_Order#Quick_fulfill|Quick Fulfill]] must be used to fulfill the rest of the order first, then fulfill the credit return or drop ship items. An alternative would be to create these as [[Part#Part_types|non-inventory]] items instead.
* '''Return and Drop ship''' - [[Sales_Order#2._Add_items|Credit Return]] items and [[Sales_Order#2._Add_items|Drop Ship]] items should not be combined with [[Part#Part_types|Service]] items. If they are, [[Sales_Order#Quick_fulfill|Quick Fulfill]] must be used to fulfill the rest of the order and then fulfill the Return. Use the [[Receiving#Receipt_tab|Receiving Ref #]] to enter a unique number to prevent tax calculation issues.

{{Plugin Release Notes}}