Changes to External Suitelet URLs in NetSuite 2024.2

Starting in NetSuite 2024.2, the external URLs for Suitelets that are accessible without login have been updated. The new format incorporates an &ns-at= parameter, which followed a new value. This modification, effective from May 9, 2024, necessitates that administrators and developers update any hard-coded links to maintain functionality.

What Changed

The following changes are significant:

The external URLs now utilize the &ns-at= format instead of the previous &h= parameter, which is important for ensuring continued access to Suitelets.
This new URL format is displayed in the External URL field on the script deployment record.

Implications of the Change

It is essential to recognize that:

All hard-coded URLs are affected. Any existing hard-coded links must be identified and updated to the new format to avoid broken links within the system and external websites.
Automated URLs that utilize methods like url.resolveScript(options) are not impacted, as these will adapt to the new format automatically.

Where to Find Hard-Coded URLs

Hard-coded URLs may exist in various locations:

Scripts and HTML files within your account.
Script parameters and settings.
External systems that may be retrieving information or triggering Suitelets.
Website links that direct users to specific Suitelets.
Search engines may also list Suitelets that are used as public-facing web pages.

Example of URL Change

The previous format that could lead to broken links is:

/app/site/hosting/scriptlet.nl?script=123&deploy=123&h=ABCDFEFGHIJKLMNOPRSTUV

This should be updated to the new format:

/app/site/hosting/scriptlet.nl?script=123&deploy=123&ns-at=KLMNOPRSTUVABCDFEFGHIJ

By making these adjustments, you will ensure that all link integrations function correctly and continue to direct users to the appropriate Suitelet.

Who This Affects

These changes primarily impact:

Administrators responsible for managing Suitelet configurations.
Developers who have embedded Suitelet links within their applications or scripts.
Webmasters maintaining external websites that reference Suitelets.

Key Takeaways

Suitelet URLs have been updated as of May 9, 2024, in NetSuite 2024.2.
Existing hard-coded URLs must be updated to the new format to prevent access issues.
Automated URL resolutions do not require changes, ensuring smoother transitions for developers.
Review all scripts, HTML files, and external references to identify and correct outdated links.