Atributos obrigatórios e opcionais para adicionar produtos – Wish Merchant Help Center

Compilamos uma lista de todos os atributos de produtos que podem ser adicionados/editados via arquivo CSV e API (exceto atributos específicos que categorias, que podem ser encontrados Produtos > Categorias e atributos) e incluímos uma tabela para servir de referência para os atributos obrigatórios (com base na ação desejada no arquivo CSV). Observe que diversos atributos de produtos foram renomeados, conforme indica a lista abaixo.

Atributos obrigatórios

Clique no atributo para ver uma descrição dele e exemplos aceitáveis.

Atributo	Adicione produtos	Adicionar variação*	Editar frete*	Editar preço e inventário*	Editar título, imagens e descrição*	Editar por categoria/Editar todos campos*	Edição permitida*
SKU principal	Necessário	Necessário	Necessário	Necessário	Necessário	Necessário	Necessário
SKU	Necessário	Necessário	Não aplicável	Necessário	Necessário	Necessário	Necessário
Name	Necessário	Não aplicável	Não aplicável	Não aplicável	Opcional	Opcional	Não aplicável
Descrição	Necessário	Não aplicável	Não aplicável	Não aplicável	Opcional	Opcional	Não aplicável
ID da categoria	Necessário	Não aplicável	Não aplicável	Não aplicável	Não aplicável	Opcional	Não aplicável
Inventário	Necessário	Necessário	Não aplicável	Opcional	Não aplicável	Opcional	Não aplicável
Código da moeda	Necessário	Necessário	Opcional	Opcional	Não aplicável	Opcional	Não aplicável
Price	Necessário	Necessário	Não aplicável	Opcional	Não aplicável	Opcional	Não aplicável
Preço de frete padrão	Necessário	Não aplicável	Opcional	Não aplicável	Não aplicável	Opcional	Não aplicável
Imagem principal	Necessário	Não aplicável	Não aplicável	Não aplicável	Opcional	Opcional	Não aplicável
Imagem limpa	Necessário	Não aplicável	Não aplicável	Não aplicável	Opcional	Opcional	Não aplicável
Variation Image	Necessário	Necessário	Não aplicável	Não aplicável	Opcional	Opcional	Não aplicável
Package Weight	Obrigatório para comerciantes da China Continental	Obrigatório para comerciantes da China Continental	Não aplicável	Não aplicável	Não aplicável	Opcional	Não aplicável
Ativado	Não aplicável	Não aplicável	Não aplicável	Não aplicável	Não aplicável	Não aplicável	Opcional

*Observação: para todas as ações de edição por arquivo CSV, os campos marcados como “Opcional” podem ser removidos dos modelos de arquivos CSV baixados caso você não queira editar tais atributos. Se esses campos não forem removidos, eles serão considerados “Obrigatórios” e deverão ser preenchidos para todas as linhas/listagens do arquivo. Por exemplo, ao usar o modelo CSV Editar preço/inventário, o campo “Inventory” poderá ser removido, e o arquivo CSV poderá ser enviado normalmente. Se o campo “Inventory” não for removido, ele deverá ser preenchido para todas as listagens para que o envio do arquivo CSV aconteça sem problemas.

Lista de atributos

Brand ID

Tipo: String

Forneça a ID da marca do produto que está sendo vendido.

O produto precisa ser autêntico e fabricado diretamente pelo proprietário da marca. Por exemplo, a Apple é a marca do iPhone ou iPad, mas a Apple não é a marca de uma capa para iPhone não fabricada pela Apple.

Acesse o Diretório de Marcaspara ver uma lista de opções de marcas ou solicitar que uma nova marca seja adicionada.

Exemplos:

Aceitável: 545d5e6a6fa88c38cdfe0735

California Proposition 65 Chemical Names

Tipo: String

Selecione os nomes das substâncias químicas aplicáveis ao seu produto, se for o caso, para cumprir a Proposta 65 da Califórnia. Se você selecionou os tipos de aviso "Alimento", "Móvel" ou "Substância química", será necessário informar pelo menos uma substância química.

Ao usar um CSV, forneça uma separados por uma barra vertical. Informe até 5 nomes. Saiba mais sobre os avisos da Proposta 65 da Califórnia.

Exemplos:

Aceitável: Cloreto de benzila
Aceitável: Chumbo
Aceitável: Ácido Nalidíxico
Não aceitável: Produto químico

California Proposition 65 Warning Type

Tipo: String

Adicione o aviso ao seu produto para estar em conformidade com a . Escolha entre “Chemical,” “Food,” “Furniture,” “On_Product_Cancer,” “On_Product_Combined_Cancer_Reproductive,” “On_Product_Reproductive,” “Raw_Wood” e “Diesel_Engines.”. Para saber mais, consulte o artigo da Central de Ajuda “Resumo da Proposta 65 da Califórnia e avisos de risco.”

Exemplos:

Aceitável: Produto químico
Aceitável: Alimento
Aceitável: Produto_Câncer
Não aceitável: Outros

Imagem limpa

Tipo: String

URL da imagem limpa do seu produto. Deve ser a mesma URL Wish usada para a URL da imagem principal ou uma das URLs de imagem extra existentes ou mesmo a URL de uma nova imagem adicionada. Os produtos com imagem limpa selecionada podem receber mais impressões e vendas. Para saber mais, consulte este artigo da Central de Ajuda: Como escolher uma imagem limpa, além das diretrizes de imagens.

Exemplos:

Aceitável: http://www.yourwebsite.com/images/7324204/3
Aceitável: http://www.yourwebsite.com/images/dress.jpg
Não aceitável: https://www.you website.com/images/7324204/3
Não aceitável: http://www.yourwebsite.com/images/dresses.html

Color

Observação: caso seu produto se enquadre nas categorias de “Acessórios de moda”, “Celulares e telecomunicações”, “Computador e escritório”, “Eletrônicos”, “Entretenimento”, “Casa e jardim”, “Melhorias para casa”, “Joias e bijuterias”, “Malas e bolsas”, “Moda masculina”, “Calçados”, “Esportes” ou “Brinquedos e hobbies”, recomendamos usar “Cor principal” para informar a cor do produto. Para outras categorias, use este campo.

Tipo: String

A cor do produto. Se quiser mostrar duas cores (por exemplo, preto e vermelho), basta separar as cores por "&" (por exemplo, "preto & vermelho"). Não confunda com produtos que têm duas variações de cores diferentes. Cada variação de cor precisa ter a sua própria linha no feed, um SKU exclusivo e o seu próprio nível de estoque. O nome da cor precisa estar na lista de cores aceitas atualmente.

Exemplos:

Aceitável: vermelho
Aceitável: preto & azul
Não aceitável: vermelho, azul
Não aceitável: preto & azul & verde

Condition

Observação: caso seu produto se enquadre nas categorias “Celulares e telecomunicações”, “Computador e escritório”, “Eletrônicos”, ou “Componentes e suprimentos eletrônicos”, recomendamos usar o campo “Condição do item” para informar a condição do produto. Para outras categorias, use este campo.

Tipo: String

Informe a condição do produto. Você pode escolher entre “Novo”, “Usado” ou “Recondicionado”. É importante informar esse dado com precisão para que os pedidos passem sem problemas pela alfândega da UE.

Exemplos:

Aceitável: novo
Aceitável: usado
Aceitável: recondicionado
Não aceitável: Antigo

Contains Battery

Tipo: Booleano

Produtos que já contêm pilhas/baterias ou que as pilhas/baterias possam estar integradas ao produto sem poder ser removidas e que podem ser recarregáveis.

Exemplos:

Aceitável: Sim
Aceitável: Não
Não aceitável: 0

Contains Liquid

Tipo: Booleano

Produtos que contêm uma substância com livre fluidez, mas de volume constante, com a consistência semelhante à da água ou de óleo, incluindo semilíquidos, como cremes, géis, lubrificantes, etc.

Exemplos:

Aceitável: Sim
Aceitável: Não
Não aceitável: 0

Contém Metal

Tipo: Booleano

Produtos que contêm ou que são feitos de metal. Metal é um material sólido que normalmente é rígido, brilhante, maleável, fundível e flexível, com condutividade térmica e elétrica.

Exemplos:

Aceitável: Sim
Aceitável: Não
Não aceitável: 0

Contém Substância em Pó

Tipo: Booleano

Qualquer produto que seja totalmente composto por partículas finas e secas.

Exemplos:

Aceitável: Sim
Aceitável: Não

Não aceitável: 0

País de origem

Tipo: String

País onde o produto é fabricado, produzido ou cultivado. O código do país precisa seguir o código ISO 3166 Alpha-2.

Exemplos:

Aceitável: CN
Aceitável: US
Aceitável: China

Código da moeda

Tipo: String

O código da sua moeda local, a moeda utilizada em todos os seus produtos. Deve corresponder à sua moeda localizada.

Exemplos:

Aceitável: USD
Aceitável: CNY
Não aceitável: Chinesa

Customs Declared Name

Tipo: String

Nome do produto declarado para liberação alfandegária. Normalmente consta da embalagem do produto.

Exemplos:

Aceitável: Kit de Ferramentas
Aceitável: Anéis
Não aceitável: !Anéis
Não aceitável: T
Não aceitável: Bom 衬衫
Não aceitável: Nomes mais longos do que 200 caracteres

Customs Declared Value

Tipo: Número (Decimal)

O preço (em USD) do produto que será declarado à alfândega. Normalmente consta da embalagem do produto.

Exemplos:

Aceitável: US$ 100,99
Aceitável: US$ 10,99
Não aceitável: US$ 49,99 + S/H

Customs Harmonization System (HS) Code

Tipo: String

HS Code classification. A classificação HS está disponível aqui. Normalmente consta da embalagem do produto.

Exemplos:

Aceitável: 33021010.00
Aceitável: 6403.20
Não aceitável: 2
Não aceitável: a

Preço de frete padrão

Tipo: Número (Decimal)

O preço de frete padrão do seu produto. Será aplicado automaticamente como preço de frete para qualquer país de destino para o qual você não definir o preço de frete.

Exemplos:

Aceitável: 100,99
Aceitável: US$ 10,99
Não aceitável: 49,99 + S/H

Descrição

Tipo: String

Uma descrição detalhada do produto com até 4.000 caracteres. Não inclua nenhum código HTML, detalhes sobre as políticas da loja ou outros textos específicos sobre a loja.

Exemplos:

Aceitável: Esta camisa social é 100% algodão e corresponde ao tamanho descrito.
<b>Aceitável: Esta camisa social é 100% algodão e corresponde ao tamanho descrito.</b><i></i>

Ativado

Tipo: String

Ative este SKU na Wish inserindo "Yes". Os usuários poderão ver e comprar os produtos ativados. Para desativar, insira "No".

Exemplos:

Aceitável: "sim" ou "não"
Não aceitável: verdadeiro
Não aceitável: Ativar

Imagens extras

Tipo: String

Lista de URLs de imagens do produto, separadas por “|”. Envie um link diretamente para a imagem e não para a página onde o produto está localizado. As mesmas regras se aplicam ao atributo URL da imagem principal. A ordem dos URLs será a ordem das imagens exibidas na página do produto. Para atualizar imagens existentes ou adicionar novas imagens, você precisa fornecer todos os URLs de imagem extras, incluindo aquelas que permanecem inalteradas. Se nenhum dos URLs de imagem extra for fornecida, não haverá atualização. As imagens podem estar no formato JPEG, PNG ou GIF e seu tamanho deve ser pelo menos 500 x 500 pixels.

Exemplos:

Aceitável: http://www.yourwebsite.com/images/7324204/3 | https://www.yourwebsite.com/images/dress.jpg
Aceitável: http://www.yourwebsite.com/images/dress.jpg
Não aceitável: http://www.yourwebsite.com/images/dresses.html

GTIN

Tipo: String

GTIN de 12 a 14 dígitos (UPC, EAN, ISBN) sem letras ou outros caracteres não numéricos. Este número é uma simbologia de código de barras usada para rastrear itens comerciais em lojas e escaneá-los no ponto de venda.

Exemplos:

Aceitável: 716393133224
Não aceitável: asdf884445ds

Inventário

Tipo: Número inteiro

Quantidade de itens daquele SKU em estoque. Por favor, use o estoque de segurança para o estoque especificado da Wish. Máximo 500.000. Estoques superiores serão automaticamente reduzidos.

Exemplos:

Aceitável: 1200
Aceitável: 0
Aceitável: 4
Não aceitável: em estoque
Não aceitável: Fora de estoque

Imagem principal

Tipo: String

URL de uma foto do produto. Vincule diretamente à imagem, e não à página onde a imagem está localizada. Aceitamos os formatos JPEG ou GIF. Não inclua logotipos de empresas, nomes ou texto de identificação promocional nem outros tipos de nomes. As imagens devem ter pelo menos 500 x 500 pixels. Não inclua nenhuma imagem de “Imagem não encontrada”.

Exemplos:

Aceitável: http://www.yourwebsite.com/images/7324204/3
Aceitável: http://www.yourwebsite.com/images/dress.jpg
Não aceitável: http://www.yourwebsite.com/images/dresses.html

Max Quantity

Tipo: Número inteiro

A quantidade máxima de produtos por pedidos. Isso permite que os usuários dividam grandes pedidos para facilitar o gerenciamento e monitoramento. Só deve ser usado em casos raros.

Exemplos:

Aceitável: 100
Aceitável: 10
Aceitável: 1
Não aceitável: 0

Name

Tipo: String

Use o modelo a seguir para criar seus nomes de produtos: marca principal + submarca, nome da família ou do produto + até 3 atributos principais + tipo de produto genérico. Os nomes dos produtos precisam ser claros e concisos e devem descrever o produto que está sendo vendido. Este modelo ajudará os consumidores a identificarem seu produto.

Exemplos:

Aceitável: Câmera Nikon D5100 DSLR (somente corpo) MODELO EUA
Aceitável: Notebook Sony VAIO 15"
Não aceitável: Melhor preço!!! ***BARATO*** Carrinho de bebê!!!

Package Height

Tipo: Número (Decimal)

A altura da embalagem que será enviada ao cliente (unidades em cm).

Exemplos:

Aceitável: 13,40

Package Width

Tipo: Número (Decimal)

A largura da embalagem que será enviada ao cliente (unidades em cm).

Exemplos:

Aceitável: 13,40

Package Length

Tipo: Número (Decimal)

O comprimento da embalagem que será enviada ao cliente (unidades em cm).

Exemplos:

Aceitável: 10

Package Weight

Tipo: Número (Decimal)

O peso do pacote que será enviado ao cliente (unidades em gramas). É um campo obrigatório para listagens criadas por comerciantes da China.

Exemplos:

Aceitável: 151,5
Aceitável: 10

SKU principal

Tipo: String

A SKU principal é o identificador único de um produto. Ao usar um arquivo CSV para editar ou adicionar novas listagens, é preciso informar a SKU principal.

Exemplos:

Aceitável: HSC0424PP
Aceitável: 112123343455432
Não aceitável: 2
Não aceitável: a

Pieces Included

Tipo: Número inteiro

A quantidade de peças associadas ao item.

Exemplos:

Aceitável: 2
Aceitável: 1
Não aceitável: -1

Price

Tipo: Número (Decimal)

O preço do produto na moeda indicada pelo “Currency Code”. Também pode ser encontrado nas ou via API GET /api/v3/merchant/currency_settings. O cliente pagará esse valor pelo produto após a conversão para a moeda dele.

Exemplos:

Aceitável: 100,99
Aceitável: US$ 10,99
Não aceitável: 49,99 + S/H

Quantity Value

Tipo: Número (Decimal)

A quantidade total de determinada variante de um produto (na unidade determinada) que é usada para calcular o preço unitário do produto, usando a fórmula abaixo. Vale ressaltar que, se um mesmo produto tiver diversas variantes, você precisará definir valores de quantidade para cada variante desse produto.

(Preço * Valor de Referência) / Valor de Quantidade = Preço Unitário (exibindo o Valor de Referência em determinada Unidade)

Exemplo: você está listando um frasco de perfume de 200 mL por US$ 33,12 e gostaria de exibir o preço por cada 100 mL:

Tipo de medida = Volume (sistema métrico)
Unidade= mL
Valor da quantidade = 200
Valor de indicação = 100
Preço unitário = (US$ 33,12 x 100) / 200 = US$ 16,56 por 100 mL

Saiba como definir o preço unitário e os atributos do preço unitário.

Exemplos:

Aceitável: 1
Aceitável: 15
Não aceitável: ABCXYZ

Preço de Referência

Tipo: Número (Decimal)

As listagens têm um campo para o preço de comparação ou de referência. Caso o comerciante opte por informar um preço de referência, cada preço de referência precisará estar em conformidade com a Política de Preço de Referência de Produto.

Exemplos:

Aceitável: 716393133224
Não aceitável: asdf884445ds

Reference Value

Tipo: Número (Decimal)

Trata-se do valor de referência (na unidade determinada) usado para calcular o preço unitário de um produto e ilustrar o número de unidades para o consumidor, usando a fórmula abaixo.

(Preço * Valor de Referência) / Valor de Quantidade = Preço Unitário (exibindo o Valor de Referência em determinada Unidade)

Exemplo: você está listando um frasco de perfume de 200 mL por US$ 33,12 e gostaria de exibir o preço por cada 100 mL:

Tipo de medida = Volume (sistema métrico)
Unidade = mililitro
Valor da quantidade = 200
Valor de indicação = 100
Preço unitário = (US$ 33,12 x 100) / 200 = US$ 16,56 por 100 mL

Saiba como definir o preço unitário e os atributos do preço unitário.

Exemplos:

Aceitável: 100
Aceitável: 38
Não aceitável: ABCXYZ

Shipping Price US (Antes US)

Observação: para atualizar o frete na moeda local para um país diferente, use o respectivo código do país com duas letras da lista de países e regiões em vez de US.

Tipo: Número (Decimal)

O preço de frete por país na moeda local para clientes que compram nos Estados Unidos.

Exemplos:

Aceitável: 1,99
Não aceitável: mais de 1,99
Aceitável: desabilitado
Aceitável: ativado

Shipping Price US_HI

Tipo: Número (Decimal)

O preço de frete regional para clientes que compram no Havaí, Estados Unidos. Você pode especificar "desativado" ou "ativado" para determinar se os usuários dessa região podem comprar o produto. Você também pode especificar "Usar preço de frete do país" para desativar o frete regional. Para atualizar o preço de frete de outra região, use o código do país + '_' + código da região, definidos aqui, em vez de usar US_HI.

Exemplos:

Aceitável: 1,99
Aceitável: desabilitado
Aceitável: ativado
Aceitável: usar preço de frete do país
Não aceitável: mais de 1,99

Tamanho

Tipo: String

O tamanho do produto, principalmente porque pertence à categoria de vestuário, calçados ou joias. Cada variação de tamanho deve ter a sua própria linha no feed, ter o seu próprio SKU exclusivo e o seu próprio nível de estoque. Deve ser um número ou estar na Lista de tamanhos aceitos atualmente.

Exemplos:

Aceitável: P
Aceitável: GG
Aceitável: 6
Aceitável: 6,5
Não aceitável: pequeno
Não aceitável: P, M

SKU

Tipo: String

SKU é usada para identificar cada variante de um produto (SKU principal). Cada SKU principal pode ter várias SKUs exclusivas. Eventuais adições ou edições às variações de um produto exigem que você informe essa SKU.

Exemplos:

Aceitável: HSC0424PP
Aceitável: 112123343455432
Não aceitável: 2
Não aceitável: a

US TTD (Time-to-Door)

Observação: para atualizar o tempo de entrega para outro país, use o respectivo código do país com duas letras da lista de país e regiões em vez de US.

Tipo: String

O tempo de entrega para a região ou país específico. O tempo de entrega é mensurado como o tempo a partir de quando o pedido foi realizado até o momento em que foi confirmado como entregue. Se a entrega para esse país estiver desativada, a coluna também deverá estar definida como “desativada”.

Exemplos:

Aceitável: 4
Não aceitável: um
Não aceitável (mais de 15 dias): 20
Não aceitável (não é um número positivo): -2
Não aceitável (não é um número inteiro): 20,5

Unit

Tipo: String

Trata-se da unidade de medida para o conteúdo total de um produto. Será usada para exibir o preço unitário do produto (de acordo com a fórmula abaixo) e para determinar os atributos Valor de Referência e Valor de Quantidade.

(Preço * Valor de Referência) / Valor de Quantidade = Preço Unitário (exibindo o Valor de Referência em determinada Unidade)

Exemplo: você está listando um frasco de perfume de 200 mL por US$ 33,12 e gostaria de exibir o preço por cada 100 mL:

Tipo de medida = Volume (sistema métrico)
Unidade = mililitro
Valor da quantidade = 200
Valor de indicação = 100
Preço unitário = (US$ 33,12 x 100) / 200 = US$ 16,56 por 100 mL

Saiba como definir o preço unitário para os produtos.

Exemplos:

Peso: onça, libra, grama, miligrama, quilograma
Volume (sistema imperial dos EUA): onça-fluida, pint, quart americano, galão
Volume (sistema métrico): mililitro, centilitro, litro, metro_cúbico
Comprimento: polegada, pé, jarda, centímetro, metro
Área pé_quadrado, metro_quadrado
Por unidade: contagem, carga, lavagem, rolo, cápsula

Variation Image

Tipo: String

Observação: este campo só é obrigatório se houver variações. Cada variação deve ter uma imagem (não precisa ser uma imagem única).

URL de uma foto do seu produto. Copie o link diretamente na imagem e na página onde está localizada. Aceitamos os formatos JPEG, PNG ou GIF. Não inclua logotipos de empresas ou nomes ou texto de identificação promocional ou outro tipos de nomes. As imagens devem ter pelo menos 500 x 500 pixels. Não inclua nenhuma imagem de “Imagem não encontrada”. Não aceitamos imagens com URLs que começam com https://.

Exemplos:

Aceitável: http://www.yourwebsite.com/images/7324204/3
Aceitável: http://www.yourwebsite.com/images/dress.jpg
Aceitável: REMOVE_ALL
Não aceitável: https://www.you website.com/images/7324204/3
Não aceitável: http://www.yourwebsite.com/images/dresses.html

Variation Option

Tipo: String

Este campo é utilizado para definir os parâmetros para a criação de variações. É possível criar suas variações com os campos tradicionais Cor e Tamanho ou usar atributos específicos de cada categoria. Inclua o nome dos atributos desejados na coluna Opção de variação (com separação por vírgulas caso haja mais de uma) para a linha do produto pertinente e verifique se a SKU de cada variação tem valores exclusivos definidos para esses campos.

Para encontrar atributos específicos de uma categoria que possam ser usados para criar variações, acesse a página Categorias e Atributos, selecione a categoria desejada e clique em “Ver atributos”. A coluna “Ativado para variações” indicará se um atributo pode ser utilizado como uma opção de variação ou não.

Exemplos:

Aceitável: criar variações usando atributos específicos para uma categoria como parâmetros. Consulte a tabela abaixo que demonstra a adição de variações de cintos masculinos:

SKU principal	SKU	Variation Option	Material	Alpha Size
1234abcd	5678efgh	Material, Alpha Size	Jeans	M
1234abcd	8765hgfe	Material, Alpha Size	Couro	S
1234abcd	1122aabb	Material, Alpha Size	Couro	M

Aceitável: criar variações usando parâmetros tradicionais (use quando faltar um parâmetro dos atributos específicos de uma categoria ou se um atributo específico não puder ser usado como um parâmetro). Consulte a tabela abaixo que demonstra variações de primer (Maquiagem > Rosto > Primer) usando os atributos tradicionais de cor e tamanho já que os atributos específicos da categoria não estão disponíveis. Aqui, o campo “Size” é utilizado para representar o acabamento e o campo “Color” é usado para representar a cor:

SKU principal	SKU	Variation Option	Tamanho	Color
1234abcd	5678efgh	Size, Color	Brilho	Leve
1234abcd	8765hgfe	Size, Color	Fosco	Médio
1234abcd	1122aabb	Size, Color	Semi-matte	Profundo

Video URL

Tipo: String

URL do vídeo de demonstração que foi enviada para esse produto.

Exemplos:

Aceitável: http://www.yourwebsite.com/videos/demo.mp4
Não aceitável: https://www.youtube.com/watch?v=123465789
Não aceitável: http://www.yourwebsite.com/images/dresses.html

Armazém

Tipo: String

Forneça o nome exclusivo do depósito que você usa internamente para identificar um depósito. O preço de frete e o estoque são aplicados apenas ao depósito especificado. Se você não definir um, eles serão aplicados ao depósito padrão anexado à conta.

Exemplos:

Aceitável: US_94132
Aceitável: SZ_CN
Não aceitável: 2
Não aceitável: a

Artigos nessa seção