Statusy gotowości
Każda walidacja zwraca jeden status. Status jest poradniczy — integracja decyduje o konsekwencjach każdej wartości.
| Status↕ | Znaczenie↕ | Sugerowana akcja↕ |
|---|---|---|
READY | Informacje są wystarczające do pewnego przypisania 6-cyfrowego kodu HS bez żadnych założeń. | Przejdź do klasyfikacji. |
INCOMPLETE | Przedmiot jest identyfikowalny, ale brakuje rozstrzygającego atrybutu, więc klasyfikacja opierałaby się na założeniach. | Poproś o atrybut wymieniony w missingAttributes, a następnie spróbuj ponownie. |
UNRECOGNIZABLE | Tekst nie ustala, czym jest przedmiot — puste wartości, bare SKU lub kody wewnętrzne, albo bełkot. | Poproś użytkownika o ponowne wprowadzenie przedmiotu. |
Gdy status to INCOMPLETE, pole missingAttributes zwraca brakujące atrybuty jako krótkie wyrażenie (np. "zawartość włókna" lub "materiał, konstrukcja"), 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.
mutation CustomsDescriptionValidate($input: CustomsDescriptionValidationInput!) { customsDescriptionValidate(input: $input) { id status missingAttributes content { name description material categories existingItemId } createdAt }}Pola wejściowe
| Pole↕ | Typ↕ | Opis↕ |
|---|---|---|
name | String | Nazwa przedmiotu. |
description | String | Czytelny dla człowieka opis przedmiotu. |
material | String | Materiał lub skład przedmiotu, jeśli jest znany (np. "55% bawełna, 45% poliester"). |
categories | [String!] | Kategorie powiązane z przedmiotem i go opisujące. |
existingItemId | ID | ID istniejącego Item do walidacji. Po podaniu, pola przechowywane przedmiotu są używane, a wszystkie pola dostarczone tutaj zastępują przechowywane wartości. |
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 echuje 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 monit o dokładnie to, co brakuje, używając
missingAttributes, zanim te dane przepłyną w dół linii. - Generuj opis celniczny — Gdy przedmiot jest
READY, przekaż te same dane do mutacjicustomsDescriptionsCreate, aby Zonos wygenerował zwięzły, zgodny z celnicą 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ś.
Gotowość do klasyfikacji
Sprawdź, czy informacje o przedmiocie są wystarczająco szczegółowe do klasyfikacji — zanim poprosisz o kod HS.
GraphQL
Mutacja
customsDescriptionValidatesprawdza, czy informacje o przedmiocie są wystarczające do pewnego przypisania 6-cyfrowego kodu HS, zanim rozpocznie się klasyfikacja. Zwraca status gotowości, który stosujesz do własnej polityki — 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:
customsDescriptionValidatenie 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.