Avalara Developer Network Developer avaTax

Exempt Transactions

Handling sales tax exempt customers in your integration

Depending on how you store your customer information, there are several ways you can manage your customer’s exempt status. Here are all of the methods available, arranged in order of detail capability.

Directly in the GetTaxRequest

  • ExemptionNo
    • You can find this in the GetTaxRequest at the document and line level. Sending any value in this field will flag the transaction as exempt. This may be the easiest of the methods, but it doesn't provide any backing information to explain the exemption in an audit. That would need to be managed manually by the user.
  • CustomerUsageType (Entity/Use Codes)
    • This is also available in the GetTaxRequest at the document and line levels. It allows you to exempt a transaction by passing a pre-coded exemption reason (see values below), or you can create custom reasons with custom rules on the AvaTax Website. This at least provides a way of explaining the reason for the exemption, but any certificates will still be managed manually by the user.

Automating Certificate Management

  • AvaTax Exemption Certificate Management System (ECMS)
    • This is a certificate management tool available to all customers on the AvaTax Website. Certificates are imported to AvaTax directly as placeholder records for a real certificate maintained by you on file. Certificates are matched to the CustomerCode in the GetTaxRequests, and transactions are exempted where appropriate.
  • Avalara CertCapture API
    • This is an add-on product that independently manages your exemption certificates. It allows you to store certificate images, send certificate requests to your customers (individually or in batches), and allows your customers to fill out certificate information directly through a wizard which results in an actual certificate. Certificates are matched to customer codes (and states applicable, and date ranges) on GetTaxRequests, and transactions are exempted where appropriate. This is not automatically included with AvaTax and would need to be purchased separately.

CustomerUsageType values

CustomerUsageType (or Entity/Use Code) is a value that can be passed at the document or line level of a tax request, and identifies the customer within a group. Frequently, it is used to mark a customer as fully or partially tax exempt. To that end, there are pre-populated customer taxability profiles present in the AvaTax system with rules for the United States and Canada:

  1. Federal government (United States)
  2. State government (United States)
  3. Tribe / Status Indian / Indian Band (both)
  4. Foreign diplomat (both)
  5. Charitable or benevolent org (both)
  6. Religious or educational org (both)
  7. Resale (both)
  8. Commercial agricultural production (both)
  9. Industrial production / manufacturer (both)
  10. Direct pay permit (United States)
  11. Direct mail (United States)
  12. Other (both)
  13. Not Used
  14. Local government (United States)
  15. Not Used
  16. Commercial aquaculture (Canada)
  17. Commercial Fishery (Canada)
  18. Non-resident (Canada)

MED1. US Medical Device Excise Tax with exempt sales tax MED2. US Medical Device Excise Tax with taxable sales tax

You can modify the behavior of these codes (and create your own codes) with tax rules in the AvaTax Website.

Note that you only need to pass the single-letter code as the CustomerUsageType to trigger the exemption behavior.