GTIN: o código universal que o Mercado Livre exige
O que é o GTIN (EAN, UPC, ISBN), onde cadastrá-lo no WooCommerce conforme seu produto tenha ou não variações, e como resolver o erro 7810 do Mercado Livre.
O GTIN é o código de barras universal de um produto: o EAN de 13 dígitos que você vê em quase qualquer embalagem, o UPC de 12, o ISBN dos livros. Em muitas categorias o Mercado Livre o exige para publicar, e quando falta ele recusa o anúncio com o erro 7810: “The attributes [GTIN] are required for category…”. Este guia mostra onde cadastrá-lo na sua loja para que o WooSync o leve ao Mercado Livre, e o que fazer se o seu produto não tem código.
As regras do Mercado Livre
Essas regras são do Mercado Livre, não do WooSync — vale conhecê-las porque explicam todo o resto:
- O código precisa ser o real do produto. O Mercado Livre valida o formato (inclusive o dígito verificador) e o cruza com seu catálogo: se o número pertence a outra marca ou outra categoria, ele é recusado. Inventar um código não funciona.
- Em um produto com variações, o GTIN vai em cada variação: cada variante (cor, tamanho) é um produto físico distinto, com seu próprio código único. Repetir o mesmo código em várias variantes também provoca recusas.
- Se o seu produto realmente não tem código (produtos artesanais, kits montados por você, marcas não registradas), o Mercado Livre aceita que você declare o motivo no lugar do código. Não é uma forma de contornar o requisito: nas categorias em que o GTIN é obrigatório, o motivo não basta.
Onde cadastrá-lo na sua loja
O WooCommerce traz um campo nativo para isso: “GTIN, UPC, EAN ou ISBN”, na seção Estoque do produto. O WooSync o lê dali e o envia ao Mercado Livre ao publicar.
- Produto simples: cadastre o código nesse campo do produto, e pronto. Você também pode cadastrá-lo como atributo de código universal no seu modelo.
- Produto com variações: o campo se repete dentro de cada variação (aba Variações → expanda a variante). Cadastre em cada uma o seu código.
Atalho para variação única: se o seu produto tem uma única variação, não é preciso repetir o dado: o WooSync usa automaticamente o código cadastrado no produto pai ou no modelo e o envia na variação, como o Mercado Livre exige. (Disponível a partir do WooSync 8.0.9.)
Com duas ou mais variações o WooSync não copia um mesmo código para todas — seria inválido pela regra de unicidade. Aí sim, cada variação precisa do seu.
Se o seu produto não tem código
No modelo você pode declarar o Motivo de GTIN vazio: produto artesanal, kit, marca sem código registrado. O WooSync o envia no lugar do GTIN e o Mercado Livre o aceita nas categorias em que o código não é estritamente obrigatório. Lembre a regra acima: se a categoria o exige, o motivo não substitui o código.
Problemas frequentes
- “The attributes [GTIN] are required for category…” (erro 7810) → a categoria exige o código e o anúncio saiu sem ele. Cadastre-o onde corresponde conforme seu produto (campo do produto simples, ou campo de cada variação) e publique de novo.
- Cadastrei o GTIN mas o erro 7810 continua (produto com variações) → verifique onde ele está cadastrado. Se está no produto pai ou no modelo e o seu produto tem várias variações, o Mercado Livre espera o código de cada variante: cadastre dentro de cada uma. Se o seu produto tem uma única variação, atualize o WooSync para a versão 8.0.9 ou mais nova: a partir dela o código do pai ou do modelo viaja sozinho.
- O Mercado Livre diz que o código é inválido ou pertence a outro produto → o número não passa na validação do catálogo do Mercado Livre: pode ter um dígito digitado errado ou pertencer a outra marca ou categoria. Confira o código na embalagem real do produto.
- Publiquei sem código e o anúncio ficou pausado ou moderado → o Mercado Livre modera os anúncios sem o GTIN devidamente cadastrado nas categorias em que o pede. Cadastre o código e sincronize de novo.
Veja também
- Mapeamento de atributos — o resto da ficha técnica que o Mercado Livre exige por categoria.
- Publicar no Mercado Livre com modelos — onde se define a categoria e o motivo de GTIN vazio.
- Exportar seu catálogo — publicar em massa com o modelo pronto.