---
title: "Setting up NetSuite Legacy Tax"
description: "The NetSuite Legacy Tax SuiteApp, by Nova Module, connects TaxCloud to NetSuite's Legacy Tax engine. It calculates sales tax in real time on your NetSuite transactions and sends completed sales to TaxCloud for reporting and filing."
canonical_url: "https://support.taxcloud.com/articles/setting-up-netsuite-legacy-tax-vU9w1rx3uD"
md_url: "https://support.taxcloud.com/articles/setting-up-netsuite-legacy-tax-vU9w1rx3uD.md"
---
# Setting up NetSuite Legacy Tax

The NetSuite Legacy Tax SuiteApp, by Nova Module, connects TaxCloud to NetSuite's Legacy Tax engine. It calculates sales tax in real time on your NetSuite transactions and sends completed sales to TaxCloud for reporting and filing.

Nova Module, a NetSuite SDN partner, built the SuiteApp and installs it in your NetSuite account. This article covers what the integration does and the part you set up in TaxCloud. For everything inside NetSuite, see [Nova Module's guides](https://help.novamodule.com/hc/en-us/sections/41814809630743-TaxCloud-NetSuite-SuiteApp).

## How the integration works

Once the SuiteApp is set up, your team keeps working in NetSuite as usual. Here's what each record does in TaxCloud:

| In NetSuite | What happens in TaxCloud |
|----|----|
| **Sales Order** | Tax is calculated in real time. Nothing is recorded for filing yet. |
| **Invoice or Cash Sale** | Tax is calculated, and saving the transaction records the sale for reporting and filing. |
| **Cash Refund or Credit Memo** | The refund is recorded and reduces your tax liability. |
| **Customer record** | Shipping addresses are verified, and exemption certificates are created and applied to the customer's transactions. |

TaxCloud then tracks your nexus and handles registrations, filing, and remittance.

## Before you begin

* **NetSuite Legacy Tax:** The SuiteApp works with NetSuite's Legacy Tax engine. It doesn't support SuiteTax.
* **TaxCloud Premium plan:** The integration requires a Premium plan.
* **Nova Module onboarding:** Nova Module installs and configures the SuiteApp as part of a required onboarding package. You can't install it yourself. Contact TaxCloud Sales to get started; your onboarding team coordinates the handoff to Nova Module.

## Step 1: Create the connection in TaxCloud


1. In TaxCloud, go to the **[Integrations](https://app.taxcloud.com/go/integrations)** page.
2. Click **Add Connection**, then select **NetSuite Legacy Tax**.

   ![NetSuite Legacy Tax tile on the Add Connection page](https://support.taxcloud.com/api/attachments.redirect?id=27a45e8d-7880-40cc-a294-6cb4e3d316eb " =780x178")
3. In the top-right corner, click **Add**.

   ![NetSuite Legacy Tax details page with the Add button](https://support.taxcloud.com/api/attachments.redirect?id=6ec92136-ebb6-4774-a730-ac01dd5c001b " =800x118")
4. Configure the connection:

   
   1. Set a **Name** for the connection.
   2. Set the **URL** for your NetSuite account.
   3. Set the default **Taxability Information Code (TIC)**. TaxCloud uses this TIC for any item that doesn't have its own. [Read more about TICs.](/articles/taxcloud-taxability-information-codes-tic-U1KLuHTyNq)

   ![Connection setup form with name, URL, and default TIC](https://support.taxcloud.com/api/attachments.redirect?id=12d6f11f-a4e1-49cb-989f-42dc477fc63b " =480x358")
5. Click **Finish Setup**.
6. On the connection's page, note the **Connection ID**. The **Manage API Keys** button you need in Step 2 is in the same section.

   ![TaxCloud API section showing the Connection ID and Manage API Keys button](https://support.taxcloud.com/api/attachments.redirect?id=7a3758ad-0f42-4267-bf69-617889146a34 " =760x94")

## Step 2: Create an API key

The SuiteApp needs an API key along with the Connection ID.


1. On the connection's page, click **Manage API Keys**.
2. Create a new API key and copy it. Store it somewhere secure.

## Step 3: Nova Module installs and configures the SuiteApp

[Nova Module](https://help.novamodule.com/hc/en-us/sections/41814809630743-TaxCloud-NetSuite-SuiteApp) installs the SuiteApp and connects it to TaxCloud using your **Connection ID** and **API key**. They then set up the rest of the integration with you: shipping method mappings, TICs on your NetSuite items, and exempt customers.

## Step 4: Test the integration

Before going live, test the integration with Nova Module, ideally in a NetSuite sandbox. Your onboarding team and Nova Module will work out the right test setup with you.

* **Testing in a sandbox:** Create a separate TaxCloud connection for it (repeat Steps 1 and 2) and leave it in **Test** mode. Test transactions aren't counted toward your tax obligations.
* **What to test:** Your real scenarios, such as your customers, items, shipping methods, an exempt customer, and a refund. Check the results on the TaxCloud [Transactions page](https://app.taxcloud.com/go/transactions).

## Step 5: Go live


1. When testing is complete, Nova Module points the SuiteApp in production NetSuite at your production connection.
2. Open your production connection in TaxCloud and click **Go Live**. Until you do, transactions from that connection aren't included in your reporting and filing.

   ![Connection header with the Test badge and Go Live button](https://support.taxcloud.com/api/attachments.redirect?id=0193ea5a-c7f4-43db-9a69-59014faf497b " =630x54")
3. Review your first few production transactions on the [Transactions page](https://app.taxcloud.com/go/transactions) to confirm tax looks right.

## Getting help

Contact [TaxCloud Support](https://support.taxcloud.com/articles/how-to-contact-taxcloud-2kOI9DHHRK) first for questions about the integration, tax calculations, or your TaxCloud account. If the issue is with the SuiteApp in NetSuite, we'll bring in Nova Module.
