Beredskapsstatusar
Varje validering returnerar en status. Statusen är rådgivande — er integration avgör konsekvensen av varje värde.
| Status↕ | Betydelse↕ | Föreslagen åtgärd↕ |
|---|---|---|
READY | Informationen räcker för att säkert tilldela en 6-siffrig HS-kod utan antaganden. | Fortsätt till klassificering. |
INCOMPLETE | Artikeln är identifierbar, men ett avgörande attribut saknas, så en klassificering skulle bygga på antaganden. | Be om attributet som anges i missingAttributes, och försök igen. |
UNRECOGNIZABLE | Texten etablerar inte vad artikeln i grunden är — tomma värden, bara SKU:er eller interna koder, eller nonsens. | Be användaren att ange artikeln igen. |
När statusen är INCOMPLETE returnerar fältet missingAttributes det/de saknade attributen som en kort fras (t.ex. "fiber content" eller "material, construction") som lämpar sig för ett användarvändt meddelande. Det är null för alla andra statusar.
Validera en artikel via API
Ange artikelfälten direkt — minst ett beskrivande fält krävs. Exemplet nedan validerar en artikel vars namn och beskrivning identifierar den som en t-shirt men utelämnar fiberinnehållet som behövs för att klassificera den, så mutationen returnerar INCOMPLETE.
mutation CustomsDescriptionValidate($input: CustomsDescriptionValidationInput!) { customsDescriptionValidate(input: $input) { id status missingAttributes content { name description material categories existingItemId } createdAt }}Indatafält
| Fält↕ | Typ↕ | Beskrivning↕ |
|---|---|---|
name | String | Artikelns namn. |
description | String | Människoläsbar beskrivning av artikeln. |
material | String | Artikelns material eller sammansättning, om känt (t.ex. "55% cotton, 45% polyester"). |
categories | [String!] | Kategorier som är kopplade till och beskriver artikeln. |
existingItemId | ID | ID för en befintlig Item att validera. När den anges används den lagrade artikelns fält och eventuella fält som anges här åsidosätter de lagrade värdena. |
Ange antingen existingItemId eller artikelfälten direkt — minst ett beskrivande fält krävs.
Validera en befintlig artikel
Om artikeln redan finns i Zonos, skicka dess ID som existingItemId i stället för att skicka om varje fält. Den lagrade artikelns fält används som bas för valideringen, och eventuella fält ni också anger i samma indata åsidosätter de lagrade värdena — användbart för att testa om en redigering skulle göra en tunn artikel klassificeringsredo.
Svarets content speglar de artikeldata som validerades, med existingItemId upplöst, så varje lagrad CustomsDescriptionValidation är självbeskrivande.
Mer än en klassificeringsgate
Eftersom beredskapsstatusen är rådgivande matar samma kontroll mer än ett arbetsflöde — det handlar inte bara om att avgöra om ni ska klassificera. customsDescriptionValidate utvärderar samma artikeldata som Zonos klassificerings- och tullbeskrivningstjänster konsumerar, vilket gör den till ett naturligt första steg i ett bredare Customs Description-arbetsflöde:
- Datakvalitetsgate — Lyft fram tunn eller oanvändbar artikelinformation vid inmatningspunkten (i ett PIM, katalogimport eller checkout) och be om exakt det som saknas med
missingAttributes, innan dessa data flödar vidare. - Generera en tullbeskrivning — När en artikel är
READY, skicka samma data till mutationencustomsDescriptionsCreateså att Zonos genererar en koncis, tull- och ICS2-godkänd tullbeskrivning från artikeln — eventuellt med begäran om en HS-kod i samma anrop. Att validera beredskap först betyder att den genererade beskrivningen byggs från komplett information snarare än antaganden. - Klassificera med trygghet — Fortsätt till Classify med vetskapen att beskrivningen är tillräckligt rik för att tilldela en korrekt 6-siffrig HS-kod utan gissningar.
Ett typiskt end-to-end-flöde är: validera beredskap → samla in eventuella missingAttributes → generera en godkänd tullbeskrivning (och HS-kod) → klassificera eller lämna in.
Klassificeringsberedskap
Kontrollera om en artikels information är tillräckligt detaljerad för att klassificera — innan ni begär en HS-kod.
GraphQL
Mutationen
customsDescriptionValidatekontrollerar om en artikels information räcker för att säkert tilldela en 6-siffrig HS-kod, innan klassificering körs. Den returnerar en beredskapsstatus som ni tillämpar er egen policy på — fortsätt till klassificering, varna, be kunden eller handlaren om mer detalj, eller avvisa artikeln.Det är en pre-flight-kontroll, inte en klassificering:
customsDescriptionValidateklassificerar inte artikeln och returnerar inte en HS-kod. Använd den för att fånga tunna eller oanvändbara beskrivningar i förväg så att beskrivningarna ni slutligen skickar till Classify ger korrekta resultat utan antaganden.Beredskapskontroll är bara ett användningsområde. Eftersom samma artikeldata driver Zonos tullbeskrivnings- och klassificeringstjänster är den här mutationen ingången till ett bredare Customs Description-arbetsflöde — gate:a datakvalitet och generera sedan en godkänd tullbeskrivning från artikeln. Se Mer än en klassificeringsgate nedan.