Skip to main content
Avalara Help Center

Install and Configure Avalara AvaTax for OpenCart

This article applies to:Avalara AvaTax for Open Cart

After you activate AvaTax Update and set up your company profile, install and configure AvaTax Update for your accounting software. During configuration, customize your setup to fit your unique business needs for things like:

  • Tax calculation settings for various tax types
  • Exemption settings if you have exempt customers
  • Product taxability settings

Alter these settings when your business needs change.


Before you install {ATN}} for OpenCart:

  • Make sure you're running the latest version of vQmod for your version of OpenCart.
  • Ensure that vQmod is installed and running in your OpenCart web store. Get more information here.
  • Ensure that SOAP service is enabled in your PHP environment. Get more information here.
  • Ensure that the default time zone is set in the php.ini file. Get more information here.

To install AvaTax Update for OpenCart:

  1. Download the AvaTax Update for OpenCart zip file and unzip the files in the following folders ,or contact Avalara Support for assistance:
    • admin
    • image
    • system
    • vqmod 
  2. Navigate to www.[]/vqmod/xml/extension_conflict_checker.php, and follow these steps:
    1. If your page displays an Access Forbidden error or doesn't open, confirm the user and the Avalara plugin folder have the required access permissions. For details, check \\vqmod\.htaccess. 
    2. If the screen below appears, AvaTax Update for OpenCart doesn't conflict with other extensions.  Skip to the Configure section below.                  
    3. If a screen like the one below appears, AvaTax Update for OpenCart conflicts with other extensions. Resolve these conflicts before using AvaTax Update.


    4. Delete all the AvaTax Update for OpenCart files that you copied into the System folder of your OpenCart directory.
    5. Delete all the AvaTax Update for OpenCart files that you copied into the Vqmod\xml folder of your OpenCart directory.


To configure AvaTax Update for OpenCart to ensure it meets your sales tax needs: 

  1. In the OpenCart Admin Panel, go to System > Settings.
  2. To edit your default store details, under Action, click Edit .
  3. On the Avalara tab, fill in the fields, using the following as a guide:
    Section Field and description
    Avalara AvaTax Credentials
    • Account ID and License Key: Use the AvaTax Update account number and license key provided in an email from Avalara (sent to the email account you used to activate your AvaTax Update account). The subject of that email is Important! Your AvaTax Update Production Account Number & License Key.
    • Service URL: Make a selection based on your account type.
    • Test Connection: Click to test and confirm the information you entered in Account ID, License Key, and Service URL. If the test connection isn't successful, verify the credentials and confirm the user and the Avalara plugin folder have the required access permissions (\\system\AvaTax4PHP).
    • Company Name: The list of associated company names populates on successful verification.
    AvaTax Tax Profile Assistant

    User Name and Password: Type your AvaTax Update user name and passwordTo use AvaTax Tax Profile Assistant to set up your tax profile, click Submit.

    Tax Calculation Settings Enable AvaTax Tax Calculation: Select to enable AvaTax Update for your store.
    Address Validation Settings
    • Enable AvaTax Address Validation: Select Yes to enable the AvaTax Update address validationHoverTT.png feature for  customer addresses and store addresses. Enabling this feature is recommended, but not required. Disabling this doesn't disable AvaTax Update address validations during tax calculations.
    • Return results in upper case: Select Yes to return the validated address in uppercase.
    • Only Validate Addresses in: Select where you want AvaTax Update to validate addresses.
    Customer Specific Settings
    • Do you want to save transaction on AvaTax: Select Yes to start saving your OpenCart invoices in AvaTax Update.
    • Enable Log: Select Yes to start generating Avalara logs in the system/AvaTax4PHP/classes/ava-logs folder. Don't enable this feature unless directed by Avalara Support.
    • Send Model Number/UPC/SKU to AvaTax: Select the tax code you want send from OpenCart to AvaTax Update. By default, the model number is sent to AvaTax Update. Using this feature may cause additional fees. Talk to your Customer Account Manager (CAM) for more information.
  • Was this article helpful?