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

Update these settings when your business needs change.

Install AvaTax for your accounting software

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 AvaTax for your accounting software

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 information provided in an email from Avalara (sent to the email account you used to activate your account). It must match what's saved in AvaTax.
    • Service URL: Select Development if you have an AvaTax development account or Production if you have an AvaTax production account.
    • 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: Use the information provided in an email from Avalara (sent to the email account you used to activate your account). It's the same credentials you use to log in to AvaTax. To 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: This function is primarily used for troubleshooting issues. If you choose to enable logging, all success, warning, and error messages are included in the log. Only enable logging if you've been instructed to do so by Avalara Support, because it can significantly slow down your service.
    • 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.