Zarządzaj Katalogiem

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

Edycja produktów pozwala na efektywne aktualizowanie istniejących produktów o dodatkowe lub zaktualizowane informacje. Zamiast usuwać i ponownie przesyłać produkt, możesz przesłać zaktualizowane informacje, a Katalog dopasuje je do istniejącego produktu, używając Twojego SKU lub identyfikatora produktu, w zależności od preferencji klucza przedmiotu. W ten sposób możesz utrzymać swój katalog na bieżąco przy minimalnym wysiłku, niezależnie od tego, czy korzystasz z Dashboard, czy z API do tworzenia nowych produktów lub edytowania istniejących.

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

Katalog nadpisze puste pola w istniejących elementach.

• 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 lbs w nowym przesyłaniu, waga 1.3 lbs nadpisze wcześniej puste pole.

Katalog nadpisze istniejące pola nowymi wartościami pól.

• Na przykład, jeśli istniejący produkt, SKU 123, miał cenę 18.99 USD, a ten sam produkt, SKU 123, miał zaktualizowaną cenę 22.99 USD, nowa cena 22.99 USD nadpisze poprzednią cenę.

Katalog nie nadpisze 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.

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

Jeśli używasz Checkout, w Twoim checkout zostanie wyświetlona zastrzeżona wiadomość, gdy produkt jest ograniczony w kraju klienta. Domyślnie wiadomość będzie brzmieć "Ten przedmiot jest ograniczony w imporcie do Twojego kraju", ale możesz dostosować własną zastrzeżoną wiadomość, podając ją w polu restrictedCountriesMessage podczas dodawania ograniczeń krajowych.

Możesz wyszukiwać produkty w Katalogu przez Dashboard lub za pomocą API, używając SKU lub identyfikatora produktu. Zauważ, że tylko dokładne dopasowania zwrócą wyniki; częściowe dopasowania nie będą rozpoznawane.

Dashboard

API

Aby filtrować według SKU lub identyfikatora produktu:

1. Kliknij na zakładkę Produkty.
2. Wybierz SKU lub Identyfikator produktu w lewym górnym rogu swojego Katalogu.
3. Wprowadź swoje SKU lub identyfikator produktu.
4. Kliknij Zastosuj, aby zobaczyć swoje przefiltrowane produkt(y).

Jeśli wybierzesz 50 lub mniej pozycji z tabeli Katalog, twój katalog zostanie pobrany bezpośrednio z Dashboard. Jednak jeśli wybierzesz Eksportuj wszystkie lub więcej niż 50 pozycji, twój plik CSV zostanie wyeksportowany za pośrednictwem e-maila.

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

1. Wybierz 50 lub mniej pozycji bezpośrednio z tabeli Katalog.
2. Kliknij Eksportuj w prawym górnym rogu.
3. Zlokalizuj swój plik CSV w swojej skrzynce odbiorczej.

Aby eksportować wszystkie produkty:

Problemy z pobieraniem z e-maila?

Jeśli masz problemy z pobraniem pliku CSV z linku w e-mailu, może to być spowodowane zablokowaniem pobierania przez przeglądarkę. W takim przypadku wykonaj następujące kroki:

1. Kliknij prawym przyciskiem myszy na przycisk "Pobierz" w swoim e-mailu.
2. Wybierz "Kopiuj adres linku", aby skopiować adres URL pobierania.
3. Wklej skopiowany adres URL do przeglądarki i naciśnij enter.
4. Twój katalog zostanie pobrany bezpośrednio z przeglądarki.

Możesz classify produkt z twojego katalogu za pomocą API, używając catalogItemId w mutacji ClassificationsCreateFromCatalog.

Zauważ, że nazwa jest wymagana, aby classify produkt z twojego katalogu. Zapoznaj się z dokumentacją API GraphQL, aby uzyskać pełną listę pól katalogu i klasyfikacji.

Aby jednocześnie utworzyć i classify produkt katalogowy, dodaj poniższą mutację ClassificationsCreateFromCatalog do swojej mutacji CatalogItemsCreate mutacji.

Classify produkt katalogowy do kodu HS 8+ cyfr (specyficzny dla kraju)

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

W poniższym przykładzie pole shipToCountries jest wypełnione, aby wygenerować kod specyficzny dla kraju dla Kanady.

mutation ClassificationsCreateFromCatalog(
  $catalogItemToClassify: [ClassificationFromCatalogInput!]!
) {
  classificationsCalculateFromCatalog(input: $catalogItemToClassify) {
    id
    configuration {
      shipToCountries
    }
    hsCode {
      code
    }
    name
  }
}

Oto przykład prośby. Podczas gdy Zonos Classify wygeneruje klasyfikację tylko z name, zdecydowanie zalecamy dodanie jak najwięcej szczegółów dla najlepszych wyników klasyfikacji.

{
  "catalogItemToClassify": [
    {
      "catalogItemId": "catalog_item_893jkdkllg03k9khjd9",
      "configuration": {
        "shipToCountries": ["CA"]
      }
    }
  ]
}

{
  "data": {
    "classificationsCreateFromCatalog": [
      {
        "id": "classification_8C49fk2945jmm232CcQtHtXdu",
        "configuration": {
          "shipToCountries": ["CA"]
        },
        "countryOfOrigin": "US",
        "hsCode": {
          "code": "6116.10.0020"
        },
        "name": "Cozy Design Women's Knitted Gloves with Roll Up Cuffs for Winter"
      }
    ]
  }
}

Błędy API i rozwiązania

* Błąd API tylko