Importowanie i aktualizowanie produktów za pomocą arkusza#

Pobierz szablon kategorii, wprowadź dane produktów i prześlij plik w Katalogu. Ten sposób pracy nie wymaga pisania kodu ani używania danych uwierzytelniających API.

Zanim zaczniesz#

Wybierz właściwy sklep w panelu zarządzania. Musisz mieć uprawnienia do edycji jego katalogu. Jeśli nie widzisz przycisku Prześlij arkusz produktów, sprawdź wybrany sklep, uprawnienia do zapisu w katalogu oraz to, czy Twoje konto ma tylko dostęp do odczytu.

Pobieranie szablonu kategorii#

Otwórz Panel zarządzania → Katalog.
Kliknij Prześlij arkusz produktów, aby otworzyć okno Importuj produkty.
W sekcji Wybierz kategorię produktu wybierz kategorię, którą chcesz zaimportować. Dostępne opcje zależą od konfiguracji sklepu.
Kliknij Pobierz szablon Excel. Dla każdej kategorii używaj osobnego szablonu i przesyłaj plik oddzielnie.

Przygotowując nowy import, pobierz nowy szablon, aby jego kolumny odpowiadały aktualnym wymaganiom kategorii. Pobrany skoroszyt jest szablonem, a nie eksportem istniejącego katalogu.

Wypełnianie skoroszytu#

Korzystaj z arkuszy skoroszytu w następujący sposób:

Arkusz	Przeznaczenie
`Products`	Wprowadzaj rzeczywiste dane produktów od wiersza 2. Nie zmieniaj pierwszego wiersza z nazwami pól.
`Instructions`	Zapoznaj się z wymaganymi polami, wymiarami i regułami dla danej kategorii.
`Enums`	Sprawdź dozwolone wartości pól, takich jak `status` i `dimension_unit`.
`Examples`	Zobacz poprawne i niepoprawne przykłady. Rzeczywiste produkty wprowadzaj w `Products`, a nie tutaj.

Każdy wiersz produktu wymaga pól sku, name, image_url i product_url oraz wymiarów wymaganych dla jego kategorii. Postępuj zgodnie z oznaczeniami wymaganych pól i instrukcjami w pobranym szablonie. Nie tłumacz nazw pól ani nie dodawaj nieznanych lub powielonych kolumn.

Zachowaj format tekstowy komórek SKU, aby program do arkuszy nie usuwał zer wiodących ani nie zmieniał długich identyfikatorów. Używaj jednego wiersza na SKU; powtarzające się wartości w tym samym pliku są odrzucane, także te różniące się wyłącznie wielkością liter.
W polu image_url podaj bezpośredni, publicznie dostępny adres obrazu HTTP lub HTTPS; musi działać bez logowania, plików cookie i niestandardowych nagłówków żądania. Adres strony szczegółów produktu wpisz w product_url.
Podaj wymiary i jednostki zgodnie z instrukcjami szablonu. Jeśli jednostka nie jest podana ani przy wymiarze, ani w dimension_unit, domyślnie używane jest in.
Wybierz status spośród dozwolonych wartości w Enums. Pozostawienie pustego pola ustawia domyślnie active; przy aktualizowaniu produktów podawaj tę wartość jawnie.

Zapisz plik jako .xlsx (zalecane). Format .csv również jest akceptowany, jeśli plik zawiera wyłącznie wiersz nagłówków produktów i dane. Starsze pliki .xls nie są obsługiwane. Każdy plik może zawierać maksymalnie 50,000 niepustych wierszy produktów i nie może przekraczać 50 MB.

Przesyłanie i sprawdzanie wyniku#

Wróć do okna importu i wybierz tę samą kategorię co w szablonie.
W sekcji Uzupełnij i prześlij wybierz zapisany plik, a następnie kliknij Rozpocznij import.
W sekcji Ostatnie importy sprawdź nazwę pliku, stan przetwarzania oraz liczbę udanych i nieudanych wierszy. Wysłanie potwierdza przyjęcie pliku; przetwarzanie trwa w tle.
Poczekaj na zakończenie przetwarzania i sprawdź nieudane wiersze, nawet jeśli zadanie ma stan Zakończono. Wróć do Katalogu, aby zweryfikować dane zaimportowanych produktów i ich gotowość.

Jeśli przetwarzanie wierszy się nie powiedzie, kliknij Plik błędów, przejrzyj komunikaty o błędach, popraw dane produktów i prześlij poprawiony plik z tą samą kategorią. Pobrany skoroszyt błędów zawiera nieudane wiersze i kolumny diagnostyczne; te kolumny diagnostyczne są ignorowane przy ponownym przesłaniu.

W przypadku tymczasowego błędu przetwarzania użyj opcji Ponów, jeśli jest dostępna. Ponowienie tego samego zadania nie poprawia nieprawidłowych danych produktów. Jeśli interfejs informuje, że wiersze wymagają sprawdzenia przez pomoc techniczną, użyj Contact support; te wiersze nie są automatycznie przetwarzane ponownie.

Aktualizowanie istniejących produktów#

Aby zaktualizować produkty, użyj tego samego szablonu kategorii i zachowaj dotychczasowy SKU każdego produktu. Wypełnij wszystkie wymagane pola w każdym uwzględnionym wierszu, zmień wartości, które chcesz zaktualizować, i prześlij plik ponownie.

Ten sam SKU w tym samym sklepie aktualizuje istniejący produkt. SKU, który jeszcze nie istnieje, tworzy nowy produkt. Zmiana SKU w arkuszu nie zmienia identyfikatora pierwotnego produktu.
Możesz przesłać tylko wiersze produktów, które chcesz zaktualizować. Produkty nieobecne w pliku nie są usuwane, wyłączane ani wycofywane z publikacji.
Nie jest to częściowa aktualizacja pól: wymagane pola nadal muszą zawierać wartości. Nie zakładaj, że pusta komórka opcjonalna zachowuje poprzednią wartość. W szczególności pusty status przyjmuje domyślnie active, a brakujące jednostki wymiarów przyjmują domyślnie in.
Zachowaj wypełniony skoroszyt do przyszłych aktualizacji. Pobrany szablon nie zawiera bieżących danych produktów.

Po zakończeniu zadania sprawdź objęte nim produkty w Katalogu. Sam udany import nie potwierdza widoczności w witrynie sklepu; sprawdź gotowość produktów i listę kontrolną wdrożenia SDK.

Automatyzacja importu#

Do cyklicznej synchronizacji po stronie serwera używaj Product Import API. Pola żądań, limity i zasady częściowej aktualizacji tego API są opisane oddzielnie od tego sposobu importowania za pomocą arkusza.