--- title: Avalara AvaTax Integration Guide description: Avalara AvaTax Integration Guide image: https://help.acorn.works/hubfs/acorn-meta-preview.png --- [Skip to content](https://help.acorn.works/help-centre/avalara-avatax-integration-guide#main-content) English - Australia Show submenu for translations [Contact Us](https://help.acorn.works/help-centre/kb-tickets/new?hsLang=en-au) [Customer Portal](https://support.acorn.works/tickets?hsLang=en-au) [![AcornLogo\_Horizontal\_FullColourWhite\_1000px](https://help.acorn.works/hs-fs/hubfs/AcornLogo_Horizontal_FullColourWhite_1000px.png?width=200&height=45&name=AcornLogo_Horizontal_FullColourWhite_1000px.png)](https://help.acorn.works/help-centre?hsLang=en-au) - [Help Articles](https://help.acorn.works/help-centre/help-articles) - [Patch Notes](https://help.acorn.works/help-centre/patch-notes) - [Status](https://status.acorn.works/) Open main navigation Close main navigation - [Help Articles](https://help.acorn.works/help-centre/help-articles) - [Patch Notes](https://help.acorn.works/help-centre/patch-notes) - [Status](https://status.acorn.works/) - English - Australia Show submenu for translations - [Contact Us](https://help.acorn.works/help-centre/kb-tickets/new) - [Customer Portal](https://support.acorn.works/tickets) Welcome to the Help Centre - There are no suggestions because the search field is empty. 1. [Acorn Help Centre](https://help.acorn.works/help-centre?hsLang=en-au) 2. [Help Articles](https://help.acorn.works/help-centre/help-articles?hsLang=en-au) 3. [Payments](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#payments) 24 March 2025 # Avalara AvaTax Integration Guide ### Avalara AvaTax for Acorn [Avalara AvaTax](https://www.avalara.com/us/en/index.html) is a cloud-based solution automating transaction tax calculations and the tax filing process. Avalara provides real-time tax calculation using tax content from more than 12,000 US taxing jurisdictions and over 200 countries, insuring your transaction tax is calculated based on the most current tax rules. This guide can assist you in setting up Avalara AvaTax for Acorn. - [Generate a Licence key in Avalara](https://help.acorn.works/hc/en-us/articles/7723958306575#h_01H9MQ0RS6HKW02SPSGVHSRF6E) - [Setup the integration between Acorn and Avalara](https://help.acorn.works/hc/en-us/articles/7723958306575#h_01H9MQ0RS6RRJA5JMAYPG8AJR0) - [Connect and configure AvaTax](https://help.acorn.works/hc/en-us/articles/7723958306575#h_01H9MQ0RS6FNDKSN20QHAVXCGE) - [Add tax to your Payments](https://help.acorn.works/hc/en-us/articles/7723958306575#h_01H9MQ0RS6TP70HK762FPSTKQY) - [Assign an AvaTax Code to content](https://help.acorn.works/hc/en-us/articles/7723958306575#h_01H9MQ0RS64HE93A4JG3ZWSW7E) - [How to remove your Avalara integration](https://help.acorn.works/hc/en-us/articles/7723958306575#h_01H9MQ0RS6TB3VTJCJT9X9EG12) ### Generate a Licence key in Avalara You'll first have to generate or retrieve your existing licence key in Avalara to get started. This key will then be added in Acorn. [Generate a Licence key in Avalara](https://knowledge.avalara.com/bundle/dqa1657870670369_dqa1657870670369/page/License_keys.html) *There is **one license key for all business applications** associated with your account. When you use a license key to connect a business application to AvaTax, generating a new license key breaks the connection to all applications. To restore the connection, enter the new license key in the AvaTax settings for each business application.* ### Setup the integration between Acorn and Avalara All of the following steps should be completed within Acorn. ### Connect and configure AvaTax Once you have your AvaTax licence key, you will need to  1. From the Admin menu, navigate to the **Integrations Hub.** 2. Find the Avalara app from the integrations hub and **expand** it to see the app details (tip: search for Avalara or filter by the Tax category to find it). 3. Click **Create Tax Integration.** *If you cannot create an integration, contact our [Support team](mailto:support@acorn.works).* ![bad20b5d4fb7026ffdb7a0014265065dc2d0e404a04945d9c337b7d1469b41b0](https://help.acorn.works/hs-fs/hubfs/bad20b5d4fb7026ffdb7a0014265065dc2d0e404a04945d9c337b7d1469b41b0.png?width=688&height=363&name=bad20b5d4fb7026ffdb7a0014265065dc2d0e404a04945d9c337b7d1469b41b0.png) 4. The Create Avalara Integration window will appear. First, **fill** in the following details:  - **Integration Name** - Friendly name of your integration. This will be displayed when setting a tax on your payments. (only visible to administrators) - **Username or Account ID** - The username or account ID provided by Avalara. - **Password or Licence Key** - The password or licence key provided by Avalara when generating a licence key. - **Use Sandbox Environment** - Recommended to enable this when testing the integration. *\*Requires an Avalara Sandbox account. Learn the difference between Avalara's [Production vs Sandbox](https://developer.avalara.com/ecommerce-integration-guide/sales-tax-badge/authentication-in-avatax/sandbox-vs-production/).* 5. **Click** Load Companies. This will validate your Username and Licence key with Avalara, and if successful, then your companies registered in Avalara will be listed. 1. **Select** the Company you want to use for transaction calculation and recording. 2. **Select** the Company Location you want to use for transaction calculation and recording. 6. The next two settings are optional - **Disable Documents** - If Disable Documents is checked, then transactions will NOT be recorded in Avalara. Use this option to calculate tax without recording documents to AvaTax. The integration will calculate tax and record documents to the AvaTax account if unchecked. - **Enable Logging** - All API requests with the integration will be logged if enabled. Used for any technical troubleshooting. We recommend enabling only when instructed by support. 7. **Click** Save. ### Add Tax to your Payments 1. From the Admin menu, navigate to the **Payments Dashboard**. 2. Create or edit an existing **payment**. 3. Under Select Tax Method, select your **Avalara integration**. 4. Click **Save**. Apply this payment to the content as you normally would, and learners will then get the right tax based on their billing information.  ### Assign an AvaTax Tax Code to content When adding payments to content, there will be a field to enter an Avalara Tax Code. ![enter avatax code](https://help.acorn.works/hs-fs/hubfs/enter%20avatax%20code.png?width=540&height=460&name=enter%20avatax%20code.png) Find the tax codes for your goods and services with Avalara. [Avalara Tax Codes](https://taxcode.avatax.avalara.com/search?q=training) ### How to remove your Avalara integration To remove your Avalara integration, you will  1. First, ensure the integration is applied to 0 payments. **Remove** the Tax Method from use on all Payments. You can find where the tax method is used by clicking the number in the Applied column.  ![mceclip1 (17)](https://help.acorn.works/hs-fs/hubfs/mceclip1%20(17).png?width=688&height=387&name=mceclip1%20(17).png) 2. Once the tax integration is no longer in use, the bin Icon will be accessible. **Click** on the bin to remove the integration. ![mceclip2 (13)](https://help.acorn.works/hs-fs/hubfs/mceclip2%20(13).png?width=688&height=386&name=mceclip2%20(13).png) - [Help Articles](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#main-content) - [User Management](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#user-management) - [Course Management](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#course-management) - [Live Learning Management](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#live-learning-management) - [Email Management](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#email-management) - [Tenancy Management](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#tenancy-management) - [Reporting](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#reporting) - [Workflows](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#workflows) - [Capabilities](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#capabilities) - [Momentum](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#momentum) - [Resources, Videos, Programs and Pages](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#resources-videos-programs-and-pages) - [Payments](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#payments) - [Multi-Language](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#multi-language) - [Content Sharing](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#content-sharing) - [Widget Dashboards](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#widget-dashboards) - [Forms](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#forms) - [Activities](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#activities) - [Self Registration](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#self-registration) - [End User Guides](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#end-user-guides) - [Single Sign-On](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#single-sign-on) - [Development Plans](https://help.acorn.works/help-centre/help-articles?hsLang=en-au#development-plans) - [FAQ's](https://help.acorn.works/help-centre/faqs?hsLang=en-au#main-content) - [Gamification & Social Learning](https://help.acorn.works/help-centre/faqs?hsLang=en-au#gamification-social-learning) - [Implementation & Onboarding](https://help.acorn.works/help-centre/faqs?hsLang=en-au#implementation-onboarding) - [Roles, Permissions & Access Control](https://help.acorn.works/help-centre/faqs?hsLang=en-au#roles-permissions-access-control) - [Hosting, Infrastructure & Business Continuity](https://help.acorn.works/help-centre/faqs?hsLang=en-au#hosting-infrastructure-business-continuity) - [Learning Paths & Development Plans](https://help.acorn.works/help-centre/faqs?hsLang=en-au#learning-paths-development-plans) - [Competency & Skills Management](https://help.acorn.works/help-centre/faqs?hsLang=en-au#competency-skills-management) - [Support & Customer Success](https://help.acorn.works/help-centre/faqs?hsLang=en-au#support-customer-success) - [Incident Management & Security Operations](https://help.acorn.works/help-centre/faqs?hsLang=en-au#incident-management-security-operations) - [Notifications & Communications](https://help.acorn.works/help-centre/faqs?hsLang=en-au#notifications-communications) - [Network & Application Security](https://help.acorn.works/help-centre/faqs?hsLang=en-au#network-application-security) - [Certifications & Compliance Tracking](https://help.acorn.works/help-centre/faqs?hsLang=en-au#certifications-compliance-tracking) - [Authentication & Single Sign-On](https://help.acorn.works/help-centre/faqs?hsLang=en-au#authentication-single-sign-on) - [Multi-Tenancy & Organizational Structure](https://help.acorn.works/help-centre/faqs?hsLang=en-au#multi-tenancy-organizational-structure) - [eCommerce & Monetization](https://help.acorn.works/help-centre/faqs?hsLang=en-au#ecommerce-monetization) - [Compliance Certifications & Audits](https://help.acorn.works/help-centre/faqs?hsLang=en-au#compliance-certifications-audits) - [Data Security & Encryption](https://help.acorn.works/help-centre/faqs?hsLang=en-au#data-security-encryption) - [User Management & Accounts](https://help.acorn.works/help-centre/faqs?hsLang=en-au#user-management-accounts) - [Personnel & Physical Security](https://help.acorn.works/help-centre/faqs?hsLang=en-au#personnel-physical-security) - [Localization & Language Support](https://help.acorn.works/help-centre/faqs?hsLang=en-au#localization-language-support) - [Mobile Access & Offline Learning](https://help.acorn.works/help-centre/faqs?hsLang=en-au#mobile-access-offline-learning) - [Branding, UI & User Experience](https://help.acorn.works/help-centre/faqs?hsLang=en-au#branding-ui-user-experience) - [Assessments, Quizzes & Surveys](https://help.acorn.works/help-centre/faqs?hsLang=en-au#assessments-quizzes-surveys) - [Integrations & APIs](https://help.acorn.works/help-centre/faqs?hsLang=en-au#integrations-apis) - [Course & Content Management](https://help.acorn.works/help-centre/faqs?hsLang=en-au#course-content-management) - [Workflow Automation](https://help.acorn.works/help-centre/faqs?hsLang=en-au#workflow-automation) - [Instructor-Led & Virtual Training (ILT/VILT)](https://help.acorn.works/help-centre/faqs?hsLang=en-au#instructor-led-virtual-training-ilt-vilt) - [Enrollment & Registration](https://help.acorn.works/help-centre/faqs?hsLang=en-au#enrollment-registration) - [Secure Development & Change Management](https://help.acorn.works/help-centre/faqs?hsLang=en-au#secure-development-change-management) - [Reporting & Analytics](https://help.acorn.works/help-centre/faqs?hsLang=en-au#reporting-analytics) - [Performance Management](https://help.acorn.works/help-centre/faqs?hsLang=en-au#performance-management) - [Privacy & Data Protection](https://help.acorn.works/help-centre/faqs?hsLang=en-au#privacy-data-protection) - [User Management](https://help.acorn.works/help-centre/faqs?hsLang=en-au#user-management) - [Patch Notes](https://help.acorn.works/help-centre/patch-notes?hsLang=en-au#main-content) - [2026](https://help.acorn.works/help-centre/patch-notes?hsLang=en-au#2026) - [2025](https://help.acorn.works/help-centre/patch-notes?hsLang=en-au#2025) - [2024](https://help.acorn.works/help-centre/patch-notes?hsLang=en-au#2024) - [2023](https://help.acorn.works/help-centre/patch-notes?hsLang=en-au#2023) - [2022](https://help.acorn.works/help-centre/patch-notes?hsLang=en-au#2022) - [Developers](https://help.acorn.works/help-centre/developers?hsLang=en-au#main-content) - [API](https://help.acorn.works/help-centre/developers?hsLang=en-au#api) - [Announcements](https://help.acorn.works/help-centre/announcements?hsLang=en-au#main-content) - [New Features & Updates](https://help.acorn.works/help-centre/announcements?hsLang=en-au#new-features-updates) - [Course Management](https://help.acorn.works/help-centre/course-management?hsLang=en-au#main-content) - [Course Settings](https://help.acorn.works/help-centre/course-management?hsLang=en-au#course-settings) - [Enrolments](https://help.acorn.works/help-centre/course-management?hsLang=en-au#enrolments) - [Forms](https://help.acorn.works/help-centre/course-management?hsLang=en-au#forms) - [Course Types](https://help.acorn.works/help-centre/course-management?hsLang=en-au#course-types) - [Troubleshooting](https://help.acorn.works/help-centre/troubleshooting?hsLang=en-au#main-content) - [Workflows](https://help.acorn.works/help-centre/troubleshooting?hsLang=en-au#workflows) - [Course Management](https://help.acorn.works/help-centre/troubleshooting?hsLang=en-au#course-management) - [User Management](https://help.acorn.works/help-centre/troubleshooting?hsLang=en-au#user-management) - [Reporting](https://help.acorn.works/help-centre/troubleshooting?hsLang=en-au#reporting) - [End User Guides](https://help.acorn.works/help-centre/troubleshooting?hsLang=en-au#end-user-guides) - [Quizzes & Assessments](https://help.acorn.works/help-centre/troubleshooting?hsLang=en-au#quizzes-assessments) - [Email](https://help.acorn.works/help-centre/troubleshooting?hsLang=en-au#email) - [Access & Login](https://help.acorn.works/help-centre/troubleshooting?hsLang=en-au#access-login) - [Live Learning Management](https://help.acorn.works/help-centre/troubleshooting?hsLang=en-au#live-learning-management) - [Getting Started](https://help.acorn.works/help-centre/getting-started?hsLang=en-au#main-content) - [Technical Requirements](https://help.acorn.works/help-centre/getting-started?hsLang=en-au#technical-requirements) - [Reference](https://help.acorn.works/help-centre/getting-started?hsLang=en-au#reference) - [Capabilities](https://help.acorn.works/help-centre/capabilities?hsLang=en-au#main-content) - [Reporting](https://help.acorn.works/help-centre/capabilities?hsLang=en-au#reporting) - [Overview](https://help.acorn.works/help-centre/capabilities?hsLang=en-au#overview) - [Assessments](https://help.acorn.works/help-centre/capabilities?hsLang=en-au#assessments) - [Setup & Configuration](https://help.acorn.works/help-centre/capabilities?hsLang=en-au#setup-configuration) - [Administration](https://help.acorn.works/help-centre/capabilities?hsLang=en-au#administration) - [Momentum](https://help.acorn.works/help-centre/momentum?hsLang=en-au#main-content) - [Workflow Builder](https://help.acorn.works/help-centre/momentum?hsLang=en-au#workflow-builder) - [Administration](https://help.acorn.works/help-centre/administration?hsLang=en-au#main-content) - [Email](https://help.acorn.works/help-centre/administration?hsLang=en-au#email) - [Training Records](https://help.acorn.works/help-centre/administration?hsLang=en-au#training-records) - [Certificates](https://help.acorn.works/help-centre/administration?hsLang=en-au#certificates) - [Multi-Tenancy](https://help.acorn.works/help-centre/administration?hsLang=en-au#multi-tenancy) - [Security](https://help.acorn.works/help-centre/administration?hsLang=en-au#security) - [User Management](https://help.acorn.works/help-centre/administration?hsLang=en-au#user-management) - [Reporting](https://help.acorn.works/help-centre/reporting?hsLang=en-au#main-content) - [Reports](https://help.acorn.works/help-centre/reporting?hsLang=en-au#reports) - [User Management](https://help.acorn.works/help-centre/user-management?hsLang=en-au) [![AcornLogo\_Horizontal\_FullColourWhite\_1000px](https://help.acorn.works/hs-fs/hubfs/AcornLogo_Horizontal_FullColourWhite_1000px.png?width=200&height=45&name=AcornLogo_Horizontal_FullColourWhite_1000px.png "AcornLogo_Horizontal_FullColourWhite_1000px")](https://acorn.works/) ###### GET IN TOUCH [support@acorn.works](mailto:support@acorn.works) --- [Asia Pacific: +61 2 6269 3330](tel:+61262693330) 8:30am to 5:30pm AEST, Mon - Fri --- [North America: +1 (888) 419-2505](tel:+18884192505) 8:30am to 5:30pm PT, Mon - Fri [mailto:hello@acorn.works](mailto:hello@acorn.works) Copyright © 2025, Acorn PLMS