Avalara Developer Network Developer avaTax

Get Started

Using AvaTax is as easy as 1, 2, 3, 4!

1 Create an AvaTax Account

To get started, we’ll first set you up with an AvaTax Sandbox account. This account will allow you to use advanced AvaTax functionality in the U.S. and Canada only, in an environment called Sandbox. Because this is a sandbox, you can experiment all you like and your test data will be kept separate from your production accounts.

Here’s how to request a free sandbox trial account today:

2 Visit the Customer Portal

To calculate tax correctly, we’ll need to know a few things about your company. Fortunately, Avalara’s Customer Portal provides a streamlined onboarding process that helps you configure your company quickly and easily. Visit Avalara Customer Portal for Sandbox Accounts and walk through the five minute setup process.

3 Calculate Tax

Your next step is to calculate tax online using the interactive AvaTax API reference page. If you want to sell $100 worth of Yarn at a retail location in Irvine, California, here’s what your transaction would look like:

{
  "type": "SalesInvoice",
  "date": "2017-03-06",
  "customerCode": "ABC",
  "addresses": {
    "singleLocation": {
      "line1": "123 Main Street",
      "city": "Irvine",
      "region": "CA",
      "country": "US",
      "postalCode": "92615"
    }
  },
  "lines": [
    {
      "number": "1",
      "quantity": 1,
      "amount": 100,
      "description": "Yarn"
    }
  ]
}

You can copy and paste this text into the model parameter box on the CreateTransaction API call, then click Try it out!. If you get an Authorization Incomplete error, click the Authorize button on the top right hand corner of the page and fill out your credentials, then try creating the transaction again.

Mixed in along with all the diagnostic information, you’ll see this data in the result:

{
  "id": 279797011,
  "code": "7a6e9396-e152-4bb2-821c-6d746c3641be",
  "companyId": 238146,
  "date": "2017-03-06",
  ...
  "totalAmount": 100,
  "totalExempt": 0,
  "totalTax": 7.75,
  "totalTaxable": 100,
  "totalTaxCalculated": 7.75,
  ...
}

This means you should charge your customer $7.75 worth of tax for this sale!

4 Download an AvaTax SDK (Optional)

Avalara has a wide variety of available software development kits for major languages. If you are writing your own code in a supported language, the AvaTax software development kit will help you get up to speed quickly!

The AvaTax SDK contains a lot of useful features to make it quick and easy to begin using all of the world-class features built into AvaTax. Even better, all of our SDKs are fully open source and we welcome bug reports and pull requests to add new features!


What's Next?


We’re really proud of the world-leading AvaTax platform, and we hope you’ll have as much fun using it as we have fun building it! Here are some ideas for next steps:

  • Read our Developer Blog for up-to-date news and articles about the great features of AvaTax
  • Ready to upgrade to a production account? Please contact the sales department anytime and we'll be happy to help you out.
  • Want to develop a certified connector? Visit our Certified Avalara Integration page today and get started!
  • Want more information about all the great API features in AvaTax? Visit the online AvaTax API reference now!
  • Have a question about the API, or want to share your success story? Visit the AvaTax Developer Community and ask questions and share tips and tricks with other developers from around the world!