Classificatiegereedheid

De mutatie customsDescriptionValidate controleert of de informatie van een item voldoende is om vol vertrouwen een 6-cijferige HS-code toe te wijzen, voordat de classificatie wordt uitgevoerd. Ze retourneert een gereedheidsstatus waarop u uw eigen beleid toepast—doorgaan met classificeren, waarschuwen, de shopper of handelaar om meer details vragen, of het item afwijzen.

Het is een voorafgaande controle, geen classificatie: customsDescriptionValidate classificeert het item niet en retourneert geen HS-code. Gebruik het om summiere of onbruikbare beschrijvingen vooraf op te sporen, zodat de beschrijvingen die u uiteindelijk naar Classify stuurt, nauwkeurige resultaten zonder aannames opleveren.

Het controleren van gereedheid is echter maar één toepassing. Omdat dezelfde itemgegevens de douanebeschrijving- en classificatieservices van Zonos aansturen, is deze mutatie het toegangspunt tot een bredere Customs Description-workflow—eerst de datakwaliteit bewaken, en vervolgens een conforme douanebeschrijving voor het item genereren. Zie Meer dan een classificatiepoort hieronder.

Gereedheidsstatussen 

Elke validatie retourneert één status. De status is adviserend—uw integratie bepaalt het gevolg van elke waarde.

Wanneer de status INCOMPLETE is, retourneert het veld missingAttributes het ontbrekende kenmerk (of de kenmerken) als een korte zin (bijv. "fiber content" of "material, construction") die geschikt is om een bericht voor de gebruiker samen te stellen. Voor elke andere status is dit veld null.

Item valideren via API 

Geef de itemvelden direct op—er is ten minste één beschrijvend veld vereist. Het onderstaande voorbeeld valideert een item waarvan de naam en beschrijving aangeven dat het een t-shirt is, maar waarbij de vezelsamenstelling ontbreekt die nodig is om het te classificeren, waardoor de mutatie INCOMPLETE retourneert.

Invoervelden

Geef existingItemId op, of de itemvelden direct—er is ten minste één beschrijvend veld vereist.

Bestaand item valideren 

Als het item al in Zonos bestaat, geeft u de ID op als existingItemId in plaats van elk veld opnieuw te versturen. De velden van het opgeslagen item worden als basis voor de validatie gebruikt, en alle velden die u ook in dezelfde invoer opgeeft, overschrijven de opgeslagen waarden—nuttig om te testen of een wijziging een summier item classificatiegereed zou maken.

Het antwoordveld content geeft de gevalideerde itemgegevens terug, met existingItemId opgelost, zodat elke opgeslagen CustomsDescriptionValidation zelfbeschrijvend is.

Meer dan een classificatiepoort 

Omdat de gereedheidsstatus adviserend is, voedt dezelfde controle meer dan één workflow—het gaat niet alleen om de beslissing of er wel of niet geclassificeerd moet worden. customsDescriptionValidate evalueert dezelfde itemgegevens die de classificatie- en douanebeschrijving-services van Zonos gebruiken, waardoor het een logische eerste stap is in een bredere Customs Description-workflow:

• Datakwaliteitspoort — Signaleer summiere of onbruikbare iteminformatie op het moment van invoer (in een PIM, catalogusimport of checkout) en vraag precies om wat ontbreekt met behulp van missingAttributes, voordat die gegevens verder stromen.
• Een douanebeschrijving genereren — Zodra een item READY is, geeft u dezelfde gegevens door aan de mutatie customsDescriptionsCreate zodat Zonos een beknopte douanebeschrijving van het item genereert die voldoet aan de douanevoorschriften en ICS2—optioneel met een HS-code-aanvraag in dezelfde aanroep. Door eerst de gereedheid te valideren, wordt de gegenereerde beschrijving opgebouwd uit volledige informatie in plaats van aannames.
• Vol vertrouwen classificeren — Ga verder naar Classify, wetende dat de beschrijving rijk genoeg is om een nauwkeurige 6-cijferige HS-code toe te wijzen zonder giswerk.

Een typische end-to-end-flow is: gereedheid valideren → eventuele missingAttributes verzamelen → een conforme douanebeschrijving (en HS-code) genereren → classificeren of indienen.