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 and set up your company profile, install and configure AvaTax 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.

Install

Before you install AvaTax 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 for OpenCart:

  1. Download the AvaTax 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.[yoursite.com]/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 for OpenCart doesn't conflict with other extensions. Skip to the Configure section below.
      OpenCart_ConflictChecker1.png
    3. If a screen like the one below appears, AvaTax for OpenCart conflicts with other extensions. Resolve these conflicts before using AvaTax.

      OpenCart_ConflictChecker2.png

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

Configure

To configure AvaTax 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 account number and license key provided in an email from Avalara (sent to the email account you used to activate your AvaTax account). The subject of that email is Important! Your AvaTax 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 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 for your store.
    Address Validation Settings
    • Enable AvaTax Address Validation: Select Yes to enable the AvaTax address validationHoverTT.png feature for  customer addresses and store addresses. Enabling this feature is recommended, but not required. Disabling this doesn't disable AvaTax 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 to validate addresses.
    Customer Specific Settings
    • Do you want to save transaction on AvaTax: Select Yes to start saving your OpenCart invoices in AvaTax.
    • 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. By default, the model number is sent to AvaTax. Using this feature may cause additional fees. Talk to your Customer Account Manager (CAM) for more information.