Gérer le catalogue

Important : Si vous tentez de créer un produit qui existe déjà, Catalog reconnaîtra le produit en fonction du SKU et/ou de l'ID du produit et remplacera les détails du produit original par les nouveaux détails.

La modification des produits vous permet de mettre à jour vos produits existants avec des informations supplémentaires ou mises à jour de manière efficace. Au lieu de devoir supprimer et re-télécharger le produit, vous pouvez télécharger les informations mises à jour, et Catalog les associera au produit existant en utilisant votre SKU ou ID de produit, selon votre préférence de clé d'article. De cette façon, vous pouvez garder votre catalogue à jour avec un minimum d'effort, que vous utilisiez le Tableau de bord ou lAPI pour créer de nouveaux produits ou modifier des produits existants.

Si vous créez/modifiez un produit de catalogue qui existe déjà dans Catalog, attendez-vous à ce qui suit :

Catalog écrasera les champs vides des articles existants.

• Par exemple, si un produit existant, SKU 321, n'avait pas de valeur pour le poids, et que le même produit, SKU 321, avait un poids de 1,3 lb dans le nouveau téléchargement, le poids de 1,3 lb remplacerait le champ précédemment vide.

Catalog remplacera les champs existants par de nouvelles valeurs de champ.

• Par exemple, si un produit existant, SKU 123, avait un prix de 18,99 USD et que le même produit, SKU 123, avait un prix mis à jour de 22,99 USD, le nouveau prix de 22,99 USD remplacerait l'ancien prix.

Catalog ne remplacera pas les valeurs existantes par des champs vides.

• Par exemple, si un produit existant, SKU 456, avait un code SH de 6109.10, mais que le code SH du produit mis à jour, SKU 456, est vide, le code SH existant reste.

Si vous souhaitez empêcher les expéditions vers un certain pays (ou pays), vous pouvez ajouter des restrictions lors de la création ou de la mise à jour d'un produit.

Si vous utilisez Checkout, un message de restriction sera affiché dans votre checkout lorsqu'un produit est restreint dans le pays du client. Par défaut, le message indiquera "This item is restricted from import to your country," mais vous pouvez personnaliser votre propre message de restriction en le fournissant dans le champ restrictedCountriesMessage lors de l'ajout de vos restrictions de pays.

Vous pouvez rechercher des produits dans le Catalogue via le Dashboard ou via l'API en utilisant soit le SKU soit l'ID du produit. Notez que seuls les correspondances exactes renverront des résultats ; les correspondances partielles ne seront pas reconnues.

Dashboard

API

Pour filtrer par SKU ou ID de produit :

1. Cliquez sur l'onglet Produits.
2. Sélectionnez SKU ou ID de produit dans le coin supérieur gauche de votre Catalogue.
3. Entrez votre SKU ou ID de produit.
4. Cliquez sur Appliquer pour voir votre ou vos produit(s) filtré(s).

Si vous choisissez 50 articles ou moins dans le tableau du Catalogue, votre catalogue sera téléchargé directement depuis le Tableau de bord. Cependant, si vous sélectionnez Exporter tout ou plus de 50 articles, votre CSV sera exporté par e-mail.

Pour exporter 50 articles ou moins, suivez ces étapes :

1. Sélectionnez 50 articles ou moins directement depuis le tableau du Catalogue.
2. Cliquez sur Exporter en haut à droite.
3. Localisez votre fichier CSV dans votre boîte de réception.

Pour exporter tous les produits :

Problème de téléchargement depuis votre e-mail ?

Si vous rencontrez des problèmes pour télécharger le fichier CSV à partir du lien de l'e-mail, cela peut être dû à votre navigateur qui bloque le téléchargement. Si c'est le cas, suivez ces étapes :

1. Cliquez avec le bouton droit sur le bouton "Télécharger" dans votre e-mail.
2. Sélectionnez "Copier l'adresse du lien" pour copier l'URL de téléchargement.
3. Collez l'URL copiée dans votre navigateur et appuyez sur Entrée.
4. Votre catalogue se téléchargera alors directement depuis votre navigateur.

Vous pouvez classify un produit de votre catalogue avec l'API en utilisant l'catalogItemId dans la mutation ClassificationsCreateFromCatalog.

Notez qu'un nom est requis pour classify un produit de votre catalogue. Consultez la référence de l'API GraphQL pour une liste complète des champs de catalogue et de classification.

Pour créer et classify un produit de catalogue simultanément, ajoutez la mutation ClassificationsCreateFromCatalog ci-dessous à votre mutation CatalogItemsCreate mutation.

Classify un produit de catalogue sur 8+ chiffres (spécifique au pays)

Lorsque le champ shipToCountries est renseigné, la classification sera sur 8+ chiffres (spécifique au pays) du code SH. Si aucun shipToCountries n'est fourni, la classification sera par défaut sur un code SH à 6 chiffres (universel). Apprenez-en davantage sur les distinctions entre les codes SH universels et spécifiques aux pays.

Dans l'exemple ci-dessous, le champ shipToCountries est renseigné pour générer un code spécifique au pays pour le Canada.

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

Voici un exemple de demande. Alors que Zonos Classify générera une classification avec juste un nom, nous recommandons vivement d'ajouter autant de détails que possible pour obtenir les meilleurs résultats de classification.

{
  "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"
      }
    ]
  }
}

Erreurs de l'API et résolutions

* Erreur de l'API uniquement