Imagine uma marca de alto padrão que acabou de lançar a loja virtual. O site está bonito, as fotos têm cuidado, o checkout funciona. No primeiro fim de semana de campanha, entram dezenas de pedidos. Na segunda-feira, alguém da equipe percebe que dois itens esgotaram no depósito, mas continuaram à venda na loja. Outra pessoa digita à mão, no sistema de gestão, os dados de cada pedido para emitir a nota fiscal. A vitrine funciona; a operação por trás dela, não.
Esse descompasso é o assunto da integração de e-commerce: fazer a loja conversar com o ERP, com o estoque e com a emissão fiscal, sem digitação duplicada e sem saldos divergentes. Na Trilion, desenvolvemos sites e sistemas desde 1995, e vemos que a integração costuma decidir se uma loja cresce com tranquilidade ou vira um esforço manual diário.
Neste artigo, você vai entender o que a integração conecta, como o estoque deve ser tratado, o que acontece entre o pedido e a nota fiscal, como APIs e webhooks sustentam tudo isso e quais perguntas fazer antes de contratar. Para ver como pensamos lojas de alto padrão, conheça nossa frente de e-commerce premium.
Integração de e-commerce: o que conecta a loja ao restante da empresa
A integração de e-commerce é a ligação automática entre a loja virtual e os sistemas internos, como ERP, estoque e emissão fiscal, para que cada pedido percorra a operação sem digitação manual.
O que é integração de e-commerce, em termos práticos
Uma loja virtual recebe pedidos, mas quem controla produtos, saldos, financeiro e documentos fiscais costuma ser outro sistema. A integração e-commerce é o conjunto de rotinas que leva informação de um lado para o outro: o pedido entra no ERP, o saldo volta para a loja, a nota fiscal retorna ao cliente.
Sem essa ponte, a empresa mantém duas versões da verdade. A loja mostra uma coisa; o escritório sabe outra. Cada diferença vira retrabalho, atraso de entrega e, no pior caso, venda de um produto que não existe mais.
O que é um ERP e por que ele entra na conversa
Segundo a Wikipédia, o ERP (enterprise resource planning, ou planejamento de recursos empresariais) é um sistema de informação que interliga dados e processos de uma organização em um único sistema. A mesma página explica que ele costuma usar uma base de dados compartilhada entre áreas como vendas, compras, contabilidade e fabricação.
Para o e-commerce, isso significa que o ERP concentra boa parte do que a loja precisa consultar ou alimentar: cadastro de produtos, estoque, pedidos, contas a receber e faturamento. A loja é um canal de venda; o ERP é o centro da operação.
Os 3 trilhos da integração
Quase toda integração entre loja e retaguarda se organiza em torno de 3 fluxos. Pensar neles separadamente ajuda a planejar, testar e corrigir cada um sem derrubar os outros.
- Catálogo e preço: o cadastro de produtos, as variações e as tabelas de preço seguem do sistema de origem para a loja.
- Estoque: o saldo disponível chega à loja, e cada venda reduz o saldo na origem.
- Pedido e nota fiscal: o pedido pago segue para o ERP, que emite o documento fiscal e devolve número, status e arquivos à loja.
Quando a integração deixa de ser opcional
Uma loja com poucos pedidos por semana pode operar com planilhas por algum tempo. O limite aparece quando o volume cresce, quando existem vários depósitos ou lojas físicas, ou quando a marca vende em mais de um canal. A partir daí, a digitação manual vira o gargalo e a fonte dos erros.
Se a sua equipe copia dados de um sistema para outro todos os dias, a integração já está fazendo falta. Compartilhe este texto com quem cuida da operação.
Estoque na loja virtual: como manter o saldo confiável
Um estoque confiável na loja depende de uma fonte única de verdade, de regras claras para reservar unidades e de atualizações que cheguem à vitrine no ritmo da operação.
Por que o saldo da loja e o do depósito divergem
A divergência nasce de situações comuns. Uma venda ocorre no balcão enquanto outra acontece no site. Uma devolução chega ao depósito e ninguém atualiza a loja. Um lote avariado é separado, mas continua somando no saldo vendável. Cada evento exige uma regra de quem atualiza quem, e quando.
Quando a integração não existe, essas diferenças se acumulam em silêncio. O cliente só descobre quando o pedido é cancelado por falta de produto, e a marca paga a conta em reputação.
Estoque total, disponível e reservado
A documentação para desenvolvedores da Shopify, usada aqui apenas como exemplo factual de como uma plataforma organiza o tema, separa o estoque em estados. O estado on_hand é o total de unidades fisicamente no local; available são as unidades que o lojista pode vender; committed são as reservadas para pedidos ainda não atendidos.
A mesma documentação descreve que, ao criar um pedido, o saldo disponível diminui e o comprometido aumenta, e só depois do atendimento o comprometido é reduzido. A lição vale para qualquer loja: vender não é o mesmo que tirar do depósito, e o sistema precisa distinguir as duas coisas.
Estoque por local: depósito, loja física e consignação
Ainda segundo a documentação da Shopify, as quantidades são registradas por combinação de produto, estado e local. Isso mostra um ponto de projeto: marcas com showroom, boutique e centro de distribuição precisam de saldo por local, não de um número único.
Na prática, a loja deve decidir de quais locais aceita vender, qual margem de segurança mantém e o que acontece quando o produto existe em um local, mas não no outro. Essas regras são de negócio, e o desenvolvimento só as traduz em código.
Rastro de auditoria nos ajustes de saldo
Toda alteração de saldo deve deixar rastro: quem alterou, por que e a partir de qual documento. A documentação citada prevê, por exemplo, um campo para registrar o sistema e o documento que originaram cada ajuste. Esse tipo de registro permite explicar uma diferença meses depois.
- Origem: qual sistema ou pessoa gerou o ajuste.
- Motivo: venda, devolução, avaria, inventário ou transferência.
- Documento: pedido, nota ou ordem de inventário que justifica a mudança.
- Momento: data e hora para reconstruir a sequência dos fatos.

Nota fiscal no e-commerce: do pedido pago ao documento emitido
A nota fiscal eletrônica é emitida a partir do pedido aprovado, normalmente pelo ERP ou por um emissor, e a loja precisa receber de volta o status e os arquivos do documento.
O que é a NF-e, de forma simples
Segundo a Wikipédia, a nota fiscal eletrônica (NF-e) é um documento de existência apenas digital, usado para registrar operações de circulação de mercadorias ou prestações de serviços. A página informa que ela está em vigor desde 15 de setembro de 2006 e que substituiu as notas impressas dos modelos 1 e 1A.
A mesma fonte lembra que a validade jurídica do documento é garantida pela assinatura digital do emitente e pelo recebimento da nota pelo fisco. Por isso, a emissão depende de um certificado digital e de um credenciamento prévio da empresa, que varia conforme o estado.
O caminho do pedido até a nota
Do ponto de vista da integração, a emissão é uma sequência de passos em que cada um depende do anterior. Desenhar essa sequência no papel antes de programar evita surpresas.
- O cliente conclui a compra e o pagamento é aprovado.
- A loja envia o pedido ao ERP com itens, valores, endereço e dados fiscais do comprador.
- O ERP valida o cadastro, calcula os tributos conforme as regras da empresa e gera o documento.
- O documento é transmitido, autorizado e devolvido com número e arquivos.
- A loja recebe o status, anexa o arquivo ao pedido e libera a separação para envio.
Dados fiscais que a loja precisa capturar
Muitas falhas de emissão começam no cadastro. Se o checkout não pede o documento do comprador ou aceita um endereço incompleto, o ERP rejeita a nota e o pedido fica parado. A loja precisa coletar, validar e organizar os dados que o documento fiscal exige.
Também é preciso conferir o cadastro do produto. Cada item deve chegar ao ERP com a classificação fiscal correta e a unidade de medida consistente. Quem define esses valores é o contador da empresa, e a integração apenas os transporta sem alterá-los.
O que fazer quando a emissão falha
A emissão pode falhar por dados inválidos, por instabilidade de comunicação ou por uma regra fiscal que mudou. Uma integração madura não esconde o erro: ela registra o motivo, avisa a equipe responsável e permite tentar de novo sem duplicar o documento.
Essa última parte é decisiva. Reenviar um pedido que já gerou nota não pode gerar uma segunda nota. Veremos adiante como a idempotência resolve esse risco.
ERP e loja: quem manda em cada informação
Integrar bem exige decidir, dado por dado, qual sistema é a fonte de verdade e qual apenas consulta, porque dois sistemas editando o mesmo campo geram conflito.
Fonte de verdade para produto, preço e cliente
Em muitas empresas, o ERP é a origem do cadastro de produtos e do saldo, enquanto a loja é a origem de conteúdo de vitrine: textos, fotos e ordem de exibição. Essa divisão evita que uma descrição editada na loja seja sobrescrita pela próxima sincronização.
O cliente merece atenção própria. Quem compra pela loja pode já existir no ERP, e duplicar cadastros prejudica o financeiro e o atendimento. A integração deve decidir como reconhecer a mesma pessoa ou empresa.
Integração em lote ou por evento
Há duas formas de mover os dados. Na integração em lote, uma rotina roda em horários definidos e transfere tudo o que mudou. Na integração por evento, cada mudança dispara uma mensagem imediata. A escolha depende do dado: preço pode atualizar de hora em hora; saldo de peça única pede resposta mais rápida.
Por isso, o termo estoque em tempo real merece cuidado. Ele só faz sentido quando todo o caminho, da baixa no depósito até a vitrine, foi desenhado para isso, e quando a operação precisa dessa velocidade.
Catálogo, B2B e logística como parte do mesmo desenho
A integração não termina no saldo e na nota. Ela alimenta o catálogo de produtos online, sustenta tabelas de preço por cliente no e-commerce B2B e informa a logística no e-commerce, do frete à entrega.
Planejar esses temas juntos poupa retrabalho. Uma regra de preço mal posicionada no ERP, por exemplo, reaparece como erro de checkout meses depois.

Como a integração funciona por baixo: API, webhook e idempotência
Lojas e sistemas conversam por APIs, que respondem a pedidos, e por webhooks, que avisam sobre eventos; a idempotência garante que repetir uma mensagem não repita o efeito.
API e webhook, sem jargão
Uma API é uma porta combinada: um sistema pede uma informação ou uma ação, e o outro responde. Um webhook é o caminho inverso: quando algo acontece, o sistema avisa o endereço cadastrado. A Stripe, em sua documentação, descreve o webhook como o meio de receber eventos assíncronos, como a confirmação de um pagamento, para que a integração reaja sozinha.
Em uma loja, o pagamento aprovado pode chegar por webhook do meio de pagamento, e a baixa de estoque pode seguir por API para o ERP. Trabalhamos com APIs, webhooks e integrações no dia a dia, e esse é o mecanismo que torna a operação automática. Para entender melhor a primeira peça, leia sobre gateway de pagamento.
Por que o mesmo aviso pode chegar duas vezes
A documentação de webhooks da Stripe informa que o endpoint pode receber o mesmo evento mais de uma vez, e recomenda registrar os identificadores dos eventos já processados para não tratá-los de novo. Também afirma que a ordem de entrega dos eventos não é garantida.
Para uma loja, isso tem consequência direta. Se o aviso de pagamento chegar duplicado e a integração não tiver defesa, o pedido pode ser enviado duas vezes ao ERP, com duas baixas de estoque e, em seguida, duas notas.
Idempotência: repetir sem duplicar
A idempotência é a propriedade de uma operação que pode ser repetida sem produzir um segundo efeito. A documentação da Stripe explica que, ao enviar uma chave de idempotência, o cliente pode repetir uma requisição após uma falha de conexão sem o risco de criar um segundo objeto.
O princípio vale além dos meios de pagamento. Ao enviar um pedido ao ERP ou solicitar uma nota, a integração deve carregar um identificador único, para que a repetição seja reconhecida e ignorada. É uma das proteções mais simples e mais importantes do projeto.
Segurança e filas nas mensagens
A mesma documentação recomenda verificar a assinatura de cada evento, porque sem verificação um invasor poderia enviar avisos falsos e acionar ações como a liberação de pedidos. Recomenda ainda responder rápido com sucesso e processar o trabalho pesado em uma fila assíncrona, para que picos de pedidos não derrubem o servidor.
- Assinatura: confirma que o aviso veio de quem diz ter enviado.
- Fila: organiza o processamento em um ritmo que o sistema aguenta.
- Registro: guarda cada evento e cada tentativa para consulta posterior.
- Reprocessamento: permite refazer uma etapa que falhou sem mexer nas demais.
Como planejar a integração: perguntas, etapas e cuidados
Um bom projeto de integração começa mapeando sistemas, fluxos e responsáveis, define regras antes de programar e termina com testes que simulam falhas, não só o caminho feliz.
Passo a passo de planejamento
Antes de falar em tecnologia, coloque a operação no papel. Esse roteiro serve para qualquer empresa, com qualquer ERP ou plataforma, e costuma revelar decisões que ninguém havia tomado.
- Liste todos os sistemas envolvidos: loja, ERP, emissor fiscal, meio de pagamento, transportadoras e atendimento.
- Desenhe o caminho de um pedido do clique até a entrega, apontando quem atua em cada passo.
- Defina, dado por dado, a fonte de verdade: produto, preço, saldo, cliente e pedido.
- Escolha o ritmo de cada fluxo: por evento ou em lote.
- Descreva o que ocorre em cada falha: pagamento recusado, produto esgotado, nota rejeitada, frete indisponível.
- Planeje testes com dados fictícios antes da primeira venda e um período de acompanhamento depois do lançamento.
Perguntas para qualquer fornecedor de integração
Quem se propõe a integrar sua loja deve responder com clareza a perguntas simples. Respostas vagas indicam que a parte difícil, as exceções, ainda não foi pensada.
- Queda do ERP: o que acontece se o ERP estiver fora do ar quando o pedido chegar?
- Duplicidade: como evitamos que um aviso repetido gere dois pedidos ou duas notas?
- Alerta fiscal: quem recebe o aviso quando uma nota é rejeitada, e em quanto tempo?
- Reserva: como o saldo é reservado entre o pagamento e a separação?
- Rastro: onde ficam os registros para explicar uma diferença de saldo?
- Continuidade: quem mantém a integração quando uma plataforma ou regra mudar?
Integração entre sistemas é a mesma disciplina
Se a sua empresa também precisa conectar CRM, financeiro ou sistemas próprios, vale conhecer nossa frente de integração de sistemas. O raciocínio é o mesmo: fonte de verdade, ritmo de troca, tratamento de falhas e rastro de auditoria.
Para escolher onde a loja vive, leia também sobre como escolher uma plataforma de e-commerce. A capacidade de integrar bem deveria pesar na decisão desde o início.
Cuidados específicos de marcas de alto padrão
Marcas premium vendem, muitas vezes, peças limitadas, edições numeradas ou itens sob encomenda. Isso torna o estoque ainda mais sensível: vender duas vezes uma peça única é um dano à marca maior do que um cancelamento comum. O desenho de reserva e de confirmação precisa respeitar essa realidade.
O atendimento também entra na conta. Quando a loja mostra status fiscal e de entrega com precisão, a equipe responde sem consultar três sistemas, e o cliente percebe cuidado em cada etapa.
Quer discutir a integração da sua loja com o ERP, o estoque e a nota fiscal? Conte-nos como a operação funciona hoje, e montamos o escopo a partir dela.
Conclusão
Integrar a loja ao ERP, ao estoque e à nota fiscal é transformar um site de vendas em uma operação que funciona sem digitação duplicada e sem saldos que se contradizem. Cada fluxo precisa de uma fonte de verdade, de um ritmo definido, de proteção contra repetição e de registros que expliquem o que aconteceu.
Na Trilion, programamos lojas e integrações com foco em marcas de alto padrão, e o nosso método começa pela operação, não pela ferramenta. A proposta é escrita depois do briefing, e o valor depende de escopo, integrações, volume e prazo. Se quiser dar o próximo passo, monte o briefing na página da frente de e-commerce premium ou em orçamento de desenvolvimento. Se este conteúdo ajudou, compartilhe com quem cuida da operação da sua empresa.
Sobre este texto
Este artigo foi escrito pela equipe da Trilion, com base na experiência de programar sites, lojas e integrações desde 1995 e na leitura de documentação pública de empresas e plataformas. Os exemplos de plataformas servem apenas para ilustrar como o tema é tratado na prática, sem recomendação nem comparação. Para temas fiscais e contábeis, consulte o contador da sua empresa.
- Wikipédia, Nota fiscal eletrônica: https://pt.wikipedia.org/wiki/Nota_fiscal_eletrônica (consulta em 07/11/2026).
- Wikipédia, Sistema integrado de gestão empresarial: https://pt.wikipedia.org/wiki/Sistema_integrado_de_gestão_empresarial (consulta em 07/11/2026).
- Stripe, documentação de webhooks: https://docs.stripe.com/webhooks (consulta em 07/11/2026).
- Stripe, requisições idempotentes: https://docs.stripe.com/api/idempotent_requests (consulta em 07/11/2026).
- Shopify, gestão de estoque para aplicativos: https://shopify.dev/docs/apps/build/orders-fulfillment/inventory-management-apps (consulta em 07/11/2026).

