Eingabefelder
Während nur eine Beschreibung erforderlich ist, um eine Klassifizierung zu generieren, desto mehr Produktdetails Sie bereitstellen, desto genauer wird Ihre Klassifizierung sein. Unten finden Sie eine umfassende Erklärung jedes Eingabefeldes, das von Classify akzeptiert wird. Durch das Verständnis dieser Eingabefelder können Sie deren Nutzung maximieren und hochgenaue Klassifizierungen generieren.
Beschreibungen der Eingabefelder
Feld | Beschreibung |
---|---|
Name (erforderlich) | Der Name des Produkts |
Beschreibung (optional) | Eine ausführliche, lange Beschreibung des Produkts |
Bild-URL (optional) | Link zu einem Bild des Produkts. Hinweis: Stellen Sie sicher, dass Sie einen Link zur tatsächlichen Bild-URL und nicht zur Produktseite verwenden |
Kategorien (optional) | Allgemeine Unterkategorien von Produkten, z.B. Bekleidung & Accessoires, Haustierbedarf, Büroprodukte oder Babykleidung, Hundebetten, Kleber & Klebeband |
Material (optional) | Woraus das Produkt besteht, z.B. Kunststoff, Holz, Stahl |
Herkunftsland (optional) | Die zwei Buchstaben Abkürzung (ISO-Code) für das Land der Herstellung oder Produktion des Produkts |
Bereitgestellter HS-Code (optional) | Fügen Sie einen vorhandenen HS-Code in Ihre Klassifizierungsanfrage ein, um Ihre Anfrage zu leiten. Je nach Ihren Vorlieben und dem Ursprung Ihres bereitgestellten HS-Codes kann Classify den HS-Code validieren und seine Kohärenz mit den Beschreibungsdetails des Artikels überprüfen. Erfahren Sie mehr. |
Bestimmungsland (optional) | Identifiziert, in welches Land das Produkt klassifiziert wird. Das Bestimmungsland muss mit der zwei Buchstaben Abkürzung (ISO-Code) jedes Landes angezeigt werden und nicht mit dem tatsächlichen Ländernamen, z.B. AU, nicht Australien. Wenn Sie dieses Feld einfügen, wird Classify einen länderspezifischen HS-Code mit 8+ Ziffern anstelle des universellen 6-stelligen Codes zurückgeben. Erfahren Sie mehr über die Unterschiede zwischen universellen und länderspezifischen HS-Codes. |
Produkt-ID (optional) | Ihre Produkt-ID oder eine beliebige Nummer, die verwendet werden kann, um jedes Produkt eindeutig zu identifizieren. Wenn keine Produkt-ID bereitgestellt wird, weist Classify Produkt-IDs zu, die mit 1 beginnen |
Hinweis: Wenn Sie Ihre CSV-Massenanforderung im Dashboard hochladen, wird das Bestimmungsland nicht Teil der Vorlage sein, sondern Sie wählen Ihre Bestimmungsländer aus, nachdem Sie Ihre CSV-Massenanforderung hochgeladen haben.
Eine Klassifizierung anfordern
Um eine Klassifizierung im Dashboard oder über die API anzufordern, folgen Sie den Schritten und der Mutation unten.
Das folgende Beispiel zeigt eine universelle (6-stellige) Anfrage. Um Klassifizierungen für spezifische Länder anzufordern, fügen Sie die ISO-Codes der Länder in die Classify Anfrage ein, wie im folgenden Beispiel zu sehen ist. Um einen universellen HS-Code anzufordern, lassen Sie das Versandland in der Classify Anfrage null
.
Die Eingabe akzeptiert eine Liste, sodass Sie viele oder eine einzelne Klassifizierung auf einmal anfordern können.
MUTATION
GraphQL
mutation {
classificationsCalculate(
input: [
{
categories: "women's clothing"
imageUrl: "https://zonos.com/images/cozygloves.webp"
name: "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
configuration: { shipToCountries: KR }
}
]
) {
id
name
categories
imageUrl
hsCode {
code
description {
full
}
}
}
}
ANTWORT
JSON
{
"data": {
"classificationsCalculate": [
{
"id": "classification_313d8d9d-e330-4d79-9922-cb7a1ff317e2",
"name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
"categories": ["women's clothing"],
"imageUrl": null,
"hsCode": {
"code": "6116.99.0000",
"description": {
"full": "Articles of apparel and clothing accessories, knitted or crocheted: Gloves, mittens and mitts, knitted or crocheted: Other : Of other textile materials"
}
}
}
]
}
}
Mögliche API-Antworten
Wenn Classify eine Klassifizierungsanfrage erhält, versucht es, die im Anfrage enthaltenen Daten des Eingangsartikels mit einem Treffer in der Datenbank von Classify's basierend auf dem höchsten Vertrauensscore abzugleichen. Je nach dem, was gefunden wird, gibt Classify eine der folgenden Antworten zurück:
- Wenn
hsCode
mit einem 6 bis 8+ stelligen HS-Code zurückgegeben wird, war Ihre Klassifizierungsanfrage erfolgreich, abhängig davon, ob ein Versandland in der Anfrage enthalten war oder nicht. - Wenn
{"errors": [ { "message": "Keine angemessene Antwort"}]}
zurückgegeben wird, bedeutet das, dass Classify aufgrund unzureichender Eingabedaten keine Klassifizierung finden konnte.
Artikel klassifizieren
Erfahren Sie, wie Sie eine Klassifizierung im Dashboard und über die API anfordern.
Unten finden Sie Beispiele, die veranschaulichen, wie Sie universelle und länderspezifische Klassifizierungen über das Dashboard oder über die API anfordern können. Für diejenigen, die umfassendere technische Details und umfangreiche Dokumentation suchen, besuchen Sie unsere Zonos GraphQL API Referenz-Entwicklerseite. Diese umfassende Ressource bietet detaillierte Einblicke in API-Endpunkte, GraphQL-Mutationen und umfangreiche technische Informationen.