This page will walk you through setting up Cyrious Control to use the online tax calculation web service provided by Avalara.

Setting up Control to use online tax calculations with Avalara.

• Microsoft .NET must be installed.
• Web Service Enhancements 2.0 (WSE2) must be installed.
• Avalara uses the 1.2.0.30714 version of the log4net.dll. Merchant Warehouse 1.8 uses a different version of this dll and will cause conflicts between the two services if the wrong version is used.

1. Contact Avalara to obtain an account to use their web service.
2. Purchase the Online Tax Module for Control. Contact your Cyrious Software salesperson for details.
3. Call Cyrious Software to get the Online Tax Module enabled on your system.
4. Once you have your account details from Avalara, open Control.
5. In Control, go to Setup » Accounting Setup » online_tax_options. If 'online_tax_options' does not appear, contact Technical Support in order to verify the Online Tax Module is enabled.
6. Check the 'Enable Online Tax Lookup' option to enable Control to communicate we the web service.
7. Fill in the account settings using the information supplied by Avalara.
8. Set the options below the account information to the settings appropriate for you company. For details on the options, follow this link: online_tax_options.
9. Click the 'Ping Avalara' button to verify the account information entered and to test communication between Avalara's web service and Control. If an error occurs while pinging and the account information entered is correct, contact Technical Support or follow the steps in the “Registering Avalara DLLs Manually” section to resolve.
10. Click 'Save' to keep the changes made.

The Avalara adapter has been updated to version 5.7.3.1. This version supports up to 1000 line items. To register the dlls:

Note: During the Control Server or Stand Alone installation process, the required DLLs for Avalara are installed and registered. The SSLIP program has also been updated to check the current version of the adapter. If the the old version is detected, the new adapter is automatically installed and registered. If the installation was not run or the SSLIP does not register the dll, the following steps will resolve any problems:

1. Install Microsoft .NET Framework 2.0. Follow this link to download the installer: Microsoft .NET 2.0 Framework.
2. Install Web Services Enhancements 2.0 (WSE 2). Follow this link to download the installer: Web Services Enhancements 2.0.
   Note: If you are using a Server OS (i.e. Windows Server 2016 Standard Edition) you may have to install .NET 2.0 and .NET 3.5 via the “Server Manager” in Windows since running the installers directly is not supported. Once in the Server Manager you'll have to add/remove roles, go through the wizard and under Features select the option for .NET 2.0 / .Net 3.5 to complete the install.
3. Copy the following DLLs to the same location as the SSLIP:
   1. Avalara.AvaTax.Adapter.dll (version 5.7.3.1)
   2. Avalara.AvaTax.Adapter.dll.config
   3. Microsoft.Web.Services2.dll
4. Create a subfolder in the SSLIP's location called AvaTax.
5. Copy log4net.dll ( 1.2.0.30714 ) into the AvaTax subfolder.
6. Register the log4net.dll with the Global Assembly Cache (GAC).
   This can be done in either of these 2 ways:
   1. Method 1: Copy the log4net.dll in the C:\Windows\Assembly folder.
   2. Method 2: Register the log4net.dll with the GAC, using of one the following methods:
      Note: For more information on the GAC Utility program, follow this link: Global Assembly Cache Tool.
      1. Method 1: Run the GAC Utility program (gacutil.exe). In the command prompt, navigate to the AvaTax subfolder and run this command
         C:\Windows\Microsoft.Net\Framework\v1.1.4322\gacutil.exe /i log4net.dll.
         
         Note: if the GacUtil.exe does not exists on the system, copy the log4net.dll to C:\WINDOWS\assembly. The assembly folder is a special folder for .NET. To copy the dll to it, drag the dll into the folder. There is no right-click > paste option available for this folder.
         
      2. Method 2: Using Powershell.. Run PowerShell as an administrator and execute this script:

Set-location "c:\program files (x86)\cyrious\control\AvaTax"
[System.Reflection.Assembly]::Load("System.EnterpriseServices, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")
$avatax = New-Object System.EnterpriseServices.Internal.Publish
$avatax.GacInstall("c:\program files (x86)\cyrious\control\AvaTax\log4net.dll")
iisreset

1. Register the Avalara DLLs by using Regasm by running this command:
   1. C:\Windows\Microsoft.Net\Framework\v2.0.50727\regasm.exe C:\Program Files\Cyrious\SSLIP\Avalara.AvaTax.Adapter.dll
   2. C:\Windows\Microsoft.Net\Framework\v2.0.50727\regasm.exe “C:\Program Files (x86)\Cyrious\Control\Avalara.AvaTax.Adapter.dll”
      
2. Restart the SSLIP if it running.

• [Microsoft .NET 1.1 Folder] - The folder the .NET framework is installed. Usually C:\Windows\Microsoft.Net\Framework\v1.1.4322\.
• [Microsoft .NET 2.0 Folder] - The folder the .NET framework is installed. Usually C:\Windows\Microsoft.Net\Framework\v2.0.50727\.

During the Control Server or Stand Alone installation process, the required DLLs for Avalara are installed and registered. If the installation was not run or Control experiences problems communicating with Avalara, the following steps resolve the problems:

1. Install Microsoft .NET Framework 1.1 or later. Follow this link to download the installer: Microsoft .NET 1.1 Download.
2. Install Web Services Enhancements 2.0 (WSE 2). Follow this link to download the installer: Web Services Enhancements 2.0.
3. Copy the following DLLs to the same location as the SSLIP:
   1. Avalara.AvaTax.Adapter.dll (version 4.1.7.3)
   2. Microsoft.Web.Services2.dll
4. Create a subfolder int he SSLIP's location called AvaTax.
5. Copy log4net.dll ( 1.2.0.30714 ) into the AvaTax subfolder.
6. Register the log4net.dll with the Global Assembly Cache (GAC). This can be done in either of thses two ways:
   1. Method 1: Copy the log4net.dll in the C:\Windows\Assembly folder, or
   2. Method 2: Register the log4net.dll with the GAC, using of one the following methods:
      Note: For more information on the GAC Utility program, follow this link: Global Assembly Cache Tool.
      - Method 1: Run the GAC Utility program (gacutil.exe). In the command prompt, navigate to the AvaTax subfolder and run this command
      C:\Windows\Microsoft.Net\Framework\v1.1.4322\gacutil.exe /i log4net.dll
      
      1. Method 2: If the GacUtil.exe does not exists on the system, copy the log4net.dll to C:\WINDOWS\assembly.The assembly folder is a special folder for .NET. To copy the dll to it, drag the dll into the folder. There is no right-click > paste option available for this folder.
         
      2. Method 3: Register the Avalara DLL with regasm by running this command:
         C:\Windows\Microsoft.Net\Framework\v1.1.4322\regasm.exe C:\Program Files\Cyrious\SSLIP\Avalara.AvaTax.Adapter.dll
         
7. Restart the SSLIP if it is running.

• [Microsoft .NET 1.1 Folder] - The folder the .NET framework is installed. Usually C:\Windows\Microsoft.Net\Framework\v1.1.4322\.

If Control fails to ping Avalara after these steps, refer to troubleshooting_avalara to find the solution.

Contributor: Development Team, Cyrious Software

Date: 08/31/2010

Version: Control 4.1+