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
| 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 Panelu nawigacyjnym 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, długotrwały 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 |
| Kraj pochodzenia (opcjonalnie) | Dwuliterowe skróty (kod ISO) dla kraju produkcji lub wytwarzania produktu |
| Podany kod HS (opcjonalnie) | 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 Panelu nawigacyjnym, kraj docelowy nie będzie częścią szablonu; zamiast tego wybrać kraje docelowe po przesłaniu grupowego żądania CSV.
Żądaj klasyfikacji
Aby żądać klasyfikacji w Panelu nawigacyjnym 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
auditTrailw zapytaniu. Skontaktuj się z pracownikiem Zonos, aby uzyskać dostęp i szczegóły implementacji.
mutation ClassifyItems($input: [ClassificationCalculateInput!]!) { classificationsCalculate(input: $input) { id name categories imageUrl hsCode { code description { 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:
- Gdy
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. - Gdy
{"errors": [ { "message": "No adequate response"}]}jest zwracany, oznacza to, że Classify nie mógł znaleźć klasyfikacji z powodu niewystarczających informacji wejściowych.
Klasyfikacja pozycji
Dowiedz się, jak żądać klasyfikacji na Panelu nawigacyjnym i za pośrednictwem API.
Poniżej znajdziesz przykłady pokazujące, jak żądać klasyfikacji uniwersalnych i specyficznych dla danego kraju za pośrednictwem Panelu nawigacyjnego 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.