Quando o Magento e o NetSuite se afastam
Com um catálogo pequeno, uma importação noturna em CSV vai safando. Numa loja Magento grande ou com muito B2B, esses mesmos atalhos tornam-se problemas todas as semanas:
- Os atributos e os produtos configuráveis desalinham-se. Um tamanho ou uma cor nova existe no NetSuite como artigo filho de uma matriz e nunca chega ao produto configurável do Magento, ou chega como um produto simples solto que ninguém encontra.
- Os clientes B2B veem o preço errado. Os preços por grupo de clientes e por empresa são mantidos em dois sítios, e a loja mostra a tabela de preços do trimestre passado.
- O stock está errado num website e certo noutro. Vários websites do Magento vendem a partir de localizações diferentes do NetSuite, e o mapeamento vive na cabeça de alguém.
- As devoluções seguem dois caminhos. Uma devolução do Magento e uma autorização de devolução do NetSuite descrevem a mesma encomenda, com quantidades diferentes e valores de reembolso diferentes.
- As finanças fecham às cegas. As encomendas são importadas tarde, em lotes ou à mão, pelo que a receita, os impostos e a tesouraria no NetSuite andam dias atrás da loja. Reconciliar os recebimentos com as encomendas passa a ser uma tarefa de fecho do mês em vez de diária.
Se um conector anterior «quase funciona» e ninguém é responsável por ele, tudo isto é resolvido à mão, uma exceção de cada vez.
Resposta curta: o Magento integra-se com o NetSuite? Sim. O Magento 2 e o Adobe Commerce disponibilizam API REST e assíncronas, e o NetSuite disponibiliza os serviços web SuiteTalk e os RESTlets. É possível ligá-los com uma integration app já construída, como a da Celigo, com outro conector ou com um desenvolvimento à medida. Seja qual for a escolha, a parte difícil é o desenho: como os produtos, os websites, os grupos de clientes e os reembolsos correspondem aos registos do NetSuite. Mover os dados é a parte fácil.
Magento Open Source ou Adobe Commerce: o mesmo problema de integração
O Adobe Commerce é a edição comercial do Magento, e o Magento Open Source é a gratuita. Para a integração, são uma só plataforma. As duas partilham o mesmo modelo de dados: websites, stores e store views, produtos, clientes e encomendas. As duas partilham as mesmas API, pelo que os padrões de integração são os mesmos.
O que muda é o que tem de ser sincronizado. O Adobe Commerce acrescenta funcionalidades B2B como contas de empresa, catálogos partilhados com preços por empresa, orçamentos e crédito de empresa (Adobe Commerce B2B introduction, consultado a 29 de setembro de 2026). Se forem usadas, a integração tem de levar esses preços e essas empresas para o NetSuite ou, no mínimo, não os estragar. Na fase de descoberta verificamos que funcionalidades da edição são de facto usadas, em vez de as presumir.
O que sincronizamos
A tabela reúne os fluxos que a Celigo publica para a sua NetSuite – Magento 2 Integration App (Celigo, NetSuite – Magento 2 Integration App, consultado a 29 de setembro de 2026), mais as devoluções, que desenhamos em cada projeto.
| Fluxo | Sentido | O que passa |
|---|---|---|
| Clientes | Magento → NetSuite, e NetSuite → Magento quando é preciso | Fichas de cliente e moradas |
| Encomendas de venda | Magento → NetSuite | Encomendas da loja, com descontos e cartões-oferta usados como linhas da encomenda |
| Encomendas criadas no NetSuite | NetSuite → Magento | Encomendas introduzidas no back office, quando têm de aparecer na conta do cliente |
| Artigos e produtos | NetSuite → Magento | Produtos, imagens, categorias, atributos e preços, incluindo artigos matriz e kits do NetSuite |
| Stock | NetSuite → Magento | Níveis de stock de uma ou várias localizações do NetSuite |
| Expedições | NetSuite → Magento | Envios e seguimento, para que o cliente veja a encomenda como expedida |
| Faturação | NetSuite → Magento | Estado da fatura e do pagamento, conforme o modelo de captura definido |
| Cancelamentos e reembolsos | NetSuite → Magento | Encomendas canceladas e reembolsos, registados no NetSuite como cash refunds ou credit memos |
| Devoluções (RMA) | Nos dois sentidos, se estiverem no âmbito | Devoluções do Magento emparelhadas com autorizações de devolução do NetSuite. Desenhadas em cada projeto; não são um fluxo-padrão da app |
Três vias: Celigo, outro conector ou à medida
| Via | Serve quando | Atenção a |
|---|---|---|
| Celigo Magento 2 – NetSuite Integration App | Os processos estão próximos de um order-to-cash padrão e se quer monitorização, gestão de erros e alertas numa plataforma, não em código | O custo da licença e os casos-limite que exigem fluxos à medida ao lado da app |
| Outro conector Magento–NetSuite | Um âmbito restrito, como só encomendas e stock, que um produto mais simples cobre | Quem o suporta, como trata erros e novas tentativas, e se cobre as funcionalidades da edição em uso |
| Desenvolvimento à medida sobre as API | Muita lógica B2B, modelos de produto pouco habituais, ou volumes e tempos que os modelos-padrão não aguentam | O código, a monitorização e as atualizações dos dois lados passam a ser da empresa |
A Celigo é a nossa via principal. A Celigo indica suportar os principais tipos de artigo do NetSuite (inventário, matriz, kits). Liga vários websites, stores e store views do Magento a uma só conta NetSuite. Pode registar os descontos no NetSuite como códigos de cupão, promoções ou linhas, e pode calcular os impostos com o SuiteTax do NetSuite ou com o motor de impostos do Magento (Celigo, consultado a 29 de setembro de 2026). A app corre sobre a plataforma de integração da Celigo, pelo que os fluxos beneficiam dos dashboards, da gestão de erros e dos alertas da plataforma. Os fluxos à medida podem coexistir com a app na mesma plataforma.
Outros conectores existem, desde extensões do Magento a middleware construído por parceiros. Alguns servem bem para um âmbito restrito. Antes de escolher um, convém perguntar quem o corrige quando uma encomenda falha às duas da manhã, e se alguém além do programador original o percebe.
À medida significa as API REST e assíncronas em lote do Magento de um lado e o SuiteTalk ou os RESTlets do NetSuite do outro. Os endpoints assíncronos do Magento colocam cada pedido em fila e devolvem um identificador que pode ser consultado depois, o que conta em grandes atualizações de catálogo (Adobe Commerce, asynchronous web endpoints, consultado a 29 de setembro de 2026). Desenvolvemos à medida quando o modelo-padrão não chega, não por defeito. Muitas vezes a resposta é híbrida: a app para os fluxos-padrão e fluxos à medida para o único processo que é só da empresa.
Para a escolha mais geral entre iPaaS, código ponto a ponto e middleware, veja iPaaS, ponto a ponto ou middleware.
Decisões de desenho próprias do Magento
São estas as decisões que fazem uma integração Magento–NetSuite funcionar ou falhar. Fechamo-las no blueprint, antes de construir qualquer fluxo.
- Produtos configuráveis e bundle. Decidir que tipo de artigo do NetSuite suporta cada tipo de produto do Magento: artigos matriz para os configuráveis, kits ou montagens para os bundle. Depois, decidir que sistema é dono dos atributos. Errar aqui é a causa mais comum de desalinhamento do catálogo.
- Websites, stores e store views. O Magento herda a configuração em cascata do nível global para o website, a store e a store view. As store views costumam ter o idioma e a moeda (Adobe Commerce, site, store and view scope, consultado a 29 de setembro de 2026). Cada website tem de corresponder a uma subsidiária, uma localização, um nível de preço e uma moeda do NetSuite. Esse mapeamento deve ficar explícito.
- Grupos de clientes B2B e preços por empresa. Escolher onde os preços são mantidos e como os grupos de clientes e os catálogos partilhados correspondem aos níveis de preço ou aos preços por cliente do NetSuite. Escolher também o que acontece quando os dois não coincidem.
- Impostos. Escolher um único motor, o SuiteTax ou o do Magento, para calcular os impostos, e garantir que o outro sistema os regista em vez de os recalcular.
- Pagamentos e captura. Decidir se o pagamento é capturado no Magento no checkout ou no NetSuite depois da expedição, porque isso muda os fluxos de fatura e de tesouraria.
- Sincronização incremental do catálogo. Enviar só o que mudou, em lotes que a API assíncrona do Magento consiga absorver, em vez de enviar o catálogo completo todas as noites.
- Devoluções e reembolsos. Decidir que sistema abre a devolução e se um reembolso se torna um cash refund ou um credit memo no NetSuite. Depois, manter os dois registos ligados. O nosso artigo sobre devoluções, reembolsos e notas de crédito trata a parte contabilística.
Como decorre o projeto
- Chamada de descoberta. Trinta minutos sobre os sistemas, as edições, os piores passos manuais e se serve a app da Celigo, um conector ou um desenvolvimento à medida.
- Blueprint de integração. Mapeamos cada fluxo e as decisões de desenho acima, e entregamos um âmbito fechado com esforço e prazos.
- Construção e testes. Construímos em sandbox, testamos com o catálogo e as encomendas reais, e revemos os casos-limite com a equipa: configuráveis, stock multiwebsite, preços B2B, reembolsos.
- Go-live e suporte. Colocamos em produção, acompanhamos de perto as primeiras sincronizações e continuamos presentes.
Depois do go-live
Uma integração sem responsável degrada-se. Depois do go-live monitorizamos os fluxos em produção, tratamos erros e novas tentativas, e alteramos os fluxos quando o catálogo, os websites ou os processos mudam. Os alertas chegam a alguém que sabe o que cada fluxo faz. Se a empresa preferir assumir a integração, formamos a equipa e entregamos documentação que reflete o que está de facto a correr. O que falha depois do lançamento, e quem o corrige, é tratado em suporte ao ERP após o go-live.
Porquê a Atypical Tech
- Authorized Celigo Partner. As integrações com a Celigo são a nossa atividade principal, não um serviço secundário. Veja a nossa parceria com a Celigo.
- Profundidade em NetSuite. Mais de dez anos de engenharia de ERP e integração. Conhecemos os registos e a contabilidade por trás de cada fluxo, não só a canalização.
- Order-to-cash de ecommerce de ponta a ponta. Das encomendas de ecommerce no ERP à exatidão do inventário multicanal. Também integramos o NetSuite com o Shopify e o NetSuite com o WooCommerce.
- Europa, na sua língua. Engenheiros seniores em Espanha, a trabalhar em inglês, espanhol, português e catalão, no mesmo fuso horário.
Fontes
- Celigo, NetSuite – Magento 2 Integration App, consultado a 29 de setembro de 2026.
- Adobe, Introduction to Adobe Commerce B2B, consultado a 29 de setembro de 2026.
- Adobe, Site, store and view scope, consultado a 29 de setembro de 2026.
- Adobe, Asynchronous web endpoints, consultado a 29 de setembro de 2026.