Gerenciar Catálogo

Importante: Se você tentar criar um produto que já existe, o Catálogo reconhecerá o produto com base no SKU e/ou ID do produto e substituirá os detalhes do produto original pelos novos detalhes.

Editar produtos permite que você atualize seus produtos existentes com informações adicionais ou atualizadas de forma eficiente. Em vez de ter que excluir e fazer o upload do produto novamente, você pode fazer o upload das informações atualizadas, e o Catálogo irá combiná-las com o produto existente usando seu SKU ou ID do produto, dependendo da sua preferência de chave do 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 Catálogo, espere o seguinte:

O Catálogo substituirá campos em branco em itens existentes.

• Por exemplo, se um produto existente, SKU 321, não tinha um valor para peso, e o mesmo produto, SKU 321, tinha um peso de 1,3 lbs no novo upload, o peso de 1,3 lbs substituiria o campo anteriormente em branco.

O Catálogo substituirá campos existentes com 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 substituiria o preço anterior.

O Catálogo não substituirá 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 permanecerá.

Se você deseja impedir remessas para um determinado país (ou países), você pode adicionar restrições ao criar ou atualizar um produto.

Se você estiver usando Checkout, uma mensagem de restrição será exibida no seu checkout quando um produto for restrito ao país do cliente. Por padrão, a mensagem dirá "Este item está restrito à importação para o seu país", mas você pode personalizar sua própria mensagem de restrição fornecendo-a no campo restrictedCountriesMessage ao adicionar suas restrições de país.

Você pode buscar produtos no Catálogo através do Dashboard ou via API usando o SKU ou o ID do produto. Note que apenas correspondências exatas retornarão resultados; correspondências parciais não serão reconhecidas.

Dashboard

API

Para filtrar por SKU ou ID do produto:

1. Clique na aba Produtos.
2. Selecione SKU ou ID do Produto no canto superior esquerdo do seu Catálogo.
3. Insira seu SKU ou ID do produto.
4. Clique em Aplicar para ver seu(s) produto(s) filtrado(s).

Se você escolher 50 itens ou menos da tabela de Catálogo, seu catálogo será baixado diretamente do Dashboard. No entanto, se você selecionar Exportar tudo ou mais de 50 itens, seu CSV será exportado por e-mail.

Para exportar 50 itens ou menos, siga estas etapas:

1. Selecione 50 itens ou menos diretamente da tabela de Catálogo.
2. Clique em Exportar no canto superior direito.
3. Localize seu arquivo CSV em sua caixa de entrada de e-mail.

Para exportar todos os produtos:

Problemas para baixar do seu e-mail?

Se você está tendo problemas para baixar o CSV a partir do link do e-mail, isso pode ser devido ao seu navegador bloquear o download. Se for o caso, siga estes passos:

1. Clique com o botão direito no botão "Download" em seu e-mail.
2. Selecione "Copiar endereço do link" para copiar a URL do download.
3. Cole a URL copiada em seu navegador e clique em enter.
4. Seu catálogo será então baixado diretamente do seu navegador.

Você pode classify um produto do seu catálogo com a API usando o catalogItemId na mutação ClassificationsCreateFromCatalog.

Observe que um nome é necessário para classify um produto do seu catálogo. Consulte a referência da API GraphQL para obter uma lista completa de campos de catálogo e classificação.

Para criar e classify um produto de catálogo simultaneamente, adicione a mutação ClassificationsCreateFromCatalog abaixo à sua mutação CatalogItemsCreate mutação.

Classify um produto de catálogo para o código de 8+ dígitos (específico do país)

Quando o campo shipToCountries é preenchido, a classificação será um código HS de 8+ dígitos (específico do país). Se nenhum shipToCountries for fornecido, a classificação será padrão para um código HS de 6 dígitos (universal). Saiba mais sobre as distinções entre códigos HS universais e específicos do país.

No exemplo abaixo, o campo shipToCountries é fornecido para gerar um código específico do país para o Canadá.

mutation ClassificationsCreateFromCatalog(
  $catalogItemToClassify: [ClassificationFromCatalogInput!]!
) {
  classificationsCalculateFromCatalog(input: $catalogItemToClassify) {
    id
    configuration {
      shipToCountries
    }
    hsCode {
      code
    }
    name
  }
}

Aqui está um exemplo de uma solicitação. Enquanto o Zonos Classify irá gerar uma classificação apenas com um nome, 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"]
      }
    }
  ]
}

{
  "data": {
    "classificationsCreateFromCatalog": [
      {
        "id": "classification_8C49fk2945jmm232CcQtHtXdu",
        "configuration": {
          "shipToCountries": ["CA"]
        },
        "countryOfOrigin": "US",
        "hsCode": {
          "code": "6116.10.0020"
        },
        "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
      }
    ]
  }
}

Erros da API e resoluções

* Erro da API apenas