Criar um produto
Crie um produto no Catalog:
- Vá para Catalog e clique em Add product no canto superior direito.
- Adicione os detalhes do seu produto. O único campo obrigatório para criar um produto é o SKU e/ou o(s) campo(s) de ID de produto. Esses campos serão usados para referenciar os produtos do seu catálogo. Saiba mais sobre os identificadores do Catalog.
- Opcional — Adicione seu(s) código(s) HS.
- Opcional — Adicione suas informações de envio (peso, dimensões, unidades de medida, etc.).
- Opcional — Adicione países restringidos.
- Clique em save product.
Crie vários produtos no Catalog:
Carregue vários produtos ou todo o seu catálogo de produtos de uma só vez.
Importante: Se você tentar criar um produto que já existe, o Catalog reconhecerá o produto com base no SKU e/ou ID de produto e sobrescreverá os detalhes do produto original com os novos detalhes.
Marcar um produto como mercadoria perigosa (DHL)
Para envios da DHL, você pode marcar um produto como mercadoria perigosa para que o serviço de valor agregado correto da DHL seja aplicado automaticamente sempre que você criar uma etiqueta para esse produto. Isso cobre as classes de mercadorias regulamentadas de "baixo risco" ou isentas: itens que são tecnicamente regulamentados, mas são enviados sob uma disposição especial ou isenção de quantidade.
Uma marcação de mercadoria perigosa é armazenada como um atributo do item de catálogo: um par key/value no produto. Os atributos são definidos por meio da API (catalogItemsCreate ou catalogItemsUpdate) — não há campo no Dashboard nem coluna de CSV para eles.
Para marcar um produto, adicione um atributo com a chave DANGEROUS_GOODS e um valor de uma das categorias suportadas abaixo.
mutation CatalogItemsCreate($sku: String!$name: String$attributes: [ItemAttributeInput!]) { catalogItemsCreate( input: [{ sku: $sku, name: $name, attributes: $attributes }] ) id name sku attributes key valueValores de mercadorias perigosas suportados
| Value↕ | Categoria↕ |
|---|---|
NOT_RESTRICTED_A70 | Não restrito, disposição especial A70: artigos pressurizados, como amortecedores a gás e absorvedores de impacto (UN3164). |
NOT_RESTRICTED_A67 | Não restrito, disposição especial A67: motores ou máquinas acionados por líquido inflamável (UN3528). |
NOT_RESTRICTED_A02 | Não restrito, disposição especial A02: isento sob a disposição de carga pequena de transporte rodoviário ADR. |
LIMITED_QUANTITY | Quantidade limitada (ADR): mercadorias perigosas embaladas em pequenas quantidades dentro dos limites regulatórios. |
EXCEPTED_QUANTITY | Quantidade isenta (IATA): quantidades muito pequenas isentas da maioria das regras de mercadorias perigosas para transporte aéreo. |
CONSUMER_COMMODITY | Mercadoria de consumo ID8000: produtos do dia a dia prontos para venda no varejo com conteúdo perigoso menor, como aerossóis e perfumes. |
MAGNETIZED_MATERIAL | Material magnetizado (UN2807): itens com campo magnético forte o suficiente para afetar os instrumentos da aeronave. |
BIOLOGICAL_SUBSTANCE | Substância biológica (UN3373): substâncias biológicas da categoria B, como amostras diagnósticas ou clínicas. |
Editar um produto
A edição de produtos permite atualizar seus produtos existentes com informações adicionais ou atualizadas de forma eficiente. Em vez de excluir e recarregar o produto, você pode carregar as informações atualizadas, e o Catalog fará a correspondência com o produto existente usando seu SKU ou ID de produto, dependendo da sua preferência de chave de item. Dessa forma, você pode manter seu catálogo atualizado com o mínimo de esforço, seja usando o Dashboard ou a API para criar novos produtos ou editar produtos existentes.
Se você criar/editar um produto de catálogo que já existe no Catalog, espere o seguinte:
O Catalog sobrescreverá os campos em branco de itens existentes.
- Por exemplo, se um produto existente, SKU 321, não tinha um valor de peso, e o mesmo produto, SKU 321, tinha um peso de 1,3 lbs no novo carregamento, o peso de 1,3 lb sobrescreveria o campo anteriormente em branco.
O Catalog sobrescreverá os campos existentes com os novos valores de campo.
- Por exemplo, se um produto existente, SKU 123, tinha um preço de 18,99 USD e o mesmo produto, SKU 123, tinha um preço atualizado de 22,99 USD, o novo preço de 22,99 USD sobrescreveria o preço anterior.
O Catalog não sobrescreverá valores existentes com campos em branco.
- Por exemplo, se um produto existente, SKU 456, tinha um código HS de 6109.10, mas o código HS do produto atualizado, SKU 456, está em branco, o código HS existente é mantido.
Para editar um produto:
- Clique na aba Products.
- Selecione o produto que deseja editar.
- Faça suas alterações.
- Clique em save product.
Para editar vários produtos ou todos os produtos de uma vez, basta carregar um arquivo CSV atualizado no Catalog, incluindo o SKU ou ID de produto. Isso acionará atualizações automáticas dos seus itens existentes.
Excluir um produto
Para excluir um produto:
- Clique na aba Products no Dashboard.
- Selecione o(s) produto(s) que deseja excluir. Depois que seu(s) produto(s) forem selecionados, um botão de exclusão aparecerá.
- Clique em Delete e depois em Delete all para confirmar a exclusão.
Para excluir todos os produtos:
- Selecione a aba Products no Dashboard.
- Clique em Manage Catalog no canto superior direito e depois em Delete all.
- Clique em Delete all novamente para confirmar a exclusão.
Observe que, se você estiver excluindo uma grande quantidade de itens (mais de aproximadamente 20.000 produtos), uma notificação aparecerá indicando que a exclusão está em andamento. Durante esse tempo, você não poderá interagir com o Catalog até que a exclusão seja concluída. No entanto, você pode descartar a notificação e navegar para fora sem interromper o processo de exclusão.
Restringir um produto
Se você quiser impedir envios para um ou vários países, pode adicionar restrições ao criar ou atualizar um produto.
Para restringir um único produto no Catalog:
- Clique na aba Products.
- Selecione o produto ao qual deseja adicionar uma restrição, o que abrirá a página de edição.
- Encontre a seção Restricted countries na parte inferior da página de edição.
- Adicione os países aos quais deseja restringir seu produto selecionando ou digitando o(s) nome(s) do país.
- Clique em save product.
Para restringir vários produtos no Catalog:
- Clique na aba Import/export.
- Baixe o Catalog template CSV.
- Preencha o modelo com os detalhes do seu produto, incluindo seu SKU/ID de produto e os países restringidos. Insira o código ISO de 2 dígitos separado por barras verticais, por exemplo,
AU|KR|MY|SG. Para restringir todos os países, basta inserirALLcomo valor. Se quiser restringir todos os países, exceto um ou alguns, insiraALL-seguido dos países que deseja deixar sem restrição, separados por barras verticais, por exemplo,ALL-CA|FR|US. Saiba mais sobre o formato de CSV. Se quiser remover todos os países restringidos existentes, insiraNONEcomo valor. - Salve seu arquivo como CSV e carregue-o no Catalog arrastando e soltando ou selecionando seu arquivo clicando em browse na mesma página em que você baixou o CSV.
- Revise seus produtos carregados na tela de pré-visualização e clique em upload.
Filtrar produtos restringidos:
Você pode filtrar produtos restringidos diretamente no catálogo baixando todo o seu catálogo em formato CSV pelo Dashboard e abrindo-o no Excel ou no Google Sheets. A partir daí, você pode usar a função de filtro para ver apenas os produtos restringidos. Isso permite localizar e gerenciar facilmente os produtos restringidos em seu catálogo.
Se precisar atualizar seu catálogo depois de fazer alterações no seu CSV, recarregue o arquivo e qualquer produto correspondente será substituído pela versão atualizada. Isso é feito identificando e correspondendo o SKU e/ou o ID de produto.
If you're using Checkout, uma mensagem de restrição será exibida no seu checkout quando um produto estiver restringido para o país do cliente. Por padrão, a mensagem dirá "This item is restricted from import to your country."
Filtrar um produto
Você pode buscar produtos no Catalog pelo Dashboard ou pela API usando o SKU, o ID de produto ou o nome do produto. Para buscas por SKU e ID de produto, apenas correspondências exatas retornarão resultados; correspondências parciais não são suportadas. No entanto, ao buscar pelo nome do produto, correspondências parciais são suportadas.
Para filtrar por SKU ou ID de produto:
- Clique na aba Products no Dashboard.
- Selecione SKU ou Product ID na parte superior esquerda do seu Catalog.
- Insira seu SKU, ID de produto ou nome do produto.
- Clique em Apply para ver seu(s) produto(s) filtrado(s).
Para buscar pelo nome de um produto:
- Clique na aba Products no Dashboard.
- Na parte superior direita do seu Catalog, digite o nome do produto no campo de busca.
- Veja seu(s) produto(s) filtrado(s).
Exportar seus produtos
Se você selecionar 50 itens ou menos na tabela do Catalog, seu catálogo será baixado diretamente pelo Dashboard. No entanto, se você selecionar Export all ou mais de 50 itens, seu CSV será exportado por e-mail.
Para exportar 50 itens ou menos, siga estas etapas:
- Selecione 50 itens ou menos diretamente na tabela do Catalog.
- Clique em Export no canto superior direito.
- Localize seu arquivo CSV na caixa de entrada do seu e-mail.
Para exportar todos os produtos:
- Vá para Dashboard -> Products -> Catalog.
- Clique no menu suspenso Manage Catalog ao lado de Add product e clique em Export all.
- Encontre seu arquivo de catálogo em seus downloads.
Problemas para baixar pelo seu e-mail?
Se você tiver problemas para baixar o CSV pelo link do e-mail, isso pode ser porque seu navegador está bloqueando o download. Se for esse o caso, siga estas etapas:
- Clique com o botão direito no botão "Download" do seu e-mail.
- Selecione "Copy link address" para copiar a URL de download.
- Cole a URL copiada no seu navegador e pressione enter.
- Seu catálogo será baixado diretamente pelo seu navegador.
Classify um produto
Você pode classificar um produto do seu catálogo com a API usando o catalogItemId na mutação ClassificationsCreateFromCatalog.
Observe que um name é obrigatório para classificar um produto do seu catálogo. Consulte a referência da API GraphQL para obter uma lista completa dos campos de catálogo e classificação.
Para criar e classificar um produto do catálogo simultaneamente, adicione a mutação ClassificationsCreateFromCatalog mostrada abaixo à sua mutação CatalogItemsCreate.
Classify um produto do catálogo com 8+ dígitos (específico por país)
Quando o campo shipToCountries é preenchido, a classificação será um código HS de 8+ dígitos (específico por país). Se nenhum shipToCountries for fornecido, a classificação será um código HS de 6 dígitos (universal) por padrão. Saiba mais sobre as diferenças entre códigos HS universais e específicos por país.
No exemplo abaixo, o campo shipToCountries é fornecido para gerar um código específico por país para o Canadá.
mutation ClassificationsCreateFromCatalog($catalogItemToClassify: [ClassificationFromCatalogInput!]!) { classificationsCalculateFromCatalog(input: $catalogItemToClassify) { id configuration { shipToCountries } hsCode { code } name }}Abaixo está um exemplo de solicitação. Embora o Zonos Classify gere uma classificação apenas com um name, recomendamos fortemente adicionar o máximo de detalhes possível para obter os melhores resultados de classificação.
{ "catalogItemToClassify": [ { "catalogItemId": "catalog_item_893jkdkllg03k9khjd9", "configuration": { "shipToCountries": [ "CA" ] } } ]}Erros da API e resoluções
| Error↕ | Resolução↕ |
|---|---|
| A SKU or product ID is required to create a product | É necessário um identificador (SKU/ID de produto) para criar, editar ou excluir um item de catálogo. Para resolver isso, adicione um SKU e/ou um ID de produto. |
| The product you are trying to edit does not exist* | Você não pode editar um produto que não existe. Para resolver isso, crie um novo produto com o SKU e/ou ID de produto desejado. |
| 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. Catalog supports the following product types: digital_good. For physical goods, leave it blank. | O Catalog só admite os seguintes tipos de produto: digital_good e physical_good. Se o seu produto for um bem físico (o mais comum), deixe este campo em branco. |
| 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 admite as seguintes preferências de embalagem: ships_alone e consolidated. Se o seu produto puder ser consolidado com outros produtos, você pode deixá-lo em branco, já que consolidated é o valor padrão. |
| Country must be specified when providing an HS code | Se você fornecer um código HS específico por país ao criar um item, um país de destino é obrigatório. Para resolver isso, adicione um país de destino. |
| Price must be greater than 0 | O Catalog não admite valores de preço negativos. Para resolver isso, adicione um preço maior que zero. |
| Currency code must be provided when a price value is supplied | Se você fornecer um preço, um código de moeda é obrigatório. Para resolver isso, adicione um código de moeda. |
| Price must be provided when a currency code is supplied | Se você fornecer um código de moeda, um preço é obrigatório. Para resolver isso, adicione um preço. |
| The accompanying dimensional field cannot be left blank | Se um campo dimensional for fornecido, os outros dois são obrigatórios; por exemplo, se você fornecer uma largura de 8 polegadas, a altura e o comprimento serão obrigatórios. |
| Measurement value must be greater than 0 | O Catalog não admite valores de medida negativos ou zero. Para resolver isso, adicione um valor maior que zero. |
| When providing a dimensional value, dimensional units cannot be left empty | Se você fornecer um valor dimensional, uma unidade dimensional é obrigatória. Para resolver isso, adicione uma unidade dimensional. |
| When providing a weight value, the weight unit cannot be left empty | Se você fornecer um valor de peso, uma unidade de peso é obrigatória. Para resolver isso, adicione uma unidade de peso. |
* Somente erro de API
Gerenciar o Catalog
Crie e modifique produtos.Aprenda a adicionar, modificar e excluir seus produtos do Zonos Catalog no Dashboard ou pela API. Use o Catalog no Dashboard para evitar escrever código ou se estiver fazendo pequenas alterações. Se quiser integrar-se diretamente ao Catalog para implementações em produção, use a API.