Skip to main content

NetSuite SuiteTax Overwrite Instructions for Release 2024.1


NetSuite SuiteTax 2024.1, released in January 2024, is a cloud-based solution designed to automate and simplify sales and use tax compliance for businesses of all sizes. Here's an overview of its key features and benefits:

  • Automated tax calculation and filing: Streamline your tax processes by automatically calculating and filing sales and use tax based on real-time tax rates and regulations.
  • Support for multiple tax jurisdictions: Manage tax compliance across various locations with built-in support for different tax rules and regulations in various countries, states, and localities.
  • Real-time tax rate updates: Ensure accurate calculations with automatic updates for tax rates, eliminating the need for manual adjustments.
  • Integration with NetSuite ERP: Seamlessly integrate SuiteTax with your existing NetSuite ERP system for a unified view of your financial data and tax obligations.

Instructions for NetSuite SuiteTax Users

With the release of NetSuite 2024.1, NetSuite accounts utilizing Nova Module's Tax Calculations SuiteApp (Bundle ID 310634) will need to update their configuration for continued functionality.

NetSuite Configuration

Activate the Script:

  • Navigate to Customization > Scripts.
  • In the Filters, select Bundle as Numbers.
  • Locate the script "Novamodule SuiteTax Overwrite" (which will appear inactive).
  • Open the script record. Uncheck the checkbox to activate the script.

Change Script Novamodule SuiteTax Overwrite to Active.png

Deployment Verification:

  • Within the "Novamodule SuiteTax Overwrite" script record, navigate to the Deployment section.
  • Ensure the script is applied only to specific records(Example: Sales Order, Invoice, Cash Sale, Return Authorization, Cash Refund, Credit Memo)
  • If you find any other record types selected (e.g., Sales Order, Invoice, Cash Sale), remove them.

Applies to Transactions Deployment Tab.png

Celigo Configuration

  • Celigo IO mappings:
    • Configure the Celigo IO mappings for Integration App flows handling NetSuite system imports. Ensure the script is deployed for the NetSuite imports records in the Deployment verification.
  • Mandatory Mappings:
    • Update the relevant mappings in the specified mapping sections.
    • The following are the standard mappings apply:
      • Custbody_nm_netsuite_suitetax is set to "T"
      • taxregoverride is set to "T"
      • taxdetailsoverride is set to "T"
    • The following are the client specific mappings apply:
      • Custbody_nm_taxtype: This field determines which tax type will be mapped to the corresponding NetSuite record.
      • Custbody_nm_taxbasis: This field defines which tax base will be mapped to the corresponding NetSuite record.
      • Custbody_nm_taxcode_id: This field specifies which tax code will be mapped to the corresponding NetSuite record.
      • Nexus: This field indicates which nexus code will be mapped to the corresponding NetSuite record.
  • The following is the API specific mappings apply:
    • item[*].custcol_nm_item_tax_amount: This field specifies which item tax amount  will be mapped to the corresponding NetSuite record on the line item level.
Value Field Name
"T" custbody_nm_netsuite_suitetax
“8” custbody_nm_taxtype
“10” custbody_nm_taxbasis
“1052” custbody_nm_taxcode_id
line_items[*].tax item[*].custcol_nm_item_tax_amount
“18” nexus
"T" taxregoverride
"T" taxdetailsoverride


Celigo Integrator Mappings.png

Note: On adding the Use Dynamic Mode to true, please make sure to add the items mappings in the order as mentioned below

  1. Items : Item (InternalId)
  2. Items : Quantity
  3. Items : Price Level (InternalId)
  4. Items : Rate
  5. Items : Amount

Celigo Integrator Item Line Level Mappings.png