Resposta curta
Integrar loja e ERP quebra em quatro pontos previsíveis: pedido duplicado, estoque divergente, status que não volta e preço que atualiza em um lado só. O desenho que resolve usa chave de idempotência no pedido e reconciliação diária de estoque, porque publicar é fácil, o que falha em silêncio é a atualização.
Você reconhece isso
A loja vende e alguém digita o pedido no ERP. O estoque é atualizado por uma planilha que sai de um sistema e entra no outro, uma ou duas vezes por dia. Quando entra promoção, o time acompanha na mão para não vender o que já acabou.
Funciona enquanto o volume é baixo. Em campanha, a distância entre o que a loja mostra e o que o estoque tem vira cancelamento, e cancelamento em marketplace custa reputação, não só a venda.
Quem já tentou integrar costuma ter uma cicatriz: pedido que entrou duas vezes, repasse feito em cima de venda estornada, ou uma sincronização que parou em silêncio e ninguém percebeu por semanas.
O que isso custa
- 2 a 6 min
- por pedido redigitado à mão
- 1 a 4 %
- de cancelamento por estoque desencontrado
- D+7
- para perceber que a sincronização parou
O terceiro número é o que mais dói e o mais fácil de resolver: a maioria das integrações não tem alerta de falha, então a descoberta acontece pelo cliente reclamando.
Como a integração é construída
Decidir quem é dono de cada dado
Preço nasce onde? Estoque é do ERP ou da loja? Sem esse acordo, os dois sistemas se sobrescrevem, e é a causa da maioria dos casos de dado que 'volta sozinho'.
Pedido com chave própria
Cada pedido carrega um identificador estável da origem, e a criação usa essa chave. O provedor reenvia notificação por política e por instabilidade; chegando dez vezes, cria uma vez.
Estoque: reserva ou colchão
Reserva no checkout é mais correto e exige que o ERP responda rápido. Colchão de segurança por item é mais barato e aceita margem de erro conhecida. A escolha é de negócio. O erro é não escolher e ficar na rotina agendada.
Cadastro com regra de identidade
Documento é a chave, e-mail é secundário, e existe uma decisão explícita para quando o documento vem em branco. Sem isso, mil clientes viram quatro mil cadastros em seis meses.
Falha que grita
Fila com nova tentativa, ponto de retomada e alerta no canal que o time já lê. Integração que falha em silêncio é pior que integração nenhuma.
Como fica depois
- Pedido da loja no ERP em minutos, sem digitação
- Estoque coerente entre os canais, com regra de segurança definida
- Um cadastro por cliente, com regra de identidade explícita
- Reprocessar não duplica nada, por desenho
- Alerta quando a fila para, antes de o cliente reclamar
Perguntas frequentes
Nosso ERP não tem API. Ainda dá?
Dá. A ordem de preferência é API, webhook, exportação de arquivo agendada e, em último caso, leitura direta do banco. Cada degrau abaixo custa mais levantamento e entrega o dado com mais atraso. O diagnóstico diz qual degrau o seu caso permite antes de você decidir.
Já usamos um integrador de mercado. Vale trocar?
Se ele atende, não. Integrador pronto resolve bem o caminho padrão de plataformas populares. Vale construir quando existe regra própria que ele não modela (split entre filiais, preço por tabela de cliente, reserva de estoque com critério seu) ou quando o volume torna o custo por pedido relevante.
Quanto tempo leva?
Entre 2 e 5 semanas para o fluxo de pedido e estoque em produção, dependendo do que o ERP expõe. Financeiro e devolução costumam entrar numa segunda etapa, porque envolvem mais decisão de negócio que trabalho técnico.
Como sabemos que não vai duplicar pedido?
Porque isso é testado antes de entrar no ar: reenviamos a mesma notificação três vezes e conferimos que o ERP continua com um pedido só. É a primeira linha do roteiro de aceite, junto com derrubar o ERP de propósito e verificar que nada se perde.