Wie erstellt man ein Produkt in Zonos Catalog?

Sie können ein Produkt in Zonos Catalog entweder über das Dashboard oder die API erstellen. Im Dashboard gehen Sie zu Catalog und klicken oben rechts auf Add product. Fügen Sie Ihre Produktdetails hinzu und klicken Sie auf save product. Wenn Sie mehrere Produkte auf einmal erstellen möchten, folgen Sie den Schritten zum Importieren von Produkten. In der API erstellen Sie eine Liste von catalogItemInputs, um Produkte zu Ihrem Katalog hinzuzufügen.

Wie bearbeitet man ein Produkt in Zonos Catalog?

Sie können ein Produkt in Zonos Catalog entweder über das Dashboard oder die API bearbeiten. Im Dashboard klicken Sie auf die Registerkarte All products, wählen das Produkt aus, das Sie bearbeiten möchten, nehmen Ihre Änderungen vor und klicken auf save product. In der API verwenden Sie die CatalogItemUpdate-Mutation, um ein Produkt zu bearbeiten.

Wie löscht man ein Produkt in Zonos Catalog?

Sie können ein Produkt in Zonos Catalog entweder über das Dashboard oder die API löschen. Im Dashboard klicken Sie auf die Registerkarte All products, wählen das Produkt oder die Produkte aus, die Sie löschen möchten, und klicken auf delete. In der API verwenden Sie die CatalogItemDelete-Mutation, um ein Produkt zu löschen.

Wie schränkt man ein Produkt in Zonos Catalog ein?

Wenn Sie Sendungen in ein bestimmtes Land (oder bestimmte Länder) verhindern möchten, können Sie beim Erstellen oder Aktualisieren eines Produkts in Zonos Catalog Einschränkungen hinzufügen. Im Dashboard wählen Sie das Produkt aus, dem Sie eine Einschränkung hinzufügen möchten, suchen den Einschränkungsabschnitt unten auf der Bearbeitungsseite, fügen die Länder hinzu, auf die Sie Ihr Produkt beschränken möchten, und klicken auf save product. In der API fügen Sie restrictedCountries beim Erstellen oder Aktualisieren eines catalogItem hinzu.

Wie exportiert man Produkte im Zonos Dashboard?

Wenn Sie Ihre Produkte im Zonos Dashboard exportieren, wird Ihr gesamter Produktkatalog automatisch in einer CSV-Datei exportiert. Gehen Sie zur Hauptseite Ihres Catalog, klicken Sie neben Add product auf die Export-Schaltfläche und finden Sie Ihre vollständige Katalogdatei in Ihren Downloads.

StartseiteGlobaler E-Commerce Catalog Produkte verwalten

Catalog verwalten

Q: Wie klassifiziert man ein Catalog-Produkt über die API?

Sie können ein Produkt aus Ihrem Katalog klassifizieren, indem Sie die catalogItemId in der ClassificationsCreateFromCatalog-Mutation verwenden. Beachten Sie, dass ein name erforderlich ist, um ein Produkt aus Ihrem Katalog zu klassifizieren. Um ein Catalog-Produkt gleichzeitig zu erstellen und zu klassifizieren, fügen Sie die ClassificationsCreateFromCatalog-Mutation zu Ihrer CatalogItemsCreate-Mutation hinzu.

Produkte erstellen und ändern.

Erfahren Sie, wie Sie Ihre Zonos Catalog-Produkt(e) im Dashboard oder über die API hinzufügen, ändern und löschen. Nutzen Sie Catalog im Dashboard, wenn Sie keinen Code schreiben möchten oder nur kleine Änderungen vornehmen. Wenn Sie Catalog für Produktionsimplementierungen direkt integrieren möchten, verwenden Sie die API.

Ein Produkt erstellen

Erstellen Sie ein Produkt in Catalog:

Gehen Sie zu Catalog und klicken Sie oben rechts auf Add product.
Fügen Sie Ihre Produktdetails hinzu. Das einzige erforderliche Feld zum Erstellen eines Produkts ist die SKU und/oder das Produkt-ID-Feld. Diese Felder werden verwendet, um Ihre Catalog-Produkte zu referenzieren. Erfahren Sie mehr über Catalog-Kennungen.
Optional—Fügen Sie Ihre(n) HS-Code(s) hinzu.
Optional—Fügen Sie Ihre Versandinformationen hinzu (Gewicht, Abmessungen, Maßeinheiten usw.).
Optional—Fügen Sie eingeschränkte Länder hinzu.
Klicken Sie auf save product.

Erstellen Sie mehrere Produkte in Catalog:

Laden Sie mehrere Produkte oder Ihren gesamten Produktkatalog auf einmal hoch.

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

Ein Produkt als Gefahrgut kennzeichnen (DHL)

Für DHL-Sendungen können Sie ein Produkt als Gefahrgut kennzeichnen, damit der korrekte DHL-Mehrwertdienst automatisch angewendet wird, wenn Sie ein Etikett für dieses Produkt erstellen. Dies umfasst die „risikoarmen“ oder ausgenommenen Klassen regulierter Güter—Artikel, die technisch reguliert sind, aber unter einer Sonderbestimmung oder Mengenausnahme versendet werden.

Ein Gefahrgut-Tag wird als Catalog-Artikel-Attribut gespeichert: ein key/value-Paar am Produkt. Attribute werden über die API (catalogItemsCreate oder catalogItemsUpdate) gesetzt—es gibt kein Dashboard-Feld oder CSV-Spalte dafür.

Nur DHL

Die Gefahrgut-Kennzeichnung betrifft nur DHL-Sendungen. Das Tag wird für andere Carrier ignoriert.

Unterstützter Attributschlüssel

DANGEROUS_GOODS ist ein unterstützter Attributschlüssel für die DHL-Gefahrgut-Kennzeichnung. Er ist noch nicht unter den genehmigten Schlüsseln in der ItemAttributeInput-Referenz aufgeführt, wird aber von der API akzeptiert.

Um ein Produkt zu kennzeichnen, fügen Sie ein Attribut mit dem Schlüssel DANGEROUS_GOODS und einem Wert aus einer der unten aufgeführten unterstützten Kategorien hinzu.

1mutation CatalogItemsCreate(

2$sku: String!

3$name: String

4$attributes: [ItemAttributeInput!]

5) {

6 catalogItemsCreate(

7 input: [{ sku: $sku, name: $name, attributes: $attributes }]

8 ) {

9 id

10 name

11 sku

12 attributes

13 key

14 value

Unterstützte Gefahrgut-Werte

Value↕	Kategorie↕
`NOT_RESTRICTED_A70`	Nicht eingeschränkt, Sonderbestimmung A70—druckbeaufschlagte Artikel, wie Gasdruckfedern und Stoßdämpfer (UN3164).
`NOT_RESTRICTED_A67`	Nicht eingeschränkt, Sonderbestimmung A67—Motoren oder Maschinen mit brennbarer Flüssigkeit (UN3528).
`NOT_RESTRICTED_A02`	Nicht eingeschränkt, Sonderbestimmung A02—ausgenommen nach der ADR-Kleinmengenbestimmung für Straßentransport.
`LIMITED_QUANTITY`	Limited Quantity (ADR)—Gefahrgut in kleinen Mengen innerhalb der regulatorischen Grenzen verpackt.
`EXCEPTED_QUANTITY`	Excepted Quantity (IATA)—sehr kleine Mengen, die von den meisten Lufttransport-Gefahrgutregeln ausgenommen sind.
`CONSUMER_COMMODITY`	Consumer commodity ID8000—verbrauchsfertige Alltagsprodukte mit geringem Gefahrstoffgehalt, wie Aerosole und Parfüm.
`MAGNETIZED_MATERIAL`	Magnetized material (UN2807)—Artikel mit einem Magnetfeld, das stark genug ist, um Flugzeuginstrumente zu beeinflussen.
`BIOLOGICAL_SUBSTANCE`	Biological substance (UN3373)—biologische Stoffe der Kategorie B, wie diagnostische oder klinische Proben.

Tags automatisch auf Etiketten anwenden

Die Kennzeichnung eines Produkts ist der erste Schritt. Damit Zonos die Kategorie automatisch auf Ihre DHL-Etiketten anwendet, aktivieren Sie Ship dangerous goods in den Etiketteneinstellungen. Sie können eine Kategorie auch manuell auf einem einzelnen Etikett auswählen—siehe Gefahrgut deklarieren.

Ein Produkt bearbeiten

Das Bearbeiten von Produkten ermöglicht es Ihnen, Ihre vorhandenen Produkte effizient mit zusätzlichen oder aktualisierten Informationen zu aktualisieren. Anstatt das Produkt löschen und erneut hochladen zu müssen, können Sie die aktualisierten Informationen hochladen, und Catalog ordnet sie dem vorhandenen Produkt anhand Ihrer SKU oder Produkt-ID zu, abhängig von Ihrer Item-Key-Präferenz. So halten Sie Ihren Katalog mit minimalem Aufwand aktuell, unabhängig davon, ob Sie das Dashboard oder die API zum Erstellen neuer Produkte oder Bearbeiten vorhandener Produkte verwenden.

Wenn Sie ein Catalog-Produkt erstellen/bearbeiten, das bereits in Catalog existiert, ist Folgendes zu erwarten:

Catalog überschreibt leere Felder bei vorhandenen Artikeln.

Wenn ein vorhandenes Produkt, SKU 321, beispielsweise keinen Wert für das Gewicht hatte und dasselbe Produkt, SKU 321, im neuen Upload ein Gewicht von 1,3 lbs hatte, würde das Gewicht von 1,3 lbs das zuvor leere Feld überschreiben.

Catalog überschreibt vorhandene Felder mit neuen Feldwerten.

Wenn ein vorhandenes Produkt, SKU 123, beispielsweise einen Preis von 18,99 USD hatte und dasselbe Produkt, SKU 123, einen aktualisierten Preis von 22,99 USD hatte, würde der neue Preis von 22,99 USD den vorherigen Preis überschreiben.

Catalog überschreibt vorhandene Werte nicht mit leeren Feldern.

Wenn ein vorhandenes Produkt, SKU 456, beispielsweise einen HS-Code von 6109.10 hatte, der HS-Code des aktualisierten Produkts, SKU 456, aber leer ist, bleibt der vorhandene HS-Code erhalten.

So bearbeiten Sie ein Produkt:

Klicken Sie auf die Registerkarte Products.
Wählen Sie das Produkt aus, das Sie bearbeiten möchten.
Nehmen Sie Ihre Änderungen vor.
Klicken Sie auf save product.

Um mehrere oder alle Produkte auf einmal zu bearbeiten, laden Sie einfach eine aktualisierte CSV-Datei in Catalog hoch, einschließlich Ihrer SKU oder Produkt-ID. Dies löst automatische Aktualisierungen Ihrer vorhandenen Artikel aus.

Ein Produkt löschen

So löschen Sie ein Produkt:

Klicken Sie im Dashboard auf die Registerkarte Products.
Wählen Sie das/die Produkt(e) aus, das/die Sie löschen möchten. Sobald Ihr(e) Produkt(e) ausgewählt ist/sind, erscheint eine Löschen-Schaltfläche.
Klicken Sie auf Delete und dann auf Delete all, um die Löschung zu bestätigen.

So löschen Sie alle Produkte:

Wählen Sie im Dashboard die Registerkarte Products.
Klicken Sie oben rechts auf Manage Catalog und dann auf Delete all.
Klicken Sie erneut auf Delete all, um die Löschung zu bestätigen.

Beachten Sie, dass beim Löschen einer großen Anzahl von Artikeln (mehr als etwa 20.000 Produkte) eine Benachrichtigung erscheint, die darauf hinweist, dass Ihre Löschung in Bearbeitung ist. Während dieser Zeit können Sie nicht mit Catalog interagieren, bis die Löschung abgeschlossen ist. Sie können die Benachrichtigung jedoch schließen und wegnavigieren, ohne den Löschvorgang zu unterbrechen.

Ein Produkt einschränken

Wenn Sie Sendungen in ein bestimmtes Land (oder bestimmte Länder) verhindern möchten, können Sie beim Erstellen oder Aktualisieren eines Produkts Einschränkungen hinzufügen.

Zonos Duty & Tax-Apps unterstützen keine Artikeleinschränkungen auf Produktebene, die bestimmte Produkte aus internationalen Bestellungen entfernen. Wenn ein eingeschränkter Artikel im Warenkorb ist, muss der gesamte Warenkorb für den Versand in dieses Land blockiert werden. Dies wird über eine Warenkorb-Einschränkungsregel gehandhabt, die im Voraus während des Onboardings konfiguriert werden muss. Während Catalog mit Duty & Tax-Apps kompatibel ist, werden Artikeleinschränkungen nur unterstützt, wenn Sie Zonos Checkout verwenden.

So schränken Sie ein einzelnes Produkt in Catalog ein:

Klicken Sie auf die Registerkarte Products.
Wählen Sie das Produkt aus, dem Sie eine Einschränkung hinzufügen möchten, wodurch die Bearbeitungsseite geöffnet wird.
Suchen Sie den Abschnitt Restricted countries unten auf der Bearbeitungsseite.
Fügen Sie die Länder hinzu, auf die Sie Ihr Produkt beschränken möchten, indem Sie den/die Ländernamen auswählen oder eingeben.
Klicken Sie auf save product.

So schränken Sie mehrere Produkte in Catalog ein:

Klicken Sie auf die Registerkarte Import/export.
Laden Sie die Catalog template CSV herunter.
Füllen Sie die Vorlage mit Ihren Produktdetails aus, einschließlich Ihrer SKU/Produkt-ID und eingeschränkter Länder. Geben Sie den 2-stelligen ISO-Code getrennt durch senkrechte Striche ein, z. B. AU|KR|MY|SG. Um alle Länder einzuschränken, geben Sie einfach ALL als Wert ein. Wenn Sie alle Länder außer einem oder wenigen einschränken möchten, geben Sie ALL- gefolgt von den Ländern ein, die Sie nicht einschränken möchten, getrennt durch senkrechte Striche, z. B. ALL-CA|FR|US. Erfahren Sie mehr über CSV-Formatierung. Wenn Sie alle vorhandenen eingeschränkten Länder entfernen möchten, geben Sie NONE als Wert ein.
Speichern Sie Ihre Datei als CSV und laden Sie sie in Catalog hoch, indem Sie sie per Drag-and-Drop ablegen oder Ihre Datei auswählen, indem Sie auf derselben Seite, von der Sie die CSV heruntergeladen haben, auf browse klicken.
Überprüfen Sie Ihre hochgeladenen Produkte auf der Vorschauseite und klicken Sie auf upload.

Eingeschränkte Produkte filtern:

Sie können eingeschränkte Produkte direkt im Katalog filtern, indem Sie Ihren gesamten Katalog im CSV-Format aus dem Dashboard herunterladen und in Excel oder Google Sheets öffnen. Dort können Sie die Filterfunktion nutzen, um nur die eingeschränkten Produkte anzuzeigen. So können Sie die eingeschränkten Produkte in Ihrem Katalog leicht finden und verwalten.

Wenn Sie Ihren Katalog nach Änderungen an Ihrer CSV aktualisieren müssen, laden Sie die Datei erneut hoch, und alle übereinstimmenden Produkte werden durch die aktualisierte Version ersetzt. Dies geschieht durch Identifizierung und Abgleich der SKU und/oder Produkt-ID.

Wenn Sie Checkout verwenden, wird in Ihrem Checkout eine Einschränkungsmeldung angezeigt, wenn ein Produkt für das Land des Kunden eingeschränkt ist. Standardmäßig lautet die Meldung: „Dieser Artikel ist für den Import in Ihr Land eingeschränkt.“

Ein Produkt filtern

Sie können Produkte in Catalog über das Dashboard oder die API anhand der SKU, Produkt-ID oder des Produktnamens suchen. Bei SKU- und Produkt-ID-Suchen werden nur exakte Übereinstimmungen zurückgegeben; Teilübereinstimmungen werden nicht unterstützt. Bei der Suche nach Produktnamen werden jedoch Teilübereinstimmungen unterstützt.

So filtern Sie nach SKU oder Produkt-ID:

Klicken Sie im Dashboard auf die Registerkarte Products.
Wählen Sie oben links in Ihrem Catalog SKU oder Product ID.
Geben Sie Ihre SKU, Produkt-ID oder Ihren Produktnamen ein.
Klicken Sie auf Apply, um Ihr(e) gefilterte(s) Produkt(e) anzuzeigen.

So suchen Sie nach einem Produktnamen:

Klicken Sie im Dashboard auf die Registerkarte Products.
Geben Sie oben rechts in Ihrem Catalog den Produktnamen in das Suchfeld ein.
Zeigen Sie Ihr(e) gefilterte(s) Produkt(e) an.

Ihre Produkte exportieren

Wenn Sie 50 oder weniger Artikel aus der Catalog-Tabelle auswählen, wird Ihr Katalog direkt aus dem Dashboard heruntergeladen. Wenn Sie jedoch Export all oder mehr als 50 Artikel auswählen, wird Ihre CSV per E-Mail exportiert.

So exportieren Sie 50 oder weniger Artikel:

Wählen Sie 50 oder weniger Artikel direkt aus der Catalog-Tabelle aus.
Klicken Sie oben rechts auf Export.
Suchen Sie Ihre CSV-Datei in Ihrem E-Mail-Posteingang.

Alle Produkte exportieren:

Gehen Sie zu Dashboard -> Products -> Catalog.
Klicken Sie auf das Dropdown Manage Catalog neben Add product und klicken Sie auf Export all.
Suchen Sie Ihre Katalogdatei in Ihren Downloads.

Probleme beim Herunterladen aus Ihrer E-Mail?

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

Klicken Sie mit der rechten Maustaste auf die Schaltfläche „Download“ in Ihrer E-Mail.
Wählen Sie „Copy link address“, um die Download-URL zu kopieren.
Fügen Sie die kopierte URL in Ihren Browser ein und drücken Sie die Eingabetaste.
Ihr Katalog wird dann direkt über Ihren Browser heruntergeladen.

Ein Produkt klassifizieren

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

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

Um ein Catalog-Produkt gleichzeitig zu erstellen und zu klassifizieren, fügen Sie die unten stehende ClassificationsCreateFromCatalog-Mutation zu Ihrer CatalogItemsCreate-Mutation hinzu.

Ein Catalog-Produkt auf 8+ stellig (länderspezifisch) klassifizieren

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

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

1mutation ClassificationsCreateFromCatalog(

2$catalogItemToClassify: [ClassificationFromCatalogInput!]!

3) {

4 classificationsCalculateFromCatalog(input: $catalogItemToClassify) {

5 id

6 configuration {

7 shipToCountries

8 }

9 hsCode {

10 code

11 }

12 name

13 }

14}

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

1{

2 "catalogItemToClassify": [

3 {

4 "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",

5 "configuration": {

6 "shipToCountries": [

7 "CA"

8 ]

9 }

10 }

11 ]

12}

API-Fehler und Lösungen

Fehler↕	Lösung↕
*A SKU or product ID is required to create a product*	Eine Kennung (SKU/Produkt-ID) ist erforderlich, um einen Catalog-Artikel zu erstellen, zu bearbeiten oder zu löschen. Fügen Sie zur Behebung eine SKU und/oder Produkt-ID hinzu.
*The product you are trying to edit does not exist**	Sie können kein Produkt bearbeiten, das nicht existiert. Erstellen Sie zur Behebung ein neues Produkt mit Ihrer gewünschten SKU und/oder Produkt-ID.
*Customs description exceeds character limit of 30 characters.*	Standardmäßig sind Zollbeschreibungen auf 30 Zeichen begrenzt, was dem häufigsten Zeichenlimit für Handelsrechnungen entspricht.
*Product type invalid. Catalog supports the following product types: digital_good. For physical goods, leave it blank.*	Catalog unterstützt nur die folgenden Produkttypen: `digital_good` und `physical_good`. Wenn Ihr Produkt eine physische Ware ist (am häufigsten), lassen Sie dieses Feld leer.
*Packing preference invalid. Catalog supports the following packing preferences: ships_alone and consolidated. If your product can be consolidated with other products, leave blank.*	Ungültige Verpackungspräferenz. Catalog unterstützt die folgenden Verpackungspräferenzen: `ships_alone` und `consolidated`. Wenn Ihr Produkt mit anderen Produkten konsolidiert werden kann, können Sie es leer lassen, da `consolidated` der Standard ist.
*Country must be specified when providing an HS code*	Wenn Sie einen länderspezifischen HS-Code beim Erstellen eines Artikels angeben, ist ein Versandziel-Land erforderlich. Fügen Sie zur Behebung ein Versandziel-Land hinzu.
*Price must be greater than 0*	Catalog unterstützt keine negativen Preiswerte. Fügen Sie zur Behebung einen Preis größer als null hinzu.
*Currency code must be provided when a price value is supplied*	Wenn Sie einen Preis angeben, ist ein Währungscode erforderlich. Fügen Sie zur Behebung einen Währungscode hinzu.
*Price must be provided when a currency code is supplied*	Wenn Sie einen Währungscode angeben, ist ein Preis erforderlich. Fügen Sie zur Behebung einen Preis hinzu.
*The accompanying dimensional field cannot be left blank*	Wenn ein Abmessungsfeld angegeben wird, sind die anderen beiden erforderlich, z. B. wenn Sie eine Breite von 8 inches angeben, sind Höhe und Länge erforderlich.
*Measurement value must be greater than 0*	Catalog unterstützt keine negativen oder Null-Messwerte. Fügen Sie zur Behebung einen Wert größer als null hinzu.
*When providing a dimensional value, dimensional units cannot be left empty*	Wenn Sie einen Abmessungswert angeben, ist eine Abmessungseinheit erforderlich. Fügen Sie zur Behebung eine Abmessungseinheit hinzu.
*When providing a weight value, the weight unit cannot be left empty*	Wenn Sie einen Gewichtswert angeben, ist eine Gewichtseinheit erforderlich. Fügen Sie zur Behebung eine Gewichtseinheit hinzu.

* Nur API-Fehler

GraphQL API ReferenceTypes, inputs, and operations used in this guide

INPUTS

ItemAttributeInput

Buchen Sie eine Demo