No Sankhya tudo passa pela TOP. É o Tipo de Operação que define como cada pedido é processado, faturado e tributado, e inserir o pedido do canal digital sem a TOP correta gera retrabalho fiscal garantido. Não é um detalhe de implantação: é a primeira decisão da integração, e ela precede qualquer discussão sobre catálogo ou estoque.
O Sankhya é um ERP brasileiro com estrutura fiscal robusta, usado por empresas que levam obrigações acessórias a sério. A Shopify vem da lógica oposta — é uma plataforma internacional, padronizada, que não conhece TOP, natureza de operação nem CFOP. Ela registra a venda; a responsabilidade fiscal fica inteira do lado do ERP.
Essa assimetria é justamente o que torna o modelo ERP First o caminho natural aqui: a plataforma executa a venda com dados atualizados, e o Sankhya continua sendo onde o documento nasce, com a estrutura fiscal que a empresa já validou.
O que é a integração Sankhya Shopify?
É a conexão automática entre o ERP Sankhya e a Shopify, fazendo os dois sistemas trocarem produtos, estoque, preços e pedidos sem digitação manual. O catálogo nasce no Sankhya, o saldo publicado é o saldo real, e cada venda entra no ERP como pedido, pronto para separação e faturamento.
Por que integrar o Sankhya exige atenção?
A TOP define como cada pedido é processado e faturado no Sankhya, e a natureza e o tipo de movimento a complementam. Inserir o pedido do canal sem essas estruturas corretas não gera erro imediato — gera nota com tributação inadequada, que aparece semanas depois na apuração. Para uma empresa que escolheu o Sankhya justamente pelo rigor fiscal, esse é o pior resultado possível.
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 Sankhya e Shopify?
- Pedido inserido sem a TOP correta. O documento é processado com regra errada e a nota sai com tributação inadequada. Numa operação que leva obrigações acessórias a sério, isso vira retrabalho de apuração.
- Natureza e tipo de movimento ignorados. Elas complementam a TOP e precisam acompanhar o pedido desde a entrada. Preencher depois é reprocessar.
- Saldo publicado da empresa ou filial errada. O Sankhya trabalha com múltiplas empresas e filiais; o saldo precisa sair da que efetivamente atende o canal.
- Estoque enviado como campo do produto. Na Shopify a quantidade vive em
InventoryItemeInventoryLevel, por location — não no produto. A atualização feita no lugar errado não tem efeito. - Preço desatualizado. A tabela mudou no ERP e o canal não acompanhou — margem errada ou venda perdida.
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 Sankhya Shopify?
A divisão de papéis não deveria ser negociável: o Sankhya é 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 do Sankhya respeitando a empresa e a filial corretas, e nem todo estoque deve ir para o canal. A Shopify guarda a quantidade por location, o que permite espelhar essa estrutura: cada filial que atende o digital vira uma location, e a integração publica apenas o disponível daquela origem. Sem esse mapa, o canal anuncia um consolidado que a operação não consegue honrar.
Como funciona o faturamento e a emissão de notas fiscais?
A nota nasce no Sankhya, com a TOP e a natureza de operação adequadas à venda para consumidor final. A Shopify não participa dessa etapa: ela não emite documento fiscal brasileiro e não conhece as estruturas do ERP. O que a integração faz é devolver à loja o número e a chave da nota autorizada, para que o comprador acompanhe o pedido com a informação correta.
Qual é o fluxo completo, do clique à nota fiscal?
O cliente compra na Shopify. A integração captura o pedido e o cria no Sankhya, 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 Sankhya 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 Sankhya 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 Sankhya e querem canal digital sem abrir mão do controle fiscal.
- Operações com estrutura de TOP bem definida, onde erro custa retrabalho de apuração.
- Negócios com múltiplas empresas ou filiais atendendo o mesmo canal.
Por que escolher uma integração ERP First para o Sankhya?
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 Sankhya 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 Sankhya 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 Sankhya, 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 Sankhya à 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 Sankhya à 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.
