Bereitschaftsstatus
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 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, 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.
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) { id status missingAttributes content { name description material categories existingItemId } createdAt }}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.
Vorhandenen Artikel validieren
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.
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. 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
missingAttributesgezielt nachfragen, bevor die Daten weiterfließen. - Zollbeschreibung erzeugen — Ist ein Artikel
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. - 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.
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 selbstbewusst 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.