No Protheus, a integração com qualquer canal começa por uma pergunta fiscal: com qual TES o pedido entra? É a TES e a natureza de operação que definem como o documento será processado e faturado, e uma venda para consumidor final não usa a mesma estrutura de uma venda para revenda. Errar isso não gera erro na hora — gera nota furada e retrabalho no fechamento.
O Protheus é o ERP mais configurável do portfólio da TOTVS, e essa flexibilidade é exatamente o que torna a integração delicada: cada empresa tem a própria parametrização, então não existe conector que funcione igual em duas implantações. A Shopify, do outro lado, é bastante padronizada — preço é campo da variante, estoque vive em InventoryLevel por location, e os pedidos seguem um fluxo de order e fulfillment previsível.
O encontro dos dois mundos é onde está o trabalho: traduzir a padronização da plataforma para a parametrização específica da sua instalação, sem tirar do Protheus a responsabilidade sobre o documento fiscal.
O que é a integração TOTVS Protheus Shopify?
É a conexão automática entre o ERP TOTVS Protheus e a Shopify, fazendo os dois sistemas trocarem produtos, estoque, preços e pedidos sem digitação manual. O catálogo nasce no TOTVS Protheus, o saldo publicado é o saldo real, e cada venda entra no ERP como pedido, pronto para separação e faturamento.
Por que integrar o TOTVS Protheus exige atenção?
O Protheus define por TES e natureza de operação como cada pedido é processado e faturado. Uma integração que ignora essas estruturas gera pedido com operação errada e nota fiscal furada — e o problema só aparece na apuração. Some-se a isso a parametrização própria de cada implantação: não existe conector genérico que sirva em duas empresas sem ajuste, porque o que muda não é o Protheus, é como cada operação o configurou.
O que a API da Shopify permite?
A Admin API da Shopify cobre catálogo, pedidos e estoque, com autenticação por X-Shopify-Access-Token. O que muda em relação a outras plataformas é a divisão de responsabilidades entre os recursos: o preço é campo da variante, o estoque tem recursos próprios, e existe um sistema de Price Lists para preços contextuais por mercado.
O consumo é limitado por um algoritmo de balde furado: 40 requisições de balde por aplicativo e por loja, com vazão de 2 por segundo — ou 400 e 20 por segundo em contas Plus. A API GraphQL usa outro modelo, cobrando pelo custo calculado da consulta. Em qualquer um dos dois, planejar o consumo faz parte do projeto.
Quais problemas surgem sem a integração entre TOTVS Protheus e Shopify?
- Pedido lançado com a TES errada. A venda para consumidor final não usa a mesma estrutura da venda para revenda. Com a TES incorreta, a nota sai com tributação inadequada e o erro só aparece na apuração fiscal.
- Saldo publicado da filial errada. O estoque precisa sair da filial que efetivamente atende o canal, e parte do saldo costuma estar comprometida com outras operações. Publicar o total é o caminho mais curto para o cancelamento.
- Conector genérico que não sobrevive à parametrização. Cada implantação de Protheus é diferente. Uma integração que assume configuração padrão quebra na primeira particularidade da empresa.
- Requisições recusadas por estouro de cota. A Admin API REST da Shopify usa balde furado: 40 de balde por app e por loja, com vazão de 2 por segundo. A carga inicial de catálogo precisa de fila e retentativa.
- Conciliação manual no fechamento. O que o canal registrou não bate com o que o ERP faturou.
Quanto custa continuar no manual?
O custo raramente aparece como linha de orçamento, e é por isso que passa despercebido. Ele aparece como cancelamento por estoque furado, como pedido faturado com atraso, como hora de equipe gasta em digitação e conferência, e como divergência no fechamento do mês. Somados, esses itens costumam superar o custo do projeto de integração já no primeiro semestre.
Como funciona a integração ERP TOTVS Protheus Shopify?
A divisão de papéis não deveria ser negociável: o TOTVS Protheus é a fonte oficial — controla estoque, preços, faturamento e fiscal — e a Shopify é a vitrine que executa a venda. Toda decisão de arquitetura decorre disso.
Estoque por Location, grade limitada a 3 opções
Dois traços da Shopify moldam qualquer projeto. O primeiro é que o saldo não pertence ao produto: ele vive em InventoryItem e InventoryLevel, sempre vinculado a uma location. O segundo é que uma variante aceita no máximo três opções — o que exige decidir, antes da carga, quais atributos da grade viram opção e quais viram metafield, coleção ou produto separado.
Como funciona o controle de estoque?
O saldo sai da filial correta do Protheus e alimenta a location correspondente na Shopify. Nem todo estoque deve ir para o canal: parte costuma estar comprometida com pedidos em aberto ou reservada a outras operações. Como a Shopify guarda quantidade por location, é possível publicar apenas o saldo disponível de uma filial específica — o que evita expor a posição consolidada da empresa e reduz cancelamento.
Como funciona o faturamento e a emissão de notas fiscais?
A nota nasce no Protheus, com a TES adequada à operação de venda para consumidor final. É essa a regra que separa uma integração ERP First de um conector qualquer: o pedido entra na cadeia de documentos com a natureza correta desde o início, e a NF-e é emitida dentro do ERP. A Shopify não emite documento fiscal brasileiro — ela recebe a informação do documento já autorizado.
Qual é o fluxo completo, do clique à nota fiscal?
O cliente compra na Shopify. A integração captura o pedido e o cria no TOTVS Protheus, na operação correta. O estoque é baixado no ERP e o saldo da location é atualizado. O pedido segue o fluxo interno de separação e conferência. O faturamento é executado no TOTVS Protheus e a NF-e é emitida. Por fim, a loja recebe a informação do documento e o rastreio, e o comprador acompanha tudo em um lugar só.
Preciso desenvolver essa integração do zero?
Não necessariamente, e essa costuma ser a decisão que mais pesa no prazo. Desenvolver internamente dá controle total, mas transfere para a sua equipe a manutenção de duas APIs que mudam sem aviso, o tratamento de limites e retentativas, e o monitoramento de um caminho que falha em silêncio. Um conector pronto encurta o caminho, desde que respeite a parametrização do seu ERP em vez de impor a dele.
O critério prático é simples: se a integração exigir que alguém confira pedidos todo dia, ela vai ser abandonada. O que sustenta a operação no longo prazo é o desenho que funciona sozinho e avisa quando para.
Quais os benefícios de integrar TOTVS Protheus e Shopify?
- Estoque confiável. O saldo publicado é o saldo real, o que reduz cancelamento e reclamação.
- Pedido sem digitação. A venda entra no ERP na operação correta, pronta para separação.
- Fiscal sob controle. A nota nasce no ERP, com a tributação que a empresa já validou.
- Fechamento sem conciliação manual. O que a loja registrou e o que o ERP faturou passam a ser a mesma coisa.
- Equipe liberada. O tempo que ia para digitação volta para atendimento e curadoria de catálogo.
Para quais empresas essa integração é indicada?
- Empresas que rodam Protheus e querem loja própria governada pelo ERP.
- Operações com parametrização fiscal específica, onde erro de TES custa retrabalho.
- Negócios com múltiplas filiais, onde a origem do saldo publicado é decisão real.
Por que escolher uma integração ERP First para o TOTVS Protheus?
Porque o inverso cria dois donos para o mesmo dado. Quando a plataforma passa a controlar preço ou estoque, a empresa termina com duas versões da verdade e nenhuma forma barata de decidir qual vale. No modelo ERP First o TOTVS Protheus continua sendo a fonte, e a Shopify recebe dados atualizados para fazer o que faz bem: vender.
Como a Plugar.me realiza a integração TOTVS Protheus Shopify?
Começamos pelo mapeamento dos fluxos que a sua operação precisa — produtos, estoque, preços, pedidos, NF-e e financeiro — e pela decisão de qual saldo alimenta cada location da Shopify. Depois desenhamos a conexão respeitando a parametrização do seu TOTVS Protheus, com fila, retentativa e monitoramento do caminho de volta, para que a integração avise quando parar em vez de falhar em silêncio.
Conclusão: vale a pena integrar o TOTVS Protheus à Shopify?
Vale quando a loja deixa de ser um teste e vira operação. A partir daí, manter catálogo, estoque e pedidos em dois lugares deixa de ser trabalhoso e passa a ser arriscado. Integrar o TOTVS Protheus à Shopify no modelo ERP First resolve isso mantendo o controle onde ele já está — no sistema que a sua empresa usa para tudo o mais.

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.
