Katalog verwalten

Wichtig: Wenn Sie versuchen, ein Produkt zu erstellen, das bereits existiert, erkennt der Katalog das Produkt anhand der SKU und/oder Produkt-ID und überschreibt die Details des ursprünglichen Produkts mit den neuen Details.

Das Bearbeiten von Produkten ermöglicht es Ihnen, Ihre vorhandenen Produkte effizient mit zusätzlichen oder aktualisierten Informationen zu aktualisieren. Anstatt das Produkt zu löschen und erneut hochzuladen, können Sie die aktualisierten Informationen hochladen, und der Katalog wird es mit dem vorhandenen Produkt anhand Ihrer SKU oder Produkt-ID abgleichen, abhängig von Ihrer bevorzugten Artikelkennung. Auf diese Weise können Sie Ihren Katalog mit minimalem Aufwand auf dem neuesten Stand halten, egal ob Sie das Dashboard oder die API verwenden, um neue Produkte zu erstellen oder vorhandene Produkte zu bearbeiten.

Wenn Sie ein Katalogprodukt erstellen/bearbeiten, das bereits im Katalog vorhanden ist, erwarten Sie Folgendes:

Der Katalog überschreibt leere Felder bei vorhandenen Artikeln.

• Zum Beispiel, wenn ein vorhandenes Produkt mit der SKU 321 keinen Wert für das Gewicht hatte und dasselbe Produkt mit der SKU 321 ein Gewicht von 1,3 lbs im neuen Upload hatte, würde das Gewicht von 1,3 lbs das zuvor leere Feld überschreiben.

Der Katalog überschreibt vorhandene Felder mit neuen Feldwerten.

• Zum Beispiel, wenn ein vorhandenes Produkt mit der SKU 123 einen Preis von 18,99 USD hatte und dasselbe Produkt mit der SKU 123 einen aktualisierten Preis von 22,99 USD hatte, würde der neue Preis von 22,99 USD den vorherigen Preis überschreiben.

Der Katalog überschreibt vorhandene Werte nicht mit leeren Feldern.

• Zum Beispiel, wenn ein vorhandenes Produkt mit der SKU 456 einen HS-Code von 6109.10 hatte, aber der HS-Code des aktualisierten Produkts mit der SKU 456 leer ist, bleibt der vorhandene HS-Code bestehen.

Wenn Sie Lieferungen in ein bestimmtes Land (oder Länder) verhindern möchten, können Sie Einschränkungen hinzufügen, wenn Sie ein Produkt erstellen oder aktualisieren.

Wenn Sie Checkout verwenden, wird eine eingeschränkte Nachricht in Ihrem checkout angezeigt, wenn ein Produkt für das Land des Kunden eingeschränkt ist. Standardmäßig lautet die Nachricht "Dieser Artikel darf nicht in Ihr Land importiert werden", aber Sie können Ihre eigene eingeschränkte Nachricht anpassen, indem Sie diese im Feld restrictedCountriesMessage angeben, wenn Sie Ihre Länderbeschränkungen hinzufügen.

Sie können Produkte im Katalog über das Dashboard oder über die API anhand der SKU oder der Produkt-ID suchen. Beachten Sie, dass nur exakte Übereinstimmungen Ergebnisse liefern; Teilübereinstimmungen werden nicht erkannt.

Dashboard

API

Um nach SKU oder Produkt-ID zu filtern:

1. Klicken Sie auf die Registerkarte Produkte.
2. Wählen Sie SKU oder Produkt-ID in der oberen linken Ecke Ihres Katalogs aus.
3. Geben Sie Ihre SKU oder Produkt-ID ein.
4. Klicken Sie auf Anwenden, um Ihre gefilterten Produkt(e) anzuzeigen.

Wenn Sie 50 oder weniger Artikel aus der Katalogtabelle auswählen, wird Ihr Katalog direkt aus dem Dashboard heruntergeladen. Wenn Sie jedoch Alle exportieren oder mehr als 50 Artikel auswählen, wird Ihr CSV per E-Mail exportiert.

Um 50 Artikel oder weniger zu exportieren, befolgen Sie diese Schritte:

1. Wählen Sie 50 oder weniger Artikel direkt aus der Katalogtabelle aus.
2. Klicken Sie oben rechts auf Exportieren.
3. Suchen Sie Ihre CSV-Datei in Ihrem E-Mail-Posteingang.

Um alle Produkte zu exportieren:

Probleme beim Herunterladen aus Ihrer E-Mail?

Wenn Sie Probleme beim Herunterladen der CSV-Datei über den E-Mail-Link haben, kann dies daran liegen, dass Ihr Browser den Download blockiert. In diesem Fall folgen Sie diesen Schritten:

1. Klicken Sie mit der rechten Maustaste auf die Schaltfläche "Download" in Ihrer E-Mail.
2. Wählen Sie "Link-Adresse kopieren", um die Download-URL zu kopieren.
3. Fügen Sie die kopierte URL in Ihren Browser ein und drücken Sie die Eingabetaste.
4. Ihr Katalog wird dann direkt von Ihrem Browser heruntergeladen.

Sie können ein Produkt aus Ihrem Katalog mit der API classify, indem Sie die catalogItemId in der ClassificationsCreateFromCatalog-Mutation verwenden.

Beachten Sie, dass ein name erforderlich ist, um ein Produkt aus Ihrem Katalog zu classify. Konsultieren Sie die GraphQL API-Referenz für eine vollständige Liste der Katalog- und Klassifikationsfelder.

Um ein Katalogprodukt gleichzeitig zu erstellen und zu classify, fügen Sie die untenstehende ClassificationsCreateFromCatalog-Mutation zu Ihrer CatalogItemsCreate Mutation hinzu.

Ein Katalogprodukt auf die 8+ Stellen (länderspezifisch) Classify

Wenn das Feld shipToCountries ausgefüllt ist, wird die Klassifikation ein 8+ Stellen (länderspezifischer) HS-Code sein. Wenn keine shipToCountries angegeben sind, wird die Klassifikation standardmäßig ein 6-stelliger (universeller) HS-Code sein. Erfahren Sie mehr über die Unterschiede zwischen universellen und länderspezifischen HS-Codes.

Im untenstehenden Beispiel wird das Feld shipToCountries angegeben, um einen länderspezifischen Code für Kanada zu generieren.

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

Hier ist ein Beispiel für eine Anfrage. Während Zonos Classify nur eine Klassifizierung mit einem name generieren wird, empfehlen wir dringend, so viele Details wie möglich hinzuzufügen, um die besten Klassifizierungsergebnisse zu erzielen.

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

API-Fehler und Lösungen

* Nur API-Fehler