A integração Protheus com WooCommerce conecta o ERP da TOTVS à sua loja em WordPress para que cada pedido nasça na vitrine e seja processado dentro do sistema que já governa o seu estoque, o seu faturamento e a sua emissão de NF-e.
Em vez de a operação viver dividida entre a loja e o ERP, a venda entra no Protheus pela rotina certa, baixa o estoque da filial correta e sai com nota fiscal pelo processo que a empresa já validou.
Na prática, o WooCommerce fica com o que faz melhor, ser a vitrine aberta e flexível que converte, e o Protheus continua sendo a fonte da verdade de preço, estoque e documento fiscal. A integração é a camada que traduz o pedido da loja para as rotinas e regras do ERP, e devolve para o WooCommerce o que o cliente precisa ver, saldo publicado e status do pedido.
O que isso resolve é o desencontro entre dois sistemas que, cada um do seu jeito, aceitam muita customização. O WooCommerce é open-source e vive de plugins, o Protheus é o ERP mais moldável do mercado. Sem uma camada no meio, alguém digita pedido à mão, o estoque diverge e a nota atrasa. Com a integração ERP First, a operação inteira acontece dentro do ERP, sem gambiarra.
O que é a integração Protheus WooCommerce?
A integração Protheus WooCommerce é a conexão que faz a loja em WordPress operar como um canal de venda do ERP, e não como um sistema paralelo. O pedido pago na vitrine é capturado, criado no Protheus pela rotina correta e conduzido pelo fluxo interno de estoque, faturamento e nota fiscal.
O papel de cada lado é claro. O WooCommerce recebe o pedido e mostra o catálogo, o preço e o saldo. O Protheus decide de qual filial sai a mercadoria, sob qual regra fiscal e em que momento a NF-e é emitida.
A integração é a ponte que carrega essa conversa nos dois sentidos, sem que ninguém reescreva informação de uma tela na outra, e o mesmo tipo de conexão aparece em outros ERPs sobre a mesma plataforma.
Você já vende no WooCommerce, mas o pedido ainda passa por uma etapa manual até virar realidade no Protheus? Cada pedido digitado à mão é uma chance a mais de estoque furado e nota atrasada. Fale com a equipe da Plugar.me e veja onde a sua operação perde tempo hoje.
Por que conectar dois sistemas tão customizáveis dá trabalho?
Integrar Protheus e WooCommerce dá trabalho porque os dois são altamente moldáveis, e essa liberdade é justamente onde as integrações quebram.
O WooCommerce é open-source, roda no WordPress do próprio lojista e vive de plugins, então não existem duas lojas iguais. O Protheus é o ERP mais customizável do país, com ADVPL, campos de usuário e regras fiscais próprias, então não existem dois Protheus iguais.
Aqui o desafio é o oposto do que se enfrenta com uma plataforma global e padronizada como a Shopify. Não é rigidez, é excesso de maleabilidade dos dois lados. A tabela abaixo mostra por que unir dois sistemas tão flexíveis pede uma camada que não dependa de improviso.
| Ponto de atrito | WooCommerce (open-source e flexível) | Protheus (ERP altamente customizável) |
|---|---|---|
| Base | WordPress self-hosted, cada loja tem sua stack | Ambiente próprio, com customizações da empresa |
| Extensões | Plugins de frete, fiscal e checkout que mudam o comportamento | Rotinas próprias, ADVPL e campos de usuário |
| Produto | Simples e variável, com atributos e variações livres | Cadastro com estrutura, TES e regras por filial |
| Regra fiscal | Fora do escopo nativo, geralmente via plugin | NF-e no processo fiscal já estabelecido |
| Evolução | Atualizações de tema e plugins a qualquer momento | Versões e customizações sob controle da TI |
A leitura correta é que a integração não deve engessar o WooCommerce nem contornar as regras do Protheus. Ela existe para que os dois padrões se encontrem sem que nenhum seja quebrado, traduzindo a loja flexível para a estrutura do ERP.
A sua loja WooCommerce tem uma pilha de plugins que ninguém sabe direito como conversa com o Protheus? Quanto mais customização solta, mais frágil fica a ponte entre os dois. Traga esse cenário para a Plugar.me e a gente mostra como a camada de integração organiza isso.
Como funciona a integração, do clique à NF-e?
A integração funciona em um fluxo único que começa no clique do cliente e termina com a NF-e emitida dentro do Protheus. Cada etapa acontece no lugar certo, sem que o WooCommerce tente fazer o papel do ERP nem o contrário.
O caminho completo é o seguinte:
- O cliente compra no WooCommerce e o pedido é pago na loja.
- A integração captura o pedido pela API REST do WooCommerce, por webhook ou consulta, e o cria no Protheus.
- O pedido entra na rotina oficial de venda do ERP, com a TES e a filial corretas.
- O estoque é baixado no Protheus e o saldo é devolvido ao WooCommerce.
- O faturamento é executado no Protheus e a NF-e é emitida pelo processo fiscal vigente.
- A loja recebe de volta o status do pedido e o rastreio, seguindo a mesma lógica de troca sem digitação das demais integrações do ERP.
O ponto que muda tudo é onde a nota nasce. A NF-e é emitida no Protheus, respeitando a regra fiscal que a empresa já tem, e não em um plugin fiscal solto do WordPress. Assim, o e-commerce nunca vira o responsável por uma decisão que é do ERP.
Quantas pessoas hoje tocam um pedido da sua loja entre a venda e a nota fiscal? Se a resposta for mais de zero, existe espaço para automatizar. Converse com um especialista da Plugar.me e desenhe esse fluxo ponta a ponta.
A integração pode gravar direto no banco do Protheus?
Não, a integração não deve gravar direto no banco do Protheus, e essa é a objeção mais importante de todas quando o ERP é o da TOTVS. Gravar direto na base, por fora das rotinas, ignora as validações, as customizações, os campos de usuário e a TES que definem como cada operação é escriturada. O jeito correto é escrever pelas rotinas e webservices oficiais do Protheus, que respeitam a lógica de negócio do ERP.
A diferença é prática, não teórica. Quando o pedido entra pela rotina oficial, ele passa pelas mesmas checagens de qualquer venda registrada por um usuário: TES válida, regra fiscal aplicada, filial correta, customização respeitada.
Quando alguém força a gravação na base, tudo isso é pulado, e o problema aparece semanas depois, no fechamento fiscal, quando já é caro consertar.
Por isso a integração ERP First trata o Protheus como fonte da verdade e escreve nele apenas pelo caminho que a TOTVS autoriza, respeitando as rotinas oficiais do ERP em cada operação.
Já ouviu que dá para acelerar a integração gravando direto na base do Protheus? Antes de aceitar esse atalho, pergunte quem responde pelo fechamento fiscal quando o dado entra sem passar pela TES. Traga a dúvida para a Plugar.me e a gente explica o caminho seguro.
E quando um plugin do WooCommerce muda ou quebra?
Quando um plugin do WooCommerce muda ou quebra, uma integração mal feita quebra junto, e é por isso que a camada de integração não pode depender da estabilidade de plugins do WordPress. Loja open-source recebe atualização de tema, de plugin e do próprio WooCommerce o tempo todo, e cada uma dessas mudanças pode alterar como o pedido é montado ou como o estoque é lido.
Uma integração gerenciada trata isso com fila, monitoramento e reprocessamento, então uma falha pontual não vira pedido perdido. Alguns cuidados fazem a diferença nesse cenário:
- Ler o pedido pela API REST oficial, com autenticação por consumer key e secret, em vez de depender de um plugin intermediário frágil.
- Usar webhooks com confirmação e reprocessar o que falhar, sem perder venda quando a loja oscila.
- Manter a regra fiscal no Protheus, para que uma troca de plugin fiscal no WordPress não afete a NF-e.
- Registrar log de cada troca de dado, para achar rápido a origem quando algo muda na loja.
É o oposto de depender de plataformas de API mais fechada, como a Tray, onde o comportamento varia menos, mas a liberdade também é menor.
A sua última atualização de plugin no WooCommerce já derrubou alguma automação sem aviso? Numa loja aberta, isso é questão de tempo, não de azar. Deixe a Plugar.me colocar uma camada que aguenta a mudança sem perder pedido no caminho.
Consultoria sob medida ou integração gerenciada?
A escolha entre uma consultoria sob medida e uma integração gerenciada é a decisão central desse projeto, e cada caminho tem um custo real de manutenção.
Um projeto ADVPL feito do zero atende a necessidade do dia, mas envelhece a cada atualização do WooCommerce, de plugin ou de customização do Protheus, e depende de quem escreveu para dar manutenção. A tabela abaixo compara os três caminhos mais comuns.
| Caminho | O que entrega | Ponto de atenção |
|---|---|---|
| Desenvolver internamente | Controle total do código | Exige time técnico e vira legado sem quem mantenha |
| Consultoria sob medida | Projeto ADVPL específico | Quebra em cada mudança e depende do fornecedor original |
| Hub gerenciado (ERP First) | Camada pronta pelas rotinas oficiais | Menos customização artesanal, mais estabilidade e evolução |
A vantagem do hub gerenciado é que a manutenção deixa de ser sua. Quando o WooCommerce ou o Protheus mudam, a camada acompanha, sem virar um chamado urgente para a sua equipe. Vale ver como esse mesmo princípio aparece nas outras integrações do Protheus já publicadas.
Está pensando em contratar um projeto sob medida para ligar o WooCommerce ao Protheus? Pergunte quem vai manter isso funcionando daqui a um ano, depois de dez atualizações de plugin. A Plugar.me tira esse peso da sua equipe.
Por que escolher uma integração ERP First para o Protheus?
Escolher uma integração ERP First para o Protheus significa colocar o ERP no centro da operação, e não a loja. Em uma empresa que roda no Protheus, o estoque, o preço e a regra fiscal já vivem lá, com customização e histórico. Faz sentido que a venda do WooCommerce entre nesse sistema, e não que a loja tente comandar por fora.
A abordagem ERP First reduz retrabalho e risco de duas formas. Primeiro, elimina a redigitação, que é onde o erro humano entra. Segundo, mantém a fonte única da verdade, então não existe a dúvida de qual sistema está certo quando os números divergem, o Protheus está certo, sempre. Isso vale para qualquer canal, como mostram todos os ERPs que a Plugar.me integra.
Para uma operação que já investiu no Protheus e nas suas customizações, a integração é o que estende esse investimento para o e-commerce, sem abrir mão do controle.
Mas você não precisa correr atrás de outras opções ou bater cabeça com a IA para fazer essa integração, vamos mostrar como ajudar você agora mesmo!
Como a Plugar.me pode ajudar nessa integração?
A Plugar.me ajuda entregando a integração Protheus WooCommerce pronta, gerenciada e escrita pelas rotinas oficiais da TOTVS, sem que a sua equipe precise desenvolver ou manter código ADVPL.
Em vez de um projeto sob medida que envelhece a cada atualização de plugin, você recebe uma camada que já conhece a API do WooCommerce e as regras do Protheus, e que continua funcionando quando os dois lados mudam.
Na prática, isso significa três coisas. A primeira é o mapeamento correto desde o começo: qual filial alimenta a loja, como a TES e os campos de usuário entram em cada pedido e como o catálogo do Protheus vira produto no WooCommerce.
A segunda é a operação dentro das regras do ERP, escrevendo pelas rotinas e webservices oficiais, respeitando validações, customizações e trilha de auditoria. A terceira é o acompanhamento contínuo, com fila, monitoramento e reprocessamento, para que uma atualização de plugin ou uma oscilação da loja não vire pedido perdido.
O resultado é uma integração que se comporta como parte da sua operação, e não como um sistema à parte que alguém precisa vigiar. É o mesmo cuidado que sustenta os clientes e parceiros que já contam com a Plugar.me em ambientes de Protheus altamente customizados.
A sua empresa já roda no Protheus e não quer abrir uma operação paralela só para vender no WooCommerce? Deixe a Plugar.me assumir a camada de integração, do mapeamento ao monitoramento, e mantenha o controle onde ele sempre esteve, dentro do seu ERP.
Conclusão: vale a pena integrar o Protheus ao WooCommerce?
Vale a pena integrar o Protheus ao WooCommerce quando a sua empresa quer vender numa loja aberta e flexível sem operar fora do ERP que governa o negócio. A integração faz o pedido nascer na vitrine e viver dentro do Protheus, com estoque por filial correto, faturamento no lugar certo e NF-e emitida pelo processo fiscal que você já confia, sempre alinhado ao que exige o Portal Nacional da Nota Fiscal Eletrônica.
O ganho real está em unir dois sistemas customizáveis sem que a liberdade de um vire o problema do outro: o WooCommerce continua flexível e as rotinas do Protheus continuam intactas, com a camada de integração traduzindo os dois lados. É menos retrabalho, menos divergência de estoque e menos risco no fechamento.
Fale agora com a Plugar.me e descubra como conectar o seu Protheus ao WooCommerce sem tirar a operação de dentro do ERP. Traga a sua loja, os seus plugins e as suas customizações, e a gente desenha a integração que respeita as rotinas que a sua empresa já construiu.
A NF-e é emitida dentro do Protheus, pelas rotinas fiscais que a empresa já usa. A integração conduz o pedido até o faturamento e devolve a informação do documento para o WooCommerce, sem criar um caminho fiscal paralelo por plugin do WordPress.
Não. Desenvolver do zero significa manter código, tratar atualizações de plugin e refazer tudo a cada mudança. Uma integração gerenciada assume as rotinas oficiais do Protheus e a API do WooCommerce e cuida da evolução, o que reduz custo e risco frente a um projeto sob medida.
Sim. O pedido entra pela rotina oficial de venda, com a TES, a filial e os campos de usuário corretos. É justamente essa lógica fiscal e de customização que a abordagem ERP First preserva, em vez de gravar direto no banco.
Com fila, monitoramento e reprocessamento. A leitura do pedido é feita pela API REST oficial, com autenticação própria, então uma atualização de plugin ou de tema não derruba a operação, e o que falha é reprocessado sem perder venda.
Sim. O saldo do Protheus por filial é publicado no WooCommerce, e o pedido pago baixa o estoque no ERP. A definição de qual filial alimenta a loja e de quanto do saldo fica exposto é feita na configuração, antes de a loja subir.
Não é recomendado. Gravar fora das rotinas pula as validações, a TES e a auditoria do ERP, e o erro só aparece no fechamento. O caminho correto é escrever pelas rotinas e webservices oficiais do Protheus.
Faz mais sentido para empresas que já rodam no Protheus, com customizações e regras fiscais próprias, e que têm ou querem uma loja WooCommerce sem abrir uma operação paralela ao ERP. Quanto mais customizado o Protheus, maior o valor de manter o ERP no comando.
Luan Carvalho é fundador e CTO da Plugar.me, empresa especializada em integração de ERP com marketplaces e plataformas de e-commerce. Atua no desenvolvimento de soluções para automação de pedidos, estoque, preços, faturamento e documentos fiscais, ajudando empresas a escalarem suas operações com estabilidade, segurança e alto desempenho. Ao longo de sua trajetória, participa da implementação de integrações entre ERPs como SAP Business One, Protheus, WinThor, Consinco e Sankhya, conectando-os aos principais marketplaces e plataformas do mercado.
