Integração Protheus VTEX: Como funciona e como estruturar?

A integração Protheus VTEX conecta o ERP da TOTVS à plataforma de e-commerce, fazendo os dois sistemas trocarem informações sem digitação manual. O Protheus permanece como a fonte oficial da operação, estoque, preços, pedidos e faturamento, e a VTEX executa a venda com dados sempre fiéis à gestão.

Essa divisão não é preferência de fornecedor. A própria documentação da VTEX trata o ERP como ponto de partida da integração de back-office: é dele que devem vir catálogo, saldo e política de preço, e é para ele que os pedidos devem retornar.

O que é sincronizado: produtos e SKUs, estoque por depósito, tabelas de preço, pedidos, clientes, notas fiscais, faturamento, status e cancelamentos.

Neste conteúdo você vai ver por que o Protheus precisa ser a fonte oficial, como funciona o fluxo completo, os três mapeamentos que decidem o sucesso do projeto, onde a nota fiscal deve nascer e o risco técnico que a maioria dos projetos ignora até o primeiro fechamento.

O que é a integração Protheus VTEX?

É a conexão automatizada entre o ERP TOTVS Protheus e a plataforma VTEX, que faz os dois sistemas trocarem informações sozinhos.

O Protheus, também conhecido como Microsiga, é o ERP da TOTVS voltado a operações industriais, comerciais e de distribuição. Sua força está no fiscal, no controle de estoque e na profundidade de regras de negócio. A VTEX é uma das principais plataformas de e-commerce da América Latina, com estrutura própria de catálogo, políticas comerciais e gestão de pedidos.

Sem integração, esses dois mundos só se comunicam por digitação. Cada pedido da loja precisa ser lançado no ERP à mão. Cada movimentação de estoque precisa ser refletida no site. Cada nota fiscal vira tarefa manual.

A integração elimina essa ponte humana: o evento em um sistema dispara automaticamente a ação correspondente no outro.

Um ponto sobre o perfil das empresas que usam essa combinação. Protheus e VTEX se encontram, normalmente, em operações de médio e grande porte, com catálogo extenso, múltiplas filiais, regras fiscais elaboradas e volume que não comporta processo manual. O desafio aqui não é organizar a operação, e sim conectá-la a um canal que roda em outra velocidade sem quebrar o que já funciona.

Quantas horas por semana o seu time gasta transferindo pedido da VTEX para o Protheus? Some isso por doze meses e você terá o custo real de operar sem integração, um número que costuma surpreender quem nunca parou para calcular. Vale colocar essa conta no papel e consultar a Plugar.me antes de qualquer decisão.

Por que o Protheus deve ser a fonte oficial dos dados?

Porque quando duas fontes disputam a mesma informação, nenhuma delas é confiável.

O cenário mais comum em operações mal estruturadas é este: o estoque “oficial” é mantido na VTEX, o cadastro é editado direto no admin da plataforma, o preço é ajustado por quem cuida da loja e o Protheus recebe os dados por último — quando recebe. O resultado é previsível: duas versões do mesmo número, conciliação manual no fim do mês e ninguém sabendo qual sistema está certo.

Com o ERP no comando, a lógica se organiza em quatro frentes:

Estoque: o saldo da loja é reflexo do saldo do Protheus, não um número mantido à parte. Cada venda, devolução, entrada ou ajuste no ERP recalcula o disponível e a VTEX acompanha. É o que impede a loja de vender o que já saiu do depósito.

Preços: a política de preço nasce no ERP e é publicada na plataforma. Reajustes, promoções e tabelas por canal deixam de existir em duas planilhas paralelas que ninguém sabe qual está valendo.

Pedidos: a venda acontece na VTEX, mas o pedido é processado no Protheus, onde as regras de reserva, separação e expedição já estão estabelecidas. A loja não vira um segundo sistema de gestão.

Faturamento: a nota nasce no sistema que domina a tributação da empresa, com o TES correto, e a informação retorna à plataforma. O fiscal não migra para onde não deveria estar.

Existe ainda um ganho estratégico: independência de canal. Com o Protheus no centro, adicionar um marketplace ou uma segunda loja não exige refazer a espinha dorsal da operação. O canal novo se conecta à estrutura que já existe.

Se hoje alguém precisa conferir dois sistemas para saber quanto estoque a empresa realmente tem, o problema não é falta de ferramenta, é falta de uma fonte oficial. Vale mapear como os seus dados circulam hoje antes de contratar qualquer integração: esse diagnóstico costuma revelar mais do que se espera.

Como funciona a integração entre Protheus e VTEX?

A integração funciona como uma esteira automática que acompanha o ciclo completo do pedido. O caminho da informação é direto:

Protheus (ERP) ⟷ Hub de integração ⟷ VTEX

O ERP é a origem dos dados de cadastro, estoque, preço e fiscal. O hub traduz e orquestra a comunicação nos dois sentidos. A plataforma executa a venda e devolve os pedidos. Veja cada etapa.

1. Publicação do catálogo

O produto é cadastrado no Protheus, com código, descrição, dados fiscais e regras comerciais. A integração publica esses itens na VTEX já no formato de produto e SKU que a plataforma utiliza, com as variações mapeadas corretamente.

2. Sincronização de estoque

Cada movimentação no Protheus recalcula o saldo, e a integração atualiza o inventário na VTEX — respeitando a estrutura de depósitos da plataforma, para que a loja mostre o disponível real de cada origem.

3. Atualização de preços

A tabela de preço definida no ERP chega à plataforma automaticamente. Quando a empresa trabalha com condições distintas por canal, cada valor é direcionado à política comercial correspondente.

4. Captura de pedidos

Concluída a venda, o pedido desce para o Protheus em segundos, com itens, valores, dados do comprador e forma de pagamento. O ERP assume dali em diante: reserva, separação e expedição seguem o fluxo já conhecido.

5. Cadastro de clientes

Se o comprador é novo, o cadastro é criado automaticamente no ERP. Se já existe, o sistema reaproveita. Sem base duplicada e sem digitação.

6. Faturamento e emissão de NF-e

Com o pedido no ERP, a nota é emitida pelo Protheus, respeitando o TES e o regime tributário da empresa. A informação retorna à VTEX, mantendo o histórico do pedido completo na plataforma.

7. Retorno de status e rastreio

Faturamento, código de envio e atualizações logísticas voltam para a loja. O cliente acompanha tudo pela própria plataforma e o time de atendimento para de responder “cadê meu pedido”.

Existe uma diferença enorme entre ver uma apresentação genérica de integração e ver o fluxo desenhado com os dados da sua operação, catálogo real, filiais reais, regras fiscais reais. O segundo tipo de conversa costuma responder em uma hora perguntas que o time carrega há meses. Vamos ajudar você agora mesmo!

Quais dados são sincronizados entre Protheus e VTEX?

A integração cobre o ciclo completo da operação. A tabela resume o que trafega e em qual direção:

Dados	Sincronização	Direção principal
Produtos e SKUs	✔	Protheus → VTEX
Estoque por depósito	✔	Protheus → VTEX
Tabelas de preço	✔	Protheus → VTEX
Pedidos	✔	VTEX → Protheus
Clientes	✔	VTEX → Protheus
Notas fiscais	✔	Protheus → VTEX
Faturamento e status	✔	Protheus → VTEX
Cancelamentos e devoluções	✔	Nas duas direções

A lógica confirma o princípio da fonte oficial: o que é cadastral, comercial e fiscal nasce no ERP e desce para a loja. O que é da venda nasce na plataforma e sobe para a gestão. Cancelamentos correm nos dois sentidos, porque tanto o cliente pode desistir quanto a operação pode identificar um problema internamente.

Integrar apenas estoque e pedido resolve metade do problema e deixa preço e fiscal no manual, justamente onde os erros custam mais caro e demoram mais para aparecer. Vale conferir, item por item dessa tabela, o que a sua integração atual realmente cobre.

Catálogo, política comercial e estoque: os três mapeamentos que decidem o projeto

Aqui está o que separa uma integração que funciona de uma que gera retrabalho permanente. A VTEX tem uma estrutura de dados própria, e a qualidade do projeto depende de três decisões de mapeamento tomadas logo no início.

O modelo de produto e SKU. A VTEX organiza o catálogo em dois níveis: o produto é o item comercial e os SKUs são suas variações, tamanho, cor, voltagem. O Protheus, por sua vez, organiza itens conforme a estrutura definida na implantação de cada empresa. Traduzir uma coisa na outra exige decisão explícita: o que vira produto, o que vira SKU, quais atributos alimentam cada nível.

As políticas comerciais. A VTEX permite operar mais de uma política comercial, cada uma com sua tabela de preço e seu estoque. É recurso poderoso para quem vende B2C e B2B na mesma plataforma, opera marcas distintas ou trabalha com condições especiais por canal. A pergunta que o projeto precisa responder é: qual tabela do Protheus alimenta qual política? Sem essa definição, o preço certo chega ao canal errado.

O estoque por depósito. A plataforma trabalha com depósitos e regras de envio associadas a eles. Uma operação com múltiplas filiais precisa decidir de qual depósito do Protheus a loja consome saldo, se trabalha com estoque consolidado ou se reserva parte do inventário para o canal digital. Cada escolha tem efeito direto no prazo de entrega prometido ao cliente.

Essas três decisões são de negócio, não de tecnologia. Elas precisam ser tomadas por quem conhece a operação, e é justamente por isso que um bom projeto começa por um mapeamento, não por uma implantação.

Onde a nota fiscal deve nascer?

No Protheus, sem discussão, e o motivo vai além do óbvio.

O ERP é onde vivem o TES, as regras tributárias por operação, os cadastros fiscais e o histórico contábil da empresa. Emitir a nota em qualquer outro ponto significa recriar essa inteligência fora do sistema que a domina, com risco de divergência a cada mudança de legislação ou de regra interna.

Três pontos merecem atenção no fluxo fiscal de uma operação VTEX:

O TES precisa estar mapeado para as operações da loja. Venda para consumidor final tem tratamento diferente de venda B2B, e a integração precisa direcionar cada pedido ao TES correto. Isso é escopo de projeto, não configuração de última hora.

A nota precisa voltar para a plataforma. O número, a chave e o link do documento devem retornar à VTEX para compor o histórico do pedido e ficar disponíveis ao cliente. Sem isso, o atendimento vira busca manual no ERP.

Devoluções e cancelamentos têm fluxo próprio. Cancelamento antes do faturamento é uma coisa; devolução depois de faturado é outra, com nota de entrada e reposição de estoque. Os dois cenários precisam estar previstos, e não improvisados quando acontecem.

A maioria dos problemas fiscais em e-commerce não nasce de má-fé nem de desconhecimento, nasce de um fluxo que ninguém desenhou completamente antes de ligar a operação. Desenhar isso leva algumas horas. Corrigir depois costuma levar meses. Fale com um especialista agora, sem compromisso e sem demora.

O risco técnico que a maioria dos projetos ignora

Este é o ponto mais importante deste conteúdo para quem usa Protheus, e o que menos aparece em conversas comerciais.

O Protheus raramente é usado como sai da caixa. Ao longo dos anos, cada empresa desenvolve campos de usuário, ajusta validações, cria pontos de entrada e configura regras que refletem o seu processo real. Essa camada é parte do valor do ERP: é ela que faz o sistema atender aquela operação especificamente.

Existem dois caminhos para uma integração gravar dados no Protheus, e a escolha entre eles define o destino do projeto:

Gravação direta no banco de dados. É rápido de implementar e perigoso de operar. Escreve na tabela sem passar pelas rotinas do ERP, o que ignora validações, regras de negócio, gatilhos e customizações. Os pedidos entram, mas entram errados — com campos obrigatórios vazios, TES não processado e rotinas internas que não dispararam.

Gravação pelas rotinas do próprio Protheus. O ERP processa a informação como se um usuário tivesse digitado, aplicando todas as validações e customizações da implantação. Dá mais trabalho para construir e evita o problema inteiro.

A diferença entre os dois caminhos não aparece na demonstração. Aparece semanas depois, quando alguém percebe que os relatórios não batem ou que o fechamento contábil encontrou lançamentos que não seguiram as regras da empresa.

Tem dúvidas entre escolher um desenvolvimento prório, consultoria ou hub? Se está curioso para saber a resposta, continue lendo.

Desenvolvimento próprio, consultoria ou hub?

Existem três caminhos para conectar o Protheus à VTEX. A tabela resume as diferenças:

Critério	Desenvolvimento interno	Consultoria sob demanda	Hub especializado
Como funciona	Conector construído pelo time de ADVPL	Projeto executado por parceiro TOTVS	Camada de integração pronta e mantida
Quem mantém	Seu time de TI	Nova ordem de serviço a cada mudança	O fornecedor
Implantação	Longa	Média	Curta
Respeito às customizações	Depende de quem construiu	Depende do escopo contratado	Parte da arquitetura
Mudanças na VTEX	Viram demanda interna	Viram novo orçamento	Acompanhadas pelo hub
Monitoramento de erros	Precisa ser construído	Raramente incluso	Incluso, por transação
Faz sentido quando	Há time dedicado e necessidade única	Já existe contrato amplo em andamento	Você quer operar, não manter integração

A leitura é direta: o custo de uma integração não está em construí-la, e sim em mantê-la funcionando todo dia. Plataformas evoluem, APIs mudam, regras fiscais são revisadas, e cada atualização, no modelo de consultoria, vira nova negociação de escopo e prazo.

Quer saber como podemos ajudar você na prática? Então veja o próximo tópico.

Como esse projeto é conduzido com a Plugar.me?

A Plugar.me é um hub de integração ERP com marketplaces e plataformas de e-commerce, que opera em nuvem e conecta o Protheus à VTEX com abordagem ERP First. O projeto começa pelo mapeamento, quais dados sincronizar, com quais regras, em qual frequência, e segue para parametrização, testes e acompanhamento em produção.

Cinco pontos definem a condução:

Gravação que respeita o seu Protheus. A integração escreve pelas rotinas do próprio ERP, para que validações, campos de usuário e customizações sejam processados normalmente.

Automação fiscal completa. Emissão de NF-e e escrituração acontecem no Protheus, com TES mapeado para as operações da loja, incluindo devoluções e cancelamentos.

Mapeamento explícito da estrutura VTEX. Produto e SKU, políticas comerciais e depósitos são definidos no início do projeto, com as decisões documentadas.

Operação em nuvem com monitoramento. Cada transação fica registrada em painel, com logs. Inconsistências aparecem para tratamento imediato, em vez de sumirem entre os sistemas.

Escalabilidade para novos canais. A mesma estrutura conecta o Protheus a marketplaces e outras plataformas. Crescer em canais deixa de exigir um projeto do zero a cada expansão.

A diferença entre uma integração bem estruturada e uma improvisada não aparece no dia da entrega, aparece no primeiro pico de vendas e no primeiro fechamento contábil. Vale conversar com quem já viu esses dois momentos acontecerem dezenas de vezes.

Conclusão

A integração Protheus VTEX transforma dois sistemas isolados em uma operação única, desde que uma decisão esteja clara desde o início: o Protheus é a fonte oficial. Estoque, preços, pedidos e faturamento nascem no ERP e a loja executa a venda com dados fiéis à gestão. É assim que a própria VTEX orienta a integração de back-office, e é o que evita a conciliação manual que consome o fechamento de tantas operações.

Três pontos merecem ser retidos deste conteúdo. O primeiro é que os mapeamentos de catálogo, política comercial e depósito são decisões de negócio tomadas no início do projeto, e determinam se a operação vai funcionar ou gerar retrabalho permanente.

O segundo é fiscal: a nota nasce no Protheus, com o TES correto, e retorna à plataforma. Devoluções e cancelamentos precisam de fluxo próprio, desenhado antes e não improvisado depois.

O terceiro é técnico e decisivo: a integração precisa gravar pelas rotinas do ERP, não direto no banco. É a diferença entre preservar anos de customização e descobrir, no fechamento, que os lançamentos não seguiram as regras da empresa.

Cada dia com Protheus e VTEX trabalhando separados é pedido represado, estoque divergente e nota correndo atrás do prazo, custos que não aparecem em relatório, mas travam a operação todo mês. Fale com a Plugar.me agora mesmo. Uma conversa de uma hora costuma ser suficiente para desenhar o caminho.