Oracle NetSuite: erros de API travam integrações

Depois de nove anos usando o Oracle NetSuite na área de TI, minha conclusão é direta: os erros de API em integrações consomem mais tempo do nosso time do que qualquer ganho que o sistema entrega. Mensagens inúteis, falhas 500 aleatórias e lotes que não informam qual registro falhou transformam cada conexão em fonte recorrente de retrabalho. Para quem depende de dados saindo e entrando todo dia, esse desgaste pesa mais do que qualquer recurso do produto.

Por que os erros de API do Oracle NetSuite travam nossas integrações

O primeiro problema que enfrentamos é a dificuldade de integração. A API do Oracle NetSuite gera mais erros do que qualquer outra com a qual já trabalhei, e as mensagens são praticamente inúteis. Um exemplo recorrente: aparece "Invalid Entity ID" e, depois de horas investigando, o problema não tem relação nenhuma com entidades. Esse tipo de retorno faz o time caçar defeito no lugar errado, e como estamos falando de ferramentas de ETL rodando em produção, cada diagnóstico errado custa tempo de operação.

Além disso, a API dispara erros 500 aleatórios e falhas de autenticação com frequência razoável, e nossas ferramentas de ETL precisam lidar com isso o tempo todo. O recurso de enviar vários registros de uma vez existe, mas é quase inútil na prática: quando um único registro da carga falha, o Oracle NetSuite não diz qual foi. Ou seja, o lote inteiro vira um exercício de adivinhação. E como a leitura normalmente devolve um registro por vez, precisamos de outra via para extrair volume, o que nos leva ao ponto seguinte.

SuiteAnalyticsConnect: documentação escassa e falhas que reaparecem

Para tirar dados em massa, usamos o SuiteAnalyticsConnect, a conexão de banco somente leitura. Ele também gera muitos erros aleatórios, embora com menos frequência do que a API. O problema maior aqui é a documentação, que é extremamente escassa. Já gastei muitos e muitos dias de desenvolvimento procurando a tabela certa e a coluna certa, sem nenhuma referência confiável que encurtasse esse caminho.

O padrão que observamos ao longo dos anos é esse: entre a conexão de banco e a API, aparece pelo menos uma vez por mês uma mensagem de erro nova, que nunca tínhamos visto antes. E isso acontece até em integrações antigas, escritas há mais de cinco anos e que nunca foram alteradas. Quando uma integração estável simplesmente começa a falhar sem mudança do nosso lado, a confiança no Oracle NetSuite como base de integração cai bastante, porque o time passa a viver em modo de manutenção defensiva em vez de evoluir entregas.

SuiteScript e a dependência de especialistas caros

O sistema é muito personalizável, mas essa personalização exige especialistas que realmente saibam o que estão fazendo. Um usuário novato criando colunas com tipos de dados errados ou com estrutura ruim pode comprometer o negócio inteiro. Se a empresa passa a usar essa estrutura ruim no dia a dia, corrigir isso anos depois vira um esforço monumental dentro do Oracle NetSuite.

O SuiteScript, por sua vez, foi uma experiência ruim desde o começo. Fiz o bootcamp da ferramenta há alguns anos e achei a linguagem desajeitada: os nomes de função não fazem sentido, não existem pacotes de IDE úteis para escrever nessa variação estranha de JavaScript e há muitas armadilhas ao ler e gravar registros em nível de cabeçalho versus nível de linha. Contratamos várias consultorias ao longo dos anos, e o resultado é um emaranhado de scripts que ninguém entende nem ousa mexer, deixando cada gravação de registro e cada carregamento de página mais lentos.

O custo fecha o ciclo: programadores de SuiteScript cobram caro, administradores de Oracle NetSuite que sabem o que fazem também, e o licenciamento em si já é caro. Por isso nossa empresa acabou escrevendo vários sistemas auxiliares fora do Oracle NetSuite, que fazem as mesmas tarefas de forma mais rápida e em linguagens compreensíveis, e depois alimentam o Oracle NetSuite apenas para o setor de contabilidade revisar.

Também pagamos pelos pacotes de suporte avançado ao longo dos anos. Hoje o retorno leva umas duas semanas em vez de um mês, o que é uma melhora pequena, e quem atende são profissionais que muitas vezes têm dificuldade de comunicação e, em alguns casos, não resolvem o problema. Do ponto de vista de TI, minha avaliação é que o Oracle NetSuite é um produto ruim, e se você tem outras opções, vale olhar com mais cuidado antes de assinar.