Pola wejściowe
Chociaż do wygenerowania klasyfikacji wystarczy opis, im więcej szczegółów dotyczących produktu podasz, tym dokładniejsza będzie twoja klasyfikacja. Poniżej znajduje się szczegółowe wyjaśnienie każdego pola wejściowego akceptowanego przez Classify. Rozumiejąc te pola wejściowe, możesz maksymalnie wykorzystać ich zastosowanie i wygenerować bardzo dokładne klasyfikacje.
Opisy pól wejściowych
| Pole | Opis |
|---|---|
| Nazwa (wymagana) | Nazwa produktu |
| Opis (opcjonalny) | Szczegółowy, długi opis produktu |
| URL obrazu (opcjonalny) | Link do obrazu produktu. Uwaga: Upewnij się, że używasz linku do rzeczywistego URL obrazu, a nie URL strony produktu |
| Kategorie (opcjonalne) | Ogólne podkategorie produktów, np. Odzież i akcesoria, Artykuły dla zwierząt, Produkty biurowe lub Ubrania dla niemowląt, Legowiska dla zwierząt, Kleje i taśmy |
| Materiał (opcjonalny) | Z czego wykonany jest produkt, np. plastik, drewno, stal |
| Kraj pochodzenia (opcjonalny) | dwu-literowy skrót (kod ISO) dla kraju produkcji lub wytwarzania produktu |
| Podany kod HS (opcjonalny) | Dołącz istniejący kod HS w swoim wniosku o klasyfikację, aby pokierować swoim wnioskiem. W zależności od twoich preferencji i pochodzenia podanego kodu HS, Classify może zweryfikować kod HS i sprawdzić jego spójność z szczegółami opisu przedmiotu. Dowiedz się więcej. |
| Kraj docelowy (opcjonalny) | Określa, do którego kraju produkt będzie klasyfikowany. Kraj docelowy musi być wyświetlany z dwu-literowym skrótem każdego kraju (kod ISO) i nie z rzeczywistą nazwą kraju, np. AU, a nie Australia. Dołączenie tego pola umożliwi Classify zwrócenie specyficznego dla kraju kodu HS o długości 8+ cyfr zamiast uniwersalnego 6-cyfrowego kodu. Dowiedz się więcej o różnicach między uniwersalnymi a specyficznymi dla kraju kodami HS. |
| ID produktu (opcjonalne) | Twoje ID produktu lub dowolny numer, który może być użyty do unikalnej identyfikacji każdego produktu. Jeśli ID produktu nie jest podane, Classify przypisze ID produktów zaczynające się od 1 |
Uwaga: Jeśli przesyłasz swój zbiorczy wniosek CSV w Dashboardzie, kraj docelowy nie będzie częścią szablonu, a wybierzesz swoje kraje docelowe po przesłaniu zbiorczego wniosku CSV.
Złóż wniosek o klasyfikację
Aby złożyć wniosek o klasyfikację w Dashboardzie lub za pomocą API, postępuj zgodnie z poniższymi krokami i mutacją.
Poniższy przykład pokazuje uniwersalny (6-cyfrowy) wniosek. Aby złożyć wnioski o klasyfikacje do konkretnych krajów, dodaj kody ISO krajów w wniosku Classify jak pokazano w poniższym przykładzie. Aby złożyć wniosek o uniwersalny kod HS, pozostaw kraj docelowy null w wniosku Classify.
Wejście przyjmuje listę, więc możesz złożyć wiele lub pojedynczy wniosek o klasyfikację jednocześnie.
MUTACJA
GraphQL
mutation {
classificationsCalculate(
input: [
{
categories: "women's clothing"
imageUrl: "https://zonos.com/images/cozygloves.webp"
name: "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
configuration: { shipToCountries: KR }
}
]
) {
id
name
categories
imageUrl
hsCode {
code
description {
full
}
}
}
}
ODPOWIEDŹ
JSON
{
"data": {
"classificationsCalculate": [
{
"id": "classification_313d8d9d-e330-4d79-9922-cb7a1ff317e2",
"name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter",
"categories": ["women's clothing"],
"imageUrl": null,
"hsCode": {
"code": "6116.99.0000",
"description": {
"full": "Articles of apparel and clothing accessories, knitted or crocheted: Gloves, mittens and mitts, knitted or crocheted: Other : Of other textile materials"
}
}
}
]
}
}
Możliwe odpowiedzi API
Gdy Classify otrzyma żądanie klasyfikacji, próbuje dopasować dane dotyczące przedmiotu zawarte w żądaniu do dopasowania w bazie danych Classify's na podstawie najwyższego wyniku pewności. W zależności od tego, co zostanie znalezione, Classify zwróci jedną z następujących odpowiedzi:
- Gdy
hsCodezostanie zwrócony z 6 do 8+ cyfrowym kodem HS, w zależności od tego, czy w żądaniu uwzględniono kraj docelowy, Twoje żądanie klasyfikacji było udane. - Gdy
{"errors": [ { "message": "Brak odpowiedniej odpowiedzi"}]}zostanie zwrócone, oznacza to, że Classify nie mogło znaleźć klasyfikacji z powodu niewystarczających informacji wejściowych.
Klasyfikowanie przedmiotów
Dowiedz się, jak złożyć wniosek o klasyfikację w Dashboardzie i za pomocą API.
Poniżej znajdziesz przykłady ilustrujące, jak złożyć wniosek o klasyfikacje uniwersalne i specyficzne dla kraju za pośrednictwem Dashboardu lub za pomocą API. Dla tych, którzy poszukują bardziej szczegółowych informacji technicznych i obszernej dokumentacji, odwiedź naszą Zonos stronę referencyjną API GraphQL dla deweloperów. To kompleksowe źródło oferuje szczegółowe informacje na temat punktów końcowych API, mutacji GraphQL oraz obszernej dokumentacji technicznej.