Jak utworzyć produkt w Katalogu Zonos?

Możesz utworzyć produkt w Katalogu Zonos za pośrednictwem Dashboard lub interfejsu API. W Dashboard przejdź do Katalogu i kliknij Dodaj produkt w prawym górnym rogu. Dodaj szczegóły produktu i kliknij zapisz produkt. Jeśli chcesz utworzyć wiele produktów na raz, postępuj zgodnie z instrukcjami dotyczącymi importowania produktów. W interfejsie API utwórz listę catalogItemInputs, aby dodać produkty do katalogu.

Jak edytować produkt w Katalogu Zonos?

Możesz edytować produkt w Katalogu Zonos za pośrednictwem Dashboard lub interfejsu API. W Dashboard kliknij kartę Wszystkie produkty, wybierz produkt, który chcesz edytować, dokonaj zmian i kliknij zapisz produkt. W interfejsie API użyj mutacji CatalogItemUpdate, aby edytować produkt.

Jak usunąć produkt w Katalogu Zonos?

Możesz usunąć produkt w Katalogu Zonos za pośrednictwem Dashboard lub interfejsu API. W Dashboard kliknij kartę Wszystkie produkty, wybierz produkt lub produkty, które chcesz usunąć, i kliknij usuń. W interfejsie API użyj mutacji CatalogItemDelete, aby usunąć produkt.

Jak ograniczyć produkt w Katalogu Zonos?

Jeśli chcesz zapobiec wysyłkom do określonego kraju (lub krajów), możesz dodać ograniczenia podczas tworzenia lub aktualizowania produktu w Katalogu Zonos. W Dashboard wybierz produkt, do którego chcesz dodać ograniczenie, znajdź sekcję ograniczeń na dole strony edycji, dodaj kraje, do których chcesz ograniczyć produkt, i kliknij zapisz produkt. W interfejsie API dodaj restrictedCountries podczas tworzenia lub aktualizowania catalogItem.

Jak wyeksportować produkty w Dashboard Zonos?

Gdy eksportujesz produkty w Dashboard Zonos, automatycznie wyeksportuje on cały katalog produktów w pliku CSV. Przejdź do głównej strony Katalogu, kliknij przycisk Eksportuj obok Dodaj produkt i znajdź pełny plik katalogowy w pobieranych plikach.

Jak klasyfikować produkt katalogowy za pośrednictwem interfejsu API?

Możesz klasyfikować produkt z katalogu za pośrednictwem catalogItemId w mutacji ClassificationsCreateFromCatalog. Pamiętaj, że nazwa jest wymagana do klasyfikacji produktu z katalogu. Aby jednocześnie utworzyć i klasyfikować produkt katalogowy, dodaj mutację ClassificationsCreateFromCatalog do mutacji CatalogItemsCreate.

Strona głównaGlobalny handel elektroniczny Katalog Zarządzaj produktami

Zarządzaj katalogiem

Twórz i modyfikuj produkty.

Dowiedz się, jak dodawać, modyfikować i usuwać produkty Katalogu Zonos w Dashboard lub poprzez interfejs API. Użyj Katalogu w Dashboard, aby uniknąć pisania kodu lub jeśli wprowadzasz małe zmiany. Jeśli chcesz bezpośrednio integrować się z Katalogiem do produkcyjnych implementacji, użyj interfejsu API.

Utwórz produkt

Utwórz produkt w Katalogu:

Przejdź do Katalog i kliknij Dodaj produkt w prawym górnym rogu.
Dodaj szczegóły produktu. Jedynym polem wymaganym do utworzenia produktu są pola SKU i/lub identyfikator produktu. Te pola będą używane do odwoływania się do produktów katalogowych. Dowiedz się więcej o identyfikatorach Katalogu.
Opcjonalnie—Dodaj kod(y) HS.
Opcjonalnie—Dodaj informacje o wysyłce (wagę, wymiary, jednostki miary itp.).
Opcjonalnie—Dodaj kraje z ograniczeniami.
Kliknij zapisz produkt.

Utwórz wiele produktów w Katalogu:

Wgraj wiele produktów lub cały katalog produktów na raz.

Ważne: Jeśli spróbujesz utworzyć produkt, który już istnieje, Katalog rozpozna produkt na podstawie SKU i/lub identyfikatora produktu i zastąpi szczegóły oryginalnego produktu nowymi szczegółami.

Oznacz produkt jako towary niebezpieczne (DHL)

W przypadku przesyłek DHL możesz oznaczyć produkt jako towary niebezpieczne, aby automatycznie zastosować poprawną usługę dodaną wartości DHL za każdym razem, gdy tworzysz etykietę dla tego produktu. Dotyczy to klas towarów regulowanych o „niskim ryzyku” lub zwolnionych — produktów, które są technicznie regulowane, ale wysyłane na podstawie specjalnego przepisu lub wyjątku ilościowego.

Tag towarów niebezpiecznych jest przechowywany jako atrybut pozycji katalogowej: para key/value na produkcie. Atrybuty są ustawiane za pośrednictwem interfejsu API (catalogItemsCreate lub catalogItemsUpdate) — nie ma pola Dashboard ani kolumny CSV.

Tylko DHL

Oznaczanie towarów niebezpiecznych dotyczy tylko przesyłek DHL. Tag jest ignorowany dla pozostałych przewoźników.

Obsługiwany klucz atrybutu

DANGEROUS_GOODS jest obsługiwanym kluczem atrybutu do oznaczania towarów niebezpiecznych DHL. Nie jest jeszcze wymieniony wśród zatwierdzonych kluczy w dokumentacji ItemAttributeInput, ale jest akceptowany przez interfejs API.

Aby oznaczyć produkt, dodaj atrybut z kluczem DANGEROUS_GOODS i wartością jednej z obsługiwanych kategorii poniżej.

1mutation CatalogItemsCreate(

2$sku: String!

3$name: String

4$attributes: [ItemAttributeInput!]

5) {

6 catalogItemsCreate(

7 input: [{ sku: $sku, name: $name, attributes: $attributes }]

8 )

9 id

10 name

11 sku

12 attributes

13 key

14 value

Obsługiwane wartości towarów niebezpiecznych

Wartość↕	Kategoria↕
`NOT_RESTRICTED_A70`	Nieograniczone, przepis szczególny A70—artykuły pod ciśnieniem, takie jak siłowniki gazowe i amortyzatory (UN3164).
`NOT_RESTRICTED_A67`	Nieograniczone, przepis szczególny A67—silniki lub maszyny zasilane łatwopalną cieczą (UN3528).
`NOT_RESTRICTED_A02`	Nieograniczone, przepis szczególny A02—wyjątek w ramach przepisów ADR dotyczących drogowego transportu małych ładunków.
`LIMITED_QUANTITY`	Ilość ograniczona (ADR)—towary niebezpieczne pakowane w małych ilościach w ramach limitów regulacyjnych.
`EXCEPTED_QUANTITY`	Ilość wyłączona (IATA)—bardzo małe ilości zwolnione z większości przepisów dotyczących transportu lotniczego towarów niebezpiecznych.
`CONSUMER_COMMODITY`	Towar konsumencki ID8000—codzienne produkty gotowe do sprzedaży detalicznej, z niewielką zawartością materiałów niebezpiecznych, takie jak aerozole i perfumy.
`MAGNETIZED_MATERIAL`	Materiał namagnesowany (UN2807)—przedmioty o polu magnetycznym wystarczająco silnym, aby wpłynąć na instrumenty lotnicze.
`BIOLOGICAL_SUBSTANCE`	Substancja biologiczna (UN3373)—próbki biologiczne kategorii B, takie jak próbki diagnostyczne lub kliniczne.

Zastosuj tagi automatycznie na etykietach

Oznaczenie produktu to pierwszy krok. Aby Zonos zastosował kategorię do etykiet DHL automatycznie, włącz Wysyłaj towary niebezpieczne w ustawieniach etykiet. Możesz również wybrać kategorię ręcznie na jednej etykiecie—zobacz zadeklaruj towary niebezpieczne.

Edytuj produkt

Edycja produktów pozwala efektywnie aktualizować istniejące produkty o dodatkowe lub zaktualizowane informacje. Zamiast usuwania i ponownego wgrania produktu, możesz wgrać zaktualizowane informacje, a Katalog dopasuje je do istniejącego produktu za pomocą Twojego SKU lub identyfikatora produktu, w zależności od preferowanego klucza pozycji. W ten sposób możesz utrzymywać katalog na bieżąco przy minimalnym wysiłku, niezależnie od tego, czy używasz Dashboard, czy interfejsu API, aby tworzyć nowe produkty lub edytować istniejące.

Jeśli utworzysz/edytujesz produkt katalogowy, który już istnieje w Katalogu, spodziewaj się następującego:

Katalog będzie nadpisywać puste pola na istniejących pozycjach.

Na przykład, jeśli istniejący produkt, SKU 321, nie miał wartości dla wagi, a ten sam produkt, SKU 321, miał wagę 1,3 funta w nowym wgrananiu, waga 1,3 funta zastąpiłaby wcześniej puste pole.

Katalog będzie nadpisywać istniejące pola nowymi wartościami pola.

Na przykład, jeśli istniejący produkt, SKU 123, miał cenę 18,99 USD i ten sam produkt, SKU 123, miał zaktualizowaną cenę 22,99 USD, nowa cena 22,99 USD zastąpiłaby poprzednią cenę.

Katalog nie będzie nadpisywać istniejących wartości pustymi polami.

Na przykład, jeśli istniejący produkt, SKU 456, miał kod HS 6109.10, ale kod HS zaktualizowanego produktu, SKU 456, jest pusty, istniejący kod HS pozostaje.

Aby edytować produkt:

Kliknij kartę Produkty.
Wybierz produkt, który chcesz edytować.
Dokonaj zmian.
Kliknij zapisz produkt.

Aby edytować wiele lub wszystkie produkty na raz, po prostu wgraj zaktualizowany plik CSV do Katalogu, włączając Twój SKU lub identyfikator produktu. Spowoduje to automatyczne aktualizacje istniejących pozycji.

Usuń produkt

Aby usunąć produkt:

Kliknij kartę Produkty w Dashboard.
Wybierz produkt(y), który chcesz usunąć. Po wybraniu produktu(ów) pojawi się przycisk usuwania.
Kliknij Usuń, a następnie Usuń wszystko, aby potwierdzić usunięcie.

Aby usunąć wszystkie produkty:

Wybierz kartę Produkty w Dashboard.
Kliknij Zarządzaj katalogiem w prawym górnym rogu, a następnie Usuń wszystko.
Kliknij Usuń wszystko ponownie, aby potwierdzić usunięcie.

Pamiętaj, że jeśli usuwasz dużą ilość pozycji (więcej niż 20 000 produktów), pojawi się powiadomienie wskazujące, że usuwanie jest w toku. W tym czasie nie będziesz w stanie wchodzić w interakcje z Katalogiem do czasu ukończenia usuwania. Możesz jednak odrzucić powiadomienie i nawigować bez przerywania procesu usuwania.

Ogranicz produkt

Jeśli chcesz zapobiec wysyłkom do określonego kraju (lub krajów), możesz dodać ograniczenia podczas tworzenia lub aktualizowania produktu.

Aplikacje Zonos Duty & Tax nie obsługują ograniczeń na poziomie pozycji, które usuwają określone produkty z zamówień międzynarodowych. Jeśli ograniczona pozycja znajduje się w koszyku, cały koszyk musi być zablokowany z wysyłką do tego kraju. Jest to obsługiwane poprzez regułę ograniczenia na poziomie koszyka, którą należy skonfigurować wcześnie podczas wdrożenia. Katalog jest kompatybilny z aplikacjami Duty & Tax, ograniczenia na poziomie pozycji są obsługiwane tylko w przypadku korzystania z Zonos Checkout.

Aby ograniczyć pojedynczy produkt w Katalogu:

Kliknij kartę Produkty.
Wybierz produkt, do którego chcesz dodać ograniczenie, które otworzy stronę edycji.
Znajdź sekcję Kraje z ograniczeniami na dole strony edycji.
Dodaj kraje, do których chcesz ograniczyć swój produkt, wybierając lub wpisując nazwy krajów.
Kliknij zapisz produkt.

Aby ograniczyć wiele produktów w Katalogu:

Kliknij kartę Importuj/eksportuj.
Pobierz Szablon CSV katalogowy.
Wypełnij szablon szczegółami produktu, w tym SKU/ID produktu i krajami z ograniczeniami. Wprowadź 2-cyfrowy kod ISO rozdzielony pionowymi kreskami, np. AU|KR|MY|SG. Aby ograniczyć wszystkie kraje, po prostu wprowadź ALL jako wartość. Jeśli chcesz ograniczyć wszystkie kraje z wyjątkiem jednego lub kilku, wprowadź ALL- i następnie kraje, które chcesz odblokować, oddzielone pionowymi kreskami, np. ALL-CA|FR|US. Dowiedz się więcej o formatowaniu CSV. Jeśli chcesz usunąć wszystkie istniejące ograniczone kraje, wprowadź NONE jako wartość.
Zapisz plik jako CSV i wgraj do Katalogu, przeciągając i upuszczając lub wybierając plik, klikając przeglądaj na tej samej stronie, z której pobrałeś CSV.
Przejrzyj wgrane produkty na ekranie podglądu i kliknij wgraj.

Filtrowanie produktów z ograniczeniami:

Możesz filtrować produkty z ograniczeniami bezpośrednio w katalogu, pobierając cały katalog w formacie CSV z Dashboard i otwierając go w programie Excel lub Google Sheets. Stamtąd możesz użyć funkcji filtrowania, aby wyświetlić tylko produkty z ograniczeniami. Umożliwia to łatwe zlokalizowanie i zarządzanie produktami z ograniczeniami w katalogu.

Jeśli musisz zaktualizować katalog po dokonaniu zmian w pliku CSV, ponownie wgraj plik, a wszystkie pasujące produkty zostaną zastąpione zaktualizowaną wersją. Odbywa się to poprzez zidentyfikowanie i dopasowanie SKU i/lub identyfikatora produktu.

Jeśli korzystasz z Checkout, gdy produkt jest ograniczony do kraju klienta, w Checkout zostanie wyświetlona wiadomość o ograniczeniu. Domyślnie wiadomość będzie brzmiała: „Ten przedmiot jest ograniczony do importu do Twojego kraju”.

Filtruj produkt

Możesz wyszukiwać produkty w Katalogu za pośrednictwem Dashboard lub interfejsu API za pomocą SKU, identyfikatora produktu lub nazwy produktu. W przypadku wyszukiwania SKU i identyfikatora produktu tylko dokładne dopasowania będą zwracać wyniki; częściowe dopasowania nie są obsługiwane. Jednak przy wyszukiwaniu według nazwy produktu obsługiwane są częściowe dopasowania.

Aby filtrować według SKU lub identyfikatora produktu:

Kliknij kartę Produkty w Dashboard.
Wybierz SKU lub ID produktu w górnym lewym rogu Katalogu.
Wprowadź SKU, ID produktu lub nazwę produktu.
Kliknij Zastosuj, aby wyświetlić filtrowany produkt(y).

Aby wyszukać nazwę produktu:

Kliknij kartę Produkty w Dashboard.
W górnym prawym rogu Katalogu wpisz nazwę produktu w polu wyszukiwania.
Wyświetl filtrowany produkt(y).

Eksportuj produkty

Jeśli wybierzesz 50 lub mniej pozycji z tabeli Katalogu, katalog zostanie pobrany bezpośrednio z Dashboard. Jednak jeśli wybierzesz Eksportuj wszystko lub więcej niż 50 pozycji, plik CSV zostanie wyeksportowany za pośrednictwem poczty e-mail.

Aby wyeksportować 50 lub mniej pozycji, wykonaj następujące kroki:

Wybierz 50 lub mniej pozycji bezpośrednio z tabeli Katalogu.
Kliknij Eksportuj w prawym górnym rogu.
Zlokalizuj plik CSV w skrzynce odbiorczej poczty e-mail.

Aby wyeksportować wszystkie produkty:

Przejdź do Dashboard -> Produkty -> Katalog.
Kliknij menu Zarządzaj katalogiem obok Dodaj produkt i kliknij Eksportuj wszystko.
Znajdź plik katalogu w pobieranych plikach.

Problemy z pobieraniem z wiadomości e-mail?

Jeśli masz problem z pobraniem pliku CSV z linku w wiadomości e-mail, może to być spowodowane blokowaniem pobierania przez przeglądarkę. Jeśli tak, postępuj zgodnie z następującymi krokami:

Kliknij prawym przyciskiem myszy na przycisek „Pobierz” w wiadomości e-mail.
Wybierz „Kopiuj adres linku”, aby skopiować adres URL pobierania.
Wklej skopiowany adres URL w przeglądarce i naciśnij Enter.
Katalog zostanie pobrany bezpośrednio z przeglądarki.

Klasyfikuj produkt

Możesz klasyfikować produkt z katalogu za pośrednictwem interfejsu API, używając catalogItemId w mutacji ClassificationsCreateFromCatalog.

Pamiętaj, że name jest wymagana do klasyfikacji produktu z katalogu. Zapoznaj się z dokumentacją GraphQL API, aby uzyskać pełną listę pól katalogów i klasyfikacji.

Aby jednocześnie utworzyć i klasyfikować produkt katalogowy, dodaj mutację ClassificationsCreateFromCatalog poniżej do mutacji CatalogItemsCreate.

Klasyfikuj produkt katalogowy do 8+ cyfr (specyficzne dla kraju)

Gdy pole shipToCountries jest wypełniane, klasyfikacja będzie kodem HS 8+ cyfr (specyficznym dla kraju). Jeśli nie podano shipToCountries, klasyfikacja będzie domyślnie kodem HS 6-cyfrowym (uniwersalnym). Dowiedz się więcej o różnicach między kodami HS uniwersalnymi i specyficznymi dla kraju.

W poniższym przykładzie pole shipToCountries jest podane w celu wygenerowania kodu specyficznego dla kraju dla Kanady.

1mutation ClassificationsCreateFromCatalog(

2$catalogItemToClassify: [ClassificationFromCatalogInput!]!

3) {

4 classificationsCalculateFromCatalog(input: $catalogItemToClassify) {

5 id

6 configuration {

7 shipToCountries

8 }

9 hsCode {

10 code

11 }

12 name

13 }

14}

Oto przykład żądania. Chociaż Zonos Classify może wygenerować klasyfikację z samą name, zdecydowanie zalecamy dodanie jak największej liczby szczegółów w celu uzyskania najlepszych wyników klasyfikacji.

1{

2 "catalogItemToClassify": [

3 {

4 "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",

5 "configuration": {

6 "shipToCountries": [

7 "CA"

8 ]

9 }

10 }

11 ]

12}

Błędy interfejsu API i rozwiązania

Błąd↕	Rozwiązanie↕
*Wymagany jest kod SKU lub identyfikator produktu do utworzenia produktu*	Identyfikator (SKU/identyfikator produktu) jest wymagany do tworzenia, edytowania lub usuwania pozycji katalogowej. Aby rozwiązać ten problem, dodaj SKU i/lub identyfikator produktu.
*Produkt, który próbujesz edytować, nie istnieje**	Nie możesz edytować produktu, który nie istnieje. Aby rozwiązać ten problem, utwórz nowy produkt z pożądanym SKU i/lub identyfikatorem produktu.
*Opis celny przekracza limit znaków wynoszący 30 znaków.*	Domyślnie opisy celniczne są ograniczone do 30 znaków, co jest zgodne z najczęściej spotykanym limitem znaków dla faktur handlowych.
*Typ produktu jest nieprawidłowy. Katalog obsługuje następujące typy produktów: digital_good. W przypadku produktów fizycznych pozostaw pole puste.*	Katalog obsługuje tylko następujące typy produktów: `digital_good` i `physical_good`. Jeśli produkt jest towarem fizycznym (najbardziej powszechny), pozostaw to pole puste.
Preferencja pakowania jest nieprawidłowa. Katalog obsługuje następujące preferencje pakowania: ships_alone i consolidated. Jeśli produkt można skonsolidować z innymi produktami, pozostaw pole puste.	Preferencja pakowania jest nieprawidłowa. Katalog obsługuje następujące preferencje pakowania: `ships_alone` i `consolidated`. Jeśli produkt można skonsolidować z innymi produktami, możesz pozostawić to pole puste, ponieważ `consolidated` jest wartością domyślną.
*Kraj musi być określony przy dostarczeniu kodu HS*	Jeśli podasz kod HS specyficzny dla kraju podczas tworzenia pozycji, wymagany jest kraj wysyłki. Aby rozwiązać ten problem, dodaj kraj wysyłki.
*Cena musi być większa niż 0*	Katalog nie obsługuje ujemnych wartości cen. Aby rozwiązać ten problem, dodaj cenę większą niż zero.
*Kod waluty musi być podany, gdy podana jest wartość ceny*	Jeśli podasz cenę, wymagany jest kod waluty. Aby rozwiązać ten problem, dodaj kod waluty.
*Cena musi być podana, gdy podany jest kod waluty*	Jeśli podasz kod waluty, wymagana jest cena. Aby rozwiązać ten problem, dodaj cenę.
*Towarzyszące pole wymiarowe nie może być puste*	Jeśli jedno pole wymiarowe jest podane, pozostałe dwa są wymagane, np. Jeśli podasz szerokość 8 cali, wymagane byłyby wysokość i długość.
*Wartość pomiaru musi być większa niż 0*	Katalog nie obsługuje ujemnych ani zerowych wartości pomiarów. Aby rozwiązać ten problem, dodaj wartość większą niż zero.
*Przy dostarczaniu wartości wymiarowej nie można pozostawić pustych jednostek wymiarowych*	Jeśli podasz wartość wymiarową, wymagana jest jednostka wymiarowa. Aby rozwiązać ten problem, dodaj jednostkę wymiarową.
*Przy dostarczaniu wartości wagi nie można pozostawić pustej jednostki wagi*	Jeśli podasz wartość wagi, wymagana jest jednostka wagi. Aby rozwiązać ten problem, dodaj jednostkę wagi.

* Tylko błąd interfejsu API

GraphQL API ReferenceTypes, inputs, and operations used in this guide

INPUTS

ItemAttributeInput

Zarezerwuj demonstrację