Avalara Developer Network Developer blog

AvaTax API 17.6 Patch Notes

This article is about the June 2017 monthly update to the AvaTax REST v2 API.

Environment URL Release Date
Sandbox https://sandbox-rest.avatax.com 2017-06-22
Production https://rest.avatax.com 2017-06-27

New Tax Type Supported: Telecommunications Taxes

Avalara is proud to announce the preview release of integrated telecommunications tax calculation for customers using AvaTax. The telecommunications tax domain handles a wide variety of taxes and fees for customers selling phones, conference calling services, internet access, and many other product and service types. Customers interested in developing communications tax connectors or working with Avalara for communications tax calculation should contact their customer account manager for more details.

New API: Transactions for Multi-Company Marketplace Vendors

In the June release, AvaTax introduces the multi-company transaction shortcut. This shortcut is intended to simplify the conversion of a complex multi-party transaction into multiple two-party transactions for reporting purposes. When using this API, you can divide up a single transaction between different selling companies and different reporting locations line-by-line. This shortcut makes it possible to generate multiple transactions more rapidly.

This API is intended to help companies with multi-vendor marketplaces, and companies categorizing consumer use tax between multiple reporting locations. Before this API was introduced, you would have to create each transaction separately with a distinct API call for each seller/buyer pair.

For companies operating a marketplace which connect sellers and buyers, a key competitive advantage is the ability to allow a customer to purchase things from a large number of sellers at once. It can be time consuming to split up a single transaction (from the buyer’s perspective) into multiple transactions (from the seller’s perspective) in order to report them correctly on your tax returns.

For companies needing to allocate consumer use tax, you can now designate reporting locations for each individual line on a purchase invoice. This allows you to purchase a large number of products at once from a vendor, and allocate each line to a different field office for reporting purposes.

TaxContent API Name Change

The AvaTax TaxContent API (formerly known as the point-of-sale API) has been renamed in order to emphasize that it is useful for a variety of companies who need tax content for other purposes. The API functionality remains the same.

Updated field on TransactionModel

For consistency of naming between the CreateTransactionModel and the TransactionModel objects, we have unified the naming of the field reportingLocationCode. The name “Reporting Location Code” was chosen because it better communicates the function of the field - it allows companies who perform location-based filing to select the location-based tax return on which a transaction will be reported.

The old field, locationCode, will continue to exist but has been deprecated. Please adjust your code to use reportingLocationCode.

Returns Functionality Improvements

A variety of improvements to the returns filing functionality in AvaTax:

  • New Filing Status API
  • Improved functionality for tax notice modifications
  • Clearer error messages for filing calendar changes
  • Compliance users may create filing calendars for broader time periods
  • Fixed an issue that caused filing attachments to be incorrectly hidden from the UI
  • Other bugfixes on notices and updating adjustments

Other Bugfixes and Improvements

  • Significant performance improvements for fetching large volumes of transactions.
  • It is now possible to call CreateOrAdjustTransaction on a transaction that was previously cancelled. Doing so will create a new transaction with a code matching the old transaction's code.
  • Activating your account using the ActivateAccount API now triggers a welcome email.
  • The fields FirstName and LastName on UserModel are now required.
  • Improvements to the Address Resolution API behavior for jurisdictions with complex taxability.
  • Documentation for the Free TaxRates APIs updated.
  • Calling CreateTransaction using a SalesOrder transaction type now correctly preserves the ItemCode and Quantity fields.
  • Improved error messages when calling CreateNexus. If you use the LocalNexusTypeId or HasLocalNexus values on the NexusModel object, you will receive an error if they are incorrectly configured.
  • When using the SetAccountConfiguration API, you will receive an error message if you attempt to set a taxability override code to a value that conflicts with a system code.
  • It is no longer possible to CreateUser for a user with a role of "CompanyAdmin" or "CompanyUser" without correctly assigning them to a company.
  • Fixed many unhandled exceptions for various edge cases.

– Ted Spence, Director, AvaTax Core Engine

Back to posts