Calculate tax for charge
This section provides a detailed mapping of Zuora's data fields to Avalara's fields for tax calculation, including examples and considerations for currency and tax mode settings.
Mapping details
The following mapping table shows how Zuora's data fields are used in Avalara to calculate the tax of a normal charge.
For example,
TaxRequest.DocCode
in Avalara is mapped to
Invoice.ID
in Zuora. The mapping to a Constant Component in Zuora means that the data field in Avalara will always be set to the same value. For example, the value of
TaxRequest.Commit
in Avalara is always set to
TRUE
.
By default, the account-level currency is always linked to the currency code in the tax request for Direct Avalara Integration. If you have enabled the Multiple Currencies feature, the currency at the billing document level, including invoices, credit memos, and debit memos, is used for this mapping.
|
Avalara Object |
Avalara Field |
Avalara Nested Field |
Zuora Component |
Zuora Field |
|---|---|---|---|---|
|
CreateTransaction |
DocCode |
Invoice |
ID or InvoiceNumber. See this article for information on how the system determines which field to use. | |
|
DocDate |
InvoiceDate | |||
|
CurrencyCode |
Billing documents, including invoices, credit memos, and debit memos |
Currency | ||
|
CustomerCode |
Account |
ID | ||
|
Commit |
Constant |
isPreview? FALSE: TRUE If it’s a preview, the status is FALSE; if not, it’s TRUE. | ||
|
DocType |
isPreview? SalesOrder: SalesInvoice If it's a preview, the document type is a Sales Order; otherwise, it's a Sales Invoice. | |||
|
DetailLevel |
Tax | |||
|
shipTo |
Contact | |||
|
Country |
Country | |||
|
City |
City | |||
|
Region |
State | |||
|
PostalCode |
PostalCode | |||
|
Line1 |
Address1 | |||
|
Line2 |
Address2 | |||
|
shipFrom |
Company | |||
|
Country |
Country | |||
|
City |
City | |||
|
Region |
State | |||
|
PostalCode |
PostalCode | |||
|
Line1 |
Address1 | |||
|
Line2 |
Address2 | |||
|
Amount |
ChargeAmount. If tax mode is inclusive, it is chargeAmount + taxAmount. | |||
|
TaxIncluded |
TaxMode. Validate if the TaxMode is TaxInclusive or not. | |||
|
ExemptionNo |
TaxExemptCertificateID | |||
|
CustomerUsageType |
Account.TaxExemption |
TaxExemptEntityUseCode | ||
|
BusinessIdentificationNo |
VATId | |||
|
TaxCode |
TaxCode.ExternalTaxCode |
ExternalTaxCode. The Avalara Tax Code configured in Zuora Billing. See this article for more information. | ||
|
ItemCode |
TaxCode | |||
|
Ref1 |
N.A. |
N.A. |
N.A | |
|
Ref2 |
N.A. |
N.A |
N.A | |
|
Line.TaxOverride |
TaxOverrideType |
n/a |
n/a | |
|
Reason |
n/a |
n/a | ||
|
TaxDate |
n/a |
n/a | ||
|
TaxAmount |
n/a |
n/a |