DOCS

Categorievalidatie

Controleer of de toegewezen categorieën per item het item daadwerkelijk beschrijven.

GraphQL

De categoriesValidate-mutatie valideert of de opgegeven categorieën van elk item het item correct beschrijven. Voor elk item dat je indient, retourneert deze mutatie een verdict en een confidenceScore. Als het verdict WRONG is, retourneert het antwoord ook plausibele alternatieve categorieën uit het categorie-universum van je organisatie.

Gebruik dit om verkeerd gecategoriseerde items te signaleren voordat onjuiste categorieën gevolgen hebben voor latere classificatie, landed cost of restrictieresultaten—en om de juiste categorie terug te suggereren aan degene die het item heeft ingevoerd.

Verdicts en zekerheid 

Elk item in het antwoord heeft een verdict en een confidenceScore (0–1) die de zekerheid van het model over dat verdict uitdrukt.

VerdictBetekenis
CORRECTHet item behoort waarschijnlijk tot de toegewezen categorieën.
WRONGHet item behoort duidelijk niet tot de toegewezen categorieën.

Als het verdict WRONG is, wordt suggestedCategories gevuld met plausibele alternatieven uit het categorie-universum van je organisatie. Elke suggestie heeft zijn eigen category-hiërarchie (root → leaf) en een confidence-score—de kans volgens het model dat dit de best passende categorie is, aflopend gesorteerd. Als het verdict CORRECT is, is suggestedCategories leeg.

Categorieën valideren via API 

Dien een of meer items in met één verzoek. name en categories zijn verplicht voor elk item; het toevoegen van optionele details zoals description, brand, material en amount verbetert de nauwkeurigheid. Het onderstaande voorbeeld valideert twee items—één correct gecategoriseerd en één duidelijk verkeerd gecategoriseerd.

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}

Invoervelden

VeldTypeBeschrijving
nameString!De productnaam of korte beschrijving. Verplicht.
categories[String!]!De categoriehiërarchie (root → leaf) om te valideren. Verplicht.
amountDecimalDe prijs van het item.
currencyCodeCurrencyCodeDe valuta waarin het bedrag is uitgedrukt.
brandStringHet merk van het item.
descriptionStringDe volledige beschrijving die bij het item hoort.
materialStringDe materiaalsamenstelling van het item.
globalTradeItemNumberStringEen Global Trade Item Number (GTIN), zoals UPC, EAN, GTIN-8 of GTIN-14.
imageUrlStringDe locatie van een afbeelding die bij het item hoort.

De beschrijvende velden worden teruggegeven op elke CategoryValidation in het antwoord, zodat elke opgeslagen validatie zelfbeschrijvend is.

GraphQL API ReferenceTypes, inputs, and operations used in this guide
Boek een demo

Was deze pagina nuttig?