NetSuite SuiteTalk REST vs SOAP vs RESTlets

Algú, un account manager o una línia de les notes de versió, li ha dit que SOAP desapareix de NetSuite. Algunes de les seves integracions funcionen sobre Celigo, d'altres sobre codi SOAP antic que no és de ningú, d'altres sobre RESTlets a mida. Celigo acaba d'afegir SuiteTalk REST al seu connector de NetSuite. Què cal canviar, per a quan i en quin ordre?

Aquest article ho respon amb les dates d'Oracle, cadascuna marcada segons com de ferma sigui la font, i després amb una taula de decisió i una checklist de migració. Dades d'Oracle i Celigo comprovades el 15 d'octubre del 2026. Tots dos proveïdors canvien els seus plans, per això la checklist acaba amb "revisar a cada versió".

Resposta curta. Sí, planifiqui el canvi. Oracle indica que els SOAP web services s'eliminaran amb NetSuite 2028.2, moment en què les integracions SOAP existents deixaran de funcionar, i que des de la 2027.1 no es podran crear integracions noves amb SOAP ni amb Token-Based Authentication (TBA). Les integracions noves han d'usar SuiteTalk REST amb OAuth 2.0. Usi SuiteQL, a través de REST, per a les consultes, i RESTlets allà on REST no arribi. Les Saved Searches no s'eliminen.

• Cal migrar: tot el que usi SOAP web services (eliminació el 2028.2) i tot el que usi NLAuth (deixa de funcionar a la 2027.1).
• Convé migrar: les integracions amb TBA a OAuth 2.0 (final de suport previst, amb caràcter tentatiu, per al 2028.2).
• Es pot migrar quan compensi: les exportacions de Saved Search, a SuiteTalk REST o SuiteQL.

El calendari d'Oracle, amb dates

Les versions de NetSuite es desplieguen compte a compte durant diverses setmanes, així que aquesta taula dona números de versió i no dates de calendari. L'estat indica com de fermes són les pròpies pàgines d'Oracle, comprovades el 15 d'octubre del 2026.

Tres detalls compten a la pràctica. Les integracions existents continuen funcionant, i els registres d'integració de les integracions SOAP i TBA existents es poden seguir editant fins que SOAP s'elimini del tot. Les integracions TBA existents funcionen fins al final de suport definitiu de TBA. I la inconsistència entre 2027.1 i 2027.2 continua avui a les pàgines d'Oracle: convé planificar per la data més primerenca, perquè no costa res i la tardana no està garantida.

Les quatre vies d'accés, en llenguatge clar

SuiteTalk REST web services (registres). El substitut de SOAP segons Oracle: JSON sobre HTTP, amb altes, lectures, modificacions i baixes de registres, i OAuth 2.0 com a mètode d'autenticació preferit. Compte: no és un clon u a u. La guia d'Oracle de SOAP a REST enumera operacions sense equivalent directe, entre elles changeEmail, changePassword, getDataCenterUrls, getPostingTransactionSummary i les operacions de llista com updateInviteeStatusList, a més d'operacions que requereixen un altre enfocament, com SuiteQL per a getDeleted.

SuiteQL, a través del servei de consultes REST. Consultes de tipus SQL sobre les dades de NetSuite, amb paginació. És el substitut habitual de les cerques SOAP i de les exportacions construïdes com a Saved Search. Celigo afirma que la seva opció REST no necessita una llicència addicional de SuiteAnalytics Connect; l'accés JDBC o ODBC és un altre canal, així que cal comprovar quina llicència té el seu compte.

RESTlets (SuiteScript). Un endpoint propi, que executa SuiteScript dins de NetSuite. Serveix per a lògica a mida, per a diversos registres en una sola crida o per a dades i comportaments que REST no exposa. Compte: és codi que manté vostè, s'executa sota els límits de governance de NetSuite, i tot el que usi NLAuth ha de canviar abans de la 2027.1.

SOAP web services. El canal heretat. Funciona per a integracions existents fins al 2028.2 i no es pot usar per a desenvolupaments nous des de la 2027.1.

Una precisió, perquè genera confusió: una Saved Search no és una API. És la definició d'una consulta, que s'executa mitjançant SOAP o mitjançant un RESTlet (a Celigo, mitjançant el RESTlet propi de Celigo). Deixar SOAP no vol dir abandonar les Saved Searches.

Què canvia amb la versió de Celigo d'octubre del 2026

Celigo va publicar les novetats d'octubre del 2026 el 6 d'octubre del 2026 i les va actualitzar el 7 d'octubre. El que diuen, atribuït a Celigo i no mesurat per nosaltres:

• El connector de NetSuite admet ara SuiteTalk REST i RESTlets a mida com a "first-class options" per a exportacions, consultes i importacions basades en registres, sense una connexió HTTP a part.
• Celigo afirma que "SuiteTalk REST is faster than Saved Search at scale" i que "requires no additional SuiteAnalytics Connect license". Són afirmacions del proveïdor. No tenim cap benchmark propi, i la velocitat depèn del disseny de la consulta, del tipus de registre i dels límits del compte.
• Celigo indica "Existing integrations are unchanged", és a dir, les integracions existents no canvien.
• NetSuite JDBC és ara una font nativa a l'assistent de sincronització de Celigo, per fer joins entre taules de SuiteAnalytics "without the limitations of Saved Search". És rellevant per a càrregues a un data warehouse i és del costat de SuiteAnalytics Connect, així que cal verificar la llicència compte per compte.
• Celigo també allotja ara un servidor SFTP estàndard. Només importa si la seva "substitució de SOAP" és en realitat un projecte d'intercanvi de fitxers.

El centre d'ajuda de Celigo enumera tres tipus d'API per a les exportacions de NetSuite. Celigo RESTlets es connecta mitjançant el RESTlet propi de Celigo. REST APIs és per a fluxos basats en registres, amb SuiteTalk per defecte i Custom RESTlets com a alternativa. SOAP Web Services serveix per a grans volums, requereix una llicència SuiteCloud Plus i és l'única opció quan el bundle d'integrator.io no es pot instal·lar al compte. Celigo suggereix combinar exportacions amb Celigo RESTlets i amb REST APIs per exportar més dades per llicència.

Per a vostè això suposa una via per sortir dels fluxos de tipus SOAP dins l'eina que ja usa, i una alternativa a les exportacions de Saved Search. El que la versió no diu és com s'autenticaran les connexions de Celigo amb NetSuite quan TBA arribi al final de suport. Pregunti-ho a Celigo; nosaltres no especulem. Per a l'elecció més àmplia de plataforma, vegi iPaaS, punt a punt i middleware i Heroku Connect vs Celigo vs MuleSoft.

Taula de decisió: quina API per a cada feina

No sap quines de les seves integracions usen SOAP o TBA? Les inventariem amb vostè en 30 minuts.

Com migrar de SOAP a SuiteTalk REST: 13 passos

1. Inventari. Llisti totes les integracions que toquen NetSuite, des de la pàgina Manage Integrations i el registre d'auditoria d'accessos, i etiqueti cadascuna amb el seu tipus d'API (SOAP, REST, RESTlet, Celigo RESTlet), la seva autenticació (NLAuth, TBA, OAuth 2.0) i un responsable.
2. Localitzi els endpoints SOAP. Anoti la versió de WSDL de cada integració. Tot el que sigui anterior a la 2025.2 ja ha passat la seva data de caducitat.
3. Elimini primer NLAuth. És el límit dur de la 2027.1.
4. Revisi Celigo, flux a flux. Llegeixi el tipus d'API de cada exportació i importació, llisti els fluxos amb SOAP Web Services i llisti les exportacions pesades de Saved Search amb els seus temps d'execució i errors.
5. Pregunti als proveïdors d'apps de tercers. Escrigui a cada proveïdor de SuiteApp o connector per demanar-li el pla de REST i OAuth 2.0, amb data.
6. Mapi les operacions. Usi la guia d'Oracle de SOAP a REST per mapar cada operació SOAP i assenyali els buits que requereixen un RESTlet.
7. Reexpressi les cerques. Reescrigui la lògica de les cerques SOAP i de les Saved Searches com a SuiteQL, i concili el nombre de files i els totals amb el resultat anterior abans de canviar.
8. Configuri l'autenticació. Creï registres d'integració OAuth 2.0, amb client credentials entre servidors i authorization code amb PKCE quan autoritzen usuaris. Roti els secrets i usi rols de mínim privilegi.
9. Revisi concurrència i governance. Miri els límits de concurrència del seu compte i programi les càrregues pesades en conseqüència.
10. Provi al sandbox. Executi l'antic i el nou en paral·lel, comparï els resultats i aprofiti les finestres de release preview.
11. Canviï flux a flux. Conservi una via de tornada enrere i actualitzi la monitorització i les alertes.
12. Retiri l'antic. Desactivi els registres d'integració i els tokens antics, i documenti el nou tipus d'API i el seu responsable.
13. Revisi a cada versió. Oracle pot ajustar les dates; llegeixi les notes de versió a cada .1 i .2.

Paranys habituals

• REST no és un clon de SOAP. El comportament de llistes i lots és diferent, falten algunes operacions i els formats d'error són uns altres.
• Els totals no sempre coincideixen. Un resultat de SuiteQL pot diferir de la Saved Search que substitueix. Concili abans del canvi, sobretot amb dades multidivisa; el nostre article sobre un pla de comptes únic en diverses filials mostra on s'amaguen aquestes diferències.
• Provi amb el rol de la integració, no amb Administrator. Una integració que funciona amb un administrador pot fallar amb el seu rol real.
• Deixar-ho per al 2028. Els cicles de release preview i de refresc del sandbox escurcen la finestra real. La nostra nota sobre per què s'endarrereixen les implementacions de NetSuite també val per a les migracions.
• Programar un RESTlet per reflex. El codi a mida l'ha de mantenir vostè; estàndard davant personalització és el criteri que cal aplicar.

On encaixa Atypical Tech

Som enginyers d'integració de NetSuite amb base a Espanya, partner d'implementació de Celigo i partner de Stacksync. Construïm APIs i RESTlets a mida allà on REST no n'hi ha prou, i migrem fluxos de Celigo o SOAP a mida a SuiteTalk REST i SuiteQL. No som partner d'Oracle NetSuite ni ens presentem com a tals. Si l'objectiu final és una sincronització bidireccional i no una reescriptura, Stacksync és una opció; per sincronitzar amb un data warehouse, vegi CDC gestionat davant Debezium autoallotjat.

Preguntes freqüents

Està NetSuite deprecant SOAP?

Sí. A 15 d'octubre del 2026, Oracle indica que els SOAP web services s'eliminaran amb NetSuite 2028.2, moment en què les integracions SOAP existents deixaran de funcionar. La 2025.2 és l'últim endpoint SOAP previst i, des de la 2027.1, no es poden crear integracions SOAP noves.

Quan deixen de funcionar les integracions SOAP de NetSuite?

Amb la versió 2028.2, segons Oracle. Abans, a cada versió es desactiva l'endpoint sense suport més antic, així que les integracions amb versions antigues de WSDL poden fallar abans. Migri a SuiteTalk REST amb marge respecte al 2028.2.

Exigeix NetSuite OAuth 2.0?

Per a integracions noves, des de la 2027.1: Oracle indica que les integracions noves no podran usar TBA i que les noves amb authorization code necessiten PKCE. Les integracions TBA existents continuen funcionant fins al final de suport definitiu de TBA, previst amb caràcter tentatiu per al 2028.2. Oracle recomana abandonar NLAuth, que deixa de funcionar a la 2027.1.

Quina diferència hi ha entre SuiteTalk REST i un RESTlet?

SuiteTalk REST és l'API estàndard d'Oracle per a registres i consultes SuiteQL. Un RESTlet és un endpoint propi de SuiteScript dins de NetSuite. Usi REST per defecte i un RESTlet per a lògica a mida o per al que REST no cobreix.

Què és SuiteQL?

Un llenguatge de consulta de tipus SQL per a les dades de NetSuite. A través de SuiteTalk REST permet a una integració executar consultes paginades amb joins i filtres. És el substitut habitual de les cerques SOAP i de les exportacions de Saved Search.

Necessito SuiteAnalytics Connect per usar SuiteQL?

Celigo afirma que la seva opció SuiteTalk REST no requereix una llicència addicional de SuiteAnalytics Connect. L'accés JDBC i ODBC, inclosa la font de sincronització JDBC de Celigo, és del costat de SuiteAnalytics Connect. Comprovi la seva pròpia llicència amb NetSuite.

Han de canviar les meves integracions de Celigo amb NetSuite?

No de seguida: Celigo indica que les integracions existents no canvien amb la seva versió d'octubre del 2026. Els fluxos amb el tipus d'API SOAP Web Services han de migrar abans del 2028.2. Els fluxos amb Celigo RESTlets o Saved Search poden passar a SuiteTalk REST quan la velocitat o l'accés ho justifiquin.

És SuiteTalk REST més ràpid que Saved Search?

Celigo ho afirma "at scale" a les novetats de la seva versió d'octubre del 2026. Nosaltres no ho hem mesurat. La velocitat depèn del disseny de la consulta, del tipus de registre i dels límits del compte, així que provi les seves exportacions més pesades en paral·lel abans de canviar.

Puc seguir usant Saved Searches?

Sí. Les Saved Searches no s'eliminen; el que s'elimina són els SOAP web services. Executi-les mitjançant un RESTlet, com fa el RESTlet propi de Celigo, en lloc de SOAP, o reescrigui les pesades com a SuiteQL.

Qui pot migrar integracions SOAP de NetSuite a Europa?

Atypical Tech: enginyers d'integració amb base a Espanya i partner d'implementació de Celigo i Stacksync, que construeixen integracions amb SuiteTalk REST, SuiteQL i RESTlets per a empreses mid-market.

Fonts

Totes comprovades el 15 d'octubre del 2026.

• Oracle NetSuite Help Center, SOAP Removal Plans FAQ.
• Oracle NetSuite Help Center, SuiteTalk SOAP Web Services Platform Overview.
• Oracle NetSuite Help Center, Support for Existing WSDL Versions.
• Oracle NetSuite Help Center, SOAP Web Services to REST Web Services Upgrade Guide.
• Oracle NetSuite Help Center, avisos d'autenticació: TBA, PKCE i NLAuth a la 2027.1.
• Celigo, October 2026 Release Highlights (6 d'octubre del 2026, actualitzat el 7 d'octubre del 2026).
• Celigo Help Center, Export data from NetSuite.

Demani la revisió de la seva integració amb NetSuite

Trenta minuts solen bastar per mapar què cal migrar abans de la 2027.1 i la 2028.2, i què pot quedar-se. Reservi una trucada o consulti les nostres integracions; si usa Celigo, comenci per la nostra pàgina de Celigo.