Integração NetSuite: conectores, API e fluxos a manter

Procurar um conector NetSuite é quase sempre sinal de que o ERP deixou de ser uma ilha: a loja online precisa de stock em tempo útil, o banco devolve extratos que alguém reconcilia à mão, o gabinete de contabilidade pede ficheiros, a direção quer indicadores noutra ferramenta. Esta página explica o que existe, o que a API NetSuite permite, como cadrar uma integração NetSuite em Portugal e, sobretudo, quem fica responsável por ela depois da entrada em produção.

Se ainda está a avaliar a plataforma no seu conjunto, comece pelo guia sobre o NetSuite em Portugal e pela visão dos módulos disponíveis. Aqui o assunto é o que liga o NetSuite ao resto.

As formas de integrar o NetSuite

Há, em termos gerais, quatro caminhos. A escolha depende da complexidade do fluxo e da frequência com que os sistemas mudam.

Nenhuma é melhor em abstrato. Um conector padrão para a loja online pode bastar durante anos; a ligação a um sistema de gestão de armazém industrial raramente se resolve sem trabalho à medida. A personalização do NetSuite trata esse segundo cenário.

API NetSuite: o que o SuiteTalk oferece

A interface programática principal chama-se SuiteTalk e existe em duas famílias: serviços web REST e serviços web SOAP.

Serviços web REST

Os serviços web REST de SuiteTalk permitem as operações CRUD sobre registos (criar, ler, atualizar, apagar), o acesso a metadados, o filtro de coleções, ações e transformações de registos e o processamento assíncrono. Permitem também executar conjuntos de dados de livros de cálculo do SuiteAnalytics e consultas SuiteQL. Ao contrário dos RESTlets, não exigem implementar um script no NetSuite, o que reduz o código a manter do lado do ERP.

Para uma PME, isto traduz-se em algo muito prático: uma aplicação externa pode criar uma encomenda de venda, transformá-la em fatura ou consultar saldos sem que alguém tenha de escrever e publicar um script dentro do sistema. Convém, ainda assim, que o integrador defina quem pode fazer o quê, com um papel dedicado e permissões mínimas.

Serviços web SOAP: um calendário a conhecer

Os serviços web SOAP continuam a existir, mas estão em fim de vida. O WSDL 2025.2 é o último ponto de acesso SOAP previsto; a partir da versão 2027.1 só esse será suportado; e depois da versão 2028.2 o SOAP deixa de estar disponível. A própria documentação recomenda REST com OAuth 2.0 para toda a integração nova.

O SOAP de SuiteTalk usa codificação Document (trocas XML orientadas à mensagem, sem suporte a RPC), transporte exclusivamente HTTPS, controlo de acesso por papel (existe um papel «Web Services Only») e pedidos síncronos ou assíncronos. Estes detalhes importam menos do que a consequência: se uma ligação existente ainda usa SOAP, ela tem de entrar no plano de migração. Se a sua empresa herdou um conector antigo, peça ao integrador um inventário e uma data de reescrita, em vez de esperar pelo último momento. A auditoria de um projeto NetSuite começa muitas vezes por este inventário.

Ecossistema de extensões

O NetSuite dispõe de um ecossistema de aplicações complementares publicadas por editores terceiros, instaláveis sobre a conta. Para o decisor, três cuidados:

• Perceber quem é o editor: o suporte da extensão não é o do NetSuite, e a vida da extensão depende da empresa que a mantém.
• Verificar a compatibilidade com as versões: o NetSuite evolui em ciclos regulares, e uma extensão desatualizada pode quebrar um fluxo. Veja a nossa página sobre versões e edições.
• Contabilizar o custo recorrente: muitas extensões têm licença própria, que se soma à do ERP (ver preços do NetSuite).

E-commerce, marketplaces e vendas

A ligação à loja online é a integração mais pedida. O que deve circular precisa de ser decidido por escrito, não suposto:

• artigos, variantes, preços e promoções (do ERP para a loja);
• stock disponível (do ERP para a loja, com a frequência que o negócio exige);
• encomendas e pagamentos (da loja para o ERP);
• estados de expedição, devoluções e notas de crédito (nos dois sentidos);
• dados de clientes, com cuidado quanto ao RGPD.

Em Portugal, juntam-se duas questões. A primeira é a faturação: quem emite a fatura, a loja, o ERP ou um programa de faturação à parte, e como esse documento, com ATCUD e código QR, chega à contabilidade. A segunda é o IVA aplicável às vendas para outros países da União Europeia. Ambos os pontos devem ser validados com o contabilista certificado antes do arranque. Para o contexto setorial, veja o ERP para comércio eletrónico e o cruzamento com vendas e CRM no NetSuite.

Com os marketplaces, o risco é outro: cada plataforma impõe o seu formato de catálogo, as suas regras de preços e os seus prazos de resposta. Um conector único raramente cobre todas. Prefira começar por um canal, estabilizar e só depois acrescentar o seguinte.

Bancos, pagamentos e tesouraria

A integração bancária tem um objetivo simples: deixar de reconciliar extratos à mão. Os cenários habituais são a importação de extratos, a emissão de ficheiros de pagamentos a fornecedores no formato SEPA e a ligação a prestadores de pagamento online para conciliar recebimentos da loja.

Antes de escolher, esclareça com o seu banco e com o integrador:

1. que formatos de extrato e de ordens de pagamento o banco aceita;
2. quem aprova os pagamentos antes do envio (separação de funções);
3. como se tratam as diferenças de conciliação.

O resultado deve ser visível em contabilidade e finanças no NetSuite, onde a conciliação bancária e as contas a pagar e a receber passam a ter origem nos mesmos dados.

A AT, o SAF-T (PT) e a faturação certificada

Este é o ponto onde Portugal difere mais de outros mercados. A integração com o ERP não pode ignorar:

• o SAF-T (PT), ficheiro que o contabilista certificado e a AT esperam em formato normalizado;
• a certificação do software de faturação: o programa que emite faturas tem de estar certificado pela AT;
• o ATCUD e o código QR nos documentos;
• a comunicação de faturas e outros documentos através do e-fatura.

Quando a faturação é feita fora do NetSuite (por exemplo, num terminal de venda ou numa aplicação setorial), a integração passa a ter de trazer para o ERP documentos já emitidos, sem os alterar, e de garantir que a contabilidade e o SAF-T refletem a mesma realidade. Consulte as nossas páginas sobre SAF-T (PT) e ERP, software de faturação certificado e faturação eletrónica. Não presuma o que o NetSuite cobre de origem para o mercado português: peça ao integrador uma resposta escrita para o seu caso.

BI, EDI, assinatura e ferramentas de escritório

Outras ligações aparecem com frequência em projetos de PME e ETI:

• Análise e BI: os conjuntos de dados SuiteAnalytics e as consultas SuiteQL, acessíveis pela API REST, alimentam painéis noutras ferramentas. O ponto crítico é a definição única dos indicadores, para que a direção e o financeiro não discutam números diferentes.
• EDI: grandes clientes da distribuição e da indústria exigem troca eletrónica de encomendas, avisos de expedição e faturas. Normalmente passa por um prestador especializado ligado ao ERP; os formatos dependem do cliente.
• Assinatura eletrónica: contratos e documentos de adjudicação podem ser assinados numa ferramenta externa e arquivados no registo correspondente do ERP.
• Escritório e correio: exportações para folha de cálculo e ligação ao correio eletrónico são úteis, desde que não se transformem em circuitos paralelos à margem do sistema.
• Armazém e transporte: leitores de código de barras, sistemas de gestão de armazém e transportadoras. Ver stocks e compras no NetSuite e ERP para logística.

Como cadrar um fluxo de integração

Uma integração falha raramente por causa da tecnologia; falha porque ninguém definiu o que devia acontecer. Recomendamos que cada fluxo tenha uma ficha com os seguintes elementos:

Esta ficha é um dos documentos mais úteis do caderno de encargos de um ERP e deve estar fechada antes de começar a programar. Na fase de arranque, as integrações entram no plano descrito em implementação do NetSuite; se vem de outro sistema, a migração tem de coordenar os dois calendários.

Quem mantém as integrações?

Esta é a pergunta que mais se esquece. Uma integração tem vários donos possíveis, e a falta de um deles é a causa de muitos incidentes:

• A empresa utilizadora é responsável pelos dados e pelas decisões de negócio (que preço vale, que stock é visível).
• O integrador NetSuite assegura, quando contratado para isso, o desenho, o desenvolvimento e a correção dos fluxos feitos à medida.
• O editor da extensão ou do conector responde pelo seu produto, não pelo seu uso específico.
• O prestador externo (loja, banco, EDI) mantém a sua parte e pode alterar formatos sem aviso longo.

Num contrato de suporte e manutenção do NetSuite devem ficar escritos o âmbito das integrações cobertas, o modo de abrir um pedido, a monitorização dos erros e o procedimento de teste a cada atualização do NetSuite. Sem isso, a primeira alteração do lado do parceiro externo torna-se um problema sem responsável.

Lembre-se também do ciclo de vida: o calendário do SOAP mostra que as interfaces mudam. Uma integração bem documentada, com credenciais geridas e testes repetíveis, sobrevive a essas mudanças; uma integração que depende da memória de uma pessoa não.

Erros frequentes nas integrações

• Integrar tudo de uma vez: arrancar com muitos fluxos sem estabilizar nenhum.
• Sem sistema de referência: o mesmo cliente ou preço pode ser alterado em dois sítios.
• Ignorar os erros silenciosos: sem alertas, uma encomenda recusada só se descobre quando o cliente reclama.
• Construir sobre SOAP novos fluxos quando a documentação recomenda REST.
• Esquecer a conformidade portuguesa: ATCUD, SAF-T (PT) e programa certificado condicionam o desenho.
• Contas partilhadas: usar a conta de um colaborador para a integração. Crie um papel dedicado.

Estes pontos aparecem também no nosso guia sobre erros em projetos ERP.

Como escolher o parceiro certo para as integrações

Ao consultar integradores, peça exemplos de fluxos semelhantes aos seus (loja online, banco, EDI), a forma como documentam e testam, e quem assegura o suporte após a entrada em produção. Pergunte explicitamente como tratam o fim do SOAP e que abordagem seguem para novos desenvolvimentos. A página como escolher o parceiro NetSuite detalha os critérios. A Integrador ERP não é afiliada à Oracle nem a nenhum integrador: pomos em contacto, gratuitamente, a sua empresa com um profissional adequado ao seu projeto; o trabalho de integração é feito por esse profissional, sob contrato consigo.

Os nomes de software mencionados são marcas dos respetivos editores, citadas a título meramente informativo. Este site é independente e não é afiliado a nenhum editor.