Dlaczego kompletny opis celny ma znaczenie
Każda międzynarodowa przesyłka wymaga kodu HS, a kod ten jest wart tylko tyle, ile jest wart opis, z którego pochodzi. Klasyfikacja HS wpływa na odprawę celną oraz na obliczanie taryf i podatków, dlatego opis na fakturze handlowej musi wyraźnie mówić, czym jest towar i z czego jest wykonany.
Gdy opis jest niejasny lub dwuznaczny, klasyfikacja musi uzupełnić luki przypuszczeniami — a przypuszczony szczegół może prowadzić do błędnego kodu HS. Błędny kod oznacza błędne taryfy i podatki oraz zwiększa ryzyko opóźnień w odprawie, grzywien i innych problemów ze zgodnością.
Walidacja Opisu Celnego pozwala wychwycić słaby opis z wyprzedzeniem, już w momencie wprowadzania danych, zamiast odkrywać problem po tym, jak towar został już sklasyfikowany na podstawie domysłu. Gdy coś brakuje, dokładnie mówi, o jaki szczegół poprosić klienta — dzięki czemu możesz naprawić opis, zanim trafi do klasyfikacji. Gdy będziesz gotowy wygenerować sam opis, zobacz Opis Celny; aby przypisać kod HS, zobacz Klasyfikuj.
Jak to działa
Przesyłasz posiadane pola opisowe towaru — name, description, material i categories. Walidacja ocenia, czy te informacje są wystarczająco szczegółowe, aby wylądować na jednym kodzie HS bez założenia niepodanego faktu, takiego jak zawartość włókna, czy tkanina jest dzianiną czy tkaniną tkaną, czy przeznaczenie towaru.
Zwraca status, który mówi, jak gotowy jest opis, oraz — gdy coś brakuje — listę clarifications, która mówi dokładnie, o co poprosić.
Walidacja nie klasyfikuje towaru i nie zwraca kodu HS. status ma charakter doradczy: ty decydujesz, co z nim zrobić, na podstawie własnej polityki — przejść do klasyfikacji, ostrzec, poprosić klienta o więcej szczegółów lub odrzucić towar.
Dwa opcjonalne wejścia rozszerzają sprawdzenie:
existingItemId— sprawdź towar, który już przechowujesz, zamiast przesyłać jego pola bezpośrednio. Wszystkie pola, które również podasz, zastępują przechowywane wartości.shipToCountry— gdy jest podana, walidacja sprawdza również, czy opis jest wystarczająco szczegółowy, aby wybrać taryfę specyficzną dla danego kraju, a nie tylko sześciocyfrową podpozycję HS.
Statusy gotowości
Pole status zwraca jedną z czterech wartości.
| Status↕ | Znaczenie↕ | Zalecana akcja↕ |
|---|---|---|
READY | Informacja jest wystarczająca do pewnego określenia kodu HS bez założeń. clarifications jest puste. | Przejdź do klasyfikacji. |
INCOMPLETE | Towar jest identyfikowalny, ale wybór między możliwymi podpozycjami HS wymagałby założenia niepodanego szczegółu. | Poproś klienta o szczegół w clarifications, następnie ponownie waliduj lub klasyfikuj. |
READY_TO_SUBHEADING | Sześciocyfrowa podpozycja jest pewnie określona, ale brakuje szczegółu, aby wybrać właściwą taryfę specyficzną dla kraju. Możliwe tylko gdy shipToCountry było dostarczone. | Opcjonalnie zbierz dodatkowy szczegół dla dokładnych taryf lub przejdź na poziomie podpozycji. |
UNRECOGNIZABLE | Tekst nie określa, czym zasadniczo jest towar — na przykład pusta wartość, sam numer SKU lub kod wewnętrzny, lub ciąg znaków bez sensu. | Poproś klienta o ponowne wprowadzenie towaru. |
Wyjaśnienia
Kiedykolwiek status nie jest READY, lista clarifications zawiera krótkie, konkretne frazy opisujące, co dodać do opisu — na przykład, "określ główną zawartość włókna". Te frazy są napisane tak, aby można je pokazać bezpośrednio klientowi, więc dobrą praktyką jest wyświetlanie ich w momencie wprowadzania danych i proszenie o brakujące szczegóły, zanim użytkownik przejdzie dalej.
Gdy status to READY, clarifications jest puste.
Waliduj opis celny
Użyj mutacji customsDescriptionValidate. Podaj bezpośrednio pola towaru lub odwołaj się do przechowywanego towaru za pomocą existingItemId. Minimum obejmuje jedno pole opisowe.
mutation CustomsDescriptionValidate($input: CustomsDescriptionValidationInput!) { customsDescriptionValidate(input: $input) { status clarifications content { name description material categories } }}W powyższym przykładzie towar jest wyraźnie identyfikowalny jako bluzka, ale odzież jest klasyfikowana częściowo według materiału i konstrukcji — więc wybranie właściwego kodu HS wymagałoby założenia. Status to INCOMPLETE, i clarifications dokładnie mówi, o co poprosić klienta. Gdy te szczegóły są dodane, ten sam towar waliduje się jako READY.
Przejrzyj przykład READY
Opis, który już zawiera decydujące atrybuty, waliduje się jako READY bez wyjaśnień.
{ "input": { "name": "Men's crew-neck t-shirt", "material": "100% combed cotton, knit", "categories": [ "Apparel", "Tops" ] }}Przejrzyj przykład specyficzny dla kraju
Dodanie shipToCountry sprawdza gotowość aż do taryfowej linii przeznaczenia. Tutaj sześciocyfrowa podpozycja jest już określona, więc status to READY_TO_SUBHEADING i clarifications opisują, co jest potrzebne do wybrania dokładnej linii taryfowej.
{ "input": { "name": "Pullover sweater", "material": "100% cotton, knit", "categories": [ "Apparel", "Tops" ], "shipToCountry": "US" }}
Walidacja Opisu Celnego
Sprawdź, czy opis towaru jest wystarczająco kompletny, aby pewnie go sklasyfikować — przed klasyfikacją.