NetSuite stopt met SOAP Web Services: tijdlijn en migratieplan

Wat er verandert en waarom het je raakt

De meeste NetSuite-gebruikers denken niet dagelijks na over het protocol waarmee hun integraties draaien. Dat hoeft ook niet, zolang alles werkt. Maar achter de schermen is er iets fundamenteels aan het veranderen. Oracle heeft besloten om SOAP Web Services, jarenlang de ruggengraat van veel NetSuite-koppelingen, volledig uit te faseren. En de eerste mijlpalen liggen dichterbij dan veel organisaties beseffen.

Voor bedrijven die orders automatisch laten doorstromen naar hun ERP, voorraadstanden synchroniseren met een webshop of facturatiedata uitwisselen tussen systemen, is dit het moment om te inventariseren hoe hun koppelingen technisch zijn opgebouwd. In dit artikel zetten we uiteen wat er verandert, waarom Oracle deze keuze maakt, waar REST concreet beter presteert en hoe je de migratie gestructureerd aanpakt zonder je dagelijkse operatie te verstoren.

De tijdlijn: drie jaar om te migreren

Oracle hanteert een gefaseerd schema dat organisaties ruim de tijd geeft, mits ze er tijdig mee beginnen. Het startpunt is NetSuite versie 2025.2: dat is het laatste geplande SOAP endpoint. Na die release stopt Oracle met het standaard meegeven van nieuwe SOAP-versies bij elke update.

Concreet betekent dit het volgende:

2026.1 release verwacht Oracle dat alle nieuw te bouwen integraties op REST draaien, bij voorkeur met OAuth 2.0 authenticatie. Bestaande SOAP-koppelingen blijven op dat moment gewoon functioneren, maar nieuwe mag je niet meer op SOAP bouwen.
2027.1 release, wordt die grens hard: het is dan technisch niet meer mogelijk om nieuwe SOAP-integraties aan te maken.
2027.2 ontvangt alleen het 2025.2 endpoint nog bugfixes; alle oudere versies worden niet meer onderhouden.
2028.2 release verdwijnt SOAP definitief uit het platform. Koppelingen die op dat moment nog op SOAP draaien, stoppen met functioneren.

Het is dus geen kwestie van een plotselinge uitschakeling, maar een weloverwogen pad met duidelijke deadlines. De belangrijkste boodschap: wie nu begint met inventariseren, heeft de luxe om gecontroleerd te migreren in plaats van onder tijdsdruk.

Waarom stopt Oracle met SOAP?

De reden achter de uitfasering is niet willekeurig. SOAP Web Services voldoen niet meer aan de standaarden die Oracle voor moderne integraties hanteert. Er zijn drie concrete knelpunten:

Beperkte ondersteuning voor nieuwe functionaliteit

Nieuwe NetSuite-records en -features worden al jaren niet meer beschikbaar gemaakt via SOAP. Wie SOAP gebruikt, mist daarmee toegang tot de nieuwste mogelijkheden van het platform.

Verouderde technische architectuur

SOAP ondersteunt geen moderne standaarden zoals de huidige metadata-architectuur van NetSuite, SuiteAnalytics Workbooks en SuiteScript 2.x Analytics API's. De XML-gebaseerde structuur met WSDL-schema's is bovendien complex in ontwikkeling en onderhoud.

Verouderde authenticatie

SOAP maakt gebruik van Token Based Authentication (OAuth 1.0), wat niet meer aansluit bij de beveiligingsstandaarden die Oracle voor zijn cloudproducten hanteert. REST ondersteunt OAuth 2.0, de huidige industriestandaard.

Wat maakt REST beter?

Eenvoudiger dataformaat

REST gebruikt JSON in plaats van XML. JSON is lichter, leesbaarder en eenvoudiger te verwerken. Dat vertaalt zich in snellere ontwikkeling en minder kans op fouten bij datatransformaties.

SuiteQL voor geavanceerde queries

Een van de krachtigste features van REST is de integratie met SuiteQL. Dit is een SQL-achtige querytaal waarmee je direct complexe dataverzoeken kunt uitvoeren op NetSuite-data. In veel gevallen vervangt SuiteQL de noodzaak voor Saved Searches, met als voordeel meer flexibiliteit en betere performance.

OAuth 2.0 authenticatie

Veiliger, flexibeler en in lijn met de standaarden die ook andere cloudplatformen hanteren. Voor integraties die onbeheerd draaien (machine-to-machine) biedt OAuth 2.0 M2M een goede oplossing, waarbij tokens tot twee jaar geldig blijven.

RESTlets als vangnet

Voor situaties waarin het standaard REST-endpoint een bepaald recordtype of bepaalde operatie nog niet ondersteunt, bieden RESTlets een alternatief. Dit zijn SuiteScript-gebaseerde endpoints die je zelf kunt configureren. Daarmee kun je de overstap naar REST al maken, ook als de volledige pariteit met SOAP nog niet bereikt is.

Actieve doorontwikkeling

Oracle investeert continu in het uitbreiden van REST-mogelijkheden. Nieuwe recordtypes, Suite Tax-ondersteuning en verbeterde analytics worden aan REST toegevoegd, terwijl SOAP in onderhoudsmodus staat.

Waar REST nog niet volledig gelijk is aan SOAP

Het is eerlijk om te benoemen dat REST op sommige punten nog niet volledig gelijkwaardig is aan SOAP. Drie aandachtspunten verdienen specifieke aandacht:

Batch processing

SOAP biedt de mogelijkheid om meerdere operaties in één verzoek te bundelen. REST verwerkt verzoeken op dit moment individueel, wat bij grote volumes kan resulteren in meer API-calls. Oracle heeft aangegeven hier verbetering in te brengen.

Legacy Tax Engine

Organisaties die nog gebruikmaken van de oude belastingberekening in NetSuite (in plaats van SuiteTax) kunnen tegen beperkingen aanlopen, omdat deze niet volledig via REST wordt ondersteund. Oracle adviseert om ook de overstap naar SuiteTax te overwegen.

Saved Searches via API

SOAP biedt directe ondersteuning voor het uitvoeren van Saved Searches. In REST is dit niet native beschikbaar, maar SuiteQL biedt in de meeste gevallen een krachtig en flexibeler alternatief.

Wat betekent dit voor jouw organisatie?

De impact hangt af van hoe je huidige integraties zijn opgezet. Drie vragen helpen om de urgentie in te schatten:

Welke koppelingen draaien er op SOAP?

Breng in kaart welke integraties gebruikmaken van SOAP Web Services. Denk aan ERP-koppelingen met webshops, CRM-synchronisaties, logistieke integraties en financiële koppelingen. Vergeet ook niet de koppelingen die ooit door een externe partij zijn gebouwd en sindsdien weinig aandacht hebben gekregen.

Welk SOAP endpoint gebruiken ze?

Controleer welke WSDL-versie je huidige integraties gebruiken. Als dat een oudere versie is dan 2025.2, loop je het risico dat ondersteuning eerder wegvalt.

Zijn er externe partijen betrokken?

Als je integraties via een partner of middleware-platform lopen (denk aan Celigo, Boomi of een maatwerkoplossing), check dan of die partij al een REST-migratieplanning heeft.

Hoe een iPaaS-platform deze overstap vereenvoudigt

Jaco de NooijTechnisch Directeur

j.denooij@fortiqo.nl 0548-201010

Organisaties die hun integraties beheren via een iPaaS-platform hebben bij deze transitie een belangrijk voordeel. In een iPaaS-omgeving zijn de koppelingen gecentraliseerd en overzichtelijk gedocumenteerd. Dat maakt het inventariseren van SOAP-afhankelijkheden eenvoudiger dan bij een landschap vol losse, op maat gebouwde koppelingen.

Bij ConnectR, het integratieplatform van Opticode, zijn alle actieve integraties zichtbaar in één dashboard. Per koppeling is inzichtelijk welke technologie wordt gebruikt, hoeveel berichten er worden verwerkt en of er fouten optreden. Daarmee kun je snel bepalen welke koppelingen aandacht nodig hebben en in welke volgorde je de migratie het beste kunt aanpakken.

Bovendien zorgt de bouwblokkenaanpak van een iPaaS ervoor dat je bij de overstap naar REST niet elke koppeling volledig opnieuw hoeft te bouwen. De datatransformaties en bedrijfslogica blijven veelal intact; het is de onderliggende communicatielaag die verandert.

Begin op tijd

De tijdlijn die Oracle hanteert, geeft organisaties voldoende ruimte om de overstap gecontroleerd te maken. Maar dat lukt alleen als je er op tijd mee begint. Wachten tot SOAP daadwerkelijk wordt uitgeschakeld betekent dat je onder tijdsdruk moet migreren, met alle risico's die daarbij horen.

Ons advies: begin met de inventarisatie. Zodra je weet welke koppelingen op SOAP draaien en hoe complex de migratie per koppeling is, kun je een realistische planning maken.

Tijd om je integraties toekomstbestendig te maken

Wij brengen je koppelingen in kaart en begeleiden de overstap naar REST.

Plan een adviesgesprek

Kennishub

Kennishub FAQ

Pages

Diensten Data-integratie (Web)apps Inventarisatie & advies ERP-specialisatie Over ons Contact

Contact

Algemene voorwaarden Privacy- en cookieverklaring

NetSuite stopt met SOAP: zo pak je de overstap naar REST aan