Prüfen Sie, ob die Artikelinformationen ausreichend detailliert sind — bevor Sie einen HS-Code anfordern.
GraphQL
Die Mutation customsDescriptionValidate prüft, ob die Artikelinformationen ausreichen, um
zuverlässig einen 6-stelligen HS-Code zuzuweisen — bevor die
Klassifizierung läuft. Sie liefert einen Bereitschaftsstatus, den Sie mit eigener Policy bewerten —
weiter klassifizieren, warnen, den Käufer oder Händler um Details bitten oder den Artikel ablehnen.
Es ist eine Vorabprüfung, keine Klassifizierung: customsDescriptionValidateklassifiziert den
Artikel nicht und liefert keinen HS-Code. Nutzen Sie sie, um dünne oder unbrauchbare
Beschreibungen früh zu erkennen, damit die Beschreibungen, die Sie später an Classify
senden, genaue, annahmefreie Ergebnisse liefern.
Bereitschaftsprüfung ist nur ein Anwendungsfall. Da dieselben Artikeldaten Zonos-Dienste für
Zollbeschreibungen und Klassifizierung speisen, ist diese Mutation der Einstieg in einen breiteren
Customs Description-Workflow — Datenqualität sichern,
dann eine konforme Zollbeschreibung aus dem Artikel erzeugen. Siehe
Mehr als ein Klassifizierungs-Gate.
Jede Validierung liefert einen status. Der Status ist beratend — Ihre Integration legt die
Konsequenz jedes Werts fest.
Status↕
Bedeutung↕
Empfohlene Aktion↕
READY
Die Informationen reichen, um einen 6-stelligen HS-Code zuverlässig und ohne Annahmen zuzuweisen.
Weiter zur Klassifizierung.
INCOMPLETE
Der Artikel ist identifizierbar, aber ein entscheidendes Attribut fehlt — Klassifizierung würde Annahmen erfordern.
Fordern Sie das in missingAttributes genannte Attribut an und wiederholen Sie.
UNRECOGNIZABLE
Der Text legt nicht fest, was der Artikel grundsätzlich ist — leere Werte, bloße SKUs oder interne Codes, oder Unsinn.
Bitten Sie den Nutzer, den Artikel neu einzugeben.
Bei INCOMPLETE liefert missingAttributes die fehlenden Attribute als kurze Phrase (z. B.
"fiber content" oder "material, construction") für nutzerfreundliche Meldungen. Für alle
anderen Status ist es null.
Übergeben Sie die Artikelfelder direkt — mindestens ein beschreibendes Feld ist erforderlich. Das
Beispiel validiert einen Artikel, dessen Name und Beschreibung ein T-Shirt identifizieren, aber den
für die Klassifizierung nötigen Fasergehalt auslassen — die Mutation liefert INCOMPLETE.
1mutationCustomsDescriptionValidate(
2$input: CustomsDescriptionValidationInput!
3){
4 customsDescriptionValidate(input:$input) {
5 id
6 status
7 missingAttributes
8 content {
9 name
10 description
11 material
12 categories
13 existingItemId
14}
15 createdAt
16}
17}
Eingabefelder
Feld↕
Typ↕
Beschreibung↕
name
String
Name des Artikels.
description
String
Menschenlesbare Beschreibung des Artikels.
material
String
Material oder Zusammensetzung, falls bekannt (z. B. "55% cotton, 45% polyester").
categories
[String!]
Kategorien, die den Artikel beschreiben.
existingItemId
ID
ID eines vorhandenen Item zur Validierung. Gespeicherte Felder werden verwendet; hier übergebene Felder überschreiben gespeicherte Werte.
Übergeben Sie entweder existingItemId oder die Artikelfelder direkt — mindestens ein
beschreibendes Feld ist erforderlich.
Existiert der Artikel bereits in Zonos, übergeben Sie seine ID als existingItemId statt alle
Felder erneut zu senden. Gespeicherte Felder dienen als Validierungsbasis; zusätzlich übergebene
Felder überschreiben gespeicherte Werte — nützlich zum Testen, ob eine Bearbeitung einen dünnen
Artikel klassifizierungsbereit macht.
Die content-Antwort gibt die validierten Artikeldaten zurück, mit aufgelöstem existingItemId,
sodass jede gespeicherte CustomsDescriptionValidation selbsterklärend ist.
Da der Bereitschaftsstatus beratend ist, speist dieselbe Prüfung mehr als einen Workflow — es geht
nicht nur um die Klassifizierungsentscheidung. customsDescriptionValidate bewertet dieselben
Artikeldaten wie Zonos-Klassifizierungs- und Zollbeschreibungsdienste und ist damit ein natürlicher
erster Schritt in einem breiteren Customs Description-Workflow:
Datenqualitäts-Gate — Dünne oder unbrauchbare Artikelinformationen beim Einstieg (PIM,
Katalogimport oder Checkout) erkennen und mit missingAttributes gezielt nachfragen, bevor die
Daten weiterfließen.
Zollbeschreibung erzeugen — Ist ein Artikel READY, übergeben Sie dieselben Daten an
customsDescriptionsCreate, damit Zonos eine prägnante, zoll- und ICS2-konforme
Zollbeschreibung erzeugt — optional mit HS-Code in derselben Anfrage. Vorab-Validierung stellt
sicher, dass die Beschreibung aus vollständigen Informationen statt Annahmen entsteht.
Mit Vertrauen klassifizieren — Fahren Sie mit Classify fort,
in dem Wissen, dass die Beschreibung reich genug für einen genauen 6-stelligen HS-Code ohne
Raten ist.
Ein typischer End-to-End-Ablauf: Bereitschaft validieren → missingAttributes erfassen → konforme
Zollbeschreibung (und HS-Code) erzeugen → klassifizieren oder einreichen.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Klassifizierungsbereitschaft
Klassifizierungsbereitschaft
Prüfen Sie, ob die Artikelinformationen ausreichend detailliert sind — bevor Sie einen HS-Code anfordern.
GraphQL
Die Mutation
customsDescriptionValidateprüft, ob die Artikelinformationen ausreichen, um zuverlässig einen 6-stelligen HS-Code zuzuweisen — bevor die Klassifizierung läuft. Sie liefert einen Bereitschaftsstatus, den Sie mit eigener Policy bewerten — weiter klassifizieren, warnen, den Käufer oder Händler um Details bitten oder den Artikel ablehnen.Es ist eine Vorabprüfung, keine Klassifizierung:
customsDescriptionValidateklassifiziert den Artikel nicht und liefert keinen HS-Code. Nutzen Sie sie, um dünne oder unbrauchbare Beschreibungen früh zu erkennen, damit die Beschreibungen, die Sie später an Classify senden, genaue, annahmefreie Ergebnisse liefern.Bereitschaftsprüfung ist nur ein Anwendungsfall. Da dieselben Artikeldaten Zonos-Dienste für Zollbeschreibungen und Klassifizierung speisen, ist diese Mutation der Einstieg in einen breiteren Customs Description-Workflow — Datenqualität sichern, dann eine konforme Zollbeschreibung aus dem Artikel erzeugen. Siehe Mehr als ein Klassifizierungs-Gate.
Bereitschaftsstatus
Jede Validierung liefert einen
status. Der Status ist beratend — Ihre Integration legt die Konsequenz jedes Werts fest.READYINCOMPLETEmissingAttributesgenannte Attribut an und wiederholen Sie.UNRECOGNIZABLEBei
INCOMPLETEliefertmissingAttributesdie fehlenden Attribute als kurze Phrase (z. B."fiber content"oder"material, construction") für nutzerfreundliche Meldungen. Für alle anderen Status ist esnull.Artikel per API validieren
Übergeben Sie die Artikelfelder direkt — mindestens ein beschreibendes Feld ist erforderlich. Das Beispiel validiert einen Artikel, dessen Name und Beschreibung ein T-Shirt identifizieren, aber den für die Klassifizierung nötigen Fasergehalt auslassen — die Mutation liefert
INCOMPLETE.mutation CustomsDescriptionValidate($input: CustomsDescriptionValidationInput!) {customsDescriptionValidate(input: $input) {idstatusmissingAttributescontent {namedescriptionmaterialcategoriesexistingItemId}createdAt}}Eingabefelder
nameStringdescriptionStringmaterialString"55% cotton, 45% polyester").categories[String!]existingItemIdIDItemzur Validierung. Gespeicherte Felder werden verwendet; hier übergebene Felder überschreiben gespeicherte Werte.Übergeben Sie entweder
existingItemIdoder die Artikelfelder direkt — mindestens ein beschreibendes Feld ist erforderlich.Vorhandenen Artikel validieren
Existiert der Artikel bereits in Zonos, übergeben Sie seine ID als
existingItemIdstatt alle Felder erneut zu senden. Gespeicherte Felder dienen als Validierungsbasis; zusätzlich übergebene Felder überschreiben gespeicherte Werte — nützlich zum Testen, ob eine Bearbeitung einen dünnen Artikel klassifizierungsbereit macht.Die
content-Antwort gibt die validierten Artikeldaten zurück, mit aufgelöstemexistingItemId, sodass jede gespeicherteCustomsDescriptionValidationselbsterklärend ist.Mehr als ein Klassifizierungs-Gate
Da der Bereitschaftsstatus beratend ist, speist dieselbe Prüfung mehr als einen Workflow — es geht nicht nur um die Klassifizierungsentscheidung.
customsDescriptionValidatebewertet dieselben Artikeldaten wie Zonos-Klassifizierungs- und Zollbeschreibungsdienste und ist damit ein natürlicher erster Schritt in einem breiteren Customs Description-Workflow:missingAttributesgezielt nachfragen, bevor die Daten weiterfließen.READY, übergeben Sie dieselben Daten ancustomsDescriptionsCreate, damit Zonos eine prägnante, zoll- und ICS2-konforme Zollbeschreibung erzeugt — optional mit HS-Code in derselben Anfrage. Vorab-Validierung stellt sicher, dass die Beschreibung aus vollständigen Informationen statt Annahmen entsteht.Ein typischer End-to-End-Ablauf: Bereitschaft validieren →
missingAttributeserfassen → konforme Zollbeschreibung (und HS-Code) erzeugen → klassifizieren oder einreichen.CustomsDescriptionValidationInput
customsDescriptionValidate
War diese Seite hilfreich?