Especificações do item no eBay: o que são e como preenchê-las

O que são as especificações do item no eBay

Cada categoria do eBay tem o seu próprio conjunto de atributos. Uma categoria de portáteis pode pedir o processador e o tamanho do ecrã, uma categoria de vestuário o tamanho e o departamento, e a maioria das categorias pede a marca. Cada atributo tem um nome escolhido pelo eBay e um valor que o utilizador indica, escolhido na lista do eBay ou escrito como texto livre quando a categoria o permite.

As especificações do item ficam ao lado do título e da descrição, e não dentro deles. Os compradores veem-nas num bloco estruturado na página da listagem, e a pesquisa do eBay utiliza-as nos filtros da coluna da esquerda — marca, tamanho, cor, estado, etc. Um pormenor que apareça apenas na sua descrição não pode ser utilizado por esses filtros.

Obrigatórias, Obrigatórias em breve, Recomendadas e Adicionais

No fluxo de criação de listagens do Seller Hub, o eBay agrupa as especificações do item de uma categoria em quatro níveis. O nível indica o que o eBay exige agora, o que passará a exigir mais tarde e o que os compradores procuram.

Como as especificações do item afetam a pesquisa, os filtros e os compradores

O eBay é direto quanto aos filtros: o seu artigo só aparece nos resultados de pesquisa filtrados se tiver adicionado a especificação do item correspondente. Um comprador que filtre uma pesquisa por Marca ou Tamanho nunca vê uma listagem que tenha deixado esse campo vazio, por melhor que seja o seu título.

As especificações do item também influenciam a classificação. Os fatores do Best Match do eBay incluem o grau de completude da listagem e a proximidade em relação aos termos de pesquisa do comprador. As orientações do eBay para vendedores indicam que as especificações do item aumentam as probabilidades de ser encontrado no eBay, no Google Shopping e nos resultados de pesquisa externos, e o fluxo de criação de listagens mostra quantas vezes cada especificação foi pesquisada nos últimos 30 dias — uma forma útil de decidir que atributos Recomendados priorizar.

Para os compradores, as especificações do item respondem às perguntas de comparação antes de lerem a descrição. Valores exatos reduzem as mensagens do tipo “isto serve?”, e valores errados originam devoluções: um comprador que filtrou por uma largura de 45 cm espera 45 cm.

Identificadores de produto: Marca, MPN, UPC, EAN, ISBN e “Não se aplica”

Os identificadores de produto são um grupo especial de especificações do item. O eBay descreve-os como códigos únicos criados pelo fabricante do produto — GTIN, como UPC, EAN e ISBN, mais a marca e o número de peça do fabricante (MPN) — e afirma que são obrigatórios na maioria das categorias.

Quando um identificador corresponde a um produto do catálogo do eBay, o eBay sugere a correspondência e pode preencher previamente o título, as fotografias e outros dados. Aceite apenas correspondências exatas: um ano de modelo ou um tamanho de embalagem diferentes são um produto diferente. Na Inventory API, o eBay prefere um ID de produto do eBay (ePID) para a correspondência com o catálogo, porque um mesmo GTIN pode corresponder a mais de um produto do catálogo.

• Marca: a marca apresentada no produto, e não o nome da empresa que lho vendeu. Para artigos genéricos, as orientações de boas práticas do eBay para programadores sugerem “Unbranded”.
• MPN: o número de peça ou de modelo do fabricante, constante da ficha técnica. Nunca coloque aqui o seu próprio SKU. Quando uma categoria exige um MPN, a Inventory API exige também uma marca.
• UPC, EAN ou ISBN: o GTIN do fabricante para essa variante exata. Valide o dígito de controlo antes de o utilizar.
• “Não se aplica”: para artigos que genuinamente não têm identificador, como antiguidades ou produtos por medida, o eBay permite selecionar “Não se aplica”. A formulação exata varia consoante o marketplace do eBay.

Limites de carateres das especificações do item no eBay

Os limites diferem entre as APIs do eBay, pelo que deve verificar qual delas é utilizada pela sua ferramenta de listagens. Quando uma fonte indica um número abaixo, esse é o máximo documentado; cada categoria pode devolver o seu próprio comprimento máximo para alguns atributos.

Como encontrar as especificações do item obrigatórias de uma categoria

Não existe uma lista única de especificações do item do eBay: os atributos e os respetivos níveis dependem da categoria final e do marketplace, e alteram-se com o tempo. Consulte-os para cada categoria em que vende.

Para um punhado de listagens, o Seller Hub é suficiente: escolha a categoria no fluxo de criação da listagem e este mostra as especificações Obrigatórias, Obrigatórias em breve, Recomendadas e Adicionais, com as contagens de pesquisas e qualquer data de “Obrigatória em breve”. Para corrigir listagens existentes em massa, a página Listagens ativas permite descarregar um ficheiro Excel com as listagens sem especificações e carregá-lo de novo, ou selecionar várias listagens e utilizar “Adicionar especificações do item”.

Para um catálogo grande ou em mudança, utilize a Taxonomy API, que devolve os mesmos metadados em formato legível por máquina:

1. Identifique a categoria final do artigo. Os atributos são definidos por categoria final, não por categoria-mãe.
2. Obtenha o ID da árvore de categorias do marketplace do eBay em que vende.
3. Chame GET /commerce/taxonomy/v1/category_tree/{category_tree_id}/get_item_aspects_for_category?category_id={id}. Ambos os parâmetros são obrigatórios.
4. Leia aspectConstraint.aspectRequired para decidir o que é obrigatório. Não confie em aspectUsage: devolve RECOMMENDED também para os atributos obrigatórios.
5. Anote aspectMode (SELECTION_ONLY significa que tem de utilizar um dos valores do eBay) e itemToAspectCardinality (MULTI permite até 30 valores).
6. Guarde expectedRequiredByDate para os atributos “Obrigatória em breve”, para os poder preencher antes do prazo.
7. Para muitas categorias de uma só vez, chame fetch_item_aspects na árvore de categorias, que devolve os atributos de todas as categorias finais, e atualize regularmente a sua cópia.

Ler os metadados dos atributos

Cada atributo devolvido por getItemAspectsForCategory traz restrições que indicam como o preencher. É nestes campos que se pode evitar a maior parte dos erros de mapeamento.

Mapear os atributos da ficha técnica do fornecedor para os atributos do eBay

Se revende outras marcas, a maior parte dos valores das especificações do item já existe na ficha técnica ou na folha de especificações do fornecedor — só que não nas palavras do eBay. O mapeamento é o trabalho de transformar uma linha da ficha técnica num nome de atributo e num valor que o eBay aceite.

Os exemplos abaixo mostram as transformações típicas. Os nomes dos atributos variam consoante a categoria, pelo que deve confirmar cada um nos metadados da categoria antes de confiar no mapeamento.

Exemplos por categoria: eletrónica, vestuário e brinquedos

Os atributos abaixo são pedidos com frequência nestas categorias e mostram de onde costumam provir os valores. São apenas ilustrativos: os nomes e os níveis reais dependem da categoria final e do marketplace, pelo que deve consultá-los conforme descrito acima.

Para o vestuário e o calçado, as páginas de ajuda do eBay descrevem uma transição, em 2026, para valores de tamanho normalizados, em que as listagens com tamanhos em falta ou pouco claros podem ser ocultadas. Consulte a ajuda “Criar uma listagem” atual do eBay antes de confiar em convenções de tamanho mais antigas.

Erros comuns nas especificações do item

A maior parte dos problemas com as especificações do item resulta de copiar valores sem verificar o que o eBay espera. Estes são os erros que mais frequentemente custam visibilidade ou originam devoluções.

• Preencher apenas os atributos Obrigatórios e ignorar os Recomendados pelos quais os compradores filtram.
• Utilizar aspectUsage em vez de aspectRequired para decidir o que é obrigatório ao trabalhar com a API.
• Escrever um valor de texto livre num atributo SELECTION_ONLY, ou uma grafia de uma marca que não corresponde à lista do eBay.
• Colocar o seu SKU no MPN, ou um código de barras comprado a um revendedor no UPC ou no EAN.
• Escolher “Não se aplica” para um identificador que o produto realmente tem.
• Misturar unidades (45 cm numa listagem, 450 mm noutra), de modo que os filtros dividam o mesmo valor.
• Utilizar as dimensões da embalagem quando o atributo pede as dimensões do artigo.
• Repetir expressões de marketing nos valores dos atributos em vez de valores de atributo simples.
• Definir os valores uma só vez e nunca voltar a verificar a categoria à procura de novos atributos “Obrigatória em breve”.

Checklist de especificações do item no eBay e preparação de valores em grande escala

Percorra esta lista para cada categoria antes de um lote de listagens entrar em linha. A parte demorada costuma ser reunir valores exatos a partir dos documentos de fornecedores, e não introduzi-los.

O Doc2Shelf ajuda nesse primeiro passo. Lê PDFs de fornecedores, extrai atributos candidatos — atribuindo a cada extração uma pontuação de confiança e guardando a página de origem e uma citação curta de cada dado extraído — e prepara rascunhos de texto orientados para o eBay e valores candidatos de especificações do item para a sua revisão. As novas ligações ao eBay estarão disponíveis em breve; as contas já ligadas podem continuar a publicar. Os novos utilizadores exportam o texto revisto como CSV ou JSON genérico, que não é um esquema de importação do eBay, e introduzem depois os valores no Seller Hub ou na sua própria ferramenta de listagens.

• Categoria final confirmada para o marketplace em que vende.
• Todos os atributos Obrigatórios preenchidos; os atributos “Obrigatória em breve” preenchidos antes da respetiva data.
• Atributos Recomendados com muitas pesquisas preenchidos.
• Marca, MPN e GTIN retirados dos documentos do fabricante e verificados.
• Valores de seleção exclusiva normalizados para os valores do eBay.
• Unidades e formatos coerentes entre listagens.
• Valores dentro dos limites de carateres documentados.
• Correspondências com o catálogo aceites apenas quando se trata do produto exato.