A integração Protheus com Shopify conecta o ERP da TOTVS à plataforma global de e-commerce de forma automática: catálogo, estoque, preços, pedidos, clientes, faturamento e documentos fiscais circulam entre os dois sistemas sem digitação, com o ERP mantido como fonte oficial dos dados.
A divisão de papéis não deveria ser negociável. O Protheus governa cadastro, saldo, política comercial e fiscal. A Shopify apresenta o produto, capta o cliente e registra o pedido. Cada dado tem um dono, e a outra ponta apenas reflete o que não é dela.
O que torna essa conexão específica é o encontro de dois extremos. A Shopify é uma plataforma global, padronizada, que funciona igual no Brasil, no México ou na Alemanha. O Protheus é provavelmente o ERP mais personalizável do mercado brasileiro, em que cada empresa tem seus campos, suas regras fiscais e suas rotinas próprias. Conciliar padronização com customização é a parte difícil do projeto.
Neste conteúdo, você vai ver onde exatamente está essa dificuldade, como a plataforma organiza catálogo e estoque, por que a nota fiscal precisa nascer no Protheus e por que integrações construídas sobre automação de tela não se sustentam.
O que é a integração Protheus com Shopify?
É a conexão automática entre o ERP TOTVS Protheus e a Shopify, fazendo os dois sistemas trocarem dados sem ninguém no meio digitando.
O Protheus é o sistema que responde pela empresa: controla estoque, preço, faturamento, fiscal e financeiro, quase sempre com forte customização acumulada ao longo dos anos. A Shopify é o canal de venda, escolhida por operações que querem loja própria com implantação rápida, custo previsível e facilidade para operar em mais de um mercado.
A ponte entre os dois precisa respeitar o que cada lado exige de verdade: as rotinas e regras de negócio configuradas no ERP, e as regras específicas da API da plataforma. É a mesma lógica das demais conexões do ERP que a Plugar.me mantém para o Protheus.
Sua empresa escolheu a Shopify pela agilidade, mas o Protheus continua recebendo os pedidos por digitação manual? Esse é o elo que trava o crescimento do canal. Converse com a equipe da Plugar.me e veja o que dá para automatizar antes de aumentar o volume.
Plataforma global e ERP customizado: onde está a dificuldade?
A Shopify não sabe que o seu Protheus existe, e muito menos como ele foi configurado. Essa é a raiz de quase todo problema em projetos mal executados.
| Característica | Shopify | Protheus |
|---|---|---|
| Modelo de dados | Padronizado e igual para todos os clientes | Adaptado à realidade de cada empresa |
| Campos disponíveis | Fixos, com metacampos para extensões | Campos de usuário criados conforme a necessidade |
| Regras fiscais | Não emite documento fiscal brasileiro | Estrutura completa de TES e operações fiscais |
| Estrutura de produto | Máximo de três opções por produto | Cadastro flexível, com múltiplos atributos |
| Evolução | Mudanças de API definidas globalmente | Customizações que precisam sobreviver a atualizações |
A camada de integração existe justamente para traduzir um lado no outro. Ela precisa saber quais campos de usuário a sua empresa criou, qual operação fiscal aplicar a cada tipo de venda e como a estrutura de produto do ERP se encaixa no limite de opções da plataforma.
É por isso que integração de marketplace ou e-commerce no Brasil não é plug and play. É engenharia sobre um ambiente personalizado, e quem trata como configuração simples descobre o problema depois do go-live, com pedido parado e nota errada.
Sua TI já avaliou conectores prontos e percebeu que nenhum deles conhece as customizações do seu Protheus? Essa percepção é correta e é o ponto de partida de um projeto bem feito. Traga esse cenário para a Plugar.me e receba uma avaliação técnica do seu ambiente.
E o que a plataforma exige do lado dela? O próximo tópico detalha as regras que definem o projeto.
Como a Shopify organiza catálogo e variantes?
A plataforma trabalha com dois níveis: produto e variante. O preço é um campo da variante, e não um recurso separado como acontece com o estoque, o que muda a estratégia de sincronização.
Duas características desenham o projeto de catálogo e precisam ser decididas antes da primeira carga:
- Teto de três opções por produto. A grade aceita no máximo três eixos de variação, com até 2.048 variantes. Um catálogo que combina cor, tamanho, voltagem e acabamento não cabe em um único produto e precisa ser reestruturado no cadastro. Descobrir isso durante a carga é caro; decidir antes é barato.
- Consumo por requisição. A plataforma controla o acesso à API por limites de chamadas, o que significa que carga inicial de catálogo e atualização contínua de estoque exigem estratégias diferentes. Disparar tudo de uma vez esbarra no limite e derruba a sincronização.
Vale registrar também que a API REST da plataforma é considerada legada desde outubro de 2024, com a recomendação oficial migrando para o modelo em GraphQL, que cobra pelo custo calculado da consulta em vez de contar requisições. Isso altera a forma de sincronizar e é um ponto a checar em qualquer solução.
Para entender como essas regras se aplicam a outros sistemas de gestão, vale conferir o guia da Shopify com o seu ERP.
Seu catálogo combina mais de três eixos de variação e você ainda não sabe como isso ficará na Shopify? Essa decisão precisa acontecer antes da carga, não durante. Traga a sua estrutura de produtos para a Plugar.me e evite refazer o cadastro depois.
Como funciona o estoque por local?
O saldo sai do Protheus e atualiza o canal, mas a pergunta relevante não é apenas quanto existe, e sim quanto pode ser vendido ali.
É comum não querer expor todo o estoque. Parte está comprometida com pedidos em aberto, parte pertence a um armazém que não atende aquele canal, e parte precisa ficar reservada para a operação que já existe. A integração tem que respeitar essa separação em vez de publicar um número único.
O modelo da Shopify é familiar para quem vem do Protheus: o recurso de item de inventário separa o produto do saldo, e o de nível de inventário guarda a quantidade em cada local. É o equivalente ao item e ao saldo por armazém do ERP, e permite publicar apenas o saldo destinado ao canal digital.
A condição é uma só: o mapa entre armazéns do Protheus e locais da plataforma precisa existir antes da primeira carga. Aqui está um erro clássico de projeto improvisado, o de tentar publicar saldo pelo cadastro do produto, o que simplesmente não tem efeito, porque o estoque vive em recursos próprios.
Sua empresa tem mais de um armazém e ainda publica um saldo único no canal? Esse atalho funciona até o primeiro pico de vendas, quando o cancelamento por ruptura aparece. Pergunte à Plugar.me como fica o mapa de armazéns e locais na sua operação.
Como pedidos, clientes e a NF-e funcionam no Protheus?
O pedido entra por notificação automática. A Shopify dispara eventos de criação de pedido assinados por chave de segurança, e essa assinatura precisa ser validada sobre o corpo bruto da requisição, o que garante que a informação veio mesmo da plataforma.
A partir daí, a integração cria o pedido no Protheus na operação correta, respeitando as TES configuradas e os campos de usuário do ambiente. O cadastro do cliente chega junto, pronto para o faturamento, porque nota fiscal exige dados completos e cadastro incompleto trava a emissão exatamente quando o pedido deveria seguir para expedição.
E aqui está o ponto central: a Shopify não emite NF-e. A plataforma trabalha com os conceitos de pedido e de atendimento do pedido, e o documento fiscal brasileiro é responsabilidade do ERP. Por isso o CPF ou CNPJ é coletado no checkout, para que a nota seja emitida no Protheus com a operação fiscal correta da sua empresa.
O fluxo completo funciona assim:
- O cliente compra na Shopify.
- A integração captura o pedido e o cria no Protheus, na operação correta.
- O estoque é baixado no ERP e o saldo do canal é atualizado.
- O pedido segue o fluxo interno de separação e conferência.
- O faturamento é executado no Protheus e a NF-e é emitida.
- Número da nota, chave e rastreio voltam para a loja junto do atendimento do pedido.
- O painel da Plugar.me registra cada etapa em log, para auditoria.
O passo seis fecha a experiência do comprador: ele encontra documento e código de envio na mesma tela, sem precisar abrir chamado. É o mesmo padrão aplicado em outros ERPs conectados à mesma plataforma.
O tráfego desses dados envolve informações pessoais, o que exige transmissão protegida e acesso restrito por função, tema tratado nas práticas de segurança aplicadas às integrações.
Você ainda emite as notas do canal digital fora do fluxo normal do Protheus? Isso multiplica trabalho e abre espaço para operação fiscal errada. Fale com a Plugar.me e traga a emissão para dentro da cadeia de documentos que a sua empresa já domina.
Por que integração baseada em automação de tela não se sustenta?
Existe uma abordagem no mercado que promete resolver o problema de forma mais simples: em vez de conversar com o ERP pelas suas interfaces oficiais, um robô simula um usuário, abre a tela do Protheus e preenche os campos como se fosse uma pessoa digitando.
Funciona em demonstração. O problema aparece na operação real, e por três motivos:
- Fragilidade a qualquer mudança. Uma atualização do Protheus que mova um campo de lugar, ou uma customização nova na tela, quebra o robô. A integração para, e ninguém descobre até o pedido não aparecer.
- Ausência de tratamento de erro. Automação de tela não tem fila de reprocessamento nem log estruturado. Quando algo falha, a mensagem se perde em silêncio, e o problema só aparece quando o cliente reclama.
- Limite de volume. O robô opera na velocidade de uma pessoa usando o sistema. Em dia de pico, a fila cresce mais rápido do que ele consegue processar.
A forma correta é entrar pelas rotinas oficiais do ERP, respeitando validações, campos de usuário e regras fiscais configuradas. Isso vale também para a outra prática de risco comum em projetos improvisados, que é gravar dados direto nas tabelas do banco de dados, atalho que corrompe informação e compromete o suporte da TOTVS.
A régua para avaliar qualquer solução é simples: pergunte como ela grava no Protheus, se respeita as suas customizações e o que acontece quando uma sincronização falha. As respostas separam um conector frágil de uma integração de verdade, como acontece nas demais conexões do Protheus com plataformas de e-commerce.
Já receberam uma proposta de integração que funciona por robô preenchendo telas do seu Protheus? Vamos mostrar como ajudar você agora mesmo!
Como a Plugar.me realiza a integração Protheus com Shopify?
A operação roda em nuvem, sem necessidade de subir servidor nem manter estrutura adicional na sua infraestrutura.
O projeto segue três frentes:
- Diagnóstico: entender como o seu Protheus está configurado, com filiais, armazéns, TES, campos de usuário e customizações, e o que a operação exige do canal.
- Mapeamento e setup: definir de onde sai cada dado, qual operação o pedido da Shopify deve usar, qual saldo o canal enxerga e como a estrutura de produtos será organizada dentro do limite de opções da plataforma.
- Go-live assistido: acompanhamento nos primeiros ciclos, quando os casos de exceção aparecem, com painel de logs para auditar cada etapa.
Empresas que integraram seus sistemas com a Plugar.me contam essa experiência na página de clientes e parceiros, incluindo operações que rodam canal digital em alto volume com o ERP no comando.
Cada mês com a Shopify operando fora do ERP é margem evaporando em erro, atraso e conciliação manual, e esse custo cresce junto com o canal. Fale com o time da Plugar.me, apresente o seu cenário e descubra em quanto tempo a sua operação pode estar rodando integrada.
Conclusão
A integração Protheus com Shopify vale a pena quando a plataforma deixa de ser teste e passa a ser canal de verdade. A partir daí, digitação manual não é economia, é o teto do canal e a origem dos erros que custam tempo e margem.
O desafio central é conciliar uma plataforma global e padronizada com um ERP profundamente personalizado. Isso significa respeitar, de um lado, o limite de opções por produto, o estoque por local e os limites de requisição da API; e, de outro, as TES, os campos de usuário e as rotinas oficiais do Protheus.
E o fiscal permanece onde deve estar. Como a plataforma não emite documento fiscal brasileiro, cada NF-e nasce no Protheus com a operação correta da empresa e é transmitida ao ambiente oficial da NF-e antes de a informação voltar para a loja.
Não deixe o seu canal digital crescer desconectado do sistema que governa a sua empresa: cada semana de processo manual é retrabalho hoje e passivo de controle amanhã.
Fale agora com a Plugar.me, apresente o cenário do seu Protheus e receba uma análise técnica de quem homologa essas integrações todos os dias. O primeiro passo não custa nada.
Não. Os dois lados oferecem interfaces oficiais, mas a ponte entre elas precisa ser construída e mantida, respeitando as customizações, os campos de usuário e as regras fiscais configuradas no seu ambiente.
Não. A plataforma trabalha com pedido e atendimento do pedido, sem emissão de NF-e. O documento fiscal é responsabilidade do ERP, e por isso o CPF ou CNPJ é coletado no checkout, para que a nota seja emitida no Protheus.
Sim, e esse é um ponto central. A gravação acontece pelas rotinas oficiais do ERP, respeitando campos de usuário, TES e regras de negócio, em vez de escrever direto no banco de dados ou simular digitação em tela.
A plataforma aceita no máximo três opções por produto, com até 2.048 variantes. Catálogos que combinam mais eixos de variação precisam ser reestruturados no cadastro, decisão que deve ser tomada antes da carga inicial.
O saldo é controlado por local na plataforma, com recursos próprios que separam o item da quantidade disponível. Isso permite publicar apenas o estoque destinado ao canal, desde que exista um mapa entre os armazéns do Protheus e os locais da Shopify.
A mensagem entra em fila para reprocessamento controlado, em vez de se perder. O painel de logs registra cada etapa, o que permite auditar o que aconteceu e reenviar quando necessário.
Sim. Como a fonte da verdade permanece no Protheus, a mesma fundação atende outros canais, incluindo marketplaces e hubs, sem duplicar cadastro nem mudar o dono do dado.
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.
