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.
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.
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.
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.
Użyj mutacji customsDescriptionValidate. Podaj bezpośrednio pola towaru lub odwołaj się do przechowywanego towaru za pomocą existingItemId. Minimum obejmuje jedno pole opisowe.
1mutationCustomsDescriptionValidate(
2$input: CustomsDescriptionValidationInput!
3){
4 customsDescriptionValidate(input:$input) {
5 status
6 clarifications
7 content {
8 name
9 description
10 material
11 categories
12}
13}
14}
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ń.
1{
2"input":{
3"name":"Men's crew-neck t-shirt",
4"material":"100% combed cotton, knit",
5"categories":[
6"Apparel",
7"Tops"
8]
9}
10}
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.
1{
2"input":{
3"name":"Pullover sweater",
4"material":"100% cotton, knit",
5"categories":[
6"Apparel",
7"Tops"
8],
9"shipToCountry":"US"
10}
11}
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Walidacja Opisu Celnego
Walidacja Opisu Celnego
Sprawdź, czy opis towaru jest wystarczająco kompletny, aby pewnie go sklasyfikować — przed klasyfikacją.
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,materialicategories. 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.
statusma 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
statuszwraca jedną z czterech wartości.READYclarificationsjest puste.INCOMPLETEclarifications, następnie ponownie waliduj lub klasyfikuj.READY_TO_SUBHEADINGshipToCountrybyło dostarczone.UNRECOGNIZABLEWyjaśnienia
Kiedykolwiek status nie jest
READY, listaclarificationszawiera 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,clarificationsjest 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) {statusclarificationscontent {namedescriptionmaterialcategories}}}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, iclarificationsdokładnie mówi, o co poprosić klienta. Gdy te szczegóły są dodane, ten sam towar waliduje się jakoREADY.Przejrzyj przykład READY
Opis, który już zawiera decydujące atrybuty, waliduje się jako
READYbez 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
shipToCountrysprawdza gotowość aż do taryfowej linii przeznaczenia. Tutaj sześciocyfrowa podpozycja jest już określona, więc status toREADY_TO_SUBHEADINGiclarificationsopisują, co jest potrzebne do wybrania dokładnej linii taryfowej.{"input": {"name": "Pullover sweater","material": "100% cotton, knit","categories": ["Apparel","Tops"],"shipToCountry": "US"}}CustomsDescriptionValidationInput
customsDescriptionValidate
Czy ta strona była pomocna?