Como preencher corretamente o CSV do Zonos Catalog no Dashboard?

Ao preencher o modelo de CSV do Catalog, o único campo obrigatório é um `sku` ou `productId`, dependendo da sua `itemKeyPreference`. Se o seu arquivo tiver duplicatas do mesmo produto com base na preferência de chave de item, um produto é criado na primeira vez e, em seguida, o produto é atualizado com detalhes novos ou adicionais, se aplicável. Depois de preencher o modelo com os detalhes dos seus produtos, carregue seu CSV no seu Catalog.

Quais são as descrições dos campos do CSV do Catalog?

Os campos do CSV do Catalog incluem SKU, Product ID, Name, Description, Weight units, Weight, Dimensional units, Length, Width, Height, Restricted countries, Digital good, Country of origin, HS code, HS code ship-to country, Image URL, Material, Brand, Price, Currency.

Quais erros posso encontrar ao importar os produtos do meu catálogo?

Você pode encontrar erros relacionados ao tamanho do arquivo, ao formato do arquivo, a cabeçalhos de coluna ausentes ou não reconhecidos, a SKU ou ID de produto ausente, a unidades de peso ou dimensionais inválidas, a valores de peso, comprimento, largura ou altura inválidos, a unidades de peso ou dimensionais ausentes quando os valores são fornecidos, a país de destino ausente quando um código HS específico por país é fornecido, a países de destino ou códigos de moeda inválidos, e a campos dimensionais ausentes quando apenas um é fornecido.

InícioComércio eletrônico global Catalog Importação de CSV de produtos

Importação de CSV do Catalog

Importe seus produtos em massa para o Catalog.

A importação em massa do Zonos Catalog permite importar todo o seu catálogo de uma só vez. Ao preencher o modelo de CSV do Catalog, o único campo obrigatório para cada produto é um SKU ou ID de produto. Se o seu arquivo tiver duplicatas do mesmo produto com base no SKU e no ID de produto, o Catalog cria o produto na primeira vez e, se aplicável, os detalhes do produto serão atualizados com quaisquer informações novas ou complementares dos produtos duplicados.

Importar produtos

Vá para Dashboard -> Products -> Catalog.
Clique em Manage Catalog no canto superior direito. Em seguida, selecione Import products no menu suspenso.
Baixe o modelo de CSV do Catalog clicando em modelo de CSV de exemplo.
Faça a correspondência dos detalhes dos seus produtos com os campos do modelo de CSV da Zonos. Para isso, use a tabela abaixo para garantir que está usando os valores e as informações corretas nos campos mais adequados.
1. Para os campos ou colunas que não usar, basta deixá-los em branco. Você também pode excluí-los, mas isso não é necessário.
Salve seu arquivo como CSV.
Carregue seu novo arquivo CSV no Catalog arrastando e soltando o arquivo ou clicando em browse para localizar e selecionar seu arquivo. Observe que o tamanho máximo de arquivo para upload no Catalog é de 50 MB.
Siga as instruções para revisar os produtos carregados e corrigir os campos caso haja erros.
Clique em Import.

Requisitos de campos

Apenas um campo é obrigatório para importar um produto: um SKU ou um ID de produto, dependendo da sua preferência de chave de item. Todas as outras colunas podem ficar em branco.

No entanto, quanto mais detalhes de produto você fornecer, melhores serão os resultados. Dados de produto completos melhoram a precisão do landed cost, a classificação do código HS e o desembaraço aduaneiro, além de reduzir a chance de atrasos ou cobranças inesperadas para os seus clientes. Recomendamos preencher todos os campos para os quais você tenha dados, mesmo que apenas um identificador seja obrigatório.

Campos condicionalmente obrigatórios

Alguns campos são opcionais por conta própria, mas se tornam obrigatórios assim que você usa um campo relacionado.

Se você fornecer↕	Você também deve fornecer↕
Peso	Unidade de peso
Unidade de peso	Peso
Comprimento, largura ou altura	As três dimensões e uma unidade dimensional
Unidade dimensional	Comprimento, largura e altura
Preço	Moeda
Volume ou teor alcoólico	Volume e unidade volumétrica
Código HS específico por país	O país ao qual ele se aplica, no formato `Country code=HS code`

Observação: O peso padrão é pound e as dimensões padrão são inch, mas esses padrões só se aplicam quando você deixa em branco tanto o valor quanto a unidade. Se você fornecer um peso ou uma dimensão sem a respectiva unidade, a importação falhará.

Observação: Se você usar Inclusive Pricing, um preço e uma moeda são obrigatórios para cada produto, e a moeda deve corresponder à moeda nativa da sua organização.

Descrição dos campos do CSV

A coluna Obrigatório indica se um campo é obrigatório, opcional ou condicionalmente obrigatório, dependendo de outros campos que você fornecer.

Coluna↕	Obrigatório↕	Descrição↕
SKU	Obrigatório*	O código que identifica o produto dentro do seu negócio, por exemplo, GRLS-GRPHC-BBT-T-S
Product ID	Obrigatório*	Seu identificador de produto, geralmente o ID da sua plataforma de comércio eletrônico, por exemplo, 254678901
Name	Opcional	O nome do seu produto, por exemplo, Camiseta gráfica infantil feminina
Description	Opcional	A descrição detalhada completa do seu produto, por exemplo, Experimente um conforto e sofisticação incomparáveis com nossa camisa premium de poliéster, meticulosamente confeccionada para valorizar os itens essenciais do seu guarda-roupa. Desenvolvida para o indivíduo moderno, esta camisa apresenta uma estética elegante e versátil, tornando-a perfeita tanto para ambientes casuais quanto formais.
Customs description	Opcional	Descrição concisa do produto para a fatura comercial. Limite de 30 caracteres, por exemplo, Camiseta infantil feminina, 100% poliéster
Weight unit	Condicional	A unidade de peso do produto. Se nenhuma unidade for fornecida, o valor padrão será `pound`. Os valores válidos são `gram`, `kilogram`, `pound` e `ounce`.
Weight	Condicional	O peso do produto. O valor do peso deve ser um número positivo.
Dimensional unit	Condicional	A unidade dimensional do produto. Se nenhuma unidade for fornecida, o valor padrão será `inch`. Os valores válidos são `inch`, `foot`, `yard`, `millimeter`, `centimeter` e `meter`.
Length	Condicional	O comprimento do produto. O valor do comprimento deve ser um número positivo.
Width	Condicional	A largura do produto. O valor da largura deve ser um número positivo.
Height	Condicional	A altura do produto. O valor da altura deve ser um número positivo.
Packing preference	Opcional	Se o seu produto é enviado sozinho, `ships_alone`, ou pode ser `consolidated`. Se o seu produto puder ser consolidado com outros produtos no envio (o mais comum), você pode deixar este campo em branco.
Restricted countries	Opcional	Restrinja seu produto de determinados países. Os valores são códigos ISO de 2 dígitos separados por uma barra vertical. Se quiser restringir todos os países, informe `ALL`. Se quiser restringir todos os países, exceto um ou alguns, informe `ALL-` seguido dos países que deseja deixar sem restrição, separados por barras verticais, por exemplo, `ALL-CA\|AU\|US`. Se quiser restringir apenas países específicos, informe os países que deseja restringir separados por barras verticais, por exemplo, `AU\|KR\|MY\|SG`. Se quiser remover todos os países restringidos existentes, informe `NONE` como valor.
Product type	Opcional	Determina a natureza do produto. Os valores são `physical_good`, `digital_good`, `service`, `subscription`, `bundle` e `partial_item`. Se o seu produto for um bem físico (o mais comum), você pode deixar este campo em branco.
Country of origin	Opcional	O país onde o produto foi fabricado. Os valores são códigos ISO de 2 dígitos, por exemplo, `JP, GB, KR`.
Universal HS code	Opcional	O código HS universal de 6 dígitos do produto, por exemplo, 9506.62
Country-specific HS codes	Opcional	Os códigos HS específicos por país do produto, separados por barras verticais quando houver vários códigos específicos por país, por exemplo, IT=6109.10.0010\|DE=6109.10.0010\|GB=6109.10.0010\|JP=6109.10.020
Image URL	Opcional	A URL da imagem do produto, por exemplo, `https://www.exampleclothingstore.com/images/girls-graphic-baby-tee-pink-unicorn-001.jpg`
Material	Opcional	O material ou composição principal do seu produto, por exemplo, Poliéster
Brand	Opcional	A marca do produto, por exemplo, Nike
Price	Opcional	O preço que você está cobrando pelo produto.
Retail price	Opcional	O preço original do produto antes dos descontos. Exibi-lo junto ao preço promocional destaca a economia para os clientes. O preço de varejo deve ser maior que o preço base do produto (acima).
Currency	Condicional	A moeda do preço. Os valores são códigos de moeda de 3 dígitos, por exemplo, `USD`, `CAD` ou `AUD`.

*Um SKU ou um ID de produto é obrigatório, mas você não precisa fornecer os dois. Qual deles se aplica depende da sua preferência de chave de item.

Para comerciantes de bebidas alcoólicas: Se você vende produtos do Capítulo 22 do Sistema Harmonizado (bebidas alcoólicas), campos de medição adicionais são obrigatórios para os cálculos de imposto especial (excise duty). Consulte nossa documentação sobre imposto especial e use o modelo de CSV especializado para esses produtos.

Coluna↕	Obrigatório↕	Descrição↕
Volumetric unit	Obrigatório para bebidas alcoólicas	A unidade de medida do volume. Os valores válidos incluem milliliter, liter, fluid_ounce, etc.
Volume	Obrigatório para bebidas alcoólicas	O volume do produto, utilizado para os cálculos de imposto especial.
Alcohol by volume	Obrigatório para bebidas alcoólicas	O percentual de teor alcoólico. O valor deve ser informado como percentual, por exemplo, 12 para 12% ABV.

Erros de importação de CSV

Você pode encontrar erros ao importar os produtos do seu catálogo. A lista a seguir descreve os erros de importação e como resolvê-los. Depois de resolver os erros, você pode reimportar seu CSV.

Erros de importação

Error↕	Descrição↕
File must be under 1 GB.	Seu arquivo é muito grande. O arquivo deve ter menos de 1 GB.
File must be in CSV format.	O Catalog só aceita o formato de arquivo CSV. Para resolver isso, garanta que o formato do seu arquivo seja CSV.
Missing column header(s).	O Catalog só aceita arquivos no formato exato do modelo do Catalog. Verifique se os cabeçalhos do seu CSV correspondem aos cabeçalhos do arquivo modelo de CSV.
Unrecognized column header(s).	Você tem cabeçalhos de coluna não reconhecidos. O Catalog só aceita cabeçalhos no formato exato do modelo do Catalog. Remova os cabeçalhos de coluna não reconhecidos e verifique se os cabeçalhos do seu CSV correspondem aos do modelo de CSV.
You are missing a SKU or product ID. Ensure all of your products have a SKU or product ID.	É necessário um identificador (SKU/ID de produto) para criar um produto no catálogo. Para resolver isso, adicione um SKU ou ID de produto para cada produto.
Customs description exceeds character limit of 30 characters.	Por padrão, as descrições aduaneiras são limitadas a 30 caracteres, o que corresponde ao limite de caracteres mais comum para faturas comerciais.
Product type invalid.	Os valores são `physical_good`, `digital_good`, `service`, `subscription`, `bundle` e `partial_item`.
Packing preference invalid. Catalog supports the following packing preferences: ships_alone and consolidated. If your product can be consolidated with other products, leave blank.	Preferência de embalagem inválida. O Catalog aceita as seguintes preferências de embalagem: `ships_alone` e `consolidated`. Se o seu produto puder ser consolidado com outros produtos, você pode deixar em branco, já que `consolidated` é o valor padrão.
Weight unit invalid. Catalog only supports the following weight units: gram, kilogram, pound, and ounce.	O Catalog só aceita as seguintes unidades sem abreviação: `gram`, `kilogram`, `pound` ou `ounce`.
Weight must be greater than zero and cannot include letters or symbols.	Verifique se o valor do peso é um número positivo válido, sem símbolos ou letras. O Catalog aceita pesos com até duas casas decimais, por exemplo, 5.85
Dimensional unit invalid. Catalog supports the following dimensional units: inch, foot, yard, millimeter, centimeter, and meter.	O Catalog só aceita as seguintes unidades sem abreviação: `inch`, `foot`, `yard`, `millimeter`, `centimeter` ou `meter`.
Length must be greater than zero and cannot include letters or symbols.	Verifique se o comprimento é um número positivo válido, sem símbolos ou letras. O Catalog aceita comprimentos com até duas casas decimais, por exemplo, 5.29
Width must be greater than zero and cannot include letters or symbols.	Verifique se a largura é um número positivo válido, sem símbolos ou letras. O Catalog aceita larguras com até duas casas decimais, por exemplo, 2.44
Height must be greater than zero and cannot include letters or symbols.	Verifique se a altura é um número positivo válido, sem símbolos ou letras. O Catalog aceita alturas com até duas casas decimais, por exemplo, 8.02
A weight unit is required when you provide a weight value.	Forneça uma unidade de peso para os produtos que tiverem um valor de peso. O Catalog aceita as seguintes unidades de peso: `gram`, `kilogram`, `pound` e `ounce`.
A dimensional unit is required if you provide dimensional values.	Forneça uma unidade dimensional para os produtos que tiverem um valor dimensional. O Catalog aceita as seguintes unidades dimensionais: `inch`, `foot`, `yard`, `millimeter`, `centimeter` e `meter`.
HS code must be between 6 and 16 characters.	O código HS deve ter entre 6 e 16 caracteres, já que os códigos HS universais têm 6 dígitos e o código HS específico por país mais longo tem 16 dígitos.
Country-specific HS codes must be in the format of 'Country code=HS Code`	Os códigos HS específicos por país devem estar no formato Código do país=Código HS, por exemplo, `KR=8518.30.9000`. Se houver vários códigos HS, separe cada um com uma barra vertical, por exemplo, `KR=8518.30.9000\|CA=8518.30.9010`.
[Country code] is not a valid country code.	Os países de destino devem estar no formato ISO, por exemplo, `KR or BR`. Verifique se seus países de destino estão no formato ISO de 2 dígitos.
Country of origin values must be in ISO format.	Verifique se seu país de origem está no formato ISO de 2 dígitos.
Price cannot include negative values, letters, or symbols.	Verifique se o preço é um valor positivo e válido. O Catalog aceita preços com até três casas decimais, por exemplo, 104.399
If you supply a price, a currency code is required.	Forneça um código de moeda para os produtos que tiverem um preço.
Currency codes must be in ISO format, e.g., AUD or THB.	Verifique se seus códigos de moeda estão no formato ISO de 3 dígitos.
If one dimensional field is provided, all three are required.	Verifique se forneceu os três campos dimensionais para os produtos com valores dimensionais.

Exemplo de importação com falha

Agendar uma demonstração