SuiteScript 2.1 wordt verplicht: wat betekent dat voor jouw NetSuite-omgeving?

Vanaf release 2028.2 draait NetSuite alleen nog maatwerkscripts die op SuiteScript 2.1 zijn gebouwd. Scripts in SuiteScript 1.0, 2.0 of 2.x stoppen dan met werken. Oracle heeft dit aangekondigd in de NetSuite Help Center en voert de overgang gefaseerd in.

Dat klinkt ver weg. Toch merk je de eerste gevolgen al eerder, en een NetSuite-omgeving die een paar jaar meegaat heeft vaak meer oude scripts dan iemand denkt. In deze blog lees je wat er verandert, wanneer en wat je nu al kunt doen.

Het tijdpad: niet alleen 2028.2

De einddeadline is 2028.2, maar voor scripts in 2.0 of 2.x verandert het gedrag al een release eerder. Vanaf 2028.1 voert NetSuite die scripts standaard uit als SuiteScript 2.1, ook als je zelf niets aanpast.

Waarom 2028.1 telt: de functies in SuiteScript 2.0 en 2.1 zijn grotendeels gelijk, maar 2.1 draait op een andere JavaScript-engine. Daardoor werken sommige onderdelen net anders. Een script dat technisch blijft draaien, kan dan toch een verkeerde uitkomst geven.

Welke scripts worden geraakt?

Alles wat in jouw account draait op SuiteScript 1.0, op 2.0 of met de annotatie @NApiVersion 2.x. Dat zijn niet alleen scripts die je bewust hebt laten bouwen. Denk ook aan:

• maatwerk van een vorige partner, een freelancer of een oud-collega
• bundles en oudere add-ons die ooit zijn geïnstalleerd
• scripts die niemand meer gebruikt, maar die nog wel actief staan

Voor SuiteScript 1.0 is Oracle duidelijk: die scripts moeten worden omgezet naar 2.1. Bij 2.0 en 2.x is de stap vaak kleiner. Daar volstaat soms testen en de annotatie aanpassen.

Wat je nu al kunt doen

Je hoeft niet morgen alles om te bouwen. Wel is het slim om nu overzicht te krijgen, zodat je de omzetting kunt plannen in plaats van er in 2028 door verrast te worden.

1. Breng in kaart wat er draait. In NetSuite kun je scriptrecords filteren op versie. Zo zie je welke scripts op 1.0, 2.0 of 2.x staan.
2. Ruim op. Scripts die niet meer gebruikt worden, dubbel zijn of niets meer doen, kun je uitzetten. Dat scheelt werk bij de omzetting. Lastig is wel dat NetSuite niet laat zien of een script nog echt wordt gebruikt. Dat een script actief staat, zegt daar weinig over.
3. Test je 2.0- en 2.x-scripts. Met een instelling op accountniveau kun je die scripts in de 2.1-omgeving laten draaien. Doe dat in een sandbox of Release Preview, niet in productie. Werkt alles, dan pas je de annotatie aan naar 2.1.
4. Plan de omzetting van 1.0-scripts. Dat is echt herschrijven. Begin met de scripts die je bedrijfsprocessen raken, zoals facturatie, orderverwerking en koppelingen.

Cadran helpt NetSuite-gebruikers bij elke stap van deze overgang. We brengen samen met je in kaart welke scripts op een oude versie draaien en wat ze doen. Daarna testen we de 2.0- en 2.x-scripts en zetten we 1.0-scripts om naar 2.1, zodat je de overgang plant op een moment dat jou uitkomt.