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 Katalogów.
- 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:
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 „niskiego ryzyka" lub zwolnionych klas towarów regulowanych — produktów, które są technicznie regulowane, ale wysyłane na podstawie specjalnego warunku lub zwolnienia z ilości.
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 Pulpitu nawigacyjnego ani kolumny CSV.
Aby oznaczyć produkt, dodaj atrybut z kluczem DANGEROUS_GOODS i wartością jednej z obsługiwanych kategorii poniżej.
mutation CatalogItemsCreate($sku: String!$name: String$attributes: [ItemAttributeInput!]) { catalogItemsCreate( input: [{ sku: $sku, name: $name, attributes: $attributes }] ) id name sku attributes key valueObsługiwane wartości towarów niebezpiecznych
| Wartość↕ | Kategoria↕ |
|---|---|
NOT_RESTRICTED_A70 | Nie ograniczony, Specjalny warunek A70—artykuły pod ciśnieniem, takie jak stężenia gazowe i amortyzatory (UN3164). |
NOT_RESTRICTED_A67 | Nie ograniczony, Specjalny warunek A67—silniki lub maszyny napędzane płynnym paliwem (UN3528). |
NOT_RESTRICTED_A02 | Nie ograniczony, Specjalny warunek A02—zwolnienie zgodnie z przepisami ADR dotyczącymi transportu drogowego małych ładunków. |
LIMITED_QUANTITY | Limitowana ilość (ADR)—towary niebezpieczne zapakowane w małych ilościach w ramach limitów regulacyjnych. |
EXCEPTED_QUANTITY | Wyjątkowa ilość (IATA)—bardzo małe ilości zwolnione z większości zasad transportu powietrznego towarów niebezpiecznych. |
CONSUMER_COMMODITY | ID towaru konsumenckiego 8000—produkty gotowe do sprzedaży na etacie codzienne 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)—substancje biologiczne kategorii B, takie jak próbki diagnostyczne lub kliniczne. |
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 Pulpitu nawigacyjnego, 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 przezapisywać 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 przezapisywać 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 przezapisywać 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 Pulpicie nawigacyjnym.
- 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 Pulpicie nawigacyjnym.
- 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.
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źALLjako 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źNONEjako 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 Pulpitu nawigacyjnego 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.
If you're using Checkout, przy ograniczeniu produktu do kraju klienta 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 Pulpitu nawigacyjnego 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 Pulpicie nawigacyjnym.
- 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 Pulpicie nawigacyjnym.
- 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 Katalogów, katalog zostanie pobrany bezpośrednio z Pulpitu nawigacyjnego. 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 Katalogów.
- Kliknij Eksportuj w prawym górnym rogu.
- Zlokalizuj plik CSV w skrzynce odbiorczej poczty e-mail.
Aby wyeksportować wszystkie produkty:
- Przejdź do Pulpit nawigacyjny -> 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.
mutation ClassificationsCreateFromCatalog($catalogItemToClassify: [ClassificationFromCatalogInput!]!) { classificationsCalculateFromCatalog(input: $catalogItemToClassify) { id configuration { shipToCountries } hsCode { code } name }}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.
{ "catalogItemToClassify": [ { "catalogItemId": "catalog_item_893jkdkllg03k9khjd9", "configuration": { "shipToCountries": [ "CA" ] } } ]}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. |
| Preferem pakowania jest nieprawidłowy. 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 domyślnie. |
| 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
Zarządzaj katalogiem
Twórz i modyfikuj produkty.Dowiedz się, jak dodawać, modyfikować i usuwać produkty Katalogu Zonos w Pulpicie nawigacyjnym lub poprzez interfejs API. Użyj Katalogu w Pulpicie nawigacyjnym, 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.