NetSuite SOAP wordt uitgefaseerd: wat moet je nu controleren?

NetSuite SOAP Web Services verdwijnen. Maar de eerste stap is niet om meteen alle integraties opnieuw op te bouwen met REST.

Het is belangrijker om eerst in kaart te brengen welke integraties vandaag SOAP gebruiken, welke bedrijfsprocessen ervan afhankelijk zijn, wie ervoor verantwoordelijk is en welke migratiemogelijkheden onderzocht moeten worden.

Oracle NetSuite heeft bevestigd dat SOAP-endpoint 2025.2 het laatst geplande endpoint is en dat SOAP Web Services volledig worden verwijderd met NetSuite-release 2028.2. Bestaande SOAP-integraties zullen vanaf dat moment niet meer werken. Bekijk de Oracle-documentatie over WSDL-versies.

Voor Europese bedrijven die NetSuite gebruiken binnen meerdere entiteiten, landen en applicaties, is de migratie van SOAP naar REST veel meer dan een API-project. Een koppeling kan essentieel zijn voor facturatie, orderverwerking, CRM, bankverrichtingen, belastingprocessen of rapportage.

De juiste eerste stap is daarom inzicht krijgen in je bestaande integraties.

‍

Wat verandert er voor NetSuite SOAP Web Services?

Oracle bouwt SuiteTalk SOAP Web Services geleidelijk af en schuift SuiteTalk REST Web Services naar voren als vervanging.

Oracle raadt aan om alle nieuwe integraties te ontwikkelen met REST Web Services en OAuth 2.0, zoals beschreven in de officiële Oracle-documentatie over WSDL-versies.

De overgang ziet er als volgt uit:

Hierbij is het belangrijk om onderscheid te maken tussen ondersteunde, nog beschikbare maar niet-ondersteunde en definitief verwijderde endpoints.

Een ondersteund endpoint kan nog bugfixes van Oracle ontvangen. Een niet-ondersteund endpoint kan technisch beschikbaar blijven, maar wordt niet langer ondersteund. Een verwijderd endpoint is uitgeschakeld en kan niet meer worden gebruikt.

Oracle beschrijft deze overgang per release in de officiële SOAP Removal Plans FAQ.

Er is wel een klein verschil in de planning binnen de documentatie van Oracle. Verschillende WSDL-documentatiepagina's vermelden dat vanaf NetSuite 2027.1 alleen endpoint 2025.2 nog wordt ondersteund, terwijl de SOAP Removal Plans FAQ verwijst naar NetSuite 2027.2.

Bedrijven moeten daarom bij het plannen van hun migratie altijd de meest recente Oracle-documentatie raadplegen om de status van hun endpoints te controleren.

Belangrijk is ook dat 2028.2 verwijst naar een NetSuite-release en niet naar een vaste kalenderdatum. De exacte timing hangt af van het releaseschema van Oracle voor elk account.

‍

Waarom stapt NetSuite over van SOAP naar REST?

Oracle investeert in REST Web Services en OAuth 2.0 als het strategische integratiemodel voor NetSuite.

SuiteTalk REST Web Services is de beoogde vervanging voor SOAP. Oracle raadt bedrijven met op maat ontwikkelde SOAP-integraties aan om te beginnen met het plannen van hun migratie naar REST.

Wanneer een specifieke behoefte niet rechtstreeks via REST Web Services kan worden ingevuld, kan een SuiteScript RESTlet een alternatief bieden.

Daarom mag een SOAP-naar-REST-migratie niet worden beschouwd als een eenvoudige vervanging van een endpoint. Elke integratie moet worden beoordeeld in functie van het bedrijfsproces dat ze ondersteunt.

‍

Wat moeten NetSuite-gebruikers nu controleren?

Een analyse van de gereedheid voor de SOAP-uitfasering moet één eenvoudige vraag beantwoorden:

Welke rol speelt SOAP binnen onze NetSuite-architectuur en wat gebeurt er als een van deze koppelingen niet meer werkt?

Daarvoor is meer nodig dan alleen het tellen van integraties.

‍

1. Identificeer alle actieve SOAP-integraties

Stel een overzicht op van alle integraties die via SOAP met NetSuite communiceren.

Leg voor elke koppeling de volgende informatie vast:

• Naam van de integratie of applicatie.
• Huidig SOAP-endpoint.
• Authenticatiemethode.
• Recente activiteit.
• Bron- en doelsystemen.
• Verantwoordelijke voor de integratie.
• Ondersteund bedrijfsproces.
• Implementatiepartner of softwareleverancier, indien van toepassing.

Gebruiksgegevens zijn nuttig, maar vertellen niet het volledige verhaal. Een koppeling die slechts één keer per maand of zelfs één keer per jaar wordt uitgevoerd, kan nog steeds essentieel zijn voor een belangrijk financieel proces.

Gebruiksgegevens tonen welke integraties actief zijn. Validatie vanuit de business maakt duidelijk welke integraties echt belangrijk zijn.

‍

2. Begrijp het bedrijfsproces achter elke koppeling

Technische namen vertellen zelden het volledige verhaal.

Bepaal voor elke SOAP-integratie:

• Welk bedrijfsproces ondersteunt deze integratie?
• Welke teams of dochterondernemingen zijn ervan afhankelijk?
• Welke gegevens worden naar NetSuite gestuurd of vanuit NetSuite opgehaald?
• Hoe vaak wordt de integratie uitgevoerd?
• Wat zijn de operationele gevolgen als de koppeling uitvalt?

Dit is vooral belangrijk voor Europese groepen met meerdere entiteiten.

Een koppeling met een beperkt datavolume kan toch bedrijfskritisch zijn voor een specifiek land of financieel proces.

‍

Niet elke SOAP-integratie volgt hetzelfde migratietraject

Verschillende integraties kunnen heel andere acties vereisen.

‍

Integraties die intern zijn ontwikkeld

Als je eigen team of implementatiepartner de integratie heeft ontwikkeld, moet je de bestaande SOAP-operaties analyseren en bepalen hoe deze kunnen worden omgezet naar SuiteTalk REST Web Services of RESTlets.

Oracle raadt bedrijven met op maat ontwikkelde SOAP-applicaties aan om zo snel mogelijk te beginnen met het plannen van hun overstap naar REST.

‍

Applicaties beheerd door externe partners

Als de integratie wordt onderhouden door een externe softwareleverancier, is de belangrijkste vraag mogelijk:

Wanneer levert de leverancier een REST-gebaseerde versie en wat moeten we testen voordat we overstappen?

Oracle adviseert om contact op te nemen met de leverancier van SOAP-applicaties die door partners zijn ontwikkeld, om te bevestigen of er een REST-gebaseerde vervanging beschikbaar komt.

Het is belangrijk om deze externe afhankelijkheden vroegtijdig te identificeren. Anders kan een ogenschijnlijk eenvoudige migratie vertraging oplopen door de planning van een leverancier.

‍

Applicaties geleverd door NetSuite

Wanneer een SOAP-gebaseerde applicatie door NetSuite zelf wordt geleverd, geeft Oracle aan dat er een REST-gebaseerd alternatief beschikbaar zal worden gesteld.

Bedrijven moeten de beschikbaarheid van deze vervanging blijven opvolgen en de nodige tests plannen om de overgang goed te laten verlopen.

‍

Controleer de endpointversie, niet alleen het gebruik van SOAP

Weten dat een integratie SOAP gebruikt, is niet voldoende.

Je moet ook controleren welke WSDL-endpointversie wordt gebruikt en of deze:

• Nog wordt ondersteund.
• Nog beschikbaar is, maar niet langer wordt ondersteund.
• Al is uitgeschakeld.

Oudere endpoints zullen geleidelijk van ondersteund naar niet-ondersteund overgaan voordat ze volledig worden uitgeschakeld.

Daarom moet de Oracle-documentatie over ondersteunde WSDL-versies worden geraadpleegd bij elke beoordeling van SOAP-integraties.

Dit leidt tot twee afzonderlijke vragen:

1. Wordt het huidige endpoint nog ondersteund of is het nog beschikbaar?
2. Wat is het migratieplan op lange termijn richting REST?

Het updaten van een verouderd SOAP-endpoint kan het risico op korte termijn beperken, maar vervangt niet de noodzaak om vóór release 2028.2 van SOAP af te stappen.

‍

Controleer ook de authenticatie van je integraties

De overgang van SOAP naar REST is ook een goed moment om de authenticatie en het beheer van integraties opnieuw te bekijken.

Controleer voor elke integratie:

• Integratierecords.
• Authenticatiestromen.
• Rollen en machtigingen.
• Inloggegevens en geheime sleutels.
• Omgevingsspecifieke configuraties.
• Monitoring en foutafhandeling.

Oracle raadt REST Web Services met OAuth 2.0 aan voor nieuw ontwikkelde integraties.

Alleen de API vervangen, zonder de bijbehorende integratieconfiguratie te evalueren, betekent dat een deel van de bestaande technische schuld behouden blijft.

‍

Migreren van SOAP naar REST is niet altijd een één-op-éénomzetting

Een veelgemaakte fout is ervan uitgaan dat elke SOAP-operatie een exact equivalent heeft binnen REST.

Controleer daarom voor elke integratie de betrokken records en velden, de uitgevoerde bewerkingen, de verwachte transactievolumes en de manier waarop fouten worden afgehandeld.

Tests moeten het volledige bedrijfsproces omvatten en niet alleen bevestigen dat API-aanroepen succesvol zijn.

‍

Wat moeten CTO's en IT-verantwoordelijken controleren?

Voor een CTO of IT-verantwoordelijke is de uitfasering van SOAP niet alleen een technische migratiekwestie. Ze brengt ook uitdagingen met zich mee op het vlak van planning en bedrijfscontinuïteit.

De belangrijkste aandachtspunten zijn:

• Impact op de bedrijfsvoering: welke omzetgerelateerde, financiële of operationele processen worden getroffen als een integratie niet meer werkt?
• Budget en capaciteit: welke ontwikkel-, test- en projectcapaciteit is nodig vóór de relevante NetSuite-releases?
• Afhankelijkheden van leveranciers: welke migraties zijn afhankelijk van externe softwareleveranciers of implementatiepartners?
• Verantwoordelijkheden: is er voor elke SOAP-integratie een duidelijke technische en zakelijke verantwoordelijke?
• Risico van uitstel: wat gebeurt er als een migratie wordt uitgesteld tot kort voor de definitieve verwijdering van SOAP?

Hoe eerder deze punten duidelijk zijn, hoe eenvoudiger het wordt om middelen toe te wijzen en te voorkomen dat meerdere migraties tegelijk dringend worden.

‍

Waar moeten Europese financiële teams op letten?

Europese bedrijven die NetSuite gebruiken, zijn vaak afhankelijk van integraties tussen verschillende systemen en landen.

SOAP-koppelingen kunnen onder meer worden gebruikt voor:

• Processen tussen CRM en orderverwerking.
• Abonnementsfacturatie en facturatie op basis van gebruik.
• Platformen voor uitgavenbeheer.
• Bankverrichtingen en betalingen.
• Belastingen en elektronische facturatie.
• Inkoopprocessen.
• Business intelligence en datawarehouses.
• Lokale operationele applicaties.

Daarom mag de prioriteit van een migratie niet alleen worden bepaald door de technische complexiteit.

Een kleine koppeling die een landspecifiek financieel proces ondersteunt, kan een groter operationeel risico vormen dan een veel omvangrijkere gegevenssynchronisatie.

Een bruikbaar prioriteringsmodel combineert bedrijfskritiek belang, migratiecomplexiteit, verantwoordelijkheden en risico's rond deadlines.

‍

Hoe prioriteer je SOAP-integraties voor migratie?

In plaats van alle integraties in één grote migratiebacklog te plaatsen, kun je ze onderverdelen in duidelijke categorieën:

• Bedrijfskritisch: ondersteunt een proces waarbij aanzienlijke downtime niet aanvaardbaar is.
• Actief, met een lager risico: is nog nodig, maar heeft een beperkte operationele impact.
• Verder onderzoek nodig: het gebruik, de verantwoordelijke of het migratietraject is onduidelijk.
• Beheerd door een leverancier: is afhankelijk van een externe softwareleverancier.
• Mogelijk uit te faseren: is inactief, dubbel uitgevoerd of niet langer nodig.

Zo voorkom je dat er tijd wordt besteed aan het migreren van integraties die eigenlijk gewoon kunnen verdwijnen.

Het doel is niet om zoveel mogelijk SOAP-koppelingen om te zetten.

Het doel is ervoor te zorgen dat alle integraties die het bedrijf nog nodig heeft, op een veilige manier kunnen blijven functioneren.

‍

Rechtstreeks migreren naar REST of kiezen voor een iPaaS-platform?

Voor een beperkt aantal eenvoudige koppelingen kan een rechtstreekse REST-integratie een geschikte oplossing zijn.

In een complexere applicatieomgeving kan de uitfasering van SOAP ook een aanleiding zijn om te onderzoeken of point-to-point-integraties nog steeds de beste keuze zijn.

Een Integration Platform as a Service (iPaaS) kan integratiestromen, datatransformaties, monitoring en foutafhandeling centraliseren, in plaats van deze logica te verspreiden over verschillende maatwerkkoppelingen.

De keuze moet gebaseerd zijn op de architectuur en mag geen automatisme zijn.

‍

Waarom al vóór 2028 beginnen met de migratie?

De grootste uitdaging is vaak niet de technische omzetting zelf, maar de coördinatie.

Voordat een integratie kan worden vervangen, moet mogelijk eerst:

• De verantwoordelijke worden geïdentificeerd.
• Worden bevestigd of de integratie nog wordt gebruikt.
• Het bijbehorende bedrijfsproces worden gevalideerd.
• Contact worden opgenomen met een leverancier.
• De beschikbare REST-functionaliteit worden beoordeeld.
• De vervangende integratie worden ontwikkeld en getest.
• De overgang naar productie worden gepland.

Wanneer meerdere dochterondernemingen en systemen betrokken zijn, kost dit tijd.

Nu beginnen betekent niet dat je alles onmiddellijk moet vervangen. Het betekent dat je onzekerheden wegneemt zolang er nog voldoende tijd is om weloverwogen beslissingen te nemen.

‍

Stel een roadmap op voor de migratie van NetSuite SOAP naar REST

Zodra de analyse is afgerond, moeten de bevindingen worden omgezet in een praktische roadmap.

Fase 1: Inventariseren

Maak een overzicht van alle integraties en controleer hun daadwerkelijke activiteit.

Fase 2: Beoordelen

Bevestig wie verantwoordelijk is, welke bedrijfsprocessen worden ondersteund, hoe kritisch de integraties zijn, wat de status van de endpoints is en welke afhankelijkheden bestaan.

Fase 3: Ontwerpen

Bepaal de doelarchitectuur: REST Web Services, RESTlet, een vervanging door de leverancier of iPaaS.

Fase 4: Ontwikkelen en testen

Ontwikkel de nieuwe integratiestromen en test het volledige bedrijfsproces van begin tot eind.

Fase 5: Overschakelen en uitfaseren

Schakel het productieverkeer over, monitor de resultaten en schakel verouderde SOAP-koppelingen uit.

‍

Wat levert een NetSuite Technical Readiness Assessment op?

Een NetSuite Technical Upgrade Readiness Assessment moet meer opleveren dan alleen een technische inventarisatie.

De verwachte resultaten zijn:

• Een gevalideerd overzicht van actieve SOAP-integraties en de huidige status van hun endpoints.
• Een prioritering van risico's op basis van bedrijfskritiek belang, verantwoordelijkheden, afhankelijkheden en migratiecomplexiteit.
• Een aanbevolen migratietraject voor elke integratie, zoals REST Web Services, RESTlet, een vervanging door de leverancier of volledige uitfasering.
• Een praktische roadmap met prioriteiten, verantwoordelijken en de volgorde van de nodige aanpassingen.

Zo krijgen technische en zakelijke stakeholders een gedeeld beeld van wat aandacht vereist en wat nog kan wachten.

‍

Hoe Novutech kan helpen

Novutech ondersteunt Europese groeibedrijven bij het beoordelen van hun NetSuite-architectuur en het voorbereiden van technische veranderingen.

Onze teams kunnen bestaande SOAP-integraties, endpointversies, activiteit, authenticatie, verantwoordelijkheden en afhankelijkheden analyseren. Vervolgens helpen we bij het bepalen van een praktisch migratietraject naar SuiteTalk REST Web Services, RESTlets of een integratieplatform wanneer dat geschikt is.

Met meer dan 250 klanten, 65 consultants en 100 certificeringen combineert Novutech NetSuite-expertise met kennis van integraties en financiële processen. Zo begeleiden we bedrijven van de eerste analyse tot de noodzakelijke aanpassingen en langdurige ondersteuning.

‍

Bereid de uitfasering van NetSuite SOAP tijdig voor

NetSuite SOAP Web Services verdwijnen met NetSuite-release 2028.2. Dit is een mijlpaal in de releaseplanning en geen vaste kalenderdatum.

De belangrijkste stap vandaag is niet om alle integraties tegelijk te migreren.

Het gaat erom te weten:

• Welke systemen met elkaar verbonden zijn.
• Welke integraties nog actief zijn.
• Welke bedrijfsprocessen ervan afhankelijk zijn.
• Wie verantwoordelijk is voor de verandering.
• Welke vervangende oplossing geschikt is.
• Wanneer de werkzaamheden moeten plaatsvinden.

Zodra deze vragen zijn beantwoord, wordt de uitfasering van SOAP een beheersbaar migratietraject in plaats van een technisch probleem dat op het laatste moment moet worden opgelost.

‍

Klaar om je NetSuite-integraties te evalueren?

Weet je niet zeker welke SOAP-integraties nog actief zijn, welke bedrijfsprocessen ervan afhankelijk zijn of hoe je de overstap naar REST moet aanpakken?

Novutech kan je helpen met een duidelijk plan voor de analyse en migratie van je NetSuite-integraties.