DOCS

Kategorievalidierung

Kategorievalidierung

Prüfen Sie, ob die zugewiesenen Kategorien jeden Artikel tatsächlich beschreiben.

GraphQL

Die Mutation categoriesValidate prüft, ob die angegebenen Kategorien jedes Artikels diesen korrekt beschreiben. Für jeden Artikel liefert sie ein verdict und einen confidenceScore. Bei WRONG enthält die Antwort plausible Alternativkategorien aus dem Kategorieuniversum Ihrer Organisation.

Nutzen Sie sie, um falsch kategorisierte Artikel zu erkennen, bevor fehlerhafte Kategorien Classify, Landed Cost oder Restrict-Ergebnisse beeinflussen — und um die richtige Kategorie an den Erfasser zurückzugeben.

Urteile und Konfidenz 

Jeder Artikel in der Antwort enthält ein verdict und einen confidenceScore (0–1) als Modellkonfidenz für dieses Urteil.

VerdictBedeutung
CORRECTDer Artikel gehört plausibel in die zugewiesenen Kategorien.
WRONGDer Artikel gehört eindeutig nicht in die zugewiesenen Kategorien.

Bei WRONG ist suggestedCategories mit plausiblen Alternativen aus dem Kategorieuniversum Ihrer Organisation gefüllt. Jeder Vorschlag hat eine eigene category-Hierarchie (Root → Leaf) und einen confidence-Wert — die Modellwahrscheinlichkeit als beste Kategorie, absteigend sortiert. Bei CORRECT ist suggestedCategories leer.

Kategorien per API validieren 

Senden Sie einen oder mehrere Artikel in einer Anfrage. name und categories sind pro Artikel erforderlich; optionale Details wie description, brand, material und amount verbessern die Genauigkeit. Das Beispiel validiert zwei Artikel — einen korrekt und einen eindeutig falsch kategorisierten.

1mutation CategoriesValidate($input: [CategoryValidateInput!]!) {
2 categoriesValidate(input: $input) {
3 id
4 name
5 categories
6 verdict
7 confidenceScore
8 suggestedCategories {
9 category
10 confidence
11 }
12 }
13}

Eingabefelder

FeldTypBeschreibung
nameString!Produktname oder Kurzbeschreibung. Erforderlich.
categories[String!]!Zu validierende Kategoriehierarchie (Root → Leaf). Erforderlich.
amountDecimalPreis des Artikels.
currencyCodeCurrencyCodeWährung des Betrags.
brandStringMarke des Artikels.
descriptionStringVollständige Beschreibung des Artikels.
materialStringMaterialzusammensetzung des Artikels.
globalTradeItemNumberStringGlobal Trade Item Number (GTIN) wie UPC, EAN, GTIN-8 oder GTIN-14.
imageUrlStringURL eines zum Artikel gehörenden Bildes.

Die beschreibenden Felder werden in jeder CategoryValidation in der Antwort zurückgegeben, sodass jede gespeicherte Validierung selbsterklärend ist.

GraphQL API ReferenceTypes, inputs, and operations used in this guide

War diese Seite hilfreich?