Existe um sintoma que aparece em quase toda loja que cresceu sem integração: o cliente compra, recebe a confirmação, e horas depois recebe o cancelamento. O produto não existia. Estava na vitrine porque a planilha de estoque foi atualizada ontem, e ontem ele existia.
Isso não é um problema de sistema. É um problema de ter dois donos da verdade.
Quem manda no estoque
A primeira decisão de qualquer integração é essa, e ela não é técnica: qual sistema é a fonte da verdade para cada informação?
O desenho que funciona na maioria das operações:
| Informação | Fonte da verdade | Direção |
|---|---|---|
| Cadastro e preço de produto | ERP | ERP → loja |
| Estoque | ERP | ERP → loja |
| Pedido | Loja | Loja → ERP |
| Status de separação e envio | ERP | ERP → loja |
| Nota fiscal | ERP | ERP → loja |
Quando essa tabela não está escrita e acordada, a integração vira uma discussão sem fim sobre qual número está certo — e a resposta muda a cada semana.
O fluxo mínimo que resolve
Uma integração completa não precisa ser complexa. Precisa fechar o ciclo.
- Produto e preço descem do ERP. Criação e alteração viram atualização na loja, incluindo variações.
- Estoque desce em intervalo curto. Quanto mais curto, menos ruptura falsa. Em operação de giro alto, minutos importam.
- Pedido sobe imediatamente após o pagamento aprovado. Com cliente, itens, valores, frete e endereço.
- A separação devolve status. O cliente acompanha sem abrir chamado.
- A nota volta para a loja. Chave, PDF e rastreio disponíveis no pedido.
Se qualquer um desses cinco passos for manual, alguém vai digitar — e alguém vai errar.
O que muda conforme o seu ERP
A pergunta que chega para a gente quase nunca é "como integrar um ERP". É "como integrar o Bling com o Shopify", "o Tiny com WooCommerce", "o Protheus com a VTEX". E o ERP muda mais o projeto do que a plataforma de loja.
| Família de ERP | Exemplos | O que esperar |
|---|---|---|
| ERPs de nuvem para PME | Bling, Tiny, Omie | API pública documentada e conectores prontos para as plataformas mais comuns. O trabalho costuma estar em regra de negócio — depósito, alocação, tributação — e não em conectividade. Atenção a limites de chamadas por minuto |
| ERPs de porte nacional | TOTVS (Protheus, RM), Sankhya, Senior | Integração possível e comum, mas depende da versão, dos módulos licenciados e às vezes de um middleware. O prazo é maior e o gargalo é liberação de acesso e homologação com o parceiro do ERP |
| ERPs internacionais | SAP Business One, Dynamics | Integração via camada de serviço ou barramento. Projeto mais formal, com ambiente de homologação e janela de deploy |
| Sistema legado ou "próprio da casa" | Sistema antigo, banco acessado direto, troca por arquivo | Viável, e é outro projeto. Se a resposta sobre a API for "a gente troca um arquivo por FTP", conte com uma camada intermediária no escopo |
Nenhuma dessas famílias é impedimento. Mas a diferença de esforço entre a primeira e a última linha é de semanas para meses, e é isso que precisa estar na proposta antes de você assinar. Como essa linha entra no orçamento está em quanto custa e quanto tempo leva um e-commerce.
O que costuma dar errado
Sincronizar tudo o tempo todo. Trazer o catálogo inteiro a cada execução derruba a API do ERP e a loja junto. O caminho é sincronizar por alteração, com uma carga completa apenas de madrugada.
Ignorar a fila de erro. Toda integração falha em algum momento: API fora do ar, produto com dado inválido, timeout. O que separa uma integração boa de uma ruim é ter uma fila visível de itens que não passaram, com a possibilidade de reprocessar.
Estoque sem reserva. Se o estoque não é reservado no momento do pedido, dois clientes compram a mesma última peça. A reserva pode viver na loja ou no ERP, mas precisa existir em algum lugar.
Um único estoque para vários canais. Loja física, marketplace e e-commerce disputando o mesmo saldo sem regra de alocação geram cancelamento em todos os canais ao mesmo tempo.
Preço em dois lugares. Promoção criada na loja enquanto o ERP continua mandando o preço de tabela produz uma disputa silenciosa: a cada sincronização, o desconto desaparece. Decida onde a promoção nasce antes de ligar a integração.
Perguntas para fazer antes de contratar
Antes de fechar qualquer integração, pergunte:
- O meu ERP tem API documentada? Se a resposta for "tem um arquivo que a gente troca por FTP", o projeto é possível, mas é outro projeto.
- Qual a frequência de sincronização de estoque? "Diária" é insuficiente para quase todo varejo.
- Existe limite de chamadas na API? ERPs de nuvem costumam ter, e isso define a arquitetura da sincronização.
- O que acontece quando falha? Se não houver resposta clara sobre reprocessamento, haverá pedido perdido.
- Quem cuida disso depois? Integração não é entrega única. ERP atualiza, API muda, regra de negócio nova aparece.
O ganho real
Uma integração bem-feita não aparece em uma métrica bonita. Aparece na ausência de coisas: menos cancelamento, menos chamado de "cadê meu pedido", menos planilha paralela, menos hora de gente digitando o que o sistema poderia ter escrito.
É por isso que ela costuma ser subestimada no orçamento e superestimada em importância só depois do primeiro pico de venda.
Perguntas frequentes
Quanto tempo leva para integrar a loja ao ERP?
Com ERP de nuvem como Bling, Tiny ou Omie e regra de negócio simples, algumas semanas dentro do projeto da loja. Com ERP de porte como TOTVS ou Sankhya, conte com mais tempo — o gargalo costuma ser liberação de acesso e homologação, não desenvolvimento.
Qual deve ser a frequência de sincronização do estoque?
Quanto mais curta, menos venda de produto inexistente. Em varejo de giro alto, o intervalo desejável é de minutos. Sincronização diária só funciona em catálogo de baixo giro e estoque folgado.
O ERP ou a loja deve ser a fonte da verdade?
Estoque, preço e cadastro de produto vêm do ERP. O pedido nasce na loja e sobe para o ERP. Status de separação, envio e nota fiscal voltam do ERP para a loja. O que não pode existir é a mesma informação sendo editada nos dois lados.
O que acontece quando a integração falha?
Uma integração bem-feita registra o item que não passou em uma fila visível e permite reprocessar. Sem isso, a falha vira pedido perdido — e você só descobre pelo cliente reclamando.
Preciso integrar tudo no lançamento?
Não, mas tudo precisa estar no plano. O caminho comum é subir produto, estoque e pedido no go-live e deixar nota fiscal ou transportadora adicional para a fase seguinte, com prazo definido.
Quer saber o que dá para integrar no seu caso? Conte qual ERP você usa e em qual plataforma sua loja roda. A Castle avalia antes de prometer — veja o escopo de uma integração ou fale com a gente.