Gotowość do klasyfikacji

Mutacja customsDescriptionValidate sprawdza, czy informacje o przedmiocie są wystarczające do pewnego przypisania 6-cyfrowego kodu HS, zanim rozpocznie się klasyfikacja. Zwraca status gotowości, do którego stosujesz własną politykę — przejdź do klasyfikacji, ostrzeż, poproś sprzedającego lub kupującego o więcej szczegółów, albo odrzuć przedmiot.

Jest to wstępna kontrola, nie klasyfikacja: customsDescriptionValidate nie klasyfikuje przedmiotu i nie zwraca kodu HS. Użyj jej, aby wychwycić słabe lub nieużyteczne opisy z wyprzedzeniem, aby opisy, które ostatecznie wyślesz do Classify, dały dokładne, wolne od założeń wyniki.

Sprawdzanie gotowości to tylko jedno zastosowanie. Ponieważ te same dane przedmiotu napędzają usługi opisu celnego i klasyfikacji Zonos, mutacja ta jest punktem wejścia do szerszego przepływu pracy Customs Description — kontrolując jakość danych, a następnie generując zgodny opis celniczny z przedmiotu. Zobacz Więcej niż brama klasyfikacji poniżej.

Statusy gotowości 

Każda walidacja zwraca jeden status. Status jest poradniczy — integracja decyduje o konsekwencjach każdej wartości.

Gdy status to INCOMPLETE, pole missingAttributes zwraca brakujące atrybuty jako krótkie wyrażenie (np. "fiber content" lub "material, construction"), które jest odpowiednie do skomponowania wiadomości dla użytkownika. Jest null dla każdego innego statusu.

Waliduj przedmiot za pośrednictwem API 

Podaj pola przedmiotu bezpośrednio — wymagane jest co najmniej jedno pole opisowe. Poniższy przykład waliduje przedmiot, którego nazwa i opis identyfikują go jako t-shirt, ale pomijają zawartość włókna potrzebną do klasyfikacji, więc mutacja zwraca INCOMPLETE.

Pola wejściowe

Podaj albo existingItemId, albo pola przedmiotu bezpośrednio — wymagane jest co najmniej jedno pole opisowe.

Waliduj istniejący przedmiot 

Jeśli przedmiot już istnieje w Zonos, przekaż jego ID jako existingItemId zamiast ponownie wysyłać każde pole. Pola przechowywane przedmiotu są używane jako podstawa walidacji, a wszystkie pola dostarczone w tym samym wejściu zastępują przechowywane wartości — przydatne do testowania, czy edycja uczyniłaby słaby przedmiot gotowym do klasyfikacji.

Odpowiedź content odzwierciedla dane przedmiotu, które zostały zwalidowane, z rozwiązanym existingItemId, więc każda przechowywana CustomsDescriptionValidation jest samodzielnie opisana.

Więcej niż brama klasyfikacji 

Ponieważ status gotowości jest poradniczy, ta sama kontrola zasila więcej niż jeden przepływ pracy — nie chodzi tylko o podjęcie decyzji, czy klasyfikować. customsDescriptionValidate ocenia te same dane przedmiotu, które konsumują usługi klasyfikacji i opisu celnego Zonos, co czyni ją naturalnym pierwszym krokiem w szerszym przepływie pracy Customs Description:

• Brama kontroli jakości — Wyświetl słabe lub nieużyteczne informacje o przedmiocie w punkcie wejścia (w PIM, imporcie katalogu lub podczas kasy) i poproś o dokładnie to, czego brakuje, korzystając z missingAttributes, zanim te dane popłyną dalej.
• Generuj opis celniczny — Gdy przedmiot jest READY, przekaż te same dane do mutacji customsDescriptionsCreate, aby Zonos wygenerował zwięzły, zgodny z przepisami celnymi i ICS2 opis celniczny z przedmiotu — opcjonalnie żądając kodu HS w tym samym wywołaniu. Walidacja gotowości z wyprzedzeniem oznacza, że wygenerowany opis jest zbudowany na kompletnych informacjach, a nie założeniach.
• Klasyfikuj z pewnością — Przejdź do Classify wiedząc, że opis jest wystarczająco bogaty, aby przypisać dokładny 6-cyfrowy kod HS bez zgadywania.

Typowy przepływ end-to-end to: waliduj gotowość → zbieraj wszelkie missingAttributes → wygeneruj zgodny opis celniczny (i kod HS) → klasyfikuj lub zgłoś.