Saiba como adicionar, modificar e eliminar os seus produtos do Zonos Catalog no Dashboard ou através da API. Utilize o Catalog no Dashboard para evitar escrever código ou se estiver a fazer pequenas alterações. Se pretender integrar diretamente com o Catalog em implementações de produção, utilize a API.
Criar um produto
Criar um produto no Catalog:
Aceda ao Catalog e clique em Add product no canto superior direito.
Adicione os detalhes do produto. O único campo obrigatório para criar um produto é o campo de SKU e/ou de ID de produto. Estes campos serão utilizados para referenciar os produtos do seu catálogo. Saiba mais sobre os identificadores do Catalog.
Opcional—Adicione o(s) código(s) HS.
Opcional—Adicione as informações de envio (peso, dimensões, unidades de medida, etc.).
A edição de produtos permite atualizar de forma eficiente os seus produtos existentes com informações adicionais ou atualizadas. Em vez de ter de eliminar e voltar a carregar o produto, pode carregar as informações atualizadas e o Catalog fará a correspondência com o produto existente através do SKU ou do ID de produto, consoante a sua preferência de chave de item. Desta forma, pode manter o seu catálogo atualizado com o mínimo de esforço, quer utilize o Dashboard ou a API para criar novos produtos ou editar produtos existentes.
Se criar/editar um produto de catálogo que já existe no Catalog, conte com o seguinte:
O Catalog preencherá os campos em branco dos 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 substituiria o campo anteriormente em branco.
O Catalog substituirá os campos existentes pelos novos valores.
Por exemplo, se um produto existente, SKU 123, tinha CN como país de origem e o mesmo produto, SKU 123, tinha VN como país de origem atualizado, o novo país de origem VN substituiria o valor anterior.
O Catalog não substituirá valores existentes por campos em branco.
Por exemplo, se um produto existente, SKU 456, tinha o código HS 6109.10, mas o código HS do produto atualizado, SKU 456, está em branco, o código HS existente mantém-se.
Para editar um produto:
Clique no separador Products.
Selecione o produto que pretende editar.
Efetue as alterações.
Clique em save product.
Para editar vários ou todos os produtos de uma só vez, basta carregar um ficheiro CSV atualizado no Catalog, incluindo o SKU ou o ID de produto. Isto irá acionar atualizações automáticas dos seus itens existentes.
Eliminar um produto
Para eliminar um produto:
Clique no separador Products no Dashboard.
Selecione o(s) produto(s) que pretende eliminar. Depois de selecionar o(s) produto(s), será apresentado um botão de eliminação.
Clique em Delete e depois em Delete all para confirmar a eliminação.
Para eliminar todos os produtos:
Selecione o separador Products no Dashboard.
Clique em Manage Catalog no canto superior direito e depois em Delete all.
Clique novamente em Delete all para confirmar a eliminação.
Note que, se estiver a eliminar uma grande quantidade de itens (mais de cerca de 20 000 produtos), será apresentada uma notificação a indicar que a eliminação está em curso. Durante esse período, não poderá interagir com o Catalog até que a eliminação esteja concluída. No entanto, pode fechar a notificação e sair da página sem interromper o processo de eliminação.
Restringir um produto
Se pretender impedir envios para um determinado país (ou países), pode adicionar restrições ao criar ou atualizar um produto.
As aplicações Zonos Duty & Tax não suportam restrições ao nível do item que removam produtos específicos de encomendas internacionais. Se um item restringido estiver no carrinho, todo o carrinho tem de ser bloqueado para envio para esse país. Isto é tratado através de uma regra de restrição ao nível do carrinho, que tem de ser configurada antecipadamente durante o onboarding. Embora o Catalog seja compatível com as aplicações Duty & Tax, as restrições ao nível do item só são suportadas quando se utiliza o Zonos Checkout.
Para restringir um único produto no Catalog:
Clique no separador Products.
Selecione o produto ao qual pretende adicionar uma restrição, o que abrirá a página de edição.
Localize a secção Restricted countries na parte inferior da página de edição.
Adicione os países para os quais pretende restringir o seu produto, selecionando ou escrevendo o(s) nome(s) do(s) país(es).
Preencha o modelo com os detalhes dos seus produtos, incluindo o SKU/ID de produto e os países restringidos. Introduza 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 introduzir ALL como valor. 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|FR|US. Saiba mais sobre a formatação de CSV. Se pretender remover todos os países restringidos existentes, introduza NONE como valor.
Guarde o ficheiro como CSV e carregue-o no Catalog arrastando e largando ou selecionando o ficheiro através de browse, na mesma página onde transferiu o CSV.
Reveja os produtos carregados no ecrã de pré-visualização e clique em upload.
Filtrar produtos restringidos:
Pode filtrar os produtos restringidos do catálogo transferindo todo o seu catálogo em formato CSV a partir do Dashboard e abrindo-o no Excel ou no Google Sheets. A partir daí, pode utilizar a funcionalidade de filtro para ver apenas os produtos restringidos. Isto permite localizar e gerir facilmente os produtos restringidos no seu catálogo.
Se precisar de atualizar o seu catálogo depois de fazer alterações ao CSV, volte a carregar o ficheiro e todos os produtos correspondentes serão substituídos pela versão atualizada. Isto é feito através da identificação e correspondência do SKU e/ou do ID de produto.
Se utilizar o Checkout, será apresentada uma mensagem de restrição no seu checkout quando um produto estiver restringido para o país do cliente. Por predefinição, a mensagem indica "This item is restricted from import to your country."
Encontrar um produto
Pode pesquisar produtos no Catalog através do Dashboard ou da API, utilizando o SKU, o ID de produto ou o nome do produto. Nas pesquisas por SKU e ID de produto, só as correspondências exatas devolvem resultados; as correspondências parciais não são suportadas. No entanto, ao pesquisar pelo nome do produto, as correspondências parciais são suportadas.
Para encontrar um produto por SKU ou ID de produto:
Clique no separador Products no Dashboard.
Selecione SKU ou Product ID no canto superior esquerdo do seu Catalog.
Introduza o SKU, o ID de produto ou o nome do produto.
Clique em Apply para ver o(s) produto(s) filtrado(s).
Para encontrar um produto pelo nome:
Clique no separador Products no Dashboard.
No canto superior direito do seu Catalog, escreva o nome do produto no campo de pesquisa.
Veja o(s) produto(s) filtrado(s).
Exportar os seus produtos
Se escolher 50 ou menos itens na tabela do Catalog, o seu catálogo será transferido diretamente a partir do Dashboard. No entanto, se selecionar Export all ou mais de 50 itens, o CSV será exportado por e-mail.
Para exportar 50 itens ou menos, siga estes passos:
Selecione 50 ou menos itens diretamente na tabela do Catalog.
Clique em Export no canto superior direito.
Localize o ficheiro CSV na caixa de entrada do seu e-mail.
Se tiver problemas ao transferir o CSV a partir da ligação do e-mail, isso pode dever-se ao facto de o seu navegador estar a bloquear a transferência. Nesse caso, siga estes passos:
Clique com o botão direito do rato no botão "Download" do e-mail.
Selecione "Copy link address" para copiar o URL de transferência.
Cole o URL copiado no navegador e prima Enter.
O seu catálogo será transferido diretamente através do navegador.
Classificar um produto
Pode classificar um produto do seu catálogo com a API utilizando o catalogItemId na mutação ClassificationsCreateFromCatalog.
Note que é necessário um name para classificar um produto do seu catálogo. Consulte a referência da API GraphQL para obter a lista completa dos campos de catálogo e de classificação.
Para criar e classificar um produto de catálogo em simultâneo, adicione a mutação ClassificationsCreateFromCatalog abaixo à sua mutaçãoCatalogItemsCreate.
Quando o campo shipToCountries está preenchido, a classificação será um código HS de 8+ dígitos (específico do país). Se não for indicado nenhum shipToCountries, a classificação será, por predefinição, um código HS de 6 dígitos (universal). Saiba mais sobre as diferenças entre códigos HS universais e específicos do país.
No exemplo abaixo, o campo shipToCountries é indicado para gerar um código específico do país para o Canadá.
Segue-se um exemplo de pedido. Embora o Zonos Classify gere uma classificação apenas com um name, recomendamos vivamente que adicione 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 eliminar um item de catálogo. Para resolver, adicione um SKU e/ou um ID de produto.
The product you are trying to edit does not exist*
Não é possível editar um produto que não existe. Para resolver, crie um novo produto com o SKU e/ou o ID de produto pretendido.
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. Catalog supports the following product types: digital_good. For physical goods, leave it blank.
O Catalog só suporta os seguintes tipos de produto: digital_good e physical_good. Se o seu produto for um bem físico (o caso 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 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.
Country must be specified when providing an HS code
Se indicar um código HS específico do país ao criar um item, é obrigatório indicar um país de destino. Para resolver, adicione um país de destino.
Price must be greater than 0
O Catalog não suporta valores de preço negativos. Para resolver, adicione um preço superior a zero.
Currency code must be provided when a price value is supplied
Se indicar um preço, é obrigatório um código de moeda. Para resolver, adicione um código de moeda.
Price must be provided when a currency code is supplied
Se indicar um código de moeda, é obrigatório um preço. Para resolver, adicione um preço.
The accompanying dimensional field cannot be left blank
Se for indicado um campo dimensional, os outros dois são obrigatórios; por exemplo, se indicar uma largura de 8 polegadas, a altura e o comprimento passam a ser obrigatórios.
Measurement value must be greater than 0
O Catalog não suporta valores de medida negativos ou iguais a zero. Para resolver, adicione um valor superior a zero.
When providing a dimensional value, dimensional units cannot be left empty
Se indicar um valor dimensional, é obrigatória uma unidade dimensional. Para resolver, adicione uma unidade dimensional.
When providing a weight value, the weight unit cannot be left empty
Se indicar um valor de peso, é obrigatória uma unidade de peso. Para resolver, adicione uma unidade de peso.
* Erro apenas da API
Marcar mercadorias perigosas (DHL)
Nos envios DHL, pode marcar um produto como mercadoria perigosa para que o serviço de valor acrescentado correto da DHL seja aplicado automaticamente sempre que criar uma etiqueta para esse produto. Isto abrange as classes de mercadorias regulamentadas de "baixo risco" ou isentas: artigos que são tecnicamente regulamentados, mas que são enviados ao abrigo de uma disposição especial ou de uma isenção por 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 através da API (catalogItemsCreate ou catalogItemsUpdate)—não existe nenhum campo no Dashboard nem coluna no CSV para os definir.
Apenas DHL
A marcação de mercadorias perigosas só afeta os envios DHL. A marcação é ignorada
nas restantes transportadoras.
Chave de atributo suportada
DANGEROUS_GOODS é uma chave de atributo suportada para a marcação de mercadorias
perigosas da DHL. Ainda não consta das chaves aprovadas na referência
ItemAttributeInput, mas é
aceite pela API.
Para marcar um produto, adicione um atributo com a chave DANGEROUS_GOODS e, como valor, uma das categorias suportadas indicadas abaixo.
Não restrito, disposição especial A70—artigos pressurizados, como molas a gás e amortecedores (UN3164).
NOT_RESTRICTED_A67
Não restrito, disposição especial A67—motores ou máquinas movidos a líquido inflamável (UN3528).
NOT_RESTRICTED_A02
Não restrito, disposição especial A02—isento ao abrigo da disposição ADR para pequenas cargas no transporte rodoviário.
LIMITED_QUANTITY
Quantidade limitada (ADR)—mercadorias perigosas embaladas em pequenas quantidades dentro dos limites regulamentares.
EXCEPTED_QUANTITY
Quantidade isenta (IATA)—quantidades muito pequenas isentas da maioria das regras de mercadorias perigosas no transporte aéreo.
CONSUMER_COMMODITY
Mercadoria de consumo ID8000—produtos de uso diário prontos para venda a retalho com reduzido conteúdo perigoso, como aerossóis e perfumes.
MAGNETIZED_MATERIAL
Material magnetizado (UN2807)—artigos com um campo magnético suficientemente forte para afetar os instrumentos da aeronave.
BIOLOGICAL_SUBSTANCE
Substância biológica (UN3373)—substâncias biológicas da categoria B, como amostras de diagnóstico ou clínicas.
Aplicar marcações automaticamente nas etiquetas
Marcar um produto é o primeiro passo. Para que a Zonos aplique a categoria às suas
etiquetas DHL automaticamente, ative Ship dangerous goods nas
definições de etiquetas. Também pode
selecionar uma categoria manualmente numa etiqueta individual—consulte
declarar mercadorias perigosas.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Gerir produtos
Gerir o Catalog
Crie e modifique produtos.Saiba como adicionar, modificar e eliminar os seus produtos do Zonos Catalog no Dashboard ou através da API. Utilize o Catalog no Dashboard para evitar escrever código ou se estiver a fazer pequenas alterações. Se pretender integrar diretamente com o Catalog em implementações de produção, utilize a API.
Criar um produto
Criar um produto no Catalog:
Criar vários produtos no Catalog:
Carregue vários produtos ou todo o seu catálogo de produtos de uma só vez.
Editar um produto
A edição de produtos permite atualizar de forma eficiente os seus produtos existentes com informações adicionais ou atualizadas. Em vez de ter de eliminar e voltar a carregar o produto, pode carregar as informações atualizadas e o Catalog fará a correspondência com o produto existente através do SKU ou do ID de produto, consoante a sua preferência de chave de item. Desta forma, pode manter o seu catálogo atualizado com o mínimo de esforço, quer utilize o Dashboard ou a API para criar novos produtos ou editar produtos existentes.
Se criar/editar um produto de catálogo que já existe no Catalog, conte com o seguinte:
O Catalog preencherá os campos em branco dos itens existentes.
O Catalog substituirá os campos existentes pelos novos valores.
O Catalog não substituirá valores existentes por campos em branco.
Para editar um produto:
Para editar vários ou todos os produtos de uma só vez, basta carregar um ficheiro CSV atualizado no Catalog, incluindo o SKU ou o ID de produto. Isto irá acionar atualizações automáticas dos seus itens existentes.
Eliminar um produto
Para eliminar um produto:
Para eliminar todos os produtos:
Note que, se estiver a eliminar uma grande quantidade de itens (mais de cerca de 20 000 produtos), será apresentada uma notificação a indicar que a eliminação está em curso. Durante esse período, não poderá interagir com o Catalog até que a eliminação esteja concluída. No entanto, pode fechar a notificação e sair da página sem interromper o processo de eliminação.
Restringir um produto
Se pretender impedir envios para um determinado país (ou países), pode adicionar restrições ao criar ou atualizar um produto.
As aplicações Zonos Duty & Tax não suportam restrições ao nível do item que removam produtos específicos de encomendas internacionais. Se um item restringido estiver no carrinho, todo o carrinho tem de ser bloqueado para envio para esse país. Isto é tratado através de uma regra de restrição ao nível do carrinho, que tem de ser configurada antecipadamente durante o onboarding. Embora o Catalog seja compatível com as aplicações Duty & Tax, as restrições ao nível do item só são suportadas quando se utiliza 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 introduzirALLcomo valor. Se pretender restringir todos os países exceto um ou alguns, introduzaALL-seguido dos países que pretende deixar sem restrição, separados por barras verticais, por exemplo,ALL-CA|FR|US. Saiba mais sobre a formatação de CSV. Se pretender remover todos os países restringidos existentes, introduzaNONEcomo valor.Filtrar produtos restringidos:
Pode filtrar os produtos restringidos do catálogo transferindo todo o seu catálogo em formato CSV a partir do Dashboard e abrindo-o no Excel ou no Google Sheets. A partir daí, pode utilizar a funcionalidade de filtro para ver apenas os produtos restringidos. Isto permite localizar e gerir facilmente os produtos restringidos no seu catálogo.
Se precisar de atualizar o seu catálogo depois de fazer alterações ao CSV, volte a carregar o ficheiro e todos os produtos correspondentes serão substituídos pela versão atualizada. Isto é feito através da identificação e correspondência do SKU e/ou do ID de produto.
Se utilizar o Checkout, será apresentada uma mensagem de restrição no seu checkout quando um produto estiver restringido para o país do cliente. Por predefinição, a mensagem indica "This item is restricted from import to your country."
Encontrar um produto
Pode pesquisar produtos no Catalog através do Dashboard ou da API, utilizando o SKU, o ID de produto ou o nome do produto. Nas pesquisas por SKU e ID de produto, só as correspondências exatas devolvem resultados; as correspondências parciais não são suportadas. No entanto, ao pesquisar pelo nome do produto, as correspondências parciais são suportadas.
Para encontrar um produto por SKU ou ID de produto:
Para encontrar um produto pelo nome:
Exportar os seus produtos
Se escolher 50 ou menos itens na tabela do Catalog, o seu catálogo será transferido diretamente a partir do Dashboard. No entanto, se selecionar Export all ou mais de 50 itens, o CSV será exportado por e-mail.
Para exportar 50 itens ou menos, siga estes passos:
Para exportar todos os produtos:
Problemas ao transferir a partir do e-mail?
Se tiver problemas ao transferir o CSV a partir da ligação do e-mail, isso pode dever-se ao facto de o seu navegador estar a bloquear a transferência. Nesse caso, siga estes passos:
Classificar um produto
Pode classificar um produto do seu catálogo com a API utilizando o
catalogItemIdna mutaçãoClassificationsCreateFromCatalog.Note que é necessário um
namepara classificar um produto do seu catálogo. Consulte a referência da API GraphQL para obter a lista completa dos campos de catálogo e de classificação.Para criar e classificar um produto de catálogo em simultâneo, adicione a mutação
ClassificationsCreateFromCatalogabaixo à sua mutaçãoCatalogItemsCreate.Classificar um produto de catálogo com 8+ dígitos (específico do país)
Quando o campo
shipToCountriesestá preenchido, a classificação será um código HS de 8+ dígitos (específico do país). Se não for indicado nenhumshipToCountries, a classificação será, por predefinição, um código HS de 6 dígitos (universal). Saiba mais sobre as diferenças entre códigos HS universais e específicos do país.No exemplo abaixo, o campo
shipToCountriesé indicado para gerar um código específico do país para o Canadá.mutation ClassificationsCreateFromCatalog($catalogItemToClassify: [ClassificationFromCatalogInput!]!) {classificationsCalculateFromCatalog(input: $catalogItemToClassify) {idconfiguration {shipToCountries}hsCode {code}name}}Segue-se um exemplo de pedido. Embora o Zonos Classify gere uma classificação apenas com um
name, recomendamos vivamente que adicione 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 caso mais comum), deixe este campo em branco.ships_aloneeconsolidated. Se o seu produto puder ser consolidado com outros produtos, pode deixar o campo em branco, uma vez queconsolidatedé o valor predefinido.Marcar mercadorias perigosas (DHL)
Nos envios DHL, pode marcar um produto como mercadoria perigosa para que o serviço de valor acrescentado correto da DHL seja aplicado automaticamente sempre que criar uma etiqueta para esse produto. Isto abrange as classes de mercadorias regulamentadas de "baixo risco" ou isentas: artigos que são tecnicamente regulamentados, mas que são enviados ao abrigo de uma disposição especial ou de uma isenção por 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 através da API (catalogItemsCreateoucatalogItemsUpdate)—não existe nenhum campo no Dashboard nem coluna no CSV para os definir.A marcação de mercadorias perigosas só afeta os envios DHL. A marcação é ignorada nas restantes transportadoras.
DANGEROUS_GOODSé uma chave de atributo suportada para a marcação de mercadorias perigosas da DHL. Ainda não consta das chaves aprovadas na referênciaItemAttributeInput, mas é aceite pela API.Para marcar um produto, adicione um atributo com a chave
DANGEROUS_GOODSe, como valor, uma das categorias suportadas indicadas 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 DHL automaticamente, ative Ship dangerous goods nas definições de etiquetas. Também pode selecionar uma categoria manualmente numa etiqueta individual—consulte declarar mercadorias perigosas.
ItemAttributeInput
Esta página foi útil?