Synchronize inline taxes with default tax code

You can set up a default tax code to be used for all invoice and credit memo line items to consolidate the taxation line item. This feature can be enabled regardless of the tax engine in use within Zuora. For external tax engines like Avalara, where tax regions and rates are not set up within Zuora, the external tax engine handles tax calculations and provides the necessary tax amounts, rates, and related information, allowing this feature to still be utilized in such scenarios.

To execute this synchronization, adhere to the following steps (that is, the sync logic):

1. Configure the default tax code in Zuora's connector UI under the NetSuite Default Tax Code section.
2. If a default tax code is specified, the connector will automatically assign it to each invoice or credit memo line item when processing invoices or credit memos from Zuora to NetSuite. The tax code in NetSuite will then apply the appropriate tax rate, sourcing the tax amount from Zuora's invoice line item or credit memo line item.
3. To activate the feature, go to the Zuora Connector UI and turn on the Sync Tax Amount with Line Items option.

Sync logic for region-specific tax code setup for Zuora tax engine

For steps on setting up region-specific tax code for Zuora tax engine, refer to Set up region-secifix tax code for Zuora tax engine.

• When transmitting tax codes based on tax description, if the internal ID of the tax code is found in Zuora's tax rate setup, send this tax code and its corresponding taxation amount to NetSuite without including tax rates in the payload.
• If the internal ID of the tax code is not provided, check if a default tax code is set in the settings UI page. If the default tax code is available, use it; otherwise, an error message gets logged.

• NetSuite ensures accurate tax information for US or Canadian subsidiaries by aggregating and displaying tax amounts at the invoice level rather than per line item. The total tax amount on the invoice will include the sum of taxes for each line item. NetSuite does not allow tax amounts to be displayed for individual line items on invoices and credit memos.
• The connector uses the Tax Rate Description field to retrieve tax codes. For historical invoices or invoices generated before the tax rate description was populated, tax codes will not be available, as taxation items do not retroactively update historical invoices. This may also affect credit memos generated from historical invoices or prorated charges. It is recommended that this feature be thoroughly tested before being enabled in production.
• Before enabling the feature, ensure that either your existing invoices are synced or historical data is excluded by setting cutover dates.

Integration with multiple tax engines: Avalara and Zuora

Integrating Zuora with multiple tax engines involves handling scenarios where invoices may contain tax items generated from different tax engines, such as Avalara and Zuora. In such situations, the connector can handle region-based tax codes for Z-Tax engine-based invoices and utilize default tax codes for Avalara or other external tax engine-based invoices.

Netsuite configuration for inline taxation

• Ensure proper integration in NetSuite by navigating to Advanced Taxes under Setup > Company > Enable Features.
• Ensure correct configuration of subsidiaries, nexus, and tax codes in NetSuite for tax compliance.
• To support the inline tax, ensure that PER LINE TAXES ON TRANSACTION is enabled in the US Nexus setup.
• Invoices may contain tax items from multiple tax engines, determined by specific logic like region-based rules.