Skip to main content

Inline Taxation for Invoices and Credit Memos


Inline Taxation for Invoices and Credit Memos

This feature enables the syncing of taxes inline with invoice and credit memo line items in NetSuite instead of the default behavior of syncing tax line items separately. This enhancement facilitates better tax reporting in NetSuite by ensuring taxes are synced inline for both invoices and credit memos. It addresses various user personas and their specific needs in terms of tax synchronization and configuration. Here’s a detailed explanation of the key points:

Synchronize Inline Taxes with Default Tax Code in NetSuite

NetSuite guarantees accurate tax amount population in invoice line items by mandating tax code and tax rate fields. Zuora's UI facilitates passing a default tax code to meet these requirements.

Sync logic

To execute this, check whether the following instructions are met.

  • Ensure a default tax code is set when populating tax amounts for NetSuite invoice line items, irrespective of the region. Configure this default tax code in Zuora’s connector UI labeled NetSuite Default Tax Code.
  • When processing invoices from Zuora to NetSuite:
    • The connector automatically assigns a default tax code to the invoice or credit memo line items if a default tax code is provided. The tax code in NetSuite will apply the tax rate, sourcing the amount from Zuora’s invoice line item.
    • If a default tax code is not set, you can configure it in the settings UI through an error message. To enable this feature, go to the Zuora Connector UI and enable the Sync Tax Amount with Line Items feature.

Integration with External Tax Engines like Avalara

The integration approach for external tax engines such as Avalara with Zuora focuses on handling tax code configurations and ensuring compatibility with NetSuite.

Sync logic

  • Tax regions and rates are not set up in Zuora. Instead, an external tax engine like Avalara handles tax calculations and provides tax amounts, rates, codes, and related information.
  • Tax codes like those in Avalara for NetSuite may not align with Zuora regions. However, you can configure the default tax code in the settings page. When utilizing external tax engines such as Avalara, the emphasis is on configuring NetSuite tax codes separately from Zuora regions.
  • If a tax engine other than Zuora’s internal tax engine is used, send the default tax code from the settings page to NetSuite.
  • Use the default tax code from Zuora’s settings page for tax transactions sent to NetSuite.

Region-specific Tax Code setup for Zuora Tax Engine

The focus of integrating Zuora’s Tax Engine with NetSuite is to map tax codes by region and ensure accurate tax amount synchronization. This integration will enable the transmission of region-based tax codes to NetSuite.

To execute this, adhere to the following instructions.

  1. Setup in Zuora:
    1. To set up the Tax Code, go to Billing > Setup Tax Code in Zuora > Zuora Tax engine setup.
    2. Add the internal ID of the tax code for each region in the tax rate description field.
    3. Ensure that every tax rate setup has the appropriate internal ID for the region, as the sync process in the integration layer does not verify this.
    4. When multiple tax rates are in a single tax region in Zuora, the internal ID must be included in all levels of tax rate setup.
    5. Ensure all tax line items on an invoice match the tax codes and rates set up in Zuora and NetSuite when multiple tax line items exist.
    6. Choose to activate Sync Tax Amount with Line Items and Region-Based Tax Code from the Netsuite connector UI page. 
  2. Setup in NetSuite:
    1. Configure tax codes in NetSuite to align with Zuora’s tax rates by region.
    2. To account for multiple tax rates within a single tax region, the tax code in NetSuite should reflect the combined total of these rates, including state and county taxes.

Sync logic

  • 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.

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.