Dowiedz się, jak żądać klasyfikacji w Dashboardzie i za pośrednictwem API.
Poniżej znajdziesz przykłady pokazujące, jak żądać klasyfikacji uniwersalnych i specyficznych dla danego kraju za pośrednictwem Dashboardu lub API. Dla tych, którzy szukają bardziej kompleksowych szczegółów technicznych i obszernej dokumentacji, odwiedź naszą stronę referencji API GraphQL Zonos dla deweloperów. Ten kompleksowy zasób oferuje szczegółowe informacje na temat punktów końcowych API, mutacji GraphQL i obszernych informacji technicznych.
Chociaż do wygenerowania klasyfikacji wymagany jest tylko opis, im więcej szczegółów produktu podasz, tym dokładniejsza będzie Twoja klasyfikacja. Alternatywnie możesz po prostu podać adres URL produktu, a Classify automatycznie wyodrębni wszystkie istotne szczegóły pozycji dla Ciebie. Poniżej znajduje się kompleksowe wyjaśnienie każdego pola wejściowego akceptowanego przez Classify. Rozumiejąc te pola wejściowe, możesz zmaksymalizować ich użycie i wygenerować wysoce dokładne klasyfikacje.
Opisy pól wejściowych
Pole↕
Opis↕
Nazwa (wymagane)
Nazwa produktu
Adres URL produktu (opcjonalnie)
Wklej adres URL produktu, a Classify automatycznie pobierze stronę i wyodrębni istotne szczegóły pozycji (nazwa, opis, kategorie itp.) do klasyfikacji. Dostępne w Dashboardzie poprzez kliknięcie ikony + lub bezpośrednie dodanie w głównym polu tekstowym. W przypadku integracji API skontaktuj się z pracownikiem Zonos. Choć idealny do demonstracji i testowania, implementacje produkcyjne osiągają optymalną wydajność i efektywność kosztów, przekazując dane pozycji bezpośrednio z systemów backendowych.
Opis (opcjonalnie)
Szczegółowy, obszerny opis produktu
Adres URL obrazu (opcjonalnie)
Link do obrazu produktu. Uwaga: Upewnij się, że używasz łącza do rzeczywistego adresu URL obrazu, a nie adresu URL strony produktu
Kategorie (opcjonalnie)
Ogólne podkategorie produktów, np. Odzież i akcesoria, Artykuły dla zwierząt domowych, Produkty biurowe lub Odzież dla niemowląt, Łóżka dla zwierząt, Kleje i taśmy
Materiał (opcjonalnie)
Z czego produkt jest zrobiony, np. plastik, drewno, stal
Uwzględnij istniejący kod HS w żądaniu klasyfikacji, aby poprowadzić Twoje żądanie. W zależności od Twojej preferencji i pochodzenia podanego kodu HS, Classify może sprawdzić kod HS i sprawdzić jego spójność względem szczegółów opisu pozycji. Dowiedz się więcej.
Kraj docelowy (opcjonalnie)
Określa, do którego kraju produkt będzie klasyfikowany. Kraj docelowy musi być wyświetlany przy użyciu dwuliterowego skrótu (kodu ISO) każdego kraju, a nie rzeczywistej nazwy kraju, np. AU, a nie Australia. Uwzględnienie tego pola spowoduje, że Classify zwróci kod HS specyficzny dla kraju z 8+ cyframi zamiast uniwersalnego kodu 6-cyfrowego. Dowiedz się więcej o różnicach między uniwersalnymi a specyficznymi dla kraju kodami HS.
ID produktu (opcjonalnie)
Twoje ID produktu lub dowolny numer, który można użyć do jednoznacznej identyfikacji każdego produktu. Jeśli ID produktu nie zostanie podane, Classify przypisze ID produktów zaczynając od 1
Uwaga: Jeśli przesyłasz swoje grupowe żądanie CSV w Dashboardzie, kraj docelowy nie będzie częścią szablonu; zamiast tego wybierzesz kraje docelowe po przesłaniu grupowego żądania CSV.
Aby żądać klasyfikacji w Dashboardzie lub za pośrednictwem API, postępuj zgodnie z poniższymi krokami i mutacją.
Poniższy przykład pokazuje żądanie uniwersalne (6-cyfrowe). Aby żądać klasyfikacji do określonych krajów, dodaj kody ISO krajów w żądaniu Classify, jak widać w poniższym przykładzie. Aby żądać uniwersalnego kodu HS, pozostaw kraj wysyłki null w żądaniu Classify.
Dane wejściowe przyjmują listę, dzięki czemu możesz żądać wielu lub jednej klasyfikacji na raz.
Uwaga: Aby wygenerować dzienniki audytu za pośrednictwem API, uwzględnij pole auditTrail w zapytaniu. Skontaktuj się z pracownikiem Zonos, aby uzyskać dostęp i szczegóły implementacji.
Gdy Classify otrzyma żądanie klasyfikacji, próbuje dopasować dane pozycji wejściowej zawarte w żądaniu do dopasowania w bazie danych Classify na podstawie najwyższego wyniku pewności. Na podstawie tego, co zostanie znalezione, Classify zwróci jedną z następujących odpowiedzi:
Gdy hsCode jest zwracany z kodem HS 6 do 8+ cyfr, w zależności od tego, czy kod kraju wysyłki został uwzględniony w żądaniu, Twoje żądanie klasyfikacji było pomyślne.
Gdy {"errors": [ { "message": "No adequate response"}]} jest zwracany, oznacza to, że Classify nie mógł znaleźć klasyfikacji z powodu niewystarczających informacji wejściowych.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
Klasyfikacja pozycji
Klasyfikacja pozycji
Dowiedz się, jak żądać klasyfikacji w Dashboardzie i za pośrednictwem API.
Poniżej znajdziesz przykłady pokazujące, jak żądać klasyfikacji uniwersalnych i specyficznych dla danego kraju za pośrednictwem Dashboardu lub API. Dla tych, którzy szukają bardziej kompleksowych szczegółów technicznych i obszernej dokumentacji, odwiedź naszą stronę referencji API GraphQL Zonos dla deweloperów. Ten kompleksowy zasób oferuje szczegółowe informacje na temat punktów końcowych API, mutacji GraphQL i obszernych informacji technicznych.
Pola wejściowe
Chociaż do wygenerowania klasyfikacji wymagany jest tylko opis, im więcej szczegółów produktu podasz, tym dokładniejsza będzie Twoja klasyfikacja. Alternatywnie możesz po prostu podać adres URL produktu, a Classify automatycznie wyodrębni wszystkie istotne szczegóły pozycji dla Ciebie. Poniżej znajduje się kompleksowe wyjaśnienie każdego pola wejściowego akceptowanego przez Classify. Rozumiejąc te pola wejściowe, możesz zmaksymalizować ich użycie i wygenerować wysoce dokładne klasyfikacje.
Opisy pól wejściowych
Żądaj klasyfikacji
Aby żądać klasyfikacji w Dashboardzie lub za pośrednictwem API, postępuj zgodnie z poniższymi krokami i mutacją.
Poniższy przykład pokazuje żądanie uniwersalne (6-cyfrowe). Aby żądać klasyfikacji do określonych krajów, dodaj kody ISO krajów w żądaniu Classify, jak widać w poniższym przykładzie. Aby żądać uniwersalnego kodu HS, pozostaw kraj wysyłki
nullw żądaniu Classify.Dane wejściowe przyjmują listę, dzięki czemu możesz żądać wielu lub jednej klasyfikacji na raz.
mutation ClassifyItems($input: [ClassificationCalculateInput!]!) {classificationsCalculate(input: $input) {idnamecategoriesimageUrlhsCode {codedescription {full}}}}Możliwe odpowiedzi API
Gdy Classify otrzyma żądanie klasyfikacji, próbuje dopasować dane pozycji wejściowej zawarte w żądaniu do dopasowania w bazie danych Classify na podstawie najwyższego wyniku pewności. Na podstawie tego, co zostanie znalezione, Classify zwróci jedną z następujących odpowiedzi:
hsCodejest zwracany z kodem HS 6 do 8+ cyfr, w zależności od tego, czy kod kraju wysyłki został uwzględniony w żądaniu, Twoje żądanie klasyfikacji było pomyślne.{"errors": [ { "message": "No adequate response"}]}jest zwracany, oznacza to, że Classify nie mógł znaleźć klasyfikacji z powodu niewystarczających informacji wejściowych.ClassificationCalculateInput
classificationsCalculate
Czy ta strona była pomocna?