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 a Netshoes 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 o problema, é necessário reprocessar manualmente a integração do estoque do SKU. Isso é feito no mesmo local onde o erro é visualizado, clicando no botão Ações > Reprocessar.
Quando é feito novo mapeamento de SKU, no entanto, não é necessário reprocessar manualmente o erro, pois a reindexação do produto é suficiente para o estoque ser atualizado na Netshoes.
Seguem as mensagens mais comuns de erros de integração de estoque com a Netshoes:
Mensagem de erro
Não foi possível localizar o mapeamento deste SKU na planilha
Este erro significa que o SKU não foi mapeado, ou que o mapeamento foi feito incorretamente. Para solucionar o problema, consulte o Mapeamento de categorias, variações e atributos da Netshoes, e realize o mapeamento do SKU.
É necessário preencher sua Planilha de Mapeamento com os termos exatos da Planilha de Consulta na Netshoes. Adotar palavras diferentes, ou variações de letras maiúsculas e minúsculas, ocasiona erros de mapeamento, pois a planilha é case sensitive.
Mensagem de erro
productGroup: Field contains invalid characters.
Conforme a documentação da Netshoes, ProductGroup é um código que agrupa variações de cor e tamanho do mesmo produto. Ele permite que, ao navegar pela plataforma da Netshoes, o usuário veja as variações do produto na mesma interface.
A necessidade de cadastrar agrupamentos de produtos da Netshoes depende da arquitetura do catálogo de uma loja VTEX. A mensagem de erro no seu Admin VTEX significa que o mapeamento desse atributo é necessário e que, ou isso não foi feito, ou não foi realizado corretamente, sendo necessário cadastrar o agrupamento.
Para mapear o atributo ProductGroup, cadastre uma especificação de produto chamada NetshoesProductGroup no ambiente VTEX, e preencha o campo com um valor no formato texto. Caracteres especiais e números não são aceitos. O valor que você definir para este campo no cadastro de especificação de produtos deve ser repetido para todas as variações de cor e tamanho de um mesmo produto, pois isso é o que vai permitir vincular variações de cor e tamanho na plataforma da Netshoes.
Mensagem de erro
Este produto não possui descrição, que é um campo obrigatório para integrar produtos neste marketplace
No cadastro do seu produto na VTEX, um campo considerado obrigatório pelo marketplace não foi preenchido na etapa de Mapeamento de categorias, variações e atributos da Netshoes. Na mensagem de erro, trata-se da Descrição do produto.
Para solucionar o problema, acesse seu Admin VTEX, em Catálogo > Produtos e SKUs, e encontre o produto em questão. Você pode Filtrar resultados ou fazer uma busca, clicando sobre essa opção. Após identificar o produto, clique em ALTERAR. Ao visualizar a página de cadastro, preencha o campo do produto Descrição do produto, e depois clique em Salvar.
Mensagens de erro
Este Sku não possui peso cadastrado ou é inferior a 1 grama, que é um campo obrigatório para integrar produtos neste marketplace
Este erro ocorre porque o campo Peso real do cadastro do SKU não foi preenchido ou isso não foi feito de forma correta, sendo que se trata de uma informação obrigatória para a Netshoes. A solução é acessar seu Admin VTEX, em Catálogo > Produtos e SKUs, e identificar o SKU da mensagem. Você pode Filtrar resultados ou fazer uma busca, clicando sobre essa opção. Uma vez na página do cadastro do SKU, preencha o campo Peso real com um valor acima de 1g, e clique Salvar.
Mensagens de erro
O Departamento (XXX) cadastrado na planilha de mapeamento, não corresponde à um valor aceito pela Netshoes.
O Gênero (XXX) cadastrado na planilha de mapeamento, não corresponde à um valor aceito pela Netshoes.
O Tamanho (XXX) cadastrado na planilha de mapeamento, não corresponde à um valor aceito pela Netshoes.
O Tipo de Produto (XXX) cadastrado na planilha de mapeamento, não corresponde à um valor contido no departamento (XXX)
A Marca XXX, cadastrada na planilha de mapeamento, não corresponde à um valor aceito pela Netshoes.
As mensagens indicam erros de mapeamento de valores. A tentativa de realizar uma correspondência entre o nome de um atributo do seu catálogo na VTEX, por exemplo, e o termo aceito pela Netshoes, não foi realizada com sucesso. Para solucionar o problema, consulte o Mapeamento de categorias, variações e atributos da Netshoes, e faça o mapeamento do atributo, variação ou categoria, conforme o que aparece na mensagem.
É necessário preencher sua Planilha de Mapeamento da Netshoes com os termos exatos da Planilha de Consulta na Netshoes. Adotar palavras diferentes, ou variações de letras maiúsculas e minúsculas dos termos aceitos pelo marketplace, ocasiona erros de mapeamento.
Mensagem de erro
Os atributo(s) XXX é(são) obrigatório(s) e não foi(foram) encontrado(s) no Produto e nem no Sku
A Netshoes não aceita integração de itens com atributos obrigatórios não mapeados. A mensagem indica que o mapeamento do atributo não foi realizado, ou que isso não foi feito de forma correta. Para solucionar o problema, consulte o Mapeamento de categorias, variações e atributos da Netshoes, e realize o mapeamento do atributo descrito na mensagem de erro.
É necessário preencher sua Planilha de Mapeamento da Netshoes com os valores exatos da Planilha de Consulta na Netshoes. Adotar palavras diferentes, ou variações de letras maiúsculas e minúsculas, ocasiona erros de mapeamento.