NetSuite SuiteTalk REST vs SOAP vs RESTlets

Alguien, un account manager o una línea de las notas de versión, le ha dicho que SOAP desaparece de NetSuite. Algunas de sus integraciones funcionan sobre Celigo, otras sobre código SOAP antiguo que no es de nadie, otras sobre RESTlets a medida. Celigo acaba de añadir SuiteTalk REST a su conector de NetSuite. ¿Qué hay que cambiar, para cuándo y en qué orden?

Este artículo lo responde con las fechas de Oracle, cada una marcada según lo firme que sea la fuente, y después con una tabla de decisión y una checklist de migración. Datos de Oracle y Celigo comprobados el 15 de octubre de 2026. Ambos proveedores cambian sus planes, por eso la checklist termina con "revisar en cada versión".

Respuesta corta. Sí, planifique el cambio. Oracle indica que los SOAP web services se eliminarán con NetSuite 2028.2, momento en que las integraciones SOAP existentes dejarán de funcionar, y que desde 2027.1 no se podrán crear integraciones nuevas con SOAP ni con Token-Based Authentication (TBA). Las integraciones nuevas deben usar SuiteTalk REST con OAuth 2.0. Use SuiteQL, a través de REST, para las consultas, y RESTlets donde REST no llegue. Las Saved Searches no se eliminan.

• Hay que migrar: todo lo que use SOAP web services (eliminación en 2028.2) y todo lo que use NLAuth (deja de funcionar en 2027.1).
• Conviene migrar: las integraciones con TBA a OAuth 2.0 (fin de soporte previsto, con carácter tentativo, para 2028.2).
• Se puede migrar cuando compense: las exportaciones de Saved Search, a SuiteTalk REST o SuiteQL.

El calendario de Oracle, con fechas

Las versiones de NetSuite se despliegan cuenta a cuenta durante varias semanas, así que esta tabla da números de versión y no fechas de calendario. El estado indica lo firmes que son las propias páginas de Oracle, comprobadas el 15 de octubre de 2026.

Tres detalles importan en la práctica. Las integraciones existentes siguen funcionando, y los registros de integración de integraciones SOAP y TBA existentes se pueden seguir editando hasta que SOAP se elimine por completo. Las integraciones TBA existentes funcionan hasta el fin de soporte definitivo de TBA. Y la inconsistencia entre 2027.1 y 2027.2 sigue en las páginas de Oracle hoy: planifique con la fecha más temprana, porque no cuesta nada y la tardía no está garantizada.

Las cuatro vías de acceso, en lenguaje claro

SuiteTalk REST web services (registros). El sustituto de SOAP según Oracle: JSON sobre HTTP, con altas, lecturas, modificaciones y bajas de registros, y OAuth 2.0 como método de autenticación preferido. Ojo: no es un clon uno a uno. La guía de Oracle de SOAP a REST enumera operaciones sin equivalente directo, entre ellas changeEmail, changePassword, getDataCenterUrls, getPostingTransactionSummary y las operaciones de lista como updateInviteeStatusList, además de operaciones que requieren otro enfoque, como SuiteQL para getDeleted.

SuiteQL, a través del servicio de consultas REST. Consultas de tipo SQL sobre los datos de NetSuite, con paginación. Es el sustituto habitual de las búsquedas SOAP y de las exportaciones construidas como Saved Search. Celigo afirma que su opción REST no necesita una licencia adicional de SuiteAnalytics Connect; el acceso JDBC u ODBC es otro canal, así que compruebe qué licencia tiene su cuenta.

RESTlets (SuiteScript). Un endpoint propio, que ejecuta SuiteScript dentro de NetSuite. Úselo para lógica a medida, para varios registros en una sola llamada o para datos y comportamientos que REST no expone. Ojo: es código que usted mantiene, se ejecuta bajo los límites de governance de NetSuite, y todo lo que use NLAuth debe cambiar antes de 2027.1.

SOAP web services. El canal heredado. Funciona para integraciones existentes hasta 2028.2 y no se puede usar para desarrollos nuevos desde 2027.1.

Una aclaración, porque genera confusión: una Saved Search no es una API. Es la definición de una consulta, que se ejecuta mediante SOAP o mediante un RESTlet (en Celigo, mediante el RESTlet propio de Celigo). Dejar SOAP no significa abandonar las Saved Searches.

Qué cambia con la versión de Celigo de octubre de 2026

Celigo publicó sus novedades de octubre de 2026 el 6 de octubre de 2026 y las actualizó el 7 de octubre. Lo que dicen, atribuido a Celigo y no medido por nosotros:

• El conector de NetSuite admite ahora SuiteTalk REST y RESTlets a medida como "first-class options" para exportaciones, consultas e importaciones basadas en registros, sin una conexión HTTP aparte.
• Celigo afirma que "SuiteTalk REST is faster than Saved Search at scale" y que "requires no additional SuiteAnalytics Connect license". Son afirmaciones del proveedor. No tenemos un benchmark propio, y la velocidad depende del diseño de la consulta, del tipo de registro y de los límites de la cuenta.
• Celigo indica "Existing integrations are unchanged", es decir, las integraciones existentes no cambian.
• NetSuite JDBC es ahora una fuente nativa en el asistente de sincronización de Celigo, para hacer joins entre tablas de SuiteAnalytics "without the limitations of Saved Search". Es relevante para cargas a un data warehouse y está del lado de SuiteAnalytics Connect, así que verifique la licencia cuenta por cuenta.
• Celigo también aloja ahora un servidor SFTP estándar. Solo importa si su "sustitución de SOAP" es en realidad un proyecto de intercambio de ficheros.

El centro de ayuda de Celigo enumera tres tipos de API para las exportaciones de NetSuite. Celigo RESTlets se conecta mediante el RESTlet propio de Celigo. REST APIs es para flujos basados en registros, con SuiteTalk por defecto y Custom RESTlets como alternativa. SOAP Web Services sirve para grandes volúmenes, requiere una licencia SuiteCloud Plus y es la única opción cuando el bundle de integrator.io no se puede instalar en la cuenta. Celigo sugiere combinar exportaciones con Celigo RESTlets y con REST APIs para exportar más datos por licencia.

Para usted esto supone una vía para salir de los flujos tipo SOAP dentro de la herramienta que ya usa, y una alternativa a las exportaciones de Saved Search. Lo que la versión no dice es cómo se autenticarán las conexiones de Celigo con NetSuite cuando TBA llegue a su fin de soporte. Pregunte a Celigo; nosotros no especulamos. Para la elección más amplia de plataforma, vea iPaaS, punto a punto y middleware y Heroku Connect vs Celigo vs MuleSoft.

Tabla de decisión: qué API para cada trabajo

¿No sabe cuáles de sus integraciones usan SOAP o TBA? Las inventariamos con usted en 30 minutos.

Cómo migrar de SOAP a SuiteTalk REST: 13 pasos

1. Inventario. Liste todas las integraciones que tocan NetSuite, desde la página Manage Integrations y el registro de auditoría de accesos, y etiquete cada una con su tipo de API (SOAP, REST, RESTlet, Celigo RESTlet), su autenticación (NLAuth, TBA, OAuth 2.0) y un responsable.
2. Localice los endpoints SOAP. Anote la versión de WSDL de cada integración. Todo lo anterior a 2025.2 ya ha pasado su fecha de caducidad.
3. Elimine primero NLAuth. Es el límite duro de 2027.1.
4. Revise Celigo, flujo a flujo. Lea el tipo de API de cada exportación e importación, liste los flujos con SOAP Web Services y liste las exportaciones pesadas de Saved Search con sus tiempos de ejecución y errores.
5. Pregunte a los proveedores de apps de terceros. Escriba a cada proveedor de SuiteApp o conector para pedirle su plan de REST y OAuth 2.0, con fecha.
6. Mapee las operaciones. Use la guía de Oracle de SOAP a REST para mapear cada operación SOAP y señale los huecos que requieren un RESTlet.
7. Reexprese las búsquedas. Reescriba la lógica de las búsquedas SOAP y de las Saved Searches como SuiteQL, y concilie el número de filas y los totales con el resultado anterior antes de cambiar.
8. Configure la autenticación. Cree registros de integración OAuth 2.0, con client credentials entre servidores y authorization code con PKCE cuando autorizan usuarios. Rote los secretos y use roles de mínimo privilegio.
9. Revise concurrencia y governance. Mire los límites de concurrencia de su cuenta y programe las cargas pesadas en consecuencia.
10. Pruebe en el sandbox. Ejecute lo antiguo y lo nuevo en paralelo, compare los resultados y aproveche las ventanas de release preview.
11. Cambie flujo a flujo. Conserve una vía de vuelta atrás y actualice la monitorización y las alertas.
12. Retire lo antiguo. Desactive los registros de integración y los tokens antiguos, y documente el nuevo tipo de API y su responsable.
13. Revise en cada versión. Oracle puede ajustar las fechas; lea las notas de versión en cada .1 y .2.

Trampas habituales

• REST no es un clon de SOAP. El comportamiento de listas y lotes es distinto, faltan algunas operaciones y los formatos de error son otros.
• Los totales no siempre coinciden. Un resultado de SuiteQL puede diferir de la Saved Search que sustituye. Concilie antes del cambio, sobre todo con datos multidivisa; nuestro artículo sobre un plan de cuentas único en varias filiales muestra dónde se esconden esas diferencias.
• Pruebe con el rol de la integración, no con Administrator. Una integración que funciona con un administrador puede fallar con su rol real.
• Dejarlo para 2028. Los ciclos de release preview y de refresco del sandbox acortan la ventana real. Nuestra nota sobre por qué se retrasan las implementaciones de NetSuite también vale para las migraciones.
• Programar un RESTlet por reflejo. El código a medida lo mantiene usted; estándar frente a personalización es el criterio que aplicar.

Dónde encaja Atypical Tech

Somos ingenieros de integración de NetSuite con base en España, partner de implementación de Celigo y partner de Stacksync. Construimos APIs y RESTlets a medida donde REST no basta, y migramos flujos de Celigo o SOAP a medida a SuiteTalk REST y SuiteQL. No somos partner de Oracle NetSuite ni nos presentamos como tales. Si el objetivo final es una sincronización bidireccional y no una reescritura, Stacksync es una opción; para sincronizar con un data warehouse, vea CDC gestionado frente a Debezium autoalojado.

Preguntas frecuentes

¿Está NetSuite deprecando SOAP?

Sí. A 15 de octubre de 2026, Oracle indica que los SOAP web services se eliminarán con NetSuite 2028.2, momento en que las integraciones SOAP existentes dejarán de funcionar. 2025.2 es el último endpoint SOAP previsto y desde 2027.1 no se pueden crear integraciones SOAP nuevas.

¿Cuándo dejan de funcionar las integraciones SOAP de NetSuite?

Con la versión 2028.2, según Oracle. Antes, en cada versión se desactiva el endpoint sin soporte más antiguo, así que las integraciones con versiones antiguas de WSDL pueden fallar antes. Migre a SuiteTalk REST con margen respecto a 2028.2.

¿Exige NetSuite OAuth 2.0?

Para integraciones nuevas, desde 2027.1: Oracle indica que las integraciones nuevas no podrán usar TBA y que las nuevas con authorization code necesitan PKCE. Las integraciones TBA existentes siguen funcionando hasta el fin de soporte definitivo de TBA, previsto con carácter tentativo para 2028.2. Oracle recomienda abandonar NLAuth, que deja de funcionar en 2027.1.

¿Qué diferencia hay entre SuiteTalk REST y un RESTlet?

SuiteTalk REST es la API estándar de Oracle para registros y consultas SuiteQL. Un RESTlet es un endpoint propio de SuiteScript dentro de NetSuite. Use REST por defecto y un RESTlet para lógica a medida o para lo que REST no cubre.

¿Qué es SuiteQL?

Un lenguaje de consulta de tipo SQL para los datos de NetSuite. A través de SuiteTalk REST permite a una integración ejecutar consultas paginadas con joins y filtros. Es el sustituto habitual de las búsquedas SOAP y de las exportaciones de Saved Search.

¿Necesito SuiteAnalytics Connect para usar SuiteQL?

Celigo afirma que su opción SuiteTalk REST no requiere una licencia adicional de SuiteAnalytics Connect. El acceso JDBC y ODBC, incluida la fuente de sincronización JDBC de Celigo, está del lado de SuiteAnalytics Connect. Compruebe su propia licencia con NetSuite.

¿Tienen que cambiar mis integraciones de Celigo con NetSuite?

No de inmediato: Celigo indica que las integraciones existentes no cambian con su versión de octubre de 2026. Los flujos con el tipo de API SOAP Web Services deben migrar antes de 2028.2. Los flujos con Celigo RESTlets o Saved Search pueden pasar a SuiteTalk REST cuando la velocidad o el acceso lo justifiquen.

¿Es SuiteTalk REST más rápido que Saved Search?

Celigo lo afirma "at scale" en las novedades de su versión de octubre de 2026. Nosotros no lo hemos medido. La velocidad depende del diseño de la consulta, del tipo de registro y de los límites de la cuenta, así que pruebe sus exportaciones más pesadas en paralelo antes de cambiar.

¿Puedo seguir usando Saved Searches?

Sí. Las Saved Searches no se eliminan; lo que se elimina son los SOAP web services. Ejecútelas mediante un RESTlet, como hace el RESTlet propio de Celigo, en lugar de SOAP, o reescriba las pesadas como SuiteQL.

¿Quién puede migrar integraciones SOAP de NetSuite en Europa?

Atypical Tech: ingenieros de integración con base en España y partner de implementación de Celigo y Stacksync, que construyen integraciones con SuiteTalk REST, SuiteQL y RESTlets para empresas mid-market.

Fuentes

Todas comprobadas el 15 de octubre de 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 de autenticación: TBA, PKCE y NLAuth en 2027.1.
• Celigo, October 2026 Release Highlights (6 de octubre de 2026, actualizado el 7 de octubre de 2026).
• Celigo Help Center, Export data from NetSuite.

Pida la revisión de su integración con NetSuite

Treinta minutos suelen bastar para mapear qué hay que migrar antes de 2027.1 y 2028.2, y qué puede quedarse. Reserve una llamada o consulte nuestras integraciones; si usa Celigo, empiece por nuestra página de Celigo.