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.
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
- 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
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
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
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
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.
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.
| Situação da variação | Onde a venda cai | O que fazer |
|---|---|---|
| Conciliada com um produto do Hap | Na variação vendida | Nada |
| Com vínculo, mas sem produto conciliado | No produto pai, com o aviso Variação ... sem vínculo conciliado no item do pedido | Concilie a variação; os próximos pedidos saem dela |
| Nunca sincronizada | No produto pai | Clique 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 Hap | No produto pai, sem aviso | Nada, 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.
| Opção | Quando a baixa acontece | Quando usar |
|---|---|---|
| Ao faturar a venda no Hap (padrão) | Quando a nota é gerada no Hap, pelo Hub de Pedidos ou pelo faturamento | A nota fiscal da venda é emitida pelo Hap |
| Ao importar o pedido pago (nota emitida fora do Hap) | Assim que o pedido pago entra no Hap | A 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
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
Ajuste Segurar o pedido pendente por até (horas). O padrão é 72 horas (de 1 a 720).
- 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.
| Situação da venda no Hap | O que o Hap faz |
|---|---|
| Ainda não faturada | Cancela a venda: solta a reserva e, se o estoque já tinha baixado, devolve ao estoque |
| Já faturada no Hap | Só avisa. Cancele a NF-e e depois a venda manualmente |
| Reembolso depois de o estoque já ter saído | Só 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
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."
