Como preencher corretamente o CSV do Zonos Catalog no Dashboard?

Ao preencher o modelo CSV do Catalog, o único campo obrigatório é um `sku` ou `productId`, consoante a sua `itemKeyPreference`. Se o seu ficheiro contiver duplicados do mesmo produto com base na preferência de chave de item, o produto é criado da primeira vez e, depois, atualizado com detalhes novos ou adicionais, se aplicável. Depois de preencher o modelo com os detalhes dos seus produtos, carregue o 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.

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

Poderá encontrar erros relacionados com o tamanho do ficheiro, o formato do ficheiro, cabeçalhos de coluna em falta ou não reconhecidos, SKU ou ID de produto em falta, unidades de peso ou dimensionais inválidas, valores de peso, comprimento, largura ou altura inválidos, unidades de peso ou dimensionais em falta quando são fornecidos valores, país de destino em falta quando é fornecido um código HS específico do país, países de destino ou códigos de moeda inválidos, e campos dimensionais em falta quando apenas um é fornecido.

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

Importação de CSV do Catalog

Importe os 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 CSV do Catalog, o único campo obrigatório para cada produto é um SKU ou ID de produto. Se o seu ficheiro contiver duplicados do mesmo produto com base no SKU e no ID de produto, o Catalog cria o produto da 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

Aceda a Dashboard -> Products -> Catalog.
Clique em Manage Catalog no canto superior direito. Em seguida, selecione Import products no menu pendente.
Transfira o modelo CSV do Catalog clicando em modelo CSV de exemplo.
Faça corresponder os detalhes dos seus produtos aos campos do modelo CSV da Zonos. Para tal, utilize a tabela abaixo para garantir que está a utilizar os valores e as informações corretos nos campos mais adequados.
1. Os campos ou colunas que não utilizar podem simplesmente ficar em branco. Também os pode eliminar, mas não é necessário.
Guarde o ficheiro em formato CSV.
Carregue o novo ficheiro CSV no Catalog arrastando e largando o ficheiro ou clicando em browse para localizar e selecionar o ficheiro. Tenha em conta que o tamanho máximo de ficheiro para carregamento no Catalog é de 50 MB.
Siga as indicações para rever os produtos carregados e corrigir os campos, caso existam erros.
Clique em Import.

Requisitos dos campos

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

No entanto, quanto mais detalhes de produto 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 desalfandegamento, e reduzem a probabilidade de atrasos ou encargos inesperados para os seus clientes. Recomendamos que preencha todos os campos para os quais tenha dados, mesmo que apenas um identificador seja obrigatório.

Campos condicionalmente obrigatórios

Alguns campos são opcionais por si só, mas passam a ser obrigatórios assim que utiliza um campo relacionado.

Se fornecer↕	Também tem de 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 do país	O país a que se aplica, no formato `Country code=HS code`

Nota: O peso predefinido é pound e as dimensões predefinidas são inch, mas estas predefinições só se aplicam quando deixa em branco tanto o valor como a respetiva unidade. Se fornecer um peso ou uma dimensão sem a respetiva unidade, a importação falha.

Nota: Se utilizar Inclusive Pricing, o preço e a moeda são obrigatórios para todos os produtos, e a moeda tem de corresponder à moeda nativa da sua organização.

Descrições dos campos do CSV

A coluna Obrigatório indica se um campo é obrigatório, opcional ou condicionalmente obrigatório, em função de outros campos que fornecer.

Coluna↕	Obrigatório↕	Descrição↕
SKU	Obrigatório*	O código que identifica o produto na sua empresa, por exemplo, GRLS-GRPHC-BBT-T-S
Product ID	Obrigatório*	O identificador do seu produto, normalmente o ID da sua plataforma de comércio eletrónico, por exemplo, 254678901
Name	Opcional	O nome do seu produto, por exemplo, T-shirt estampada de bebé para menina
Description	Opcional	A descrição completa e detalhada do seu produto, por exemplo, Desfrute de um conforto e sofisticação inigualáveis com a nossa camisa premium de poliéster, meticulosamente confecionada para valorizar os básicos do seu guarda-roupa. Concebida a pensar na pessoa moderna, esta camisa apresenta uma estética elegante e versátil, sendo perfeita tanto para ocasiões informais como formais.
Customs description	Opcional	Descrição concisa do produto para a fatura comercial. Limite de 30 caracteres, por exemplo, Camisa menina, 100% poliéster
Weight unit	Condicional	A unidade de peso do produto. Se não for indicada nenhuma unidade, o valor predefinido será `pound`. Os valores válidos são `gram`, `kilogram`, `pound` e `ounce`.
Weight	Condicional	O peso do produto. O valor do peso tem de ser um número positivo.
Dimensional unit	Condicional	A unidade dimensional do produto. Se não for indicada nenhuma unidade, o valor predefinido 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 tem de ser um número positivo.
Width	Condicional	A largura do produto. O valor da largura tem de ser um número positivo.
Height	Condicional	A altura do produto. O valor da altura tem de ser um número positivo.
Packing preference	Opcional	Se o seu produto é enviado isoladamente (`ships_alone`) ou se pode ser consolidado (`consolidated`). Se o seu produto puder ser consolidado com outros produtos no envio (o caso mais comum), pode deixar este campo em branco.
Restricted countries	Opcional	Restrinja o seu produto em determinados países. Os valores são códigos ISO de 2 dígitos separados por uma barra vertical. Se pretender restringir todos os países, introduza `ALL`. Se pretender restringir todos os países exceto um ou alguns, introduza `ALL-` seguido dos países que pretende deixar sem restrição, separados por barras verticais, por exemplo, `ALL-CA\|AU\|US`. Se pretender restringir apenas países específicos, introduza os países que pretende restringir separados por barras verticais, por exemplo, `AU\|KR\|MY\|SG`. Se pretender remover todos os países restringidos existentes, introduza `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 caso mais comum), 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 de cada país para o produto, separados por barras verticais quando existem vários códigos específicos, por exemplo, IT=6109.10.0010\|DE=6109.10.0010\|GB=6109.10.0010\|JP=6109.10.020
Image URL	Opcional	O 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 a 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 cobra pelo produto.
Retail price	Opcional	O preço original do produto antes de descontos. Apresentá-lo ao lado do preço de saldo evidencia a poupança para os clientes. O preço de retalho tem de ser superior ao 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`.

*É obrigatório um SKU ou um ID de produto, mas não precisa de ambos. O que se aplica depende da sua preferência de chave de item.

Para comerciantes de bebidas alcoólicas: Se vende produtos abrangidos pelo Capítulo 22 do Sistema Harmonizado (bebidas alcoólicas), são obrigatórios campos de medição adicionais para o cálculo dos impostos especiais de consumo. Consulte a nossa documentação sobre impostos especiais de consumo e utilize o modelo CSV especializado para estes 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 no cálculo dos impostos especiais de consumo.
Alcohol by volume	Obrigatório para bebidas alcoólicas	A percentagem de teor alcoólico. O valor deve ser introduzido como percentagem, por exemplo, 12 para 12% ABV.

Erros de importação de CSV

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

Erros de importação

Erro↕	Descrição↕
File must be under 1 GB.	O seu ficheiro é demasiado grande. O ficheiro tem de ter menos de 1 GB.
File must be in CSV format.	O Catalog só suporta o formato de ficheiro CSV. Para resolver, certifique-se de que o seu ficheiro está em formato CSV.
Missing column header(s).	O Catalog só suporta ficheiros no formato exato do modelo do Catalog. Certifique-se de que os cabeçalhos do seu CSV correspondem aos cabeçalhos do ficheiro modelo CSV.
Unrecognized column header(s).	Existem cabeçalhos de coluna não reconhecidos. O Catalog só suporta cabeçalhos no formato exato do modelo do Catalog. Remova os cabeçalhos de coluna não reconhecidos e confirme que os cabeçalhos do seu CSV correspondem aos do modelo 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, adicione um SKU ou ID de produto a cada produto.
Customs description exceeds character limit of 30 characters.	Por predefinição, as descrições aduaneiras estão limitadas a 30 caracteres, o que corresponde ao limite de caracteres mais comum nas 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 suporta as seguintes preferências de embalagem: `ships_alone` e `consolidated`. Se o seu produto puder ser consolidado com outros produtos, pode deixar o campo em branco, uma vez que `consolidated` é o valor predefinido.
Weight unit invalid. Catalog only supports the following weight units: gram, kilogram, pound, and ounce.	O Catalog só suporta as seguintes unidades, sem abreviaturas: `gram`, `kilogram`, `pound` ou `ounce`.
Weight must be greater than zero and cannot include letters or symbols.	Certifique-se de que o valor do peso é um número positivo válido, sem símbolos nem letras. O Catalog suporta 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ó suporta as seguintes unidades, sem abreviaturas: `inch`, `foot`, `yard`, `millimeter`, `centimeter` ou `meter`.
Length must be greater than zero and cannot include letters or symbols.	Certifique-se de que o comprimento é um número positivo válido, sem símbolos nem letras. O Catalog suporta comprimentos com até duas casas decimais, por exemplo, 5.29
Width must be greater than zero and cannot include letters or symbols.	Certifique-se de que a largura é um número positivo válido, sem símbolos nem letras. O Catalog suporta larguras com até duas casas decimais, por exemplo, 2.44
Height must be greater than zero and cannot include letters or symbols.	Certifique-se de que a altura é um número positivo válido, sem símbolos nem letras. O Catalog suporta alturas com até duas casas decimais, por exemplo, 8.02
A weight unit is required when you provide a weight value.	Indique uma unidade de peso para os produtos que tenham um valor de peso. O Catalog suporta as seguintes unidades de peso: `gram`, `kilogram`, `pound` e `ounce`.
A dimensional unit is required if you provide dimensional values.	Indique uma unidade dimensional para os produtos que tenham um valor dimensional. O Catalog suporta as seguintes unidades dimensionais: `inch`, `foot`, `yard`, `millimeter`, `centimeter` e `meter`.
HS code must be between 6 and 16 characters.	O código HS tem de ter entre 6 e 16 caracteres, uma vez que os códigos HS universais têm 6 dígitos e o código HS específico de um 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 de cada país têm de estar no formato Código do país=Código HS, por exemplo, `KR=8518.30.9000`. Se existirem vários códigos HS, separe-os 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 têm de estar em formato ISO, por exemplo, `KR or BR`. Certifique-se de que os seus países de destino estão no formato ISO de 2 dígitos.
Country of origin values must be in ISO format.	Certifique-se de que o país de origem está no formato ISO de 2 dígitos.
Price cannot include negative values, letters, or symbols.	Certifique-se de que o preço é um valor positivo e válido. O Catalog suporta preços com até três casas decimais, por exemplo, 104.399
If you supply a price, a currency code is required.	Indique um código de moeda para os produtos que tenham um preço.
Currency codes must be in ISO format, e.g., AUD or THB.	Certifique-se de que os seus códigos de moeda estão no formato ISO de 3 dígitos.
If one dimensional field is provided, all three are required.	Certifique-se de que indicou os três campos dimensionais para os produtos com valores dimensionais.

Exemplo de importação falhada

Marcar uma demonstração