Como Integrar PDV e E-commerce no Checkout: Guia Prático

Veja como a integração entre PDV e e-commerce funciona no checkout: estoque, pagamento, nota fiscal, custo real e os erros mais comuns.


Foto de Gabriella Fernandes
Escrito por
Última atualização:

Integrar o PDV ao e-commerce quase não muda a tela do checkout. Muda de onde ele tira os dados: um único estoque, um único cadastro de produto e uma única origem para a nota fiscal, tudo vindo do PDV.

É por isso que escolher o sistema certo não garante a integração. Ela falha depois, no tipo de conexão usada: API própria, webhook ou middleware, e cada um sincroniza o estoque numa velocidade diferente.

A falha mais cara aparece exatamente aí, quando alguém compra online um produto que já tinha acabado no balcão.

Como o Checkout Muda Quando o PDV Está Integrado ao E-commerce

Sem integração, o checkout do e-commerce roda com um estoque próprio, separado do balcão da loja.

Isso cria dois cadastros de produto, dois preços para atualizar e dois lugares onde uma venda pode dar errado.

Com o PDV integrado, o checkout passa a consultar o mesmo estoque em tempo real, o mesmo cadastro de produto e o mesmo histórico de vendas do balcão.

Na prática, quando alguém compra um produto na loja física, o checkout online já reflete essa baixa de estoque antes do próximo cliente finalizar a compra.

Isso resolve o problema mais comum de quem vende nos dois canais sem integração, o cliente que compra online um produto que já tinha acabado no estoque físico.

Como Funciona Tecnicamente a Integração Entre PDV e Checkout (API, Webhook e Middleware)

A conexão entre o PDV e o checkout acontece por três caminhos técnicos possíveis.

API própria do PDV: o sistema PDV expõe endpoints que a plataforma de e-commerce consulta diretamente, sem intermediário. É o modelo mais rápido e mais estável.

Webhook: o PDV avisa o e-commerce sempre que algo muda, uma venda, uma alteração de preço, um novo produto. O checkout recebe esse aviso e atualiza sozinho.

Middleware: uma camada intermediária que conecta os dois sistemas quando nenhum dos dois tem API pronta para conversar com o outro. Empresas como a Nuvemshop, a Tray e a VTEX oferecem apps de integração que fazem esse papel.

Sistemas PDV modernos, principalmente os que rodam em nuvem, tendem a ter API própria pronta. Já sistemas locais mais antigos costumam depender de middleware.

O tipo de conexão escolhido aqui define diretamente a velocidade da sincronização de estoque, que é o próximo ponto crítico do checkout.

Sincronização de Estoque em Tempo Real: Como Evitar Overselling no Checkout

O overselling acontece quando o checkout vende um produto que já não existe mais no estoque físico.

Isso gera cancelamento de pedido, reembolso e cliente insatisfeito, o pior tipo de atrito no e-commerce.

A integração bem feita reserva o estoque no momento em que o cliente finaliza o pedido no checkout, não no momento em que ele só adiciona ao carrinho.

Isso evita dois problemas ao mesmo tempo: reservar estoque para carrinhos abandonados e vender um produto que sumiu do balcão nos últimos minutos.

Sistemas com sincronização via webhook resolvem isso em segundos. Sistemas que dependem de sincronização em lote, a cada 15 ou 30 minutos, deixam uma janela de risco real para overselling.

Antes de contratar, pergunte diretamente qual é o intervalo de sincronização do estoque entre o PDV e o e-commerce.

Como Unificar os Métodos de Pagamento Entre a Maquininha do PDV e o Checkout Online

O pagamento é o ponto onde a maioria das integrações para na superfície e não entra no detalhe técnico.

Na prática, unificar pagamento significa que o gateway do checkout e a maquininha do PDV reportam para o mesmo painel financeiro, com o mesmo identificador de venda.

Isso evita o problema clássico de conciliação, onde o financeiro precisa cruzar manualmente vendas do e-commerce com vendas do balcão em duas planilhas diferentes.

Alguns sistemas vão além e permitem que o cliente pague no checkout com um cartão salvo previamente na loja física, ou vice-versa.

O ponto de atenção real: verifique se o gateway do checkout e a maquininha do PDV suportam o mesmo split de pagamento, principalmente se você trabalha com marketplace ou split entre fornecedores.

Comprar Online e Retirar na Loja: Como o Checkout Precisa Avisar o PDV (Click and Collect)

O modelo de comprar online e retirar na loja só funciona se o checkout e o PDV conversarem no momento exato da compra.

Quando o cliente escolhe retirada na loja, o checkout precisa reservar o produto no estoque físico imediatamente, não só no estoque geral.

Sem essa reserva específica, o produto reservado para retirada pode ser vendido no balcão antes do cliente chegar.

O Que Acontece se o Estoque Reservado no Checkout For Vendido no Balcão Antes da Retirada?

Isso é um erro de configuração, não uma limitação do modelo.

Uma integração correta bloqueia esse item específico no sistema do PDV assim que o pedido de retirada é confirmado no checkout, exatamente como se fosse uma venda em andamento no caixa.

Se o seu PDV não separa “estoque reservado para retirada” de “estoque disponível para venda no balcão”, o click and collect vai gerar problema mais cedo ou mais tarde.

Emissão de NF-e e NFC-e nas Vendas do E-commerce Feitas Pelo PDV

Cada canal de venda costuma exigir um tipo de documento fiscal diferente.

Vendas de balcão emitem NFC-e. Vendas para outras empresas pelo e-commerce podem exigir NF-e, dependendo do CNPJ do comprador.

Na integração, o checkout precisa informar ao PDV qual documento emitir para cada pedido, com base no perfil do comprador e no tipo de operação.

Sistemas homologados fazem essa emissão de forma automática assim que o pagamento é aprovado no checkout, sem intervenção manual do lojista.

Quais Plataformas de E-commerce Já Integram Nativamente com Sistemas PDV

Nem toda plataforma de e-commerce tem o mesmo nível de integração pronta com sistemas PDV.

Plataforma Tipo de integração com PDV
Nuvemshop Apps prontos no marketplace, conectam estoque e pedidos direto com PDVs parceiros
Tray API aberta e apps de integração via marketplace de parceiros
VTEX Módulo nativo de omnichannel, voltado para operações de maior porte
Shopify Apps de integração de terceiros, exige verificar compatibilidade com o PDV local
WooCommerce Plugins de integração, exige mais configuração manual que as plataformas com app pronto

Antes de escolher o PDV, confirme se ele já tem um conector pronto para a sua plataforma específica. Isso muda completamente o custo do próximo passo.

Passo a Passo Para Integrar o PDV ao Checkout do Seu E-commerce

Verifique se o PDV Tem API Própria ou Precisa de Middleware

Pergunte diretamente ao fornecedor do PDV se existe documentação de API pública ou se a integração depende de um parceiro externo.

Sincronize o Catálogo de Produtos Antes do Estoque

Cadastre e unifique os produtos primeiro. Sincronizar estoque com catálogos diferentes entre PDV e checkout gera erro de correspondência de item.

Configure o Checkout Para Refletir o Estoque em Tempo Real

Ative a sincronização via webhook, se disponível, em vez de sincronização em lote. Isso fecha a janela de risco de overselling.

Teste um Pedido Completo Antes de Publicar

Simule uma compra completa: reserva de estoque, pagamento, emissão de nota fiscal e baixa no PDV. Só publique depois que os quatro passos funcionarem sem erro manual.

Quanto Custa Integrar um Sistema PDV ao Checkout do E-commerce

O custo varia conforme o caminho técnico escolhido.

Modelo de integração Custo típico
Conector pronto no marketplace da plataforma R$ 0 a R$ 150/mês
Sistema PDV compatível (mensalidade) R$ 60 a R$ 250/mês
Integração sob medida via API (projeto único) R$ 3.000 a R$ 15.000
Taxa de transação do checkout 0,25% a 2% por venda

Para a maioria das pequenas empresas, o conector pronto resolve sem custo de desenvolvimento. O projeto sob medida só compensa quando o PDV atual não tem nenhuma opção de app ou API disponível.

Erros Mais Comuns ao Integrar PDV e Checkout (e Como Evitar Venda Duplicada)

Sincronização em lote em vez de tempo real. Gera a maior parte dos casos de overselling. Prefira sempre webhook a atualização programada de hora em hora.

Dois cadastros de produto com SKU diferente. O checkout e o PDV enxergam o mesmo item como produtos distintos, e o estoque nunca bate.

Cliente cobrado duas vezes. Acontece quando o gateway do checkout e o sistema de pagamento do PDV não compartilham o mesmo identificador de transação.

Nota fiscal duplicada ou ausente. Ocorre quando a integração não define, com clareza, qual sistema é responsável por emitir o documento fiscal de cada canal.

Testar um pedido completo antes de publicar, como descrito no passo a passo acima, evita a maioria desses erros antes que cheguem ao cliente final.

Perguntas Frequentes

O checkout do e-commerce fica mais lento com a integração do PDV?

Não deveria. Uma integração bem feita consulta o estoque e confirma o pedido em milissegundos, via API. Se o checkout ficar lento depois de integrar, o problema costuma ser o middleware mal configurado, não a integração em si.

Preciso trocar de PDV para integrar com o e-commerce?

Só se o seu PDV atual não tiver API própria nem suportar um middleware de integração. A maioria dos sistemas PDV lançados nos últimos anos já tem essa camada pronta. Sistemas muito antigos, sem atualização, geralmente exigem troca.

A integração funciona com qualquer emissor de nota fiscal?

Não. O PDV precisa estar homologado para emitir NF-e ou NFC-e e a integração precisa mapear qual documento sai para cada canal. Verifique isso antes de fechar contrato com qualquer plataforma.

Integração de PDV com e-commerce funciona sem internet no checkout online?

O checkout do e-commerce sempre depende de internet, isso não muda com a integração. O que muda é o PDV da loja física: alguns sistemas guardam a venda localmente e sincronizam o estoque assim que a conexão volta.

Quanto custa integrar um sistema PDV ao checkout do e-commerce?

Varia de zero (quando a plataforma já tem um conector pronto no marketplace de apps) até R$ 15.000 num projeto de integração sob medida via API. A maioria das pequenas empresas resolve com um conector pronto, sem custo de desenvolvimento.

Dá para integrar um PDV com mais de uma plataforma de e-commerce ao mesmo tempo?

Sim, desde que o PDV tenha uma API central que sirva de fonte única de estoque e preço. Cada plataforma se conecta a essa mesma API. O risco cresce se cada canal atualizar o estoque de forma independente, sem um ponto central.