Atualização necessária: atualize os scripts para o SuiteScript 2.1

Nas últimas semanas, vários de nossos clientes nos procuraram preocupados com uma mensagem que começou a aparecer dentro da conta do NetSuite. O texto é o seguinte:

Atualização necessária: atualize os scripts para o SuiteScript 2.1

Um ou mais scripts desta conta utilizam o SuiteScript 1.0, 2.0 ou 2.x. Os scripts que utilizam essas versões deixarão de funcionar em uma versão futura do NetSuite. Para garantir a compatibilidade, converta seus scripts para o SuiteScript 2.1 o quanto antes. Mais informações estarão disponíveis em breve.

Lido dessa forma, no meio do painel e sem contexto, o aviso gera alarme. "Deixarão de funcionar", "o quanto antes" e "atualização necessária" em três linhas sugerem uma urgência iminente.

Ela não existe. Não há risco de interrupção nesta semana nem no próximo mês. Mas o aviso também não é irrelevante: marca o início de uma mudança real que convém planejar com antecedência.

Neste artigo explicamos o que a mensagem significa em termos simples, o que ela diz e o que não diz, e quais são os passos concretos que recomendamos na Deimos Solutions.

Atualizado. Incorporamos o calendário oficial que a Oracle publica em sua documentação, com a versão 2028.2 como prazo final. A conclusão de fundo não muda, não é uma emergência.

A resposta curta

Se você dispõe de apenas dois minutos, estes são os pontos essenciais:

• Seus scripts continuam funcionando hoje exatamente como ontem. O aviso é preventivo, não é um relatório de erro.
• O prazo final é a versão 2028.2. O aviso não a menciona, mas a Oracle a publica em sua documentação. São cerca de dois anos de margem.
• Não é uma emergência, mas também não é opcional. Em algum momento será necessário realizar a conversão.
• A prioridade não é migrar, e sim conhecer a situação atual. A maioria das empresas não sabe quantos scripts antigos existem em sua conta nem quais processos dependem deles.

Primeiro, o que é um "script" no NetSuite?

Se você não pertence à área técnica, esta seção organiza todo o restante.

O NetSuite inclui uma ampla funcionalidade padrão, mas nenhuma empresa opera exatamente igual à outra. O SuiteScript é a linguagem de programação que permite acrescentar ao NetSuite comportamentos próprios de cada negócio.

Na prática, um script é aquilo que faz o seu NetSuite funcionar sob medida para a sua operação. Por exemplo:

• Um fluxo de aprovação de pedidos de compra conforme valores e áreas.
• Um cálculo de comissões com a lógica específica da equipe comercial.
• A geração automática de um documento no formato exigido pelo seu país.
• Uma integração que sincroniza pedidos com o e-commerce ou o operador logístico.
• Validações que impedem registrar uma transação com dados incompletos.

São componentes que a maioria dos usuários nunca vê, mas que são executados dezenas ou centenas de vezes por dia em segundo plano.

As versões do SuiteScript, em termos simples

O SuiteScript passou por várias gerações ao longo dos anos:

É a mesma lógica de qualquer software: surgem versões novas, melhores e mais rápidas, e as anteriores são descontinuadas com o tempo. O NetSuite vem impulsionando a adoção do 2.x há anos. Não se trata de uma novidade repentina, e sim do capítulo previsível de um processo que começou em 2015.

"Congelado" não significa "fora de serviço"

A documentação oficial da Oracle é clara em relação ao SuiteScript 1.0: os scripts continuam sendo suportados, mas a funcionalidade do 1.0 não é mais atualizada e não há desenvolvimento de novas funções ou melhorias para essa versão.

Em outras palavras, o código antigo funciona, mas ficou parado. Não receberá melhorias, não poderá aproveitar as capacidades novas da plataforma e, a cada versão semestral do NetSuite, o ambiente sobre o qual ele se apoia se modifica ligeiramente.

Essa é a razão de fundo para migrar, independentemente de qualquer prazo.

Por que o aviso aparece agora?

Porque ele chegou com a versão 2026.2 do NetSuite.

A Oracle publica duas atualizações maiores por ano e as aplica conta por conta, de forma escalonada. A implantação da 2026.2 foi anunciada em julho de 2026 e alcançou as contas por etapas.

Isso explica uma dúvida que recebemos várias vezes: por que uma empresa viu o aviso e outra do mesmo grupo ainda não. Não se trata de um erro nem de um diagnóstico diferente. Simplesmente uma conta já foi atualizada para a 2026.2 e a outra ainda não.

O que o aviso NÃO diz (e convém esclarecer)

Este é o ponto que mais tranquilidade deveria trazer.

O aviso não menciona a data, mas a data existe. A mensagem fala de "uma versão futura do NetSuite" sem indicar qual. A documentação da Oracle publica o calendário completo.

O que importa continua valendo. Não há risco de uma interrupção imprevista, nada deixa de funcionar neste mês e há cerca de dois anos de margem. A diferença é que agora dá para planejar contra um número concreto em vez de uma incógnita.

Se você precisa transformar isso em uma decisão de negócio e não em uma tarefa técnica, desenvolvemos isso separadamente em O que significa para a sua empresa o NetSuite aposentar o SuiteScript 1.0, 2.0 e 2.x, pensado para quem decide e não para quem programa.

Há uma segunda mudança que costuma ser mencionada junto com esta e convém não misturá-las, a retirada do TBA (Token-Based Authentication), o método de autenticação utilizado por muitas integrações. Tem seu próprio calendário, com anos que se sobrepõem aos do SuiteScript,

• 2027.1 — não será possível criar novas integrações com TBA.
• 2028.1 (tentativo) — deixariam de funcionar as integrações existentes que ainda utilizem TBA.

São dois temas distintos que costumam ser mencionados juntos porque afetam o mesmo tipo de desenvolvimento antigo. Se você conta com integrações para sistemas externos, esse segundo ponto merece uma revisão própria.

A diferença entre versão declarada e versão executada

Este é o detalhe técnico mais relevante do artigo, e convém conhecê-lo mesmo sem trabalhar com código.

Cada script declara internamente com qual versão deve ser executado. Muitos desenvolvedores utilizaram historicamente a etiqueta genérica 2.x, entendendo que ela significava "a versão mais recente disponível".

Não é assim. Por padrão, 2.x é resolvido como 2.0, e não como 2.1.

O que isso implica? Que existem contas consideradas atualizadas que, na realidade, estão executando a versão anterior. E que a lista de scripts, observada superficialmente, não reflete a situação real: a versão declarada e a versão efetivamente executada são dois dados diferentes.

Por isso a primeira recomendação não é "migrar tudo", e sim determinar o que está sendo executado de fato.

Os três passos que recomendamos

1. Realizar o inventário

Antes de modificar uma única linha de código é necessário conhecer o ponto de partida. Isso implica listar todos os scripts da conta, identificar sua versão real e — o passo que com frequência é omitido — revisar também os plug-in implementations, que costumam ficar fora da lista principal e permaneceram em versões antigas por mais tempo que o restante.

O resultado é um documento concreto: quantos scripts existem, em que versão estão e qual processo do negócio depende de cada um.

2. Priorizar em vez de migrar tudo simultaneamente

Uma migração em massa e simultânea é a forma mais rápida de gerar o problema que se pretendia evitar. A prioridade deve seguir o risco do negócio: primeiro o que envolve dinheiro e fechamento contábil, depois o operacional e, por último, o acessório.

Existe uma alternativa pouco conhecida: o NetSuite oferece uma preferência no nível da conta que permite executar os scripts de servidor 2.0 dentro do ambiente 2.1 sem modificar o código. Os que validam corretamente demonstram ser compatíveis; os que não validam continuam sendo executados como 2.0, sem interrupções. É uma ferramenta de diagnóstico muito útil, desde que ativada primeiro em um ambiente sandbox e nunca diretamente em produção.

3. Testar em sandbox com transações reais

O fato de um script compilar na versão nova não garante que o processo do negócio continue correto. Uma mudança menor pode não gerar erro e ainda assim calcular de maneira distinta, e esse tipo de falha só é detectado no fechamento mensal.

Toda migração deveria ser validada em sandbox com dados e transações reais antes de se aproximar da produção.

O componente não técnico do projeto

Convém assinalar com clareza: traduzir a sintaxe de uma versão para outra é a parte simples.

A dificuldade está em outro lugar. Os scripts mais expostos a essa mudança costumam ser precisamente aqueles que funcionam sem problemas há mais anos. E um código executado sem modificações há oito anos foi escrito, na maioria dos casos, por alguém que já não faz parte da empresa, junto com o raciocínio que o sustentava.

O trabalho real, portanto, não é de tradução, e sim de reconstrução: compreender por que aquele script faz o que faz antes de reescrevê-lo. Recuperar esse critério original é o que demanda tempo, e se torna mais complexo a cada ano que passa.

É também o melhor argumento para não postergar: não pelo prazo, mas porque o conhecimento necessário para executá-lo corretamente vai se perdendo.

Perguntas frequentes

Existe risco de interrupção imediata?

Não. Os scripts continuam sendo executados normalmente. O aviso é uma advertência antecipada sobre uma mudança futura, não o relatório de uma falha.

Qual é o prazo real?

A Oracle publica o calendário em sua documentação. Em 2027.1 o SuiteScript 1.0 entra em fim de vida. Em 2028.1 os scripts 2.0 e 2.x passam a ser executados como 2.1 por padrão. Em 2028.2 todos os scripts devem usar 2.1. São cerca de dois anos de margem, suficiente para planejar sem pressa.

O aviso apareceu na minha conta e não na de outra empresa. Isso indica algum problema?

Não. As versões do NetSuite são aplicadas de forma escalonada, conta por conta. O aviso chega com a versão 2026.2, de modo que depende de quando cada conta foi atualizada.

Nunca solicitamos desenvolvimentos sob medida. Ainda assim nos afeta?

É possível. Muitas contas incorporam scripts que chegaram por meio de bundles, SuiteApps de terceiros ou integrações instaladas durante a implementação original. O inventário é a única forma de confirmar.

Qual é o custo deste processo?

Depende da quantidade de scripts e de sua complexidade. Uma conta com cinco scripts simples representa um trabalho de dias; uma com cem scripts inter-relacionados constitui um projeto. Por isso o diagnóstico vem primeiro: sem inventário, qualquer estimativa carece de fundamento.

Basta alterar a etiqueta de versão?

Em alguns casos sim, em muitos outros não. O SuiteScript 2.1 é mais rigoroso que o 2.0, e certas construções antes toleradas agora geram erro. Além disso, modificar a versão sem validar o comportamento é precisamente o cenário que produz erros silenciosos durante o fechamento.

A inteligência artificial resolve isso de forma automática?

Contribui de maneira significativa na parte mecânica: traduzir funções, reestruturar o código, gerar um primeiro rascunho. Porém não consegue identificar que determinado campo é preenchido por meio de uma solução alternativa da qual a equipe financeira depende, nem confirmar que a versão nova se comporta igual com dados reais. A IA reduz o esforço na parte simples, o que confere ainda mais peso à validação humana.

O que ocorre se nenhuma ação for tomada?

No curto prazo, nenhuma consequência. No médio prazo acumula-se dívida técnica: as capacidades novas da plataforma permanecem inacessíveis e, à medida que 2028.2 se aproxima, será necessário executar em poucos meses um trabalho que poderia ter sido distribuído em dois anos.

Inventário de scripts sem custo

Como assinalamos anteriormente, o primeiro passo não é migrar, e sim conhecer a situação atual. E esse passo não deveria depender da contratação de um serviço.

Por isso, na Deimos Solutions, abrimos uma convocatória a qualquer empresa usuária do NetSuite — seja cliente nosso ou não — para realizar um diagnóstico e inventário inicial sem custo algum.

O que a revisão inclui

• Identificação completa dos scripts da conta que serão afetados, incluindo aqueles que costumam ficar fora da lista principal.
• Classificação por nível de risco e versão, com a versão real de execução de cada script, não a declarada.
• Um relatório claro sobre a situação efetiva da plataforma, redigido em linguagem compreensível também para perfis não técnicos.

Com esse relatório disponível é possível tomar decisões fundamentadas: priorizar, planejar ou simplesmente arquivá-lo com a certeza de que a conta se encontra em bom estado.

Uma vez entregue, caso deseje que nossa equipe se encarregue da migração, enviamos uma proposta formal e um orçamento personalizado. Sem nenhum compromisso. O inventário fica à sua disposição em qualquer caso.

Deseja revisar o estado da sua conta?

Entre em contato e combinamos uma sessão breve com um de nossos consultores para iniciar o diagnóstico. Não é necessário preparar nada de antemão.

Conclusão

O aviso do SuiteScript 2.1 não constitui uma emergência, mas também não é uma mensagem que convenha ignorar durante dois anos.

A diferença entre as empresas que atravessam esse tipo de transição sem sobressaltos e as que acabam resolvendo urgências raramente é técnica. É de antecipação: umas conhecem o conteúdo de sua conta e outras o descobrem no dia em que algo deixa de funcionar.

A boa notícia é que hoje existe tempo suficiente para estar no primeiro grupo.

Se esta mensagem apareceu na sua conta e você deseja compreender exatamente o que ela implica no seu caso, entre em contato. Na Deimos Solutions trabalhamos com NetSuite todos os dias e podemos oferecer um panorama claro antes que qualquer decisão precise ser tomada.