Serversync Touchpoint

This topic applies to

Applies to

SuiteCommerce Advanced


This information refers to the Mont Blanc release of SuiteCommerce Advanced and later.

You can customize your implementation of SuiteCommerce Advanced to use the serversync touchpoint. This touchpoint maintains the identity of the user and cart contents when a user opens items in other tabs or windows. This is useful during email marketing campaigns, when users open a separate instance of the application from a link in an email.

Using the serversync touchpoint requires customizing your implementation of SuiteCommerce Advanced to extend or override the following SuiteCommerce Advanced source files:

  • CheckoutApplication@X.X.X\SuiteScript\checkout.environment.ssp

  • Header@X.X.X\JavaScript\Header.Profile.View.js

  • ProductList@X.X.X\SuiteScript\ProductList.Model.js

  • Profile@X.X.X\SuiteScript\Profile.Model.js


Making changes to core JavaScript source files or changing any vital functionality of the application can make migrating to future releases difficult. Before making changes to SuiteCommerce Advanced, see Customize and Extend Core SuiteCommerce Advanced Modules and Best Practices for Customizing SuiteCommerce Advanced

In the case of the serversync touchpoint, NetSuite has provided a customization patch that you can use.


If you have already made customizations to your implementation of SuiteCommerce Advanced, use caution when applying these custom modules.

To apply the serversync touchpoint custom modules:

  1. Click the link to download the serversync zip file.

  2. Extract the files, then place the Serversync directory and all contents in the Modules > extensions directory for your implementation of SuiteCommerce Advanced.


    If you have already made customizations to the checkout.environment.ssp SuiteScript file in the CheckoutApplication@X.X.X module, run a diff between the new custom version of checkout.environment.ssp and your existing override, incorporate NetSuite’s customizations into your custom module, and remove the EnvironmentCustom@1.0.0 folder from your new Serversync directory.

    Customizations you have made to the Header, ProductList, and Profile modules are only affected if you have modified the same methods and properties that have been extended in this patch. Run a diff on the appropriate files and, if you have made customizations in the same methods and properties, incorporate NetSuite’s changes into your custom module.

  3. Go to Modules > extensions > Serversync to locate the distro.json provided with the patch.

  4. Open the new distro.json file and locate the appropriate Serversync entries for CheckoutApplication, Header, ProductList, and Profile.

  5. Copy the Serversync entries and paste them into the list of modules in your existing distro.json file.


    If you have already made any customizations to the CheckoutApplication module, or customizations to the same methods and properties of the Header, ProductList, or Profile modules in your implementation of SuiteCommerce Advanced, do not use the Serversync entries from the new distro.json.

  6. Open a command prompt from your source directory and deploy to NetSuite.


    Since these customizations modify files stored as SSP libraries, changes are not visible in your local environment. You must deploy your custom modules directly to NetSuite. See Deploy to NetSuite for more information.