Sincronizacao de Estoque
Mantenha o estoque sincronizado entre o Bling e todos os marketplaces
O que e a sincronizacao de estoque
A sincronizacao de estoque e o mecanismo que mantem as quantidades disponiveis nos marketplaces sempre alinhadas com o estoque real cadastrado no Bling. Sem sincronizacao, voce corre o risco de vender mais do que tem em estoque ou de deixar produtos desatualizados com quantidade zero mesmo tendo mercadoria disponivel.
O ManarIA atua como intermediario inteligente entre o Bling e os marketplaces: recebe as atualizacoes do Bling, aplica as regras configuradas (como margem de seguranca) e atualiza automaticamente o estoque na Shopee, Shein e outros canais conectados.
Como funciona: Bling -> ManarIA -> Marketplaces
O fluxo de sincronizacao segue tres etapas:
- Bling registra uma movimentacao de estoque (entrada, saida, ajuste ou pedido faturado)
- Bling envia um webhook para o ManarIA notificando a mudanca
- ManarIA calcula o novo estoque (aplicando margem de seguranca se configurada) e atualiza os itens vinculados na Shopee e/ou Shein
Cada atualizacao gera um registro no log de sincronizacao, permitindo rastrear exatamente o que aconteceu, quando e com qual resultado.
Vinculo entre produtos
Para que a sincronizacao funcione, cada anuncio no marketplace precisa estar vinculado a um produto no Bling. Esse vinculo e feito pelo ID do produto Bling. Quando o ManarIA recebe uma atualizacao de estoque do Bling, ele busca todos os anuncios vinculados a esse ID e atualiza o estoque em cada um.
Sincronizacao automatica via webhooks
A sincronizacao automatica acontece em tempo real sempre que o Bling detecta uma movimentacao de estoque. Voce nao precisa fazer nada — basta garantir que a integracao com o Bling esta configurada corretamente.
Situacoes que disparam a sincronizacao automatica:
- Entrada de mercadoria (compra, producao, ajuste positivo)
- Saida de mercadoria (venda, ajuste negativo, perda)
- Faturamento de pedido no Bling
- Cancelamento de pedido (devolucao ao estoque)
Sincronizacao manual
Quando precisar forciar uma atualizacao imediata, o ManarIA oferece sincronizacao manual:
Sincronizar todos os produtos
Na pagina de Sincronizacao, clique no botao "Sincronizar Todos". Uma confirmacao sera exibida informando que o processo pode levar alguns minutos. Ao confirmar, o ManarIA consulta o Bling e atualiza o estoque de todos os produtos vinculados em todos os marketplaces.
Use essa opcao quando:
- Acabou de conectar um novo marketplace
- Suspeitar que o estoque nos canais esta desatualizado
- Retornar de um periodo de manutencao ou indisponibilidade
Sincronizacao por produto
Para atualizar um produto especifico, use o campo de busca por ID Bling nos filtros da pagina de Sincronizacao para localizar o produto e verificar os logs recentes.
Logs de sincronizacao
A pagina de Sincronizacao exibe todos os registros de sincronizacao realizados, com informacoes detalhadas sobre cada operacao.
Colunas da tabela de logs
| Coluna | Descricao |
|---|---|
| ID | Identificador unico do registro de sincronizacao |
| Produto (ID Bling) | ID do produto no Bling que originou a sincronizacao |
| Status | Resultado da operacao: Sucesso, Erro ou Pulado |
| Mensagem | Detalhes da operacao (estoque anterior e novo, ou mensagem de erro) |
| Tempo (ms) | Tempo de resposta da API do marketplace em milissegundos |
| Data/Hora | Momento em que a sincronizacao foi executada |
Status possiveis
- Sucesso: o estoque foi atualizado no marketplace com sucesso. A mensagem mostra a transicao, por exemplo
Estoque: 10 -> 8 - Erro: ocorreu uma falha na comunicacao com o marketplace ou na atualizacao do item. A mensagem de erro aparece em vermelho com o motivo
- Pulado: a sincronizacao foi ignorada, geralmente porque o estoque nao mudou ou o item nao estava elegivel para atualizacao
Filtros de status
Use o seletor de status para exibir apenas os registros de interesse:
- Todos os Status: exibe tudo
- Sucesso: apenas sincronizacoes bem-sucedidas
- Erro: apenas falhas (util para diagnostico)
- Pulado: apenas registros ignorados
Busca por ID Bling
No campo de busca ao lado do filtro de status, voce pode digitar o ID de um produto Bling para ver apenas os logs daquele produto especifico. A busca e aplicada com um pequeno atraso automatico para evitar requisicoes desnecessarias enquanto voce digita.
Estatisticas de sincronizacao
No topo da pagina, quatro cartoes exibem um resumo do desempenho da sincronizacao:
| Metrica | Descricao |
|---|---|
| Total de Syncs | Numero total de sincronizacoes realizadas desde o inicio |
| Sucesso | Quantidade de sincronizacoes bem-sucedidas |
| Erros | Quantidade de sincronizacoes com falha |
| Taxa de Sucesso | Percentual de sincronizacoes sem erro |
Uma taxa de sucesso saudavel e acima de 95%. Taxas abaixo disso indicam problemas na integracao que precisam de atencao.
Diagnostico de vinculos orfaos
O painel de Integridade de Vinculos aparece logo abaixo das estatisticas e realiza uma verificacao automatica de consistencia dos dados.
O que sao vinculos orfaos
Um vinculo orfao ocorre quando um anuncio no marketplace esta associado a um ID de produto Bling que nao existe mais na base de dados do ManarIA. Isso pode acontecer quando:
- Um produto foi excluido do Bling mas o anuncio continua ativo no marketplace
- O vinculo foi feito com um ID incorreto
- Houve uma migracao de dados que nao foi concluida corretamente
Como interpretar o diagnostico
Se o painel mostrar "Todos os vinculos OK" (badge verde), todos os anuncios nos marketplaces tem um produto Bling correspondente e a sincronizacao funcionara normalmente.
Se houver itens orfaos, o painel se expande automaticamente mostrando uma tabela com:
- Produto Bling ID: o ID que esta referenciado mas nao existe
- Qtd. de itens afetados: quantos anuncios estao com esse vinculo quebrado
- Marketplace(s): em quais plataformas os itens afetados estao
- Exemplos: nomes e SKUs dos anuncios afetados (ate 3 por ID)
Como resolver vinculos orfaos
- Identifique o produto correto no Bling que corresponde aos anuncios afetados
- Edite o vinculo de cada anuncio no ManarIA para apontar para o ID correto
- Recarregue a pagina para verificar se o diagnostico esta limpo
Margem de estoque
A margem de estoque e uma configuracao por conta de marketplace que define quanto do estoque real sera exposto no canal de vendas. Ela serve como colchao de seguranca para evitar overselling em situacoes de alta demanda ou atrasos na sincronizacao.
Como configurar a margem
A margem e configurada nas opcoes de cada conta de marketplace. Por exemplo, se voce tem 100 unidades no Bling e configura uma margem de 10%, o ManarIA exibira 90 unidades no marketplace.
Valores comuns de margem:
- 0%: todo o estoque disponivel e exposto
- 5% a 10%: margem conservadora para produtos de demanda estavel
- 15% a 20%: margem mais agressiva para produtos de alta rotatividade ou com logistica complexa
Dicas e problemas comuns
Estoque desatualizado no marketplace apos uma venda Verifique se o pedido foi faturado corretamente no Bling e se o webhook de estoque foi enviado. Acesse os logs de sincronizacao e filtre por "Erro" para verificar se houve falha na atualizacao.
Taxa de sucesso abaixo do esperado Os erros mais comuns sao: token de integracao expirado, anuncio pausado ou removido no marketplace, ou item sem vinculo com produto Bling. Filtre os logs por "Erro" e verifique a mensagem de cada falha para identificar o padrao.
Sincronizacao manual nao atualiza alguns produtos Confirme que os produtos estao vinculados corretamente. Use o diagnostico de vinculos orfaos para verificar se ha IDs inconsistentes. Produtos sem vinculo valido sao ignorados durante a sincronizacao.
Estoque vai a zero mesmo tendo mercadoria Pode ser um problema de vinculo incorreto ou de produto com estoque zerado no Bling. Verifique o saldo do produto diretamente no Bling e confirme que o vinculo aponta para o produto certo.
Sincronizacao muito lenta A sincronizacao em massa pode levar varios minutos dependendo do volume de produtos. Isso e normal. Acompanhe o progresso pelos logs — novos registros aparecem conforme as sincronizacoes sao concluidas.