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 „gering risiko“- 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.
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.
mutation CatalogItemsCreate($sku: String!$name: String$attributes: [ItemAttributeInput!]) { catalogItemsCreate( input: [{ sku: $sku, name: $name, attributes: $attributes }] ) { id name sku attributes key valueUnterstü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. |
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.
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 einfachALLals Wert ein. Wenn Sie alle Länder außer einem oder wenigen einschränken möchten, geben SieALL-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 SieNONEals 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.
If you're using Checkout, a restricted message will be displayed in your checkout when a product is restricted to the customer's country. By default, the message will say "This item is restricted from import to your country."
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.
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 eine Klassifizierung nur mit einem name generiert, empfehlen wir dringend, so viele Details wie möglich für die besten Klassifizierungsergebnisse hinzuzufügen.
{ "catalogItemToClassify": [ { "catalogItemId": "catalog_item_893jkdkllg03k9khjd9", "configuration": { "shipToCountries": [ "CA" ] } } ]}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
Catalog verwalten
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.