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.
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.).
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.
Somente DHL
A marcação de mercadorias perigosas afeta apenas envios da DHL. A marcação é ignorada para
outras transportadoras.
Chave de atributo suportada
DANGEROUS_GOODS é uma chave de atributo suportada para a marcação de mercadorias perigosas da DHL.
Ainda não está listada entre as chaves aprovadas na
referência ItemAttributeInput, mas é aceita pela API.
Para marcar um produto, adicione um atributo com a chave DANGEROUS_GOODS e um valor de uma das categorias suportadas abaixo.
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.
Aplicar marcações automaticamente nas etiquetas de envio
Marcar um produto é o primeiro passo. Para que a Zonos aplique a categoria às suas
etiquetas da DHL automaticamente, ative Ship dangerous goods em
label settings. Você também pode
selecionar uma categoria manualmente em uma única etiqueta; consulte
declare dangerous goods.
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.
Os aplicativos Zonos Duty & Tax não suportam restrições no nível do item que removem produtos específicos de pedidos internacionais. Se um item restringido estiver no carrinho, todo o carrinho deve ser bloqueado para envios a esse país. Isso é feito por meio de uma regra de restrição no nível do carrinho, que deve ser configurada com antecedência durante o onboarding. Embora o Catalog seja compatível com os aplicativos Duty & Tax, as restrições no nível do item só são suportadas quando se usa o Zonos Checkout.
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.
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 inserir ALL como valor. Se quiser restringir todos os países, exceto um ou alguns, insira ALL- 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, insira NONE como 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.
Se você estiver usando o 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.
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.
Classificar 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çãoCatalogItemsCreate.
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á.
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.
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
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Gerenciar produtos
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.
Criar um produto
Crie um produto no Catalog:
Crie vários produtos no Catalog:
Carregue vários produtos ou todo o seu catálogo de produtos de uma só vez.
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/valueno produto. Os atributos são definidos por meio da API (catalogItemsCreateoucatalogItemsUpdate) — não há campo no Dashboard nem coluna de CSV para eles.A marcação de mercadorias perigosas afeta apenas envios da DHL. A marcação é ignorada para outras transportadoras.
DANGEROUS_GOODSé uma chave de atributo suportada para a marcação de mercadorias perigosas da DHL. Ainda não está listada entre as chaves aprovadas na referênciaItemAttributeInput, mas é aceita pela API.Para marcar um produto, adicione um atributo com a chave
DANGEROUS_GOODSe um valor de uma das categorias suportadas abaixo.mutation CatalogItemsCreate($sku: String!$name: String$attributes: [ItemAttributeInput!]) {catalogItemsCreate(input: [{ sku: $sku, name: $name, attributes: $attributes }])idnameskuattributeskeyvalueValores de mercadorias perigosas suportados
NOT_RESTRICTED_A70NOT_RESTRICTED_A67NOT_RESTRICTED_A02LIMITED_QUANTITYEXCEPTED_QUANTITYCONSUMER_COMMODITYMAGNETIZED_MATERIALBIOLOGICAL_SUBSTANCEMarcar um produto é o primeiro passo. Para que a Zonos aplique a categoria às suas etiquetas da DHL automaticamente, ative Ship dangerous goods em label settings. Você também pode selecionar uma categoria manualmente em uma única etiqueta; consulte declare dangerous goods.
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.
O Catalog sobrescreverá os campos existentes com os novos valores de campo.
O Catalog não sobrescreverá valores existentes com campos em branco.
Para editar um produto:
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:
Para excluir todos os produtos:
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.
Os aplicativos Zonos Duty & Tax não suportam restrições no nível do item que removem produtos específicos de pedidos internacionais. Se um item restringido estiver no carrinho, todo o carrinho deve ser bloqueado para envios a esse país. Isso é feito por meio de uma regra de restrição no nível do carrinho, que deve ser configurada com antecedência durante o onboarding. Embora o Catalog seja compatível com os aplicativos Duty & Tax, as restrições no nível do item só são suportadas quando se usa o Zonos Checkout.
Para restringir um único produto no Catalog:
Para restringir vários produtos no Catalog:
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.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.
Se você estiver usando o 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:
Para buscar pelo nome de um produto:
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:
Para exportar todos os produtos:
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:
Classificar um produto
Você pode classificar um produto do seu catálogo com a API usando o
catalogItemIdna mutaçãoClassificationsCreateFromCatalog.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
ClassificationsCreateFromCatalogmostrada abaixo à sua mutaçãoCatalogItemsCreate.Classificar 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 nenhumshipToCountriesfor 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) {idconfiguration {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
digital_goodephysical_good. Se o seu produto for um bem físico (o mais comum), deixe este campo em branco.ships_aloneeconsolidated. Se o seu produto puder ser consolidado com outros produtos, você pode deixá-lo em branco, já queconsolidatedé o valor padrão.ItemAttributeInput
Esta página foi útil?