Estoque em tempo real nos canais

Com o envio em tempo real ligado, cada movimentação de estoque no Hap empurra o saldo novo para todos os canais conectados, em segundos. A venda do canal desconta da variação certa, baixa o estoque no momento escolhido na conexão (ao faturar ou ao importar o pedido pago), o pedido ainda não pago pode segurar a unidade e o cancelamento feito no canal chega ao Hap. A tela Estoque multicanal mostra a divergência entre o Hap e o que cada canal anuncia. No Mercado Livre o envio de estoque manda só a quantidade: o preço do anúncio só vai junto se você ligar a opção na conexão.

MarketplaceAtualizado em 15/10/2026

Quando usar

Quando a empresa vende o mesmo estoque em mais de um canal e não pode depender de uma sincronização agendada, quando os saldos anunciados vivem divergindo do físico, ou para decidir em que momento a venda do canal baixa o estoque do Hap.

Antes de começar

  • Conexões de marketplace ativas em Marketplace > Canais
  • Recurso habilitado no servidor pela equipe Hap (ele vem desligado de fábrica)
  • Envio de estoque em tempo real ligado na configuração de CADA conexão que deve receber
  • Um único depósito de marketplace somando no envio (a tela da conexão avisa quando há mais de um)
  • Variações (tamanho e cor) conciliadas com os produtos do Hap, para a venda cair na variação certa

Vender o mesmo estoque em dois canais sem sincronização imediata é vender no escuro: entre a venda numa loja e a próxima varredura agendada, o outro canal continua oferecendo o que já saiu, e a venda sem estoque vira cancelamento, reclamação e punição de reputação. O envio em tempo real fecha essa janela: toda movimentação que muda saldo dispara o envio para todos os canais conectados da empresa, não só para o canal onde a venda aconteceu.

1. Pool único: um estoque, todos os canais

O saldo publicado nos canais é a soma dos depósitos marcados como depósito de marketplace, menos as reservas de pedidos ainda não faturados. O desenho recomendado é um POOL ÚNICO: um só depósito publicando para todos os canais. Todos vendem do mesmo balde e o número anunciado é sempre o que existe. Depósito Full (estoque que fica no centro de distribuição do canal, como o Full do Mercado Livre) é separado e não entra nessa soma.

2. Como ligar

Configuração da conexão, aba Estoque: a chave de envio de estoque em tempo real ligada, e a leitura de estoque do canal desligada automaticamente (mão única)
  1. 1

    Peça à equipe Hap a habilitação do recurso no servidor. Ele vem desligado de fábrica, para nenhuma empresa começar a enviar sem querer.

  2. 2

    Em Marketplace > Canais, abra a configuração da conexão e, na aba Estoque, ligue Enviar estoque em tempo real, a cada movimentação. Repita para cada canal que deve receber.

  3. 3

    Na aba Pedidos, escolha em Baixar o estoque da venda o momento em que a venda do canal baixa o estoque (seção 5).

  4. 4

    Ajuste o saldo físico no Hap e dispare uma carga total de estoque, para todos os anúncios partirem do número certo. Dali em diante o tempo real mantém.

  5. 5

    Confira o resultado na tela Estoque multicanal: o saldo do Hap e o que cada canal anuncia devem bater.

3. Como o envio acontece

Cada movimentação entra numa fila de envio, e movimentações seguidas do mesmo produto são agrupadas: o canal recebe um envio único com o saldo final, não uma rajada. O envio sai em segundos e é o saldo absoluto do pool, sem depender de o canal ter recebido os anteriores. A carga total em lote usa o mesmo caminho, para alinhar o catálogo inteiro de uma vez no início ou depois de um inventário.

Zero de verdade vai ao canal. Produto que já teve estoque no Hap e zerou envia ZERO, para o anúncio parar de vender. A opção Ignorar saldo zero de produtos sem estoque no Hap (aba Estoque da conexão) só pula o produto que NUNCA teve entrada de estoque nos depósitos de marketplace do Hap. Nesse caso o anúncio fica com a quantidade que já estava no canal, porque o Hap ainda não controla aquele produto.

O envio de estoque não muda o preço. No Mercado Livre o envio de estoque manda só a quantidade: o preço do anúncio no canal, inclusive a promoção, fica como está. Se você quer que o preço do Hap acompanhe cada envio de estoque, ligue a opção Enviar preço junto com o estoque, na aba Estoque da conexão. Ela vem desligada. Ligada, o preço do Hap (o preço próprio do anúncio, se houver, senão o do produto) sobrescreve o do Mercado Livre a cada envio, inclusive a promoção, e cada troca fica registrada nos logs da conexão com o preço de antes e o novo.

Configuração da conexão Mercado Livre, aba Estoque: a opção Enviar preço junto com o estoque, desligada (o padrão), com a explicação do que muda ao ligar

O preço próprio de um anúncio, gravado no Estúdio de Anúncio, vai ao Mercado Livre na hora, só o preço daquele anúncio, com a opção ligada ou não.

4. A venda cai na variação vendida

Quando o cliente compra a camiseta GG azul, a venda entra no Hap no produto da variação GG azul, e não no produto pai. É o que faz a reserva e a baixa descontarem a peça certa, e o saldo enviado de cada variação ficar correto.

Para isso a variação precisa estar conciliada com o produto do Hap. No painel do canal (Marketplace > Canais), abra a aba Produtos, clique em Ver variações no anúncio e use Conciliar em cada variação.

Onde a venda da variação entra no Hap
Situação da variaçãoOnde a venda caiO que fazer
Conciliada com um produto do HapNa variação vendidaNada
Com vínculo, mas sem produto conciliadoNo produto pai, com o aviso Variação ... sem vínculo conciliado no item do pedidoConcilie a variação; os próximos pedidos saem dela
Nunca sincronizadaNo produto paiClique em Sincronizar na aba Produtos do painel do canal e concilie a variação
Conciliada, mas nunca teve entrada de estoque no depósito de marketplace do HapNo produto pai, sem avisoNada, se a empresa controla o estoque no pai. Se o estoque é por variação, lance a entrada nas variações

O último caso é de propósito: há empresas que controlam o estoque no produto pai e conciliam as variações só para publicar. Nelas, baixar na variação sairia de um produto sem saldo.

5. Quando a venda do canal baixa o estoque

Cada conexão decide o momento da baixa na aba Pedidos, campo Baixar o estoque da venda. Até a baixa, a reserva do pedido segura a unidade, e ela já sai do saldo enviado aos canais.

Configuração da conexão, aba Pedidos: o campo Baixar o estoque da venda (Ao faturar a venda no Hap, o padrão) com a explicação das duas opções; na mesma aba ficam Segurar o estoque dos pedidos com pagamento pendente e o prazo em horas
Momento da baixa
OpçãoQuando a baixa aconteceQuando usar
Ao faturar a venda no Hap (padrão)Quando a nota é gerada no Hap, pelo Hub de Pedidos ou pelo faturamentoA nota fiscal da venda é emitida pelo Hap
Ao importar o pedido pago (nota emitida fora do Hap)Assim que o pedido pago entra no HapA nota é emitida em outro sistema; sem isso o Hap nunca baixaria

Pedido Full/FBA (o estoque está no centro de distribuição do canal) e pedido com nota emitida pelo próprio canal nunca baixam o estoque do Hap. No modo Ao importar o pedido pago, o que não conseguiu baixar na importação baixa no faturamento, se a nota for gerada no Hap depois.

6. Pedidos aguardando pagamento

Na Nuvemshop, na Shopee e no TikTok Shop, o pedido com pagamento pendente (Pix ou boleto ainda não pago) já desconta o estoque na loja, mas só vira venda no Hap depois do pagamento. Sem cuidado, o envio seguinte do Hap devolve a unidade à loja e ela pode ser vendida de novo.

A opção Segurar o estoque dos pedidos com pagamento pendente (aba Pedidos da conexão, desligada por padrão) resolve isso:

  1. 1

    Ligue a opção na conexão.

    A opção Segurar o estoque dos pedidos com pagamento pendente, na aba Pedidos da conexão (aqui desligada, o padrão)
  2. 2

    Ajuste Segurar o pedido pendente por até (horas). O padrão é 72 horas (de 1 a 720).

  3. 3

    Salve.

Com a opção ligada, as unidades desses pedidos saem do saldo enviado a todos os canais, sem criar venda no Hap. Pagou, o pedido vira venda normalmente. Cancelou, ou o prazo passou sem pagamento, a unidade volta no próximo envio.

7. Cancelamento feito no canal

Quando o canal cancela o pedido inteiro, o Hap reage conforme a situação da venda. Tudo fica registrado na aba Eventos do pedido, no Hub de Pedidos.

Hub de Pedidos, aba Eventos do pedido: cada evento com o tipo, a mensagem, o selo e a data e hora (neste pedido, cancelado no canal antes desta atualização, aparecem só os sincronismos e a mudança para cancelado)
O que acontece quando o canal cancela
Situação da venda no HapO que o Hap faz
Ainda não faturadaCancela a venda: solta a reserva e, se o estoque já tinha baixado, devolve ao estoque
Já faturada no HapSó avisa. Cancele a NF-e e depois a venda manualmente
Reembolso depois de o estoque já ter saídoSó avisa. Confira se a mercadoria voltou e faça a devolução no Hap

8. Pedidos antigos que nunca baixaram estoque

Antes desta atualização a venda do canal só reservava, sem baixar o estoque. A baixa retroativa desses pedidos antigos é feita pelo suporte da Hap, empresa a empresa, com uma simulação conferida antes. Não é preciso fazer nada por conta própria: fale com o suporte.

9. Acompanhar e conferir divergência

Estoque multicanal: o saldo do Hap e o que cada canal anuncia; número em vermelho tracejado é divergência, e o aviso explica a diferença

A tela Estoque multicanal (Painel de controle > Operação) é o acompanhamento diário: uma linha por produto com o saldo do Hap e o número que cada canal está anunciando. Número em vermelho tracejado é divergência; pare o mouse e o aviso explica a diferença com o Hap. A comparação usa a última leitura do anúncio, então serve para flagrar canal que ficou para trás sem precisar esperar reclamação de cliente.

Problemas comuns

  • "O canal continua com o saldo antigo: confira na configuração da conexão, aba Estoque, se Enviar estoque ao canal está ligado. As chaves gerais de saída desligadas derrubam o tempo real junto, e a conexão em modo de simulação também não envia."
  • "O canal anuncia MAIS do que existe no físico: quase sempre há mais de um depósito de marketplace somando no envio, e cada canal recebe a soma de todos. A aba Estoque da conexão mostra o aviso; acione o suporte para consolidar."
  • "O canal mostra estoque que eu não tenho: com a opção Ignorar saldo zero de produtos sem estoque no Hap ligada, o produto que NUNCA teve entrada de estoque no Hap fica com a quantidade que já estava no canal. Lance o estoque do produto no Hap (entrada ou inventário) ou desligue a opção nessa conexão. Produto que já teve estoque no Hap e zerou envia zero normalmente."
  • "A venda caiu no produto pai e não no tamanho ou cor vendido: a variação não está conciliada (o item do pedido traz o aviso Variação ... sem vínculo conciliado), nunca foi sincronizada, ou a variação conciliada nunca teve entrada de estoque no depósito de marketplace do Hap (empresa que controla o estoque no pai). Concilie a variação na aba Produtos do painel do canal (Ver variações > Conciliar): os próximos pedidos saem dela. O pedido que já entrou não muda sozinho; corrija o item na venda."
  • "Vendi no canal e o estoque do Hap não baixou: com Baixar o estoque da venda em Ao faturar, a baixa só acontece quando a nota é gerada no Hap (até lá a reserva segura a unidade). Se a sua nota é emitida fora do Hap, mude a conexão para Ao importar o pedido pago. Pedido Full/FBA e pedido com nota emitida pelo canal nunca baixam: o estoque é do canal."
  • "A baixa ficou pendente: no Hub de Pedidos, aba Eventos do pedido, aparece Baixa de estoque pendente com o motivo (por exemplo, saldo insuficiente ou depósito não informado). A nota continua valendo e não é desfeita. Corrija a causa e fale com o suporte da Hap para refazer a baixa."
  • "O canal voltou a oferecer a unidade de um pedido ainda não pago: a opção Segurar o estoque dos pedidos com pagamento pendente está desligada, ou o prazo em horas passou. Ligue a opção (Nuvemshop, Shopee e TikTok Shop) e ajuste o prazo."
  • "O canal cancelou e a venda continua no Hap: se a venda já foi faturada no Hap, o Hap só avisa (aba Eventos do pedido no Hub); cancele a NF-e e depois a venda. Também ficam como estavam os pedidos cancelados antes da atualização e os cancelamentos que o Hap recusou (o aviso traz o motivo)."
  • "O cliente teve reembolso depois do envio e o estoque não voltou: correto, o Hap só avisa. Confira se a mercadoria voltou de fato e faça a devolução no Hap."
  • "Pedidos antigos nunca baixaram estoque: antes desta atualização a venda do canal só reservava. A baixa retroativa desses pedidos é feita pelo suporte da Hap, com simulação antes; fale com o suporte."
  • "O preço de um anúncio do Mercado Livre mudou depois de um envio de estoque: antes desta atualização o envio de estoque do Mercado Livre levava o preço do Hap junto e podia sobrescrever o preço do anúncio, inclusive a promoção. Agora ele manda só a quantidade. Confira o preço desses anúncios e corrija no Mercado Livre, ou grave o preço próprio do anúncio no Estúdio de Anúncio, que vai ao canal na hora."
  • "Quero que o preço do Hap vá junto com o estoque para o Mercado Livre: ligue Enviar preço junto com o estoque na aba Estoque da conexão. A cada envio o preço do Hap passa a sobrescrever o do anúncio, inclusive a promoção, e cada troca fica registrada nos logs da conexão com o preço de antes e o novo."
  • "Liguei o tempo real e o canal parou de escrever saldo no Hap: correto, e de propósito. Com o tempo real o Hap é a única fonte do saldo, e a escrita do canal no Hap é desligada automaticamente para não criar um circuito de saldo inflado."

Artigos relacionados