Porady praktyczne > Krok 1 - Ustawienia > Polecenia na karcie Zaawansowane > Sklep internetowy > Jak importować i eksportować produkty zdefiniowane w sklepie?

Kiedy zdefiniuje się już produkty dostępne w sklepie, może zajść potrzeba wyeksportowania katalogu produktów do innego projektu lub wykorzystania w innym programie, na przykład w bazie danych magazynu. Czasem warto zaimportować istniejący katalog produktów, żeby nie tworzyć go zupełnie od początku.

W programie WebSite X5 istnieje możliwość importu i eksportu katalogu produktów za pomocą narzędzi dostępnych na pasku narzędzi w oknie Sklep | Katalog produktów. Katalog produktów eksportowany jest do pliku w formacie .TXT lub .CSV i można go otwierać w zwykłym edytorze tekstowym (na przykład Notatniku Windows) albo w programie Microsoft Excel.

Jeśli chcesz ręcznie edytować plik będący wynikiem eksportu katalogu produktów lub utworzyć nowy plik przeznaczony do zaimportowania do programu, musisz przestrzegać pewnych zasad:

▪	Pierwszy wiersz musi zawierać prawidłowe nagłówki będące nazwami pól, czyli:

ID;Category;Name/Code;Description;Price;Enable VAT;VAT Value;Weight;Images;Options;Enable Discounts;Discounts

▪	Jeśli usuniesz pole nagłówkowe, usuniesz tym samym dane tego pola dla wszystkich produktów. Pól obowiązkowych (Category, Name/Code, Description and Price) nie da się usunąć.

▪	Każdy wiersz po nagłówkowym odpowiada jednemu produktowi.

▪	Wartości poszczególnych pól oddziela się średnikami ";".

▪	Dla każdego produktu muszą być podane następujące informacje: nazwa kategorii, nazwa produktu, opis produktu i cena produktu. Wszystkie pozostałe pola są opcjonalne i można je ominąć (nie wpisując niczego między średnikami rozdzielającymi sąsiednie pola ";").

▪	Identyfikator produktu, ID, jest generowany przez program automatycznie. Jeśli wpisujesz ręcznie nowy produkt, musisz zostawić pole ID puste.

▪	Wszystkie spacje w pliku zostaną zignorowane podczas importu.

Oto parametry pliku .TXT lub .CSV:

Parametr: ID
Obowiązkowy	Nie	Opis	Unikalny identyfikator produktu.
Wartość	Jest on automatycznie generowany i przypisywany produktowi przez program. Jeśli chcesz edytować plik .TXT lub .CSV powstały jako wynik eksportu, nigdy nie zmieniaj wartości pola ID, tylko zostaw pole puste dla nowych produktów, które będą kiedyś dodane. Podczas importowania katalogu program sprawdza, czy identyfikatory nie powtarzają się i w razie potrzeby generuje nowe.
Parametr: Category
Obowiązkowy	Tak	Opis	Kategoria produktu.
Wartość	Za pomocą znaku ">" można tworzyć ścieżki z podkategorii danej kategorii. Na przykład, T-shirt z podkategorii "Sportowe" należącej do kategorii "Ubrania męskie" będzie miał w pliku .TXT lub .CSV ścieżkę kategorii: ... ; Ubrania męskie > Sportowe ; ... W ten sposób można stworzyć dowolne drzewo kategorii.
Parametr: Name/Code
Obowiązkowy	Tak	Opis	Nazwa lub kod produktu.
Wartość	Kiedy katalog jest eksportowany do formatu .TXT lub .CSV, ta wartość jest odczytywana z pola Nazwa/Kod znajdującego się w oknie Ustawienia produktu \| Ogólne.
Parametr: Description
Obowiązkowy	Tak	Opis	Opis produktu.
Wartość	Kiedy katalog jest eksportowany do formatu .TXT lub .CSV, ta wartość jest odczytywana z pola Opis znajdującego się w oknie Ustawienia produktu \| Ogólne.
Parametr: Price
Obowiązkowy	Tak	Opis	Cena produktu.
Wartość	Kiedy katalog jest eksportowany do formatu .TXT lub .CSV, ta wartość jest odczytywana z pola Cena znajdującego sie w oknie Ustawienia produktu \| Ogólne.
Parametr: Enable VAT
Obowiązkowy	Nie	Opis	Określa, czy podana jest stawka VAT dla danego produktu.
Wartość	Kiedy katalog jest eksportowany do formatu .TXT lub .CSV, ta wartość jest odczytywana z pola VAT (%) znajdującego się w oknie Ustawienia produktu \| Ogólne. Ta opcja jest dostępna tylko wtedy, gdy w oknie Sklep \| Dostępność w grupie Ustawienia VAT-u w polu Rodzaj wybrana jest opcja "zawiera VAT". Zadaniem tego parametru jest umożliwienie podania dla danego produktu stawki VAT różnej od stawki dla innych produktów w katalogu. W tym wypadku ceny podawane są netto, bez VAT-u. Ten parametr może mieć wartość 0, jeśli pole wyboru VAT (%) nie jest zaznaczone, albo 1 jeśli pole wyboru jest zaznaczone.
Parametr: VAT Value
Obowiązkowy	Nie	Opis	Wartość VAT naliczana od ceny produktu dla określonej stawki VAT.
Wartość	Kiedy katalog jest eksportowany do formatu .TXT lub .CSV, ta wartość jest odczytywana z pola VAT (%) znajdującego się w oknie Ustawienia produktu \| Ogólne, które z kolei jest dostępne tylko wtedy, gdy w oknie Sklep \| Dostępność w grupie Ustawienia VAT-u wybrany jest Rodzaj "Zawiera VAT". Jeżeli pole wyboru VAT (%) w oknie Ustawienia produktu \| Ogólne jest zaznaczone, ale nie jest podana żadna wartość, stosowana jest Domyślna stawka (%) określona w oknie Ustawienia produktu \| Dostępność.
Parametr: Weight
Obowiązkowy	Nie	Opis	Waga produktu.
Wartość	Kiedy katalog jest eksportowany do formatu .TXT lub .CSV, ta wartość jest odczytywana z pola Waga znajdującego się w oknie Ustawienia produktu \| Ogólne.
Parametr: Images
Obowiązkowy	Nie	Opis	To jest lista obrazów zawartych w danym projekcie.
Wartość	Kiedy katalog jest eksportowany do formatu .TXT lub .CSV, ta wartość jest odczytywana z pola Ustawienia produktu \| Obraz. Dla każdego obrazu podana jest bezwzględna ścieżka dostępu. Jeśli natomiast plik .TXT lub .CSV tworzy się w celu importu, lista obrazów produktów może rozpocząć się od znaku „\|”, po którym następuje względna lub bezwzględna ścieżka dostępu. Na przykład: ... ; PathImage1 \| PathImage2 \| PathImage3 ; ....
Parametr: Options
Obowiązkowy	Nie	Opis	Lista możliwych wariantów lub rodzajów danego produktu.
Wartość	Kiedy katalog jest eksportowany do formatu .TXT lub .CSV, ta wartość jest odczytywana z pola Lista rodzajów podstawowych znajdującego się w oknie Ustawienia produktu \| Opcje. Gdy przygotowujesz plik .TXT lub .CSV z myślą o zaimportowaniu go, rodzaje produktu podaje się w postaci listy rozdzielonej pionową kreską "\|", czyli w formacie: ... ; wariant1 \| wariant2 \| wariant3 ; .... W ten sposób można podać dowolną liczbę rodzajów danego produktu.
Parametr: Enable Discounts
Obowiązkowy	Nie	Opis	Określa, czy zastosowany jest rabat ilościowy.
Wartość	Kiedy katalog jest eksportowany do formatu .TXT lub .CSV, ta wartość jest odczytywana z pola Udziel rabatu ilościowego znajdującego się w oknie Ustawienia produktu \| Rabat. Ten parametr może mieć wartość 0 lub 1, w zależności od tego, czy pole wyboru Udziel rabatu ilościowego zostało zaznaczone, czy nie.
Parametr: Discounts
Obowiązkowy	Nie	Opis	Lista możliwych rabatów ilościowych.
Wartość	Kiedy katalog jest eksportowany do formatu .TXT lub .CSV, ta wartość jest odczytywana z pola Udziel rabatu ilościowego znajdującego się w oknie Ustawienia produktu \| Rabat. Gdy przygotowujesz plik .TXT lub .CSV z myślą o zaimportowaniu go, rabaty podaje się w następującym formacie: ... ; ilość : rabat \| ilość : rabat ; ... Zatem, jeśli rabat 10% może być udzielony przy zakupie co najmniej 20 sztuk artykułu, a rabat 15% przysługuje przy zakupie co najmniej 50 sztuk, należy to zapisać: ... ; 20 : 10 \| 50 : 15 ; ... Używając znaku "\|" można zapisać dowolną liczbę rabatów ilościowych.

Kiedy importujesz plik .TXT lub .CSV będący wynikiem poprzedniego eksportu albo napisany ręcznie, program prawdopodobnie uaktualni go generując brakujące identyfikatory ID. Jeśli chcesz mieć kopię zaktualizowanego pliku .TXT lub .CSV, musisz wykonać ponowny eksport zaktualizowanego katalogu produktów.

Porady praktyczne:

-	Jak napisać wiadomość e-mail z powiadomieniem?