Nos marketplaces para os quais a VTEX desenvolveu um conector nativo, por vezes ocorrem erros de integração de estoque. Este artigo reúne os erros mais comuns de integração de estoque com o Mercado Livre e orienta sobre como solucioná-los.
Existem mensagens que identificam quais são os erros. Você pode visualizá-las no Admin VTEX, em MARKETPLACE > Conexões > Estoque, clicando sobre a mensagem de processo com erro.
Após solucionar um erro, é necessário reprocessar manualmente a integração do estoque daquele SKU. Isso é feito no mesmo local onde o erro é visualizado, clicando em Ações > Reprocessar.
Seguem abaixo as mensagens mais comuns de erros de integração de estoque com o Mercado Livre.
Mensagem de erro
Mensagem de erro não mapeada pela integração. Entre em contato com a VTEX informando o ocorrido para que o mapeamento seja realizado. Mensagem no Mercado Livre: Validation error. Is not possible to activate an item without stock.
A causa mais comum para o erro é que não há estoque para o item, e não é possível no Mercado Livre ativar um item sem estoque. Portanto, é necessário atualizar a quantidade de SKUs em estoque e reprocessar o erro. Se após o reprocessamento manual o erro persistir, outra causa possível é que o SKU esteja inativo. Verifique o status do SKU no seu Admin VTEX, em Catálogo > Produtos e SKU. Uma terceira possibilidade é que o item não esteja marcado corretamente na coleção ou política comercial definidos para o Mercado Livre. Se necessário, consulte o artigo Associação de SKU à Política Comercial.
Mensagem de erro
Mensagem de erro não mapeada pela integração. Entre em contato com a VTEX informando o ocorrido para que o mapeamento seja realizado. Mensagem no Mercado Livre: ProductId not found.
Para que um item seja integrado ao Mercado Livre, ao preencher os campos de cadastro desse produto é necessário que as flags Exibir no site e Mostrar produto esgotado estejam marcadas como ativas. Caso contrário, os SKUs deste produto não serão integrados ao Mercado Livre.
Mensagem de erro
Estoque não atualizado pois o anúncio no Mercado Livre está finalizado
Há diferentes motivos para o Mercado Livre considerar um anúncio como finalizado. O período de veiculação do anúncio pode ter sido concluído, por exemplo, ou pode ser que o anúncio esteja em desacordo com a política do marketplace. Não é possível atualizar estoque para anúncios finalizados no Mercado Livre. Para saber a razão de um anúncio ter sido finalizado, entre em contato com o Mercado Livre. Saiba mais na documentação do Mercado Livre sobre ajuda com anúncios.
Mensagens de erro
Não é possível atualizar um anúncio que está sob revisão pelo Mercado Livre. Mensagens no Mercado Livre: Cannot update item XXX [status:under_review, has_bids:false] variations is not modifiable.
Não é possível atualizar um anúncio que está sob revisão pelo Mercado Livre. Mensagens no Mercado Livre: Cannot update item XXX [status:under_review, has_bids:false] available quantity is not modifiable.
A tradução do trecho under review significa sob revisão, ou seja, o Mercado Livre está revisando o anúncio, pois ele violou as condições exigidas. Nas mensagens acima, por exemplo, é possível que algum dado do cadastro tenha sido preenchido de forma incorreta. Quando um anúncio está sob revisão no Mercado Livre, não é possível integrar estoque. Para solucionar a questão, entre em contato com o Mercado Livre.
Mensagem de erro
Mensagem de erro não mapeada pela integração. Entre em contato com a VTEX informando o ocorrido para que o mapeamento seja realizado. Mensagem no Mercado Livre: The caller is not authorized to access this resource.
Esta mensagem significa que o usuário está suspenso e, portanto, sua autorização para integrar estoque foi interrompida. A suspensão pode ocorrer por motivos diversos, desde pendências financeiras com o Mercado Livre, até a expiração do token da integração. Somente o Mercado Livre é capaz de identificar a causa e solucionar o problema, portanto, entre em contato com o marketplace.
Mensagem de erro
A quantidade disponível não é modificável em items com logística Fulfillment
Quando o seller optou pelo serviço Mercado Envios Full, isto significa que o Mercado Livre é o responsável pelo fulfillment do pedido. Ou seja, a logística de entrega do produto ao consumidor final é responsabilidade do próprio marketplace. Neste caso, é o Mercado Livre que controla o estoque, não sendo possível à VTEX atualizar estoques para anúncios desse tipo.
Mensagem de erro
The attributes [GTIN] are required for category. Check the attribute is present in the attributes list or in all variation's attributes_combination or attributes.
Mensagem traduzida: Os atributos GTIN são obrigatórios para a categoria. Verifique se o atributo está presente na lista de atributos ou em todas as variações de attributes_combination ou de attributes.
Também chamado de EAN na VTEX, o GTIN é o código de identificação único de um SKU. Trata-se do código de barras preenchido no cadastro de SKU, e a mensagem indica que o GTIN é obrigatório para a categoria à qual o SKU pertence. Caso o código tenha sido preenchido incorretamente, ou não seja válido, o SKU não será integrado ao Mercado Livre. Providenciar o GTIN correto de um produto é responsabilidade de fornecedores e fabricantes, a VTEX não gera códigos de barras para suprir este cenário.
Mensagens de erro
Error validating grant. Your authorization code or refresh token may be expired or it was already used.
Mensagem traduzida: Erro ao validar a concessão. Seu código de autorização ou token de atualização pode estar expirado ou pode ter sido utilizado.
Error converting access token
Mensagem traduzida: Erro ao converter o token de acesso.
As mensagens indicam que há algum problema com o seu token. Para o Mercado Livre, um token pode expirar por diferentes motivos, como prazo de validade extinto, ou suspeita de ameaça à segurança, por exemplo. Problemas relacionados a tokens devem ser tratados diretamente com o Mercado Livre. Após solucionar o erro, é necessário autorizar novamente a integração com o Mercado Livre no Admin VTEX. Se o erro persistir, pode ser necessário primeiro refazer a configuração do cadastro do conector no Admin VTEX, e só depois realizar nova autorização da integração.
Mensagem de erro
User not active
Mensagem traduzida: Usuário inativo.
Um usuário pode ser desativado no Mercado Livre por diversas razões, desde o preenchimento incorreto de dados cadastrais, até ter sido banido da plataforma por uma conduta em desacordo com a política do marketplace. Para solucionar o problema, entre em contato com o Mercado Livre.