Entendendo a Quarentena Preventiva de Produtos e o Desbloqueio Automático
Última atualização: Novembro de 2026
Aplicável para: Todos os lojistas dropshippers.
1. O que é a Lista de Produtos Bloqueados?
Quando a Hubiss tenta publicar um produto no Mercado Livre ou na Shopee e a API do canal rejeita o item de forma reiterada com erro de validação estrutural, a plataforma move esse produto temporariamente para a tabela de Produtos Bloqueados para Integração (integration_blocked_products).
Isso funciona como uma quarentena preventiva de segurança.
2. Por que Essa Proteção Existe? (Arquitetura Fail-Safe)
Você pode se perguntar: "Por que a Hubiss bloqueia o produto em vez de ficar tentando enviar infinitamente?"
O motivo é a proteção direta da sua loja e da sua conta:
- Evitar Bloqueio por Excesso de Requisições (Rate Limit):
Se um robô continuar enviando um produto com dados inválidos centenas de vezes por minuto, os firewalls do Mercado Livre e da Shopee bloqueiam temporariamente a conexão da sua conta por suspeita de ataque. - Evitar Penalidades de Catálogo:
Marketplaces monitoram a taxa de erro de integração de cada vendedor. Muitas tentativas com falha reduzem a pontuação de qualidade técnica da sua loja. - Economia de Recursos:
Ao colocar produtos inválidos em quarentena, o sistema foca todo o poder de processamento em sincronizar rapidamente os produtos e pedidos que estão saudáveis.
3. O que Causa o Bloqueio Preventivo?
Os principais motivos que colocam um produto em quarentena são:
| Causa da Rejeição | O que aconteceu? | Como corrigir? |
|---|---|---|
| Código EAN Inválido | O código de barras cadastrado no produto tem dígito verificador incorreto. | Corrija o EAN no produto ou marque como "Não se Aplica". |
| Categoria Sem Mapeamento | O produto pertence a um grupo sem categoria folha vinculada. | Acesse Categorização Inteligente e vincule a categoria folha. |
| Atributo Obrigatório Vazio | O campo Marca * ou outro atributo obrigatório ficou em branco. |
Preencha o atributo na tela de mapeamento da categoria. |
| Código ANVISA inválido | O Item Code da Shopee recebeu o SKU ou um código curto, como 1810. |
Informe o número oficial de registro, processo ou notificação da ANVISA. Se o produto for dispensado, use 00. |
| URL de Imagem Inacessível | A foto principal do fornecedor caiu ou não pôde ser baixada. | Atualize a foto do produto com um link válido. |
4. Como os Produtos São Desbloqueados?
A boa notícia é que você não precisa desbloquear produto por produto manualmente:
- Rotina Automática de Desbloqueio (
UnblockIntegrationBlockedProductsJob):
A Hubiss executa uma rotina automática de hora em hora em segundo plano.
Assim que você corrige a categoria pendente ou preenche os atributos com asterisco vermelho, essa rotina detecta a correção, remove os produtos da quarentena automaticamente e despacha a publicação para o marketplace! - Desbloqueio Imediato via Suporte:
Caso você tenha acabado de fazer um ajuste massivo e queira que o envio ocorra imediatamente sem esperar a rotina de hora em hora, basta clicar em "Revalidar Produtos Bloqueados" ou solicitar o reprocessamento rápido ao suporte.
5. E depois do desbloqueio, o que acontece?
Depois que o produto sai da quarentena, ele volta para o fluxo normal de publicação. Se a tentativa falhar por um erro temporário do marketplace, existe uma rotina automática de hora em hora que reprocessa o item sem precisar de ninguém da Hubiss.
Veja os detalhes em 05-rotina-automatica-de-reprocessamento-de-erros-de-integracao.md.
Pronto para colocar em prática?
Acesse seu painel agora mesmo para aplicar as configurações e acelerar suas vendas automatizadas.