InícioSoluções postais de saída Ferramentas para remetentes Verified Accounts Importação de CSV

Importação de CSV

Importe seus itens de catálogo com um arquivo CSV—sem necessidade de integração com canal.

A importação de CSV é uma das três formas de montar o catálogo da sua Verified Account. É a opção para remetentes que não vendem por um canal compatível como Etsy, eBay ou WooCommerce, ou que mantêm os dados dos produtos em uma planilha em vez de em um sistema que possa ser conectado à Zonos. Também é a forma mais rápida de carregar um catálogo existente de uma só vez, e não exige um desenvolvedor—se você consegue exportar uma planilha, consegue montar seu catálogo.

Os itens importados passam pelas mesmas verificações de PGA que os itens sincronizados por canal, para que seus envios com destino aos EUA permaneçam em conformidade de qualquer forma. Lembre-se de que um CSV é um envio pontual: conforme seus produtos mudarem, você precisará importá-los novamente para manter seu catálogo atualizado.

Se você preferir gravar itens de forma programática a partir do seu próprio sistema, a Catalog API é a terceira opção.

Correspondência entre pedidos e itens do catálogo: Esta é a ordem que a Zonos usa para fazer a correspondência, não uma lista de campos obrigatórios. Quando seus pedidos e números de rastreamento forem importados posteriormente, a Zonos vincula cada linha de pedido a um item do catálogo primeiro pelo Product ID, depois pelo SKU e, por fim, pelo Name. Mantenha os identificadores usados pelos seus itens precisos e consistentes entre seu catálogo e seus pedidos. Esse comportamento ainda está sendo finalizado e pode mudar antes do lançamento.

O que cada item precisa

Muito pouco é estritamente obrigatório. Alguns campos opcionais fazem uma diferença real na capacidade da Zonos de avaliar seus produtos corretamente, então inclua-os se os tiver.

Prioridade↕	Campos↕	Por quê↕
Obrigatório	Name, mais um SKU ou um product ID (ou ambos)	Uma linha sem esses campos não pode ser importada.
Fortemente recomendado	Country of origin, HS code	Eles determinam o cálculo de impostos e a avaliação das agências dos EUA. Várias verificações da Zonos dependem do country of origin, portanto um item sem ele pode não ser sinalizado quando deveria. Deixe o HS code em branco e a Zonos classifica o item a partir do nome e da descrição.
Opcional	Description, weight e unit, price e currency, image URL	Úteis, mas não necessários. Uma descrição factual melhora a classificação quando você não informou um HS code.

Você não precisa de dados completos no primeiro dia. Comece com o que tiver e depois envie novamente para preencher as lacunas—um item com o mesmo SKU ou product ID é atualizado no local em vez de criar uma duplicata.

Importar seus itens

Em Dashboard, vá para Catalog.
Selecione Manage, depois Import products.
Baixe o modelo de CSV de exemplo na janela de importação. A importação de catálogo da Verified Account usa o mesmo modelo que a Importação de CSV de produtos.
Corresponda os detalhes dos seus produtos às colunas do modelo. No mínimo, cada item precisa de um SKU ou product ID e um name.
Salve seu arquivo como um CSV que use vírgulas entre as colunas e pontos para decimais, como no modelo. Se você usa o Excel com configurações em alemão ou de outros idiomas europeus, consulte primeiro Usar o Excel com configurações em alemão ou de outros idiomas europeus.
Arraste e solte seu arquivo CSV na janela de importação, ou clique para procurá-lo.
Revise os itens enviados e corrija quaisquer campos sinalizados com erros.
Clique em Import.

Nota: Se você enviar um item com o mesmo SKU ou product ID de um item existente, a nova linha atualiza o item existente em vez de criar uma duplicata.

Após a conclusão da importação, a verificação de PGA é executada automaticamente em segundo plano. Um selo Needs attention aparece ao lado de qualquer item que precise de mais informações—pode levar alguns instantes para aparecer em itens recém-importados.

Usar o Excel com configurações em alemão ou de outros idiomas europeus

A Zonos lê um CSV com vírgulas (,) entre as colunas e pontos (.) como separador decimal, o mesmo formato do modelo (por exemplo, um peso de 0.32). O Excel em alemão e em muitas outras configurações de idiomas europeus usa ponto e vírgula (;) entre as colunas e vírgulas como separador decimal, tanto ao abrir um CSV quanto ao salvá-lo. A Zonos não consegue ler um arquivo salvo dessa forma.

Para abrir o modelo, não clique duas vezes nele, ou todas as colunas podem acabar em uma só. No Excel, vá para Data → From Text/CSV, selecione o modelo e escolha Comma como delimitador.

Antes de enviar, abra o arquivo salvo em um editor de texto, como o Bloco de Notas ou o TextEdit, e confira a primeira linha. Ela deve corresponder ao modelo, com vírgulas entre os nomes das colunas: SKU,Product ID,Name,.... Se aparecer ponto e vírgula, altere as configurações de separador do seu computador e salve o arquivo novamente no Excel. No Windows, vá para Control Panel → Region → Additional settings e defina List separator como vírgula e Decimal symbol como ponto. Você pode restaurá-las depois de salvar.

Substituir os pontos e vírgulas por vírgulas em um editor de texto só funciona se nenhuma célula contiver vírgula e todos os números já usarem ponto. Caso contrário, as colunas se deslocam e a importação falha.

Colunas do CSV

Cada linha representa um item. O modelo inclui campos opcionais adicionais—consulte Importação de CSV de produtos para a lista completa. Para o catálogo da Verified Account e a verificação de PGA, estas são as colunas mais importantes:

Coluna↕	Obrigatório↕	Descrição↕
SKU	Obrigatório*	Seu identificador exclusivo para o item. *Cada item precisa de um SKU ou de um product ID (ou de ambos). Usado para corresponder pedidos e números de rastreamento importados quando um item não tem product ID.
Product ID	Obrigatório*	O identificador da sua plataforma para o item. *Cada item precisa de um SKU ou de um product ID (ou de ambos). O identificador que a Zonos usa primeiro para corresponder pedidos e números de rastreamento importados.
Name	Obrigatório	O nome do item, por exemplo, Carteira de couro masculina. Usado como alternativa para corresponder pedidos e números de rastreamento importados quando um item não tem product ID nem SKU—mantenha-o preciso e consistente.
Country of origin	Recomendado	O código ISO de 2 letras do país onde o item foi fabricado, por exemplo, VN. Altamente recomendado: várias verificações da Zonos dependem dele, portanto itens sem ele podem não ser sinalizados.
Universal HS code	Recomendado	O código HS universal de 6 dígitos do item, por exemplo, 4202.31. Se deixado em branco, a Zonos classifica o item a partir do seu nome e descrição.
Description	Opcional	Uma descrição detalhada e factual do item, incluindo o que ele é, seu material e sua finalidade. Usada para classificação e verificação de PGA.
Weight	Opcional	O peso do item, como número, por exemplo, 0.2.
Weight unit	Opcional	A unidade do peso: `pound`, `ounce`, `kilogram` ou `gram`. Obrigatório quando você informa um peso.
Price	Opcional	O preço do item, como número, por exemplo, 49.99.
Currency	Opcional	O código ISO de 3 letras da moeda do preço, por exemplo, USD. Obrigatório quando você informa um preço.
Image URL	Opcional	Uma URL publicamente acessível para a imagem do item.

Erros comuns de importação

Erro↕	Descrição↕
Cabeçalho(s) de coluna ausente(s)	Seu arquivo está sem um ou mais cabeçalhos de coluna do modelo. Baixe o modelo novamente e faça os cabeçalhos corresponderem exatamente.
Cabeçalho(s) de coluna não reconhecido(s)	Seu arquivo contém um cabeçalho de coluna que não está no modelo. Remova ou renomeie a coluna.
SKU ou product ID ausente	Uma linha não tem nem SKU nem product ID. Adicione pelo menos um para que o item possa ser identificado.
Código HS inválido	O código HS não é válido. Os códigos HS universais devem ter pelo menos 6 dígitos, por exemplo, 4202.31.
Código de país inválido	O país de origem não é um código ISO de 2 letras válido.
O arquivo não é um CSV	O arquivo enviado não está no formato CSV. Salve sua planilha como um arquivo `.csv` e tente novamente.

Agendar uma demonstração