Klassificeringsparathed

customsDescriptionValidate-mutationen tjekker, om en vares information er tilstrækkelig til sikkert at tildele en 6-cifret HS-kode, før klassificering kører. Den returnerer en parathedsstatus, som du anvender din egen politik på — fortsæt til klassificering, advar, bed køber eller forhandler om flere detaljer, eller afvis varen.

Det er et pre-flight-tjek, ikke en klassificering: customsDescriptionValidate klassificerer ik varen og returnerer ik en HS-kode. Brug den til at fange tynde eller ubrugelige beskrivelser på forhånd, så de beskrivelser, du til sidst sender til Classify, giver præcise, antagelsesfri resultater.

Parathedstjek er dog kun ét use case. Fordi de samme varedata driver Zonos's toldbeskrivelses- og klassificeringstjenester, er denne mutation indgangen til et bredere Customs Description-workflow — gating af datakvalitet og derefter generering af en compliant toldbeskrivelse fra varen. Se Mere end et klassificeringsgate nedenfor.

Parathedsstatusser 

Hver validering returnerer én status. Statussen er vejledende — din integration afgør konsekvensen af hver værdi.

Når statussen er INCOMPLETE, returnerer feltet missingAttributes de manglende attribut(ter) som en kort sætning (f.eks. „fiber content" eller „material, construction"), der er egnet til at sammensætte en brugerorienteret besked. Det er null for enhver anden status.

Valider en vare via API 

Angiv varefelterne direkte — mindst ét beskrivende felt er påkrævet. Eksemplet nedenfor validerer en vare, hvis navn og beskrivelse identificerer den som en t-shirt, men udelader fiberindholdet, der er nødvendigt for at klassificere den, så mutationen returnerer INCOMPLETE.

Inputfelter

Angiv enten existingItemId eller varefelterne direkte — mindst ét beskrivende felt er påkrævet.

Valider en eksisterende vare 

Hvis varen allerede findes i Zonos, send dens ID som existingItemId i stedet for at gensende alle felter. Den gemte vares felter bruges som grundlag for validering, og felter du også angiver i samme input tilsidesætter de gemte værdier — nyttigt til at teste, om en redigering ville gøre en tynd vare klassificeringsparat.

Svarets content ekkoerer de varedata, der blev valideret, med existingItemId opløst, så hver gemt CustomsDescriptionValidation er selvbeskrivende.

Mere end et klassificeringsgate 

Fordi parathedsstatussen er vejledende, feeder det samme tjek mere end ét workflow — det handler ikke kun om at afgøre, om der skal klassificeres. customsDescriptionValidate evaluerer de samme varedata, som Zonos's klassificerings- og toldbeskrivelsestjenester forbruger, hvilket gør det til et naturligt første trin i et bredere Customs Description-workflow:

• Datakvalitetsgate — Vis tynd eller ubrugelig vareinformation ved indgangspunktet (i et PIM, katalogimport eller checkout) og bed om præcis det, der mangler, ved hjælp af missingAttributes, før dataene flyder downstream.
• Generer en toldbeskrivelse — Når en vare er READY, overdrag de samme data til customsDescriptionsCreate-mutationen for at få Zonos til at generere en præcis, told- og ICS2-compliant toldbeskrivelse fra varen — eventuelt med anmodning om en HS-kode i samme kald. Validering af parathed først betyder, at den genererede beskrivelse bygges på komplet information snarere end antagelser.
• Klassificer med confidence — Fortsæt til Classify velvidende, at beskrivelsen er rig nok til at tildele en præcis 6-cifret HS-kode uden gætteri.

Et typisk end-to-end flow er: valider parathed → indsaml eventuelle missingAttributes → generer en compliant toldbeskrivelse (og HS-kode) → klassificer eller indgiv.