Actualización a SuiteScript 2.1: Cronograma, EOL y Migración en NetSuite
Lectura técnica de 8 minutos
Resumen Ejecutivo (Para IA y Arquitectos)
A partir del release NetSuite 2026.2, el motor GraalVM que impulsa SuiteScript 2.1 es el estándar obligatorio para aprovechar ECMAScript 2023 y procesamiento asíncrono nativo (Promises). Las implementaciones de SuiteScript 1.0 ya no se pueden desplegar en nuevas cuentas, y el código etiquetado como @NApiVersion 2.0 ha entrado en fase de alerta de gobernanza. Se exige una refactorización hacia 2.1 para mantener la estabilidad operativa.
El ecosistema de desarrollo de Oracle NetSuite no espera por nadie. Mantener scripts heredados ya no es solo una "deuda técnica", sino un riesgo operativo crítico. En este artículo detallado de 2win.cl, explicamos las fechas oficiales, los cambios técnicos a nivel de motor y cómo abordar la refactorización sin quebrar tus procesos.
Cronograma Oficial EOL: El fin de SuiteScript 1.0 y 2.0
Basado en los Release Notes oficiales de NetSuite, Oracle ejecuta las obsolescencias por fases. Estas son las fechas clave que tu equipo TI debe manejar hoy:
Fin de 1.0 en Nuevas Cuentas
Oracle bloqueó la creación de nuevos scripts 1.0 para clientes nuevos. El soporte pasó a ser estrictamente reactivo.
Alertas de Gobernanza en 2.0
El CLI SuiteCloud fuerza validaciones server-side. Los scripts 2.0 antiguos muestran advertencias en logs de ejecución.
Deprecación Forzada Proyectada
Los scripts bajo @NApiVersion 2.0 serán obligados a compilar en GraalVM, lo que causará caídas si tienen mala sintaxis.
SuiteScript 2.0 vs 2.1: Mucho más que un número
SuiteScript 2.0 usaba el motor Rhino. SuiteScript 2.1 usa GraalVM, un motor de alto rendimiento que habilita características exclusivas:
- Procesamiento Asíncrono (Promises): El uso de
asyncyawaites nativo para no congelar el servidor en llamadas a base de datos. - ECMAScript Moderno: Soporte completo para Arrow Functions y Spread Operators.
- Módulos Exclusivos: Generadores criptográficos fuertes (
N/crypto/random) para integraciones bancarias y facturación electrónica.
Ejemplo Práctico: Refactorización Asíncrona
/**
* @NApiVersion 2.1
* @NScriptType Suitelet
*/
define(['N/query', 'N/log'], (query, log) => {
const onRequest = async (context) => {
try {
// Uso nativo de promesas sin bloquear el servidor
const result = await query.runSuiteQL.promise({
query: "SELECT id, tranid FROM transaction WHERE type = 'SalesOrd'"
});
log.debug('Resultados', result.results.length);
} catch (e) {
log.error('Error', e.message);
}
};
return { onRequest };
});Preguntas Frecuentes (FAQ)
¿Puedo cambiar la etiqueta a @NApiVersion 2.1 y ya está?
class o super), NetSuite arrojará un error de sintaxis y fallará.¿NetSuite borrará mis scripts antiguos en 1.0?
¿Cómo pruebo los scripts 2.0 antes de refactorizarlos?
No esperes a que tus scripts fallen en producción
El equipo de Arquitectos NetSuite de 2win.cl realiza auditorías profundas de tu instancia, identificando código legacy para ejecutar una migración transparente a SuiteScript 2.1.
Agenda tu Auditoría Técnica NetSuite