Skip to content
  • There are no suggestions because the search field is empty.

How to Migrate NetSuite Integration from Legacy to SuiteApp

Learn how to smoothly migrate your NetSuite integration from Legacy to SuiteApp to get advanced features like custom fields, multi-subsidiary support, and automatic payment pushes.

TABLE OF CONTENTS

Step 1: Contact the Customer Success Team

Before switching from Legacy to SuiteApp, make sure you gather and share the following configuration and list details with your Customer Success Manager:

  1. Confirm the status (enabled/disabled) of the following options in your current Precoro setup:
    • Use Item Vendor Code as SKU;
    • Enable Vendor Contact Mapping.
  2. Decide which NetSuite lists should be integrated with Precoro and shared through the SuiteApp. For each list, provide:
    • Sync scope: Should this list be imported from NetSuite and used in Precoro?
    • Assignment level: Is this list value applied on a document or item level in NetSuite?
    • Subsidiary coverage: Does this list apply globally, or is it different per subsidiary?

Here is the full list of supported objects:

Departments
Classes 
Locations
Chart of Accounts
Projects
Taxes
Classes
Customers
Billable Fields
Suppliers
Items
Custom Segments (specify which ones to include)

Once you share the required list and configuration details with your CSM, our Product Team will prepare the mapping files based on your inputs and send them back to you.

Step 2: Rename the Integration Records

Before the Precoro SuiteApp installation, you need to update the names of integration records in NetSuite to prevent duplications and avoid conflicts during the SuiteApp setup.

To rename the existing Precoro Integration:

  1. Go to Setup → Integration → Manage Integrations.

    Manage Integrations
  2. Open the Precoro Integration → click Edit.
  3. Change the “Precoro Integration” name to any other suitable option.
  4. Click Save to record the changes.

    Rename

 To rename the existing Precoro Integration Role:

  1. Go to Setup → Users/Roles → Manage Roles.

    Manage Roles-1
  2. Click Edit next to the Precoro Integration Role.
  3. Change the “Precoro Integration Role” name to any other suitable option.
  4. Click Save to record the changes.

    Rename Role

Step 3: Set Up the NetSuite SuiteApp Integration

Follow the steps below:

  1. Install Precoro SuiteApp in NetSuite.
  2. Retrieve integration credentials.
  3. Connect Precoro with NetSuite.
  4. Finalize the integration.

Step 4: Configure Global Settings in NetSuite

Once the SuiteApp connection is established, complete the following setup steps in your NetSuite account:

  1. Navigate to Precoro → Configuration → Integrations.

    Configuration
  2. Open the Global Settings tab.
  3. In the Other Settings section, enable the following checkboxes:
    • Import Item Vendor Code As SKU
    • Enable Vendor Contact Mapping
    • Integrate Billable Field
    • Sync Employee
  4. In the Sync New Records by Default section, select the checkboxes for each list you want Precoro to automatically sync when new records are created in NetSuite.

    Settings-1

Step 5: Set Preferred Transaction Form in NetSuite

To ensure transactions are processed through the correct form:

  1. Go to Customization → Forms → Transaction Forms.
  2. Open your desired form (previously used with the Legacy integration).
  3. Navigate to the Roles tab.
  4. Find the Precoro Integration Role → enable the Preferred checkbox.
  5. Click Save to apply the changes.

Step 6: Grant Access to Custom Segments (If Used)

If you plan to integrate Custom Segments, make sure that access to each relevant segment is granted to the new Precoro Integration Role in NetSuite.

Step 7: Import Required Lists via CSV

Once the setup is completed, you can start your NetSuite data migration to Precoro SuiteApp using CSV files. 

💡 Please note:  Migration of Taxes and Custom Segments via CSV is not supported.

To import the lists:

  1. Go to  Setup → Import/Export → Import CSV Records.

    Import
  2. Select the import and record types, character recording, CSV column delimiter, and other settings according to the instructions in the table below → upload your file.
List type Instructions
Vendor

Import file:

  • Columns: Internal ID, Sync to Precoro (2)
  • Encoding: Unicode (UTF-8)

Import settings:

  • Import type: Relationships
  • Record type: Vendors
  • Character encoding: Unicode (UTF-8)
  • CSV column delimiter: Semicolon
  • Import options: Update
Chart of Accounts

Import file:

  • Columns: Internal ID, Sync to Precoro
  • Encoding: Unicode (UTF-8)

Import settings:

  • Import type: Accounting
  • Record type: Chart of Accounts
  • Character encoding: Unicode (UTF-8)
  • CSV column delimiter: Semicolon
  • Import options: Update
Locations

Import file:

  • Columns: Internal ID, Sync to Precoro as Item Custom Field, Sync to Precoro as Company Location
  • Encoding: Unicode (UTF-8)

Import settings:

  • Import type: Classification
  • Record type: Location
  • Character encoding: Unicode (UTF-8)
  • CSV column delimiter: Semicolon
  • Import options: Update
Departments

Import file:

  • Columns: Internal ID, Sync to Precoro as DCF (2), Sync to Precoro as ICF (2)
  • Encoding: Unicode (UTF-8)

Import settings:

  • Import type: Classification
  • Record type: Department
  • Character encoding: Unicode (UTF-8)
  • CSV column delimiter: Semicolon
  • Import options: Update
Classes

Import file:

  • Columns: Internal ID, Sync to Precoro as DCF, Sync to Precoro as ICF
  • Encoding: Unicode (UTF-8)

Import settings:

  • Import type: Classification
  • Record type: Class
  • Character encoding: Unicode (UTF-8)
  • CSV column delimiter: Semicolon
  • Import options: Update

Items

(different item types will be in different separate imports)

Import file:

  • Columns: Internal ID, Sync to Precoro
  • Encoding: Unicode (UTF-8)

Import settings:

  • Import type: Items
  • Record type: Non-inventory Item for Purchase
  • Character encoding: Unicode (UTF-8)
  • CSV column delimiter: Semicolon
  • Import options: Update

💡 Please note: You can import Customers and Projects either together or separately, depending on how they’re structured in NetSuite. If they belong to different NetSuite lists, you can still use the same Precoro file, as their internal IDs are unique and won’t overlap.

Customers/Projects

Import file:

  • Columns: Internal ID, Sync to Precoro
  • Encoding: Unicode (UTF-8)

Import settings:

  • Import type: Relationships
  • Record type: Customers Only or Projects
  • Character encoding: Unicode (UTF-8)
  • CSV column delimiter: Semicolon
  • Import options: Update