SuiteCommerce 2024.1.x Minor Releases: CMS Lazy Load Changes, third_parties Folder Move, and CLI Update
Three minor SuiteCommerce releases (2024.1.1, 2024.1.2, 2024.1.30) introduce mandatory CMS page lazy loading, relocate the third_parties source folder, bump SuiteCloud CLI to 1.9.0, and fix PayPal redirects, 3D Secure parameter forwarding, and gulp build errors.
Oracle shipped three minor releases under the 2024.1 SuiteCommerce branch. This page covers 2024.1.1, 2024.1.2, and 2024.1.30. The most impactful changes are the forced lazy-loading of all CMS Page Type scripts and the relocation of the third_parties folder in SuiteCommerce / SCA source.
Versioning change (2024.1.30)
Minor releases now use a tens-based numbering scheme. What would have been 2024.1.3 is instead 2024.1.30, leaving room for hotfix point releases (e.g., 2024.1.31) between minor releases. No code impact, but update any automation that parses version strings.
What changed
2024.1.30
third_partiesfolder relocated — Thethird_partiesdirectory in SuiteCommerce and SCA source has been moved to avoid maintaining two separate Git repositories for the same application. If your gulp tasks, CI pipelines, or custom build scripts reference the old path (e.g.,third_parties/require.js/2.3.6), they will break.- SuiteCloud CLI updated to 1.9.0 — If you pin CLI versions in
package.jsonor CI images, update to@oracle/suitecloud-cli@1.9.0. - PayPal redirect fix — Customers paying an invoice via PayPal are now correctly sent to the Payment and Review page instead of the My Account page.
- Negative deposit display fix — Deposit subtotals now render as
-$1.00instead of$-1.00.
2024.1.2 — CMS Lazy Load overhaul
- All CMS Page Type custom record scripts are now lazy loaded unconditionally. The
CMS Pages Lazy Loadtoggle on the SuiteCommerce configuration record (Integrations > Site Management Tools) has been removed. You can no longer opt out of lazy loading. - Store Manager role elevated permissions — CMS Page Type custom records now run with the Store Manager role's elevated permissions without requiring login. Custom records need Create or higher permission for the Store Manager role to render on Commerce sites.
- If pages still do not display after the update, you must manually add the Store Manager role to any custom records you created: Customization > Lists, Records, & Fields > Record Types, select the record, go to the Permissions tab, add Store Manager at Create level or higher.
2024.1.1
- POST instead of GET for purchase cancellations — Cancellation requests are now sent via POST. If you have middleware, proxy rules, or SuiteScript user-event scripts that inspect cancellation traffic by HTTP method, update them.
- 3D Secure fixes — Required GET parameters are now correctly forwarded in the redirect URL sent to payment gateway partners after a 3D Secure challenge. Quote payments with 3D Secure now redirect to the confirmation page as expected.
- Gulp build fixes — Resolved
gulp release sdf_releaseerrors (file referenced by attribute file is missingand async completion failures) and a jQuery-bxslider compilation error. - Theme Customizer fix — The Theme Customizer now renders correctly when using Site Management Tools.
- Icons/fonts fix — Some SCA deployments were missing icons and fonts; this has been corrected.
What to do
- Update build paths. Search your gulp tasks, CI configs, and any custom scripts for references to the old
third_partiesfolder path. Update them to the new location after pulling the 2024.1.30 source. - Upgrade SuiteCloud CLI. Run
npm install @oracle/suitecloud-cli@1.9.0(or the equivalent global install) in your development and CI environments. - Audit custom record permissions. If you created custom records linked to CMS Page Types and pages are not rendering, add the Store Manager role at Create level or higher on each custom record's Permissions tab. This does not apply to NetSuite-native or third-party extension custom records.
- Remove references to the CMS Pages Lazy Load setting. Any SuiteScript or integration code that reads or writes the lazy-load configuration flag on the SuiteCommerce configuration record should be removed — the setting no longer exists.
- Review cancellation handling. If you have user-event scripts, RESTlets, or reverse proxies that distinguish cancellation requests by HTTP method, update them to expect POST instead of GET.
- Test 3D Secure payment flows. If you use 3D Secure with quotes or invoices, run end-to-end tests to confirm the redirect and parameter forwarding fixes apply correctly in your environment.
Source: Oracle NetSuite Release Notes