DOCS
HemFör logistikleverantörer Category Validation

Category Validation

Kontrollera om artiklarnas tilldelade kategorier passar produkten, och få bättre kategoriförslag när de inte gör det.

Kategorivalidering 

Produktkategorier beskriver vad en artikel är, vanligtvis som en hierarki från en bred rot till ett specifikt blad — till exempel ["Footwear", "Athletic", "Running Shoes"]. Korrekta kategorier håller er katalog ren och matar efterföljande processer som klassificering och handelscompliance, där en felkategoriserad artikel kan ge fel resultat.

Kataloger samlar på sig kategorifel över tid — från manuell inmatning, leverantörsflöden eller migreringar mellan system. Zonos Category Validation kontrollerar om kategorierna som tilldelats en artikel faktiskt beskriver den artikeln, och när de inte gör det föreslår den bättre kategorier hämtade från de kategorier er organisation redan använder.

Så fungerar det 

Zonos Category Validation använder AI för att bedöma om den kategorihierarki ni anger korrekt beskriver en artikel, baserat på artikelns name och eventuella ytterligare detaljer ni anger, såsom brand, material och description.

För varje artikel returneras en verdict med värdet CORRECT eller WRONG tillsammans med en konfidenspoäng. När utlåtandet är WRONG returneras en rankad lista med föreslagna kategorier så att ni kan korrigera tilldelningen. Förslag hämtas från er organisations kategoriträd — den uppsättning kategorivägar er organisation använder — och alla kategorier ni skickar in läggs till i trädet automatiskt, så att ett välskött träd ger bättre förslag över tid.

Detta är en batch-endpoint — ni kan validera många artiklar i en enda begäran, och resultaten returneras i samma ordning som indata.

Utlåtande och konfidens 

Varje resultat innehåller en verdict:

  • CORRECT — artikeln hör plausibelt hemma i de tilldelade kategorierna.
  • WRONG — artikeln hör inte hemma i de tilldelade kategorierna.

Varje resultat innehåller också en confidenceScore mellan 0.0 och 1.0 som anger hur säker modellen är på det utlåtande den returnerade. Poängen speglar säkerhet i själva utlåtandet, så ett säkert WRONG-resultat har en hög confidenceScore precis som ett säkert CORRECT-resultat. När utlåtandet är WRONG innehåller listan suggestedCategories alternativa kategorihierarkier, var och en med ett confidence-värde och sorterade från mest till minst sannolika. När utlåtandet är CORRECT är suggestedCategories tom.

Vi rekommenderar att ni använder konfidenspoängen för att avgöra vilka resultat som ska accepteras automatiskt och vilka som ska skickas till manuell granskning.

Validera kategorier 

För att validera kategorier använder ni mutationen categoriesValidate. Varje artikel kräver ett name och hierarkin categories som ska valideras. Ni kan valfritt inkludera brand, material, description, amount, currencyCode, globalTradeItemNumber och imageUrl för att förbättra noggrannheten. Skicka in flera artiklar i en enda begäran för att validera i bulk.

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}

I exemplet ovan bekräftas den första artikelns kategorier som CORRECT med hög konfidens och utan förslag. Den andra artikeln flaggas säkert som WRONG, och listan suggestedCategories föreslår bättre passande kategorier rankade efter konfidens.

Hantera ert kategoriträd 

Er organisations kategoriträd är den uppsättning kategorivägar Zonos vet att er organisation använder. Category Validation hämtar sina suggestedCategories från detta träd, så att hålla det korrekt och komplett förbättrar direkt kvaliteten på förslagen. Kategorier ni skickar in till categoriesValidate läggs till i trädet automatiskt, men ni kan också hantera det direkt.

Varje kategori är en hierarki lagrad som en path-array, från bred rot till specifikt blad — till exempel ["Footwear", "Athletic", "Running Shoes"].

Lista era kategorier

Använd frågan categories för att hämta er organisations kategoriträd. Resultaten är paginerade.

1query Categories {
2 categories(first: 50) {
3 totalCount
4 edges {
5 node {
6 id
7 path
8 }
9 }
10 }
11}

Lägg till kategorier

Använd mutationen categoriesCreate för att lägga till en eller flera kategorivägar i ert träd. Det är användbart för att så trädet före validering så att förslag kan dra nytta av er fulla taxonomi.

1mutation CategoriesCreate($input: [CategoryCreateInput!]!) {
2 categoriesCreate(input: $input) {
3 id
4 path
5 }
6}

Uppdatera eller ta bort kategorier

Använd mutationen categoryUpdate för att korrigera en kategoris path via dess id, eller mutationen categoryDelete för att ta bort en kategori som inte längre gäller. Att rensa bort föråldrade eller felaktiga kategorier håller förslagen relevanta.

1mutation CategoryUpdate($input: CategoryUpdateInput!) {
2 categoryUpdate(input: $input) {
3 id
4 path
5 }
6}

För att ta bort en kategori skickar ni dess id till mutationen categoryDelete. Den returnerar SUCCESS eller FAILURE.

1mutation CategoryDelete($id: ID!) {
2 categoryDelete(id: $id)
3}
GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

CategoryCreateInput CategoryUpdateInput CategoryValidateInput

MUTATIONS

categoriesCreate categoriesValidate categoryDelete categoryUpdate

Var den här sidan till hjälp?

Få support·Juridiska dokument·© 2026 Zonos
På den här sidan:
  • Category Validation
  • Kategorivalidering
  • Så fungerar det
  • Utlåtande och konfidens
  • Validera kategorier
  • Hantera ert kategoriträd