Wykaz Atrybutów w plikach merXu (.xls, .xlsx lub .csv)
Wykaz atrybutów
Zwróć uwagę na atrybuty, które opisaliśmy jako wymagane. Ich prawidłowe uzupełnienie warunkuje rozpoczęcie sprzedaży po zaimportowaniu pliku.
Pozostałe atrybuty wzbogacają ofertę.
Tabela atrybutów:
| nazwa atrybutu | opis |
| supplier_product_id kod produktu dostawcy pole wymagane | Kod nadaje sprzedawca; musi być unikatowy i używany wyłącznie dla 1 produktu jeden kod = jeden produkt Jeśli omyłkowo przypiszesz ten sam kod do dwóch lub więcej produktów, wywoła to błędy w imporcie pliku oraz błędy w opisach i parametrach Twoich produktów. |
| name nazwa pole wymagane | Nazwa produktu widoczna na liście ofert dostępnych dla kupujących lub w wynikach wyszukiwania. |
| merxu_category_path ścieżka kategorii na merXu | Przykład: Elektrotechnika / Oświetlenie / Źródła światła / Lampy LED |
description
| Ograniczenie do 3000 znaków description-pl, description-en |
manufacturer | Przykłady: Philips, Bosch, Makita |
| manufacturer_product_id kod producenta | Globalny, katalogowy kod producenta. Jeżeli to Ty jesteś producentem i wystawiasz swoje produkty na merXu, możesz używać kodu katalogowego jako kodu dostawcy (manufacturer_product_id = supplier_product_id). |
| ean europejski kod towarowy | Kod kreskowy zgodnie z: https://pl.wikipedia.org/wiki/EAN |
| production_country kraj produkcji | Tu wpisz dwuliterowy kod kraju pochodzenia Twojego produktu. Użyj wielkich liter. https://pl.wikipedia.org/wiki/ISO_3166-1_alfa-2 |
| main_image_url zdjęcie główne | Adres URL głównego obrazu lub nazwa pliku lub ścieżka do pliku, który zostanie dołączony podczas importowania CSV. Jeśli nie wskażesz głównego obrazu, wstawimy tutaj pierwszy obraz z kolumny other_images_urls. Przykład: URL, image.jpg, product-images/image.jpg |
| other_images_urls dodatkowe zdjęcia | Limit: 10 obrazów Pole powinno zawierać adres URL lub nazwy załączonych dodatkowych plików graficznych lub ścieżki do plików oddzielone średnikiem ";". |
| video_youtube film o produkcie | Do galerii produktu możesz dodać również film reklamowy, ukazujący zalety, właściwości produktu. Do arkusza, w kolumnie video_youtube, wpisz adres URL (link) filmu z serwisu YouTube. |
| etim_class | Jeśli stosujesz tę klasyfikację dla swoich produktów, możesz podać kod etim w pliku. |
| currency waluta pole wymagane | Cena, w której sprzedajesz produkt, może być wyrażona w jednej walucie: PLN, CZK lub EUR. |
| price cena netto pole wymagane | Cena netto Twojego produktu; zapis wyłącznie z separatorem '.' lub ciągły: 120.96 10000 |
| hidden_price ukryta cena | Pole wyboru 1/0. Jeśli zaznaczysz to pole wpisując “1”, cena Twojej oferty pozostanie ukryta. |
| vat Stawka podatku VAT dla produktu pole wymagane | VAT wyraź liczbą całkowitą np. 23 (a nie 23% lub 8%). |
| price_unit jednostka sprzedaży | Domyślną jednostką sprzedaży jest sztuka. Jeśli chcesz ją zmienić, wpisz odpowiednią wartość - symbol jednostki. Do wyboru masz: m, m2, m3, l, kg. |
| price_quantity jakiej ilości towaru dotyczy wskazana cena | Przykład: jeśli cena 100zł dotyczy 5 sztuk wierteł, wpisz wartość “5” w price_quantity. Przedstawimy w ofercie cenę za 1 wiertło. |
| order_increment wielokrotność sprzedaży | Przykład: chcesz sprzedawać tuby kleju kartonami po 12 szt. Możesz wskazać cenę (price) 10 zł za jedną sztukę oraz ustalić order_increment równy “12”. Wówczas klient będzie mógł wybrać zakup 12, 24, 36 szt, itd |
| condition stan produktu | Nowy, używany i odnowiony. |
| enabled aktywowanie ofert | Pole wyboru 1/0. Wpisz “1” lub pozostaw te miejsce puste, jeśli chcesz, żeby produkt był aktywny po zaimportowaniu pliku. |
| dispatch_time czas wysyłki | Określ tym czas wysyłki produktu do odbiorcy. Podaj liczbę dni, np. 2. |
| in_stock | 1 - produkt jest na stanie i jest gotowy do wysyłki 0 - produkt nie jest na stanie ale może zostać zamówiony. Produkty z wartością in_stock=1 będą oznaczone na stronie oferty i listingu jako "gotowe do wysyłki" |
| country_of_dispatch kraj, z którego wysyłasz zamówienia | Podaj tu dwuliterowy kod zgodny z ISO 3166-1. Na przykład PL, CZ. |
| destination_countries kraje, do których zgadzasz się wysyłać zamówienia. | Podaj tu dwuliterowy kod zgodny z ISO 3166-1. Na przykład PL, CZ. |
| shipping_pricing_external_id ID cennika dostaw, który stworzyłeś na swoim koncie. | Dodanie go powoduje udostępnienie dla kupujących przycisku KUP TERAZ. Instrukcja tworzenia cennika: https://lp.merxu.com/pl/shipping-pricing |
| custom attributes dodatkowe atrybuty | Zdefiniuj dokładną nazwę atrybutu i zapisz ją w swoim języku, zaczynając wielką literą, dalszą część małymi literami; wiersze uzupełnij w swoim języku; jednostki miary w obrębie nazwy zapisz w [] potwierdź wybór języka podczas importu CSV na stronie merXu |
Atrybuty produktowe
supplier_product_id
kod produktu dostawcy (pole wymagane)
To najważniejszy atrybut w pliku. MerXu rozpoznaje Twoje produkty, używając tego parametru. To Ty jako dostawca ustanawiasz i przypisujesz ten kod do swoich produktów.
Kod produktu dostawcy może mieć dowolny charakter – to jest składać się z liter i cyfr; może to być EAN, możesz też użyć globalnego kodu producenta. Kod produktu dostawcy nie ma też wymaganej liczby znaków..
Kluczowe jest, by był unikatowy, to jest przypisany do Twojego jednego konkretnego produktu, i nie powtarzał się w Twoim katalogu produktów, nawet po długim czasie.
Jeśli omyłkowo przypiszesz ten sam kod do dwóch lub więcej produktów, wywoła to błędy w imporcie pliku oraz błędy w opisach i parametrach Twoich produktów.
name
nazwa (pole wymagane)
Nazwa produktu widoczna na liście ofert dostępnych dla kupujących lub w wynikach wyszukiwania.
Możesz udostępnić nazwę w kilku językach. W takim wypadku dodaj osobną kolumnę, a jej nazwę rozszerz o dwuliterowy kod języka, którego używasz:
polski – pl, czeski – cs, estoński – et, litewski – lt, słowacki – sk.
Przykłady: name-en, name-cs, name-et, name-pl.
Użyj małych liter.
(wg ISO 639-1) https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
Pole z ograniczeniem liczby znaków: maksymalnie 255 znaków dla nazwy w każdym języku.
merxu_category_path
ścieżka kategorii na merXu
W pliku masz możliwość podania pełnej, szczegółowej ścieżki kategorii dla swoich produktów, na przykład:
Elektrotechnika / Oświetlenie / Źródła światła / Lampy LED
Uzupełnienie tego parametru jest ważne - pozwala nam na prawidłowe połączenie Twojego produktu z odpowiednią kategorią w merXu. Produkty nie będą skategoryzowane automatycznie - wskazanie ścieżki pomaga więc nam w ręcznej klasyfikacji.
Pole z ograniczeniem do 255 znaków; możesz użyć “/” i innych znaków specjalnych, żeby rozdzielić kolejne segmenty ścieżki.
description
opis produktu
Opis produktu wyświetla się jako prosty, ciągły tekst. Aby go atrakcyjnie sformatować, zastosuj znaczniki HTML. Sprawdź wykorzystywane przez nas znaczniki na stronie: https://merxu.com/pl/html/. Przykładowy tekst opisu z punktorami:
<ul>W skład zestawu wchodzą:
<li>wiertarka</li>
<li>akumulator</li>
<li>zestaw wierteł</li>
<li>walizka</li></ul>
Pamiętaj, że możesz też udostępnić opis w wielu językach. Tak jak w przypadku pola dodatkowej nazwy w innym języku, dodaj osobną kolumnę i rozszerz nazwę o przyrostek z dwuliterowym kodem języka, którego używasz:
polski – pl, czeski – cz, estoński – et, litewski – lt, słowacki – sk.
Przykłady: description-en, description-sk, description-lt.
Użyj małych liter. Ograniczenie do 3000 znaków.
(wg ISO 639-1) https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
manufacturer
nazwa producenta
Przykłady: Philips, Bosch, Makita
manufacturer_product_id
kod producenta
Globalny, katalogowy kod producenta. Ma charakter publiczny i służy do globalnej identyfikacji produktu.
Jeżeli to Ty jesteś producentem i wystawiasz swoje produkty na merXu, możesz używać kodu katalogowego jako kodu dostawcy (manufacturer_product_id = supplier_product_id).
ean
europejski kod towarowy
Kod kreskowy zgodnie z: https://pl.wikipedia.org/wiki/EAN
production_country
kraj produkcji
Tu wpisz dwuliterowy kod kraju pochodzenia Twojego produktu, na przykład PL dla produktów pochodzących z Polski, DE – dla niemieckich, CE – dla kanadyjskich itd.
Użyj wielkich liter. Listę kodów znajdziesz w linku – to część tabeli opisana alfa-2.
(ISO 3166-1) https://pl.wikipedia.org/wiki/ISO_3166-1_alfa-2
main_image_url
zdjęcie główne
Zdjęcie główne produktu będzie widoczne w wynikach wyszukiwania - na liście ofert.
Zdjęcia możesz wgrać na dwa sposoby:
- podając w tabeli adres URL głównego zdjęcia, jeśli posiadasz publiczną bazę zdjęć i udostępniasz je merXu do pobrania:
Arkusz kalkulacyjny: przykład kolumny main_image_url z uzupełnionymi adresami URL zdjęć głównych dla 2 produktów:
- podając w tabeli nazwę pliku ze zdjęciem. Zdjęcia te dodasz na nasz serwer podczas wczytywania pliku w “Katalogu produktów”.
Pamiętaj, że nazwa pliku zdjęciowego, którą podajesz w tabelce, musi zawierać rozszerzenie ze wskazaniem typu pliku graficznego. Akceptujemy pliki: .gif, .jpg, .jpeg, .png. Ważne też jest, aby w arkuszu wpisać dokładną nazwę pliku ze zdjęciem. Wielkość liter musi być spójna (również dotyczy to rozszerzenia pliku).
Na przykładzie widzisz plik dla zdjęcia głównego ze wskazanym rozszerzeniem .jpg.
Arkusz kalkulacyjny: kolumna main_image_url z zapisaną nazwą pliku .jpg. Zdjęcie zostanie dodane do produktu z poziomu konta merXu.
Jeśli w Twoim pliku zabraknie głównego zdjęcia, w jego miejsce wstawimy pierwsze zdjęcie ze zdjęć dodatkowych z kolumny other_images_urls .
Wymagania techniczne i kryteria dla zdjęcia głównego i dodatkowych
- Maksymalna rozdzielczość obrazu: 2560 x 2560 pikseli
- Minimalna rozdzielczość obrazu: 500 x 500 pikseli
- Akceptowany format obrazu: .gif, .jpg, .jpeg, .png
- Maksymalny rozmiar obrazu: 10 MB
- Zdjęcie powinno przedstawiać wyłącznie produkt, na jednolitym tle, bez obramowania
- Produkt powinien zajmować 80-90% przestrzeni zdjęcia, które powinno pokazywać jak najwięcej jego szczegółów
- Obrazy nie mogą zawierać znaków praw autorskich, znaków wodnych ani odbić
Pamiętaj, że zdjęcia danego przedmiotu pobieramy przed wystawieniem oferty. Jeśli zatem korzystasz ze zdjęć produktów umieszczonych na zewnętrznym serwerze i zaktualizujesz je na tym serwerze, nie zostaną one zaktualizowane automatycznie na merXu.
Jeśli chcesz przesłać wszystkie zdjęcia razem, w jednym folderze, nazwa folderu powinna być określona w arkuszu przed nazwą pliku graficznego. Wartość kolumny powinna wyglądać: nazwa_folderu / nazwa_obrazu.
other_images_urls
dodatkowe zdjęcia
Limit: 10 zdjęć
Pole powinno zawierać adres URL lub nazwy dołączonych dodatkowych plików graficznych oddzielone średnikiem “; “:
Arkusz kalkulacyjny, kolumna other_images_urls uzupełniona nazwami 3 dodatkowych zdjęć;
Zdjęcia dodatkowe powinny spełniać te same kryteria i wymagania techniczne, co zdjęcie główne. Mogą przedstawiać produkt w użyciu, zbliżenia ważnych funkcji, produkt ukazany pod różnym kątem (z różnych stron), opakowanie produktu, akcesoria po wyjęciu z pudełka, transformacje produktu – złożony, rozwinięty, otwarty, zamknięty itp.
video_youtube
film o produkcie
Do galerii produktu możesz dodać również film reklamowy, ukazujący zalety, właściwości produktu. Do arkusza, w kolumnie video_youtube, wpisz adres URL (link) filmu z serwisu YouTube.
etim_class
Jeśli stosujesz tę klasyfikację dla swoich produktów, możesz podać kod etim w pliku.
Klasyfikacja dotyczy takich sektorów jak: Elektrotechnika, Materiały budowlane, Ogrzewanie i hydraulika oraz Narzędzia.
Klasyfikacja ETIM: http://www.etim.org.pl/klasyfikacja/lista
Przykład: EC001743
Atrybuty ofertowe
Tę część atrybutów definiujesz, jeśli chcesz wystawić swoje produkty bezpośrednio po imporcie danych.
Zwróć uwagę na atrybuty, które opisaliśmy jako wymagane. Ich prawidłowe uzupełnienie warunkuje rozpoczęcie sprzedaży po zaimportowaniu pliku.
W tej części pojawią się też atrybuty wymagające wskazania w wierszu wartości “1” lub “0”.
“1” oznacza “tak”, czyli na przykład: aktywuj, udostępnij, ukryj, zezwól.
“0” oznacza “nie”, czyli na przykład: wstrzymaj, nie udostępniaj.
currency
waluta (pole wymagane)
Cena, w której sprzedajesz produkt, może być wyrażona w jednej walucie: PLN, CZK lub EUR.
W polu wstaw trzyliterowy kod waluty zgodny z ISO 4217. Listę kodów walutowych znajdziesz tu: https://pl.wikipedia.org/wiki/ISO_4217.
Możesz prowadzić sprzedaż w różnych walutach. Potraktuj wtedy produkt z inną walutą jako osobną ofertę: nadaj mu osobny, unikatowy kod supplier_product_id, a w odpowiednim polu wskaż wybraną walutę.
Slajd pokazuje sposób zapisu danych dla tego samego przedmiotu (nazwa, kod ean) sprzedawanego w różnych walutach:
price
cena netto (pole wymagane)
Cena ofertowa netto dla produktu. Zwróć uwagę na sposób zapisu:
- cenę całkowitą zapisz w ciągu, bez użycia spacji i innych znaków;
- cenę częściową (na przykład z groszami) możesz zapisać, wyłącznie używając kropki jako separatora.
Na przykład: 10000, 120.50, 399.99
Uwaga - nawet jeśli zdecydujesz się wystawiać oferty z opcją ukrytej ceny (hidden_price) uzupełnij to pole i wskaż np. cenę katalogową produktu.
hidden_price
ukryta cena
pole wyboru 1/0. Jeśli zaznaczysz to pole wpisując “1”, cena Twojej oferty pozostanie ukryta.
Pamiętaj, że oferty z ukrytą ceną mogą być prezentowane na dole listy dostępnych ofert:
Przedziały cenowe
Omówione za chwile atrybuty wykorzystasz, jeśli cenę zakupu chcesz uzależnić od wielkości zamówienia.
Dla jednego produktu możesz zdefiniować pięć takich przedziałów, dodając do tabeli kolejne kolumny z zakresami cen.
Obecnie przedziały cenowe możesz określić na dwa sposoby. Wybierz ten, który najbardziej Ci odpowiada i trzymaj się go w całości, nie łącząc ze sobą.
Sposób 1
price_quantity
przedział cenowy
Zwróć uwagę na konstrukcję – tu oprócz wartości zmienia się też nazwa kolumny. Musisz uzupełnić parametr i w wierszu, i w nazwie kolumny.
Na slajdzie widzisz produkt, w którym dostawca podał trzy przedziały cen:
Tak wygląda ten produkt (w cenie regularnej 10 zł) z trzema przedziałami cen:
price_25 cena za sztukę dla zakupu między 25 a 49 sztuk;
price_50 cena za sztukę dla zakupu między 50 a 99 sztuk;
price_100 cena za sztukę dla zakupu od 100 sztuk.
Zwróć uwagę na to, jak zmienia się nazwa atrybutu: w nieuzupełnionej formie jest to price_quantity. Zdefiniowany i uzupełniony atrybut wskazuje wielkość zamówienia price_25, a wiersz – przypisaną do niego cenę. W miejsce quantity wstaw wartość liczbową.
Sposób 2
tier_price1 oraz tier_quantity1
W tym sposobie musisz zastosować oba parametry.
- tier_price - określa cenę produktu w tym przedziale
- tier_quantity - określa minimalną liczbę produktów wchodzącą do tego progu
Kolejne przedziały dodajesz poprzez dodanie dodatkowej pary parametrów: tier_price2 + tier_quantity2, tier_price3 + tier_quantity3, itd.
Na slajdzie widzisz przykład dwóch przedziałów:
A tak wygląda oferta:
vat
Stawka podatku VAT dla produktu
VAT wyraź liczbą całkowitą np. 23 (a nie 23% lub 8%). Nazwa atrybutu musi być zapisana małymi literami.
price_unit
jednostka sprzedaży
Domyślną jednostką sprzedaży jest sztuka. Jeśli chcesz ją zmienić, wpisz odpowiednią wartość - symbol jednostki. Do wyboru masz: metr (wpisz: “m”) , metr kwadratowy (wpisz “m2”), metr sześcienny (wpisz “m3”), litr (wpisz “l) lub kilogram (wpisz “kg”).
price_quantity
jakiej ilości towaru dotyczy wskazana cena
Przykład: jeśli cena 100zł dotyczy 5 sztuk wierteł, wpisz wartość “5” w price_quantity. Przedstawimy w ofercie cenę za 1 wiertło.
Widok arkusza:
Widok oferty:
order_increment
wielokrotność sprzedaży
Przykład 1: chcesz sprzedawać tuby kleju kartonami po 12 szt. Możesz wskazać cenę (price) 10 zł za jedną sztukę oraz ustalić order_increment równy “12”. Wówczas klient będzie mógł wybrać zakup 12, 24, 36 szt, itd.
Widok arkusza:
Widok oferty:
Przykład 2: Jeśli zależy ci, żeby wspomniane w poprzednim parametrze wiertła sprzedać w pełnym opakowaniu (5 sztuk), dodaj wartość w order_increment (5).
Widok arkusza:
Widok oferty:
Przykład 3: chcesz sprzedawać śruby w cenie 3,50 zł za 100 sztuk, ale w paczkach po 500 (ponieważ sprzedajesz pełne opakowania na 500 sztuk). Ustaw więc price na “3.5”, price_quantity na 100, a order_increment na 500. Klient będzie mógł zrobić zamówienie na minimum 5 paczek po 100 sztuk każda.
Widok arkusza:
Widok oferty:
special_price
cena specjalna
Możesz wskazać cenę specjalną, promocyjną dla swojego produktu. Określisz ją, podając obowiązującą wartość tej ceny. Na przykład jeśli produkt w cenie regularnej (price) 1000 zł ma kosztować 890 zł, to w pole special_price wpisz dodatkowo 890.
Czas trwania tej promocji możesz dowolnie zmieniać, korzystając z atrybutów special_price_from i special_price_to.
special_price_from
Jeśli chcesz, by oferta specjalna rozpoczęła się we wskazanym przez Ciebie momencie, uzupełnij pole, podając datę i godzinę startu promocji we wskazanym formacie:
YYYY-MM-DD HH:MM:SS
Jeśli w polu enabled wskazałeś “1”, a kolumnę special_price_from pozostawisz pustą, Twój produkt będzie aktywny po imporcie danych, a my domyślnie ustalimy początek trwania oferty specjalnej na moment rozpoczęcia sprzedaży.
special_price_to
Uzupełnij pole, podając datę i godzinę końca trwania ceny specjalnej w takim formacie jak dla special_price_from:
YYYY-MM-DD HH:MM:SS
Jeśli nie wskażesz końca trwania promocji, będzie ona aktywna do czasu jej “ręcznego” wyłączenia (poprzez aktualizację oferty).
condition
stan produktu – nowy, używany i odnowiony
Wybierz i wpisz jeden z trzech wariantów odpowiedzi, zgodnie ze stanem oferowanego produktu: NEW / USED / REFURBISHED.
enabled
aktywowanie ofert
Pole wyboru 1/0. Wpisz “1” lub pozostaw te miejsce puste, jeśli chcesz, żeby produkt był aktywny po zaimportowaniu pliku, a klienci mogli od razu dokonać zakupu. Wpisz “0” jeśli chcesz, żeby oferta nie była widoczna na merXu po wczytaniu pliku.
dispatch_time
czas wysyłki
Określ tym czas wysyłki produktu do odbiorcy. Podaj liczbę dni, np. 2 (a nie np. “1-2 dni”).
country_of_dispatch
kraj, z którego wysyłasz zamówienia.
Podaj tu dwuliterowy kod zgodny z ISO 3166-1, na przykład PL, CZ, EE, podany w części tabeli alfa-2. Lista kodów ISO 3166-1 alfa-2 Użyj wielkich liter.
Jeśli pozostawisz to pole puste, uznamy, że miejscem wysyłki jest kraj, w którym jest zarejestrowana Twoja firma.
destination_countries
kraje, do których zgadzasz się wysyłać zamówienia.
Podaj tu dwuliterowy kod zgodny z ISO 3166-1, na przykład PL, CZ, EE, podany w części tabeli alfa-2.
Użyj wielkich liter.Poszczególne kody państw oddziel średnikami: PL;CZ;ET;LT;SK.
Pozostaw to miejsce puste, jeśli zgadzasz się wysyłać produkty do wszystkich krajów merXu, czyli wszystkich krajów UE. Uzupełnimy wtedy te wartości automatycznie.
shipping_pricing_external_id
ID cennika dostaw, który stworzyłeś na swoim koncie.
Dodanie go powoduje udostępnienie dla kupujących przycisku KUP TERAZ.
Instrukcja tworzenia cennika: https://lp.merxu.com/pl/shipping-pricing
Atrybuty dodatkowe
W tym punkcie mówimy, jak utworzyć dodatkowe szczegółowe atrybuty, które są kluczowe w skutecznym i szybkim wyszukiwaniu i sprzedaży Twojego produktu.
Tę część pliku budujesz samodzielnie.
Atrybuty dodatkowe, w odróżnieniu od podstawowych i ogólnych, muszą posiadać nazwy w Twoim języku.
Ograniczenie do 199 znaków.
Jeśli chcesz utworzyć nowy atrybut, zdefiniuj taką nazwę kolumny, która dokładnie opisze jej znaczenie. Zwróć też uwagę, by jej format spełniał następujące kryteria:
- nazwy atrybutów muszą zaczynać się wielką literą; dalszą część nazwy zapisz małymi literami, na przykład: Kolor, Gęstość objętościowa, Waga.
- jeśli kolumna opisuje wartość wyrażoną w określonych jednostkach, podaj nazwę tej jednostki w nawiasie kwadratowym,
- jednostki miary w nawiasach mogą być zapisane małymi lub wielkimi znakami,
- odstępy między wyrazami zaznaczaj za pomocą spacji,
- każdy użyty znak będzie wyświetlany w nazwie atrybutu – unikaj kropek, przecinków lub podkreślników.