DOCS

Artikel klassifizieren

Artikel klassifizieren

Erfahren Sie, wie Sie eine Klassifizierung in Dashboard und über die API anfordern.

Nachfolgend finden Sie Beispiele zur Anforderung universeller und länderspezifischer Klassifizierungen über Dashboard oder API. Für umfassendere technische Details besuchen Sie unsere Zonos GraphQL API-Referenz. Diese Ressource bietet detaillierte Einblicke in API-Endpunkte, GraphQL-Mutationen und technische Informationen.

Eingabefelder 

Für eine Klassifizierung ist nur eine Beschreibung erforderlich — je mehr Produktdetails Sie angeben, desto genauer wird die Klassifizierung. Alternativ können Sie eine Produkt-URL angeben; Classify extrahiert dann automatisch alle relevanten Artikeldetails. Nachfolgend eine Übersicht aller von Classify akzeptierten Eingabefelder. Mit diesem Wissen maximieren Sie deren Nutzung für hochpräzise Klassifizierungen.

FeldBeschreibung
Name (erforderlich)Der Name des Produkts
Produkt-URL (optional)Fügen Sie eine Produkt-URL ein — Classify ruft die Seite ab und extrahiert relevante Artikeldetails (Name, Beschreibung, Kategorien usw.) für die Klassifizierung. In Dashboard über das +-Symbol oder direkt im Haupttextfeld. Für API-Integrationen kontaktieren Sie Ihren Zonos-Ansprechpartner. Ideal für Demos und Tests; in Produktion erzielen Sie optimale Leistung und Kosteneffizienz, indem Sie Artikeldaten direkt aus Backend-Systemen übergeben.
Beschreibung (optional)Eine ausführliche, detaillierte Produktbeschreibung
Bild-URL (optional)Link zu einem Produktbild. Hinweis: Verwenden Sie die URL des Bildes, nicht die der Produktseite
Kategorien (optional)Allgemeine Unterkategorien, z. B. Clothing & Accessories, Pet Supplies, Office Products oder Baby Clothes, Pet Beds, Adhesives & Tape
Material (optional)Woraus das Produkt besteht, z. B. Kunststoff, Holz, Stahl
Herkunftsland (optional)Die zweistellige Abkürzung (ISO-Code) für das Herstellungs- oder Produktionsland
Angegebener HS-Code (optional)Geben Sie einen vorhandenen HS-Code in Ihrer Anfrage an, um die Klassifizierung zu steuern. Je nach Präferenz und Herkunft des HS-Codes kann Classify den Code validieren und auf Konsistenz mit der Artikelbeschreibung prüfen. Mehr erfahren.
Zielland (optional)Legt fest, für welches Land klassifiziert wird. Das Zielland muss als zweistellige Abkürzung (ISO-Code) angegeben werden, nicht als Ländername, z. B. AU, nicht Australia. Mit diesem Feld liefert Classify einen länderspezifischen HS-Code mit 8+ Stellen statt des universellen 6-stelligen Codes. Mehr zu universellen und länderspezifischen HS-Codes.
Produkt-ID (optional)Ihre Produkt-ID oder eine eindeutige Kennung. Ohne Produkt-ID vergibt Classify IDs ab 1

Hinweis: Beim CSV-Upload in Dashboard ist das Zielland nicht Teil der Vorlage — Sie wählen die Zielländer nach dem Upload aus.

Klassifizierung anfordern 

So fordern Sie eine Klassifizierung in Dashboard oder über die API an:

Das Beispiel zeigt eine universelle (6-stellige) Anfrage. Für länderspezifische Klassifizierungen fügen Sie die ISO-Codes der Länder in die Classify-Anfrage ein. Für einen universellen HS-Code lassen Sie das Lieferland in der Anfrage null.

Die Eingabe ist eine Liste — Sie können eine oder viele Klassifizierungen gleichzeitig anfordern.

Hinweis: Um Audit Trails per API zu erzeugen, fügen Sie das Feld auditTrail in Ihre Abfrage ein. Kontaktieren Sie Ihren Zonos-Ansprechpartner für Zugang und Implementierungsdetails.

1mutation ClassifyItems($input: [ClassificationCalculateInput!]!) {
2 classificationsCalculate(input: $input) {
3 id
4 name
5 categories
6 imageUrl
7 hsCode {
8 code
9 description {
10 full
11 }
12 }
13 }
14}

Mögliche API-Antworten

Bei einer Klassifizierungsanfrage versucht Classify, die Eingabedaten mit dem besten Treffer in der Classify-Datenbank anhand des höchsten Konfidenzwerts abzugleichen. Je nach Ergebnis gibt Classify eine der folgenden Antworten zurück:

  1. Wenn hsCode mit einem 6- bis 8+-stelligen HS-Code zurückgegeben wird (je nachdem, ob ein Lieferland angegeben wurde), war Ihre Anfrage erfolgreich.
  2. Wenn {"errors": [ { "message": "No adequate response"}]} zurückgegeben wird, konnte Classify aufgrund unzureichender Eingabeinformationen keine Klassifizierung finden.
GraphQL API ReferenceTypes, inputs, and operations used in this guide

War diese Seite hilfreich?