Klassifiseringsklarhet

Mutasjonen customsDescriptionValidate sjekker om en vares informasjon er tilstrekkelig til å trygt tildele en 6-sifret HS-kode, før klassifiseringen kjøres. Den returnerer en klarhetsstatus som du bruker din egen policy på – gå videre til klassifisering, advar, spør kjøperen eller forhandleren om mer detaljer, eller avvis varen.

Det er en pre-flight-sjekk, ikke en klassifisering: customsDescriptionValidate klassifiserer ikke varen og returnerer ikke en HS-kode. Bruk den til å avdekke tynne eller ubrukelige beskrivelser på forhånd slik at beskrivelsene du til slutt sender til Classify gir nøyaktige, antagelsesfrie resultater.

Klarhetskontroll er bare en bruk. Fordi de samme varens data driver Zonos sitt toldebeskrivelse- og klassifiseringstjenester, er denne mutasjonen inngangspunktet til et bredere Toldebeskrivelse-arbeidsflyt – som avgrenser datakvalitet og deretter genererer en kompatibel toldebeskrivelse fra varen. Se Mer enn en klassifiseringsport nedenfor.

Klarhetsstatuser 

Hver validering returnerer en status. Statusen er rådgivende – integrasjonen din bestemmer konsekvensen av hver verdi.

Når statusen er INCOMPLETE, returnerer feltet missingAttributes den manglende attributten(e) som en kort setning (f.eks. "fiberinnhold" eller "materiale, konstruksjon") som er egnet for å komponere en brukervendt melding. Det er null for enhver annen status.

Valider en vare via API 

Oppgi varefeltene direkte – minst ett beskrivende felt er påkrevd. Eksemplet nedenfor validerer en vare hvis navn og beskrivelse identifiserer den som en t-skjorte, men utelater fiberinnholdet som trengs for klassifisering, slik at mutasjonen returnerer INCOMPLETE.

Inndatafelt

Oppgi enten existingItemId eller varefeltene direkte – minst ett beskrivende felt er påkrevd.

Valider en eksisterende vare 

Hvis varen allerede finnes i Zonos, oppgi dens ID som existingItemId i stedet for å sende alle feltene på nytt. Feltene fra den lagrede varen brukes som grunnlag for validering, og eventuelle felt du også oppgir i samme inndata overstyrer de lagrede verdiene – nyttig for å teste om en redigering vil gjøre en tynn vare klassifiseringsbereit.

Responsen content gjentakelse varedata som ble validert, med existingItemId oppløst, slik at hver lagret CustomsDescriptionValidation er selvbeskriving.

Mer enn en klassifiseringsport 

Fordi klarhetsstatusen er rådgivende, fører den samme kontrollen til mer enn en arbeidsflyt – det handler ikke bare om å bestemme om du skal klassifisere. customsDescriptionValidate evaluerer de samme varedata som Zonos sitt klassifiserings- og toldebeskrivelsestjenester konsumerer, noe som gjør den til et naturlig første trinn i en bredere Toldebeskrivelse-arbeidsflyt:

• Datakvalitetsport – Avdekk tynne eller ubrukelige vareinformasjon på inngangspunktet (i en PIM, katalogimport eller kasse) og spør etter nøyaktig hva som mangler ved hjelp av missingAttributes, før dataene flyter nedstrøms.
• Generer en toldebeskrivelse – Når en vare er READY, send de samme dataene til mutasjonen customsDescriptionsCreate for å få Zonos til å generere en kortfattet, tolds- og ICS2-kompatibel toldebeskrivelse fra varen – og eventuelt be om en HS-kode i samme anrop. Å validere klarhet først betyr at den genererte beskrivelsen er bygget fra fullstendig informasjon i stedet for forutsetninger.
• Klassifiser med selvtillit – Gå videre til Classify vel vitende om at beskrivelsen er rik nok til å tildele en nøyaktig 6-sifret HS-kode uten gjetteri.

En typisk ende-til-ende-flyt er: valider klarhet → samle eventuelle missingAttributes → generer en kompatibel toldebeskrivelse (og HS-kode) → klassifiser eller arkiver.