Integração entre Salesforce e NetSuite: sincronização segura entre CRM e ERP

O desafio: conectar dois ecossistemas empresariais sem perder a rastreabilidade

Em organizações nas quais os dados são atualizados constantemente, é fundamental garantir que CRM e ERP trabalhem de forma sincronizada. Salesforce e NetSuite são líderes em suas categorias, mas integrá-los de forma segura e com rastreabilidade completa exige estratégia, arquitetura e experiência.

A AT Vault foi escolhida para unificar a gestão de clientes, cotações, pedidos e faturamento entre os dois sistemas, eliminando tarefas manuais e garantindo a consistência dos dados em tempo real.

O objetivo: uma integração bidirecional, segura e escalável. Projetamos e implementamos uma integração completa entre Salesforce e NetSuite, utilizando tecnologias nativas e padrões abertos para garantir uma comunicação confiável e rastreável entre os dois sistemas.

A solução: dois canais de sincronização

• Outbound (Salesforce → NetSuite): integração via SOAP SuiteTalk 2022.2 com Token Based Authentication (TBA), para enviar registros essenciais do Salesforce ao NetSuite.
• Inbound (NetSuite → Salesforce): endpoints Apex REST JSON que recebem informações do NetSuite, fazem sua desserialização e atualizam os objetos do Salesforce por meio de upserts automáticos.

O resultado: uma sincronização fluida, segura e modular, preparada para escalar à medida que o negócio cresce.

Arquitetura técnica: simples, modular e preparada para escalar

Arquitetura da integração

A arquitetura que projetamos foi baseada em quatro camadas:

• Ativação: triggers Apex que detectam alterações e disparam fluxos outbound.
• Orquestração: handlers especializados que estruturam os dados e a lógica.
• Transporte: helper HLP_NetSuiteCallout com assinatura TBA e gerenciamento HTTPS.
• Persistência: correlação entre registros do Salesforce ↔ NetSuite por meio de IDs externos.

Esse modelo modular permite estender facilmente a integração a novos objetos ou processos sem afetar o núcleo da solução.

Principais fluxos de integração

A integração abrange todo o ciclo de relacionamento entre cliente, venda e faturamento:

Salesforce → NetSuite

1. Account → Customer: Cada criação / alteração no Salesforce cria / atualiza um Customer no NetSuite por meio de uma solicitação SOAP assinada com TBA. O identificador internalId retornado pelo NetSuite é armazenado no Salesforce para manter a sincronização futura.
2. Contact → Contact: Os contatos associados às contas são replicados e atualizados automaticamente, garantindo a consistência entre CRM e ERP.
3. Quote → SalesOrder: Quando uma cotação passa para o status Accepted, o Salesforce gera uma SalesOrder no NetSuite com todos os itens e valores correspondentes, executada de forma assíncrona com @future(callout=true).

NetSuite → Salesforce

1. SalesOrder → Order / OrderItem: Os pedidos criados no NetSuite são enviados ao Salesforce por meio de Apex REST, gerando Orders e OrderItems, vinculados automaticamente às Quotes originais.
2. Invoice → Invoice: As faturas emitidas no NetSuite são integradas ao Salesforce no objeto personalizado Inovice__c, incluindo valores, moeda e relacionamento com o pedido associado.
3. Item → Product2 + PricebookEntry: Os produtos do NetSuite são sincronizados com o Salesforce, criando ou atualizando automaticamente suas versões em Product2 e no Standard Pricebook.

Diagrama da integração entre Salesforce e NetSuite para sincronizar CRM e ERP com fluxos bidirecionais seguros.

Inteligência técnica: assincronia, idempotência e consistência

A arquitetura que implementamos garante consistência e resiliência diante de falhas por meio de uma abordagem baseada em:

• Processos assíncronos, que otimizam o desempenho e evitam bloqueios em transações complexas.
• Chaves técnicas de correlação (como ID_NetSuite__c ou NTS_fld_internalIdNTS__c) para garantir a idempotência e evitar duplicidades.
• Sincronização de catálogos que atualiza automaticamente produtos, preços e relacionamentos entre objetos padrão e personalizados.

A segurança da integração foi um dos pilares fundamentais do projeto:

A segurança foi um dos pilares fundamentais da integração. Para proteger a comunicação entre Salesforce e NetSuite, foram utilizados mecanismos robustos de autenticação e permissões controladas.

• TBA (Salesforce → NetSuite): assinaturas HMAC-SHA256 com HTTPS.
• OAuth 2.0 (NetSuite → Salesforce): usuário de integração com permissões controladas.

Graças a essa configuração, a comunicação entre os sistemas atende aos mais altos padrões de segurança corporativa.

Resultados e benefícios

A implementação possibilitou a automação completa do fluxo comercial e contábil, gerando resultados concretos:

O projeto permitiu reduzir o tempo dedicado a atividades administrativas em 60 %, eliminar registros duplicados e oferecer rastreabilidade completa, da oportunidade à fatura. Isso gerou um impacto direto na produtividade das equipes comercial e financeira.

O que aprendemos com essa integração?

Estudo de caso: como a AT Vault implementou uma integração bidirecional entre Salesforce e NetSuite para unificar vendas, operações e faturamento.

• Definir o sistema mestre de cada objeto: clientes, produtos, pedidos e faturas.
• Usar IDs externos para manter a correlação entre as plataformas.
• Projetar processos idempotentes para evitar duplicidades.
• Separar a lógica de negócio, o transporte e a persistência.
• Registrar erros e respostas para facilitar o suporte e a auditoria.

Principais aprendizados deste caso

Integrar Salesforce e NetSuite não é apenas possível: é estratégico. Com uma arquitetura bem projetada, é possível escalar sem perder controle nem segurança.

Na AT Vault, ajudamos empresas a conectar seus ecossistemas de negócios com integrações seguras, modulares e rastreáveis.

Perguntas frequentes

Quanto tempo leva uma integração entre Salesforce e ERP como esta?

Uma integração bidirecional completa como a deste caso leva de 6 a 12 semanas, dependendo das regras de negócio. A versão por fases (inicialmente somente leitura) gera valor já no primeiro mês.

O que significa uma integração ser idempotente?

Significa que, se a mesma mensagem for processada duas vezes — devido a uma nova tentativa ou falha de rede —, o resultado será o mesmo: clientes e pedidos não serão duplicados. Esse é o principal requisito técnico de uma integração confiável.

Esse padrão pode ser usado com outros ERPs?

Sim: a arquitetura (canais por entidade, filas e reconciliação) também se aplica a SAP Business One, Tango ou Odoo — o conector muda, mas o padrão permanece. Temos um guia geral de integração entre Salesforce e ERP em Recursos.