Skip to main content

Avalara taxes in invoice item adjustments


Avalara taxes in invoice item adjustments

This feature is in Limited Availability. It is only available for Zuora's direct Avalara Integration. If you wish to have access to this feature, submit a request at Zuora Global Support

Adjusting an invoice item with a processing type of Charge or Discount will result in a charge invoice item adjustment. The Avalara Integration calculates taxes for charge invoice item adjustments through the Zuora UI and SOAP API. When you create charge invoice item adjustments in the Zuora UI, tax values are calculated by Avalara synchronously. Zuora records these taxes as invoice item adjustments. You can view these tax invoice item adjustments from the Zuora adjustment list after the charge invoice item adjustments are processed. For each charge invoice item adjustment, Zuora creates a corresponding invoice item adjustment for each tax item returned from Avalara.

When Avalara Integration calculates taxes for charge invoice item adjustments, Avalara might return an extra tax item with a 0% tax rate. Zuora validates all the tax items when creating invoice item adjustments, but this extra tax item is ignored during the tax item validation.

The following figure gives an example of the credit-type charge invoice item adjustment (IIA-00000174) and its tax invoice item adjustments (IIA-00000175 and IIA-00000176). 


You can also view the transaction details and tax items in Avalara. 



The limitations on calculating tax for charge invoice item adjustments are as follows:

  • Avalara controls all tax calculations, Zuora does not adjust tax line items.
  • When creating charge invoice item adjustments in a batch call, Zuora recommends you have up to five charge invoice item adjustments. A timeout error can occur if the communication between Zuora and Avalara takes more than two minutes.
  • When you use the SOAP API to create charge invoice item adjustments, Zuora does not support using the useSingleTransaction field on the CallOption object.

Cancel tax invoice item adjustments

Avalara controls all tax calculations. When you create charge invoice item adjustments in Zuora, tax invoice item adjustments are created automatically and are tied to their charge invoice item adjustments. To cancel a tax invoice item adjustment, you must cancel the corresponding charge invoice item adjustment.