Saltar para o conteúdo principal
Amazon

Erro «Escolha primeiro o tema de variação» ao validar a família na Amazon

Surge ao clicar em Pré-visualizar a família na Amazon quando o campo Tema de variação continua vazio porque nenhum tema do tipo de produto corresponde aos atributos das variantes. Resolve-se escrevendo um tema da lista que o tipo de produto admite e voltando a clicar no botão.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 5 de novembro de 2026

O essencial

Módulo
Amazon
Versões
Odoo 17, 18, 19 e 20
Verificado
no código do conector, versão 20.0 · nas fontes indicadas no fim
Leitura
4 min

O que vê e quando aparece

A ação é interrompida com este aviso: Escolha primeiro o tema de variação: nenhum tema deste tipo de produto corresponde aos atributos das variantes. (Choose the variation theme first: no theme of this product type fits the attributes of the variants.). Surge ao clicar no botão Pré-visualizar a família na Amazon (Preview family on Amazon) da ficha de Listagens. O texto está no código publicado do Odoo 17, 18, 19 e 20.

A ficha abre-se a partir de Amazon › Catálogo › Listagens, e cada troço desse menu exige a permissão Visualizador (Viewer). O botão fica oculto quando Número de variantes (Product Variant Count) é inferior a dois ou quando Tipo de Produto Amazon (Amazon Product Type) está vazio. Com os valores por defeito não se vê, porque o tipo de produto está vazio.

Esquema feito com código: o menu Amazon › Catalog › Listings, o botão Preview family on Amazon, o campo Variation theme e a mensagem de erro
Esquema feito com código a partir do código publicado do módulo, não é uma captura do Odoo. Os rótulos estão em inglês, o texto original do módulo.
Your Odoo doesn't talk to Amazon, Temu or Shopify?
Vídeo: Your Odoo doesn't talk to Amazon, Temu or Shopify? (vídeo em inglês)

A condição exata no código

A ordem em que o botão atua é esta: primeiro verifica as suas permissões, depois prepara a família de variantes e, só então, olha para o campo Tema de variação (Variation theme).

Ao preparar a família, o módulo escreve o tema de variação nas fichas da família. A mensagem surge se, depois de preparada, o campo continuar vazio (ou apenas com espaços). O próprio texto do aviso explica-o: nenhum tema deste tipo de produto corresponde aos atributos das variantes.

Se o campo tiver qualquer texto, essa verificação passa: não avalia se o tema é adequado para o produto.

Quando a ação é interrompida, não se chega a pedir à Amazon a validação do pai nem a das variantes, e não se guarda nada do que a ação ia alterar a partir daí. Essa validação é o que o botão faz quando tudo está em ordem.

O que significa

O tema de variação diz em que se diferenciam as variantes de um mesmo produto na Amazon. A ajuda do campo explica-o assim: «Em que diferem as variantes na Amazon (SIZE, COLOR, SIZE/COLOR…), da lista que o tipo de produto admite. Vazio: o anúncio vai sozinho.» (How the variants differ on Amazon (SIZE, COLOR, SIZE/COLOR…), from the list the product type allows. Empty: the listing goes on its own.).

O campo vê-se na ficha de Listagens e fica oculto quando Número de variantes é inferior a dois. Por isso a mensagem só pode surgir em fichas de produtos com variantes e com tipo de produto da Amazon escolhido, que são as que mostram o botão.

No código publicado, a ação que cria a família na Amazon lança a mesma mensagem.

Esquema feito com código: a mesma mensagem em castelhano, alemão, francês, italiano e português
Esquema feito com código a partir das traduções publicadas do módulo, não é uma captura do Odoo: o texto como o utilizador o vê consoante o idioma do seu Odoo.

Como resolver, passo a passo

  1. Abra Amazon › Catálogo › Listagens e entre na ficha do produto com variantes.
  2. Verifique que vê o botão Pré-visualizar a família na Amazon. Se não aparecer, verifique que o produto tem pelo menos duas variantes e que Tipo de Produto Amazon não está vazio.
  3. Procure o campo Tema de variação. Se estiver vazio ou com espaços, é a causa da mensagem.
  4. Escreva um tema da lista que o tipo de produto admite, com o formato dos exemplos da ajuda: SIZE, COLOR, SIZE/COLOR.
  5. Clique de novo em Pré-visualizar a família na Amazon.
  6. Leia o aviso que surge no fim: Família validada pela Amazon: … anúncios, … erros. Veja «Família de variantes». (Family validated by Amazon: … listings, … errors. See "Variation family".). Surge como aviso de advertência se houver erros e como aviso de sucesso se não os houver.

O que verificar depois

Quando a pré-visualização chega a validar a família, o módulo deixa um relatório chamado «Família de variantes». Começa com o tema escolhido (Tema:), os atributos da Amazon que pede (pede:) e o SKU pai:. Segue-se uma tabela com as colunas Atributo do Odoo e Atributo da Amazon.

Nessa tabela, uma linha é marcada com OK se corresponder ao tema; se não, diz: Não corresponde ao tema: defina «Atributo da Amazon» no atributo do Odoo, ou escreva o valor em cada variante (Does not fit the theme: set "Amazon attribute" on the Odoo attribute, or type the value in each variant). Essa frase é a pista para ajustar os atributos se o tema que escreveu não condiz com as suas variantes.

O relatório inclui também a lista de variantes, com a indicação novo (new) junto das que ainda não estão na Amazon, e, se alguma não tiver referência, a linha Variantes sem referência (SKU), fora da família: (Variants without a reference (SKU), left out of the family:) com os respetivos nomes.

Como a FlexigoTech o pode ajudar

O módulo está publicado no Odoo Apps para Odoo 17, 18, 19 e 20 (consulte a sua ficha no Odoo Apps ou a página do módulo). Se está a montar o catálogo da Amazon sobre o Odoo e quer que alguém reveja consigo os atributos das variantes, a FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

Continue a ler

Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes