Moduł Magento ORBA Ceneo.pl PRO v. 1.0.1

Moduł Magento ORBA Ceneo.pl PRO v. 1.0.1 Kompatybilny z wersjami Magento: 1.5.x, 1.6.x, 1.7.x, 1.8.x, 1.9.x Aktualizacja dokumentacji: wtorek, 18 sierpnia 2015 Orba Sp. z o.o. ul. Bukowińska 10/170 02-703 Warszawa NIP: 521 36 54 780 Adres biura: ul. Niedźwiedzia 29A 02-737 Warszawa Roman Baluta roman.baluta@orba.pl 530 834 300 Kacper Gugała kacper.gugala@orba.pl 664 320 649 www.orba.pl

Spis treści 1. Instalacja...3 1.1 Z poziomu serwera...3 1.2 Z poziomu panelu administracyjnego...3 2. Konfiguracja...5 2.1 Konfiguracja podstawowa...5 2.2 System transakcyjny CPA...7 2.3 Mapowanie podstawowych atrybutów...7 2.2.1 Dostępność [avail]...7 2.2.2 Pozostałe atrybuty...8 2.4 Mapowanie atrybutów dla niesprecyzowanej branży...9 2.5 Mapowanie atrybutów dla poszczególnych branży...9 3. Oferta...9 3.1 Edycja dodatkowych atrybutów produktu:...9 4. Masowe mapowanie kategorii... 10 4.1 Nowe mapowanie... 10 5. Odświeżanie danych... 11 5.1 Odświeżanie kategorii... 11 5.2 Odśwież cache feedów XML... 11 6. URL-e feedów... 11 7. FAQ najczęściej zadawane pytania... 12

1. Instalacja Moduł ORBA Ceneo.pl PRO dostarczany jest jako paczka wszystkich niezbędnych plików instalacyjnych w skompresowanym formacie [tgz]. Instalację modułu należy przeprowadzić w jeden z poniżej przedstawionych sposobów: 1.1 Z poziomu serwera Ponieważ paczka z modułem ORBA Ceneo.pl PRO zachowuje odpowiednią strukturę katalogów Magento, istnieje możliwość wypakowania paczki oraz wgrania jej zawartości bezpośrednio do głównego katalogu Magento na serwerze, na którym dana platforma się znajduje. Następnie należy wykonać trzy dodatkowe kroki pozwalające na rozpoczęcie pracy z modułem: 1.1.1 Jeśli w sklepie jest włączona kompilacja kodu, należy ją wykonać ponownie. [SystemTools CompilationRun Compilation Process] 1.1.2 Z poziomu panelu administracyjnego należy wyczyścić cache Magento [Cache Management Flush Magento Cache oraz Flush Cache Storage] 1.1.3 Należy wylogować się oraz powtórnie zalogować się do panelu administracyjnego Magento. Moduł ORBA Ceneo.pl PRO będzie widoczny w zakładce [Katalog ORBA Ceneo.pl PRO]. Uwaga: Moduł ORBA Ceneo.pl PRO dodaje do Twojego Magento nowy atrybut produktu "ceneopro_category_id". Jeżeli chcesz odinstalować nasz moduł, musisz usunąć ten atrybut ręcznie! Edycja produktów w panelu administracyjnym przestanie działać, jeśli odinstalujesz moduł bez usuwania tego atrybutu. Przepraszamy za niedogodności, ale niestety, nie da się tej operacji przeprowadzić automatycznie. 1.2 Z poziomu panelu administracyjnego Jeśli dostęp do serwera jest ograniczony, administrator Magento ma możliwość zainstalowania modułu ORBA Ceneo.pl PRO z poziomu panelu administracyjnego w zakładce: [SystemMagento ConnectMagento Connect Manager] Dane potrzebna do logowania są tożsame z danymi do logowania w panelu administracyjnym. W celu poprawnej instalacji modułu należy postępować zgodnie z poniższą instrukcją: 1.2.1 W zakładce Extentions w sekcji Direct package file upload należy wybrać paczkę modułu ORBA Ceneo.pl PRO z dysku Waszego komputera, a następnie nacisnąć przycisk Upload.

1.2.2 W konsoli (znajdującej się na dole strony) otrzymamy odpowiedni status instalacji oraz końcowy komunikat. Jeśli komunikat jest pozytywny, należy postępować z jego wytycznymi i odświeżyć konsolę: Można teraz bezpiecznie wylogować się z systemu MagentoConnectManager, korzystając z przycisku Return to admin. 1.2.3 Jeśli w sklepie jest włączona kompilacja kodu, należy ją wykonać ponownie. [SystemTools CompilationRun Compilation Process] 1.2.4 Z poziomu panelu administracyjnego należy wyczyścić cache Magento [Cache Management Flush Magento Cache oraz Flush Cache Storage] 1.2.5 Należy wylogować się oraz powtórnie zalogować się do panelu administracyjnego Magento. Poprawnie zainstalowany Moduł ORBA Ceneo.pl PRO będzie widoczny w zakładce [Katalog ORBA Ceneo.pl PRO]. Uwaga: Moduł ORBA Ceneo.pl PRO dodaje do Twojego Magento nowy atrybut produktu "ceneopro_category_id". Jeżeli chcesz odinstalować nasz moduł, musisz usunąć ten atrybut ręcznie! Edycja produktów w panelu administracyjnym przestanie działać, jeśli odinstalujesz moduł bez usuwania tego atrybutu. Przepraszamy za niedogodności, ale niestety, nie da się tej operacji przeprowadzić automatycznie.

2. Konfiguracja W celu wygenerowania zawartości pliku XML należy przeprowadzić poniższą konfigurację modułu. [Katalog ORBA Ceneo.pl PRO Konfiguracja] UWAGA! Produkty nie będą widoczne w feedzie jeśli nie zostaną wprowadzone oraz uruchomione mapowania oraz/lub uzupełnione ręcznie pole kategorii Ceneo dla danych produktów. 2.1 Konfiguracja podstawowa Stanowi najważniejszą część konfiguracji modułu. Tutaj administrator decyduje globalnie, jakie informacje o produktach zostaną udostępnione poprzez serwis Ceneo.pl. Poniżej znajduje się lista podstawowych ustawień wraz z ich krótkim opisem. 2.1.1. Unikalny hash Jest to wartość generowana automatycznie podczas instalacji modułu. Istnieje możliwość jej edycji. Jest ona doklejana do URL-i feedów w celu ochrony przed łatwym dostępem pliku z zewnątrz. 2.1.2. Generowanie feeda live Istnieje możliwość wyboru, w którym momencie feed XML będzie budowany. Jeśli wybrano "Tak" feed XML będzie budowany od nowa przy każdym wejściu w URL. Jeśli wybrano "Nie", będzie pobierany z cache'u. Pamiętajmy, że przy dużej liczbie produktów w sklepie feed budowany live będzie generowany bardzo długo, co może obciążać cały sklep, ale również może

spowodować, że Ceneo.pl nie pobierze pliku w ogóle (timeout). Zalecamy, aby sklepy z dużą liczbą produktów lub wolnymi serwerami ustawiały tę wartość na Nie. Cache Ceneo.pl PRO odświeża się co każde 6 godzin, ale jego ważność jest dłuższa, w związku z czym nie ma możliwości, żeby robot Ceneo natrafił na brak pliku. Jeśli jednak tak by się zdarzyło (np. popsuł się CRON albo ktoś ręcznie wyczyścił cache Magento), plik zacznie generować się na żywo. 2.1.3. Używaj ID zamiast SKU w feedach Pozwala na zmianę pierwotnej logiki budowania feedu (z wykorzystaniem SKU produktu). Funkcja została dodana do modułu ze względu na fakt, iż serwis Ceneo.pl nie akceptuje wszystkich formatów SKU np. ze spacjami. 2.1.4. Eksportuj produkty bez zdefiniowanej kategorii Ceneo.pl Standardowo w feedach XML pojawiają się jedynie produkty, którym zdefiniowano kategorię w Ceneo.pl (poprzez Masowe Mapowanie lub ręcznie podczas edycji produktu). Jeśli sklep ma potrzebę, aby wykorzystywać nasz moduł do wygenerowania katalogu XML ze wszystkimi produktami dla integracji innych niż Ceneo.pl, można ustawić tę opcję na Nie, co spowoduje ignorowanie sprawdzania, czy kategoria została ustawiona. 2.1.5. Eksportuj niedostępne produkty Moduł umożliwia zdefiniowanie czy produkty niedostępne w sklepie (stan magazynowy równy zero) zostaną wyeksportowane do pliku XML. Administrator ma możliwość wybrania opcji Nie, wówczas podczas generowania pliku XML produkty niedostępne są pomijane. 2.1.6. Pokaż dostępność w feedzie XML Możliwość wyświetlenia w pliku XML stanu magazynowego produktu lub jego ukrycie. 2.1.7. Pokaż w feedzie XML, czy produkt jest zestawem Przy wykorzystaniu dedykowanego atrybutu produktu można uruchomić (pokazać w pliku XML) dodatkowy atrybutu Ceneo.pl - set, informujący, że dany produkt prosty jest w rzeczywistości zestawem kilku produktów 2.1.8. Pokaż masę produktu w feedzie XML Możliwość pokazania w w pliku XML masy produktu (weight). Jeśli masa produktu będzie pusta dla danego produktu, ale skonfigurujemy moduł tak, aby ją wyświetlał, wówczas w pliku XML nie pojawi się wartość weight. 2.1.9. Pokaż w feedzie XML, czy produkt jest dostępny w Kup na Ceneo Ta opcja dotyczy sklepów, które posiadają aktywną usługę Kup na Ceneo. Wówczas jej oznaczenie na Tak powoduje dodanie do pliku XML cechy basket, która informuje, który produkt dostępny będzie do kupienie bezpośrednio w serwisie Ceneo.pl. 2.1.10. Pokaż stany magazynowe w feedzie XML

Możliwość wyświetlenia w pliku XML dokładnej liczby dostępnych produktów w Magento (stock). 2.2 System transakcyjny CPA Obsługa przekazywania danych do serwisu Ceneo.pl dla sklepów, które współpracują z serwisem na zasadzie prowizyjnym od zrealizowanego zamówienia. Konfiguracja funkcji wymaga wprowadzenia numeru GUID sklepu widoczny w panelu Ceneo.pl klienta. 2.3 Mapowanie podstawowych atrybutów Moduł umożliwia mapowanie atrybutów produktów z podstawowymi atrybutami występującymi w strukturze pliku XML Ceneo.pl 2.2.1 Dostępność [avail] Istnieje możliwość określenia 5 poziomów dostępność produktu, które będą widoczne dla użytkownika w serwisie Ceneo.pl. avail - dostępność produktu. Dostępne opcje [1, 3, 7, 14, 99] gdzie: 1 dostępny, sklep wyśle produkt w ciągu 24 godzin, 3 sklep wyśle produkt do 3 dni, 7 sklep wyśle produkt w ciągu tygodnia, 14 produkt zostanie wysłany nie wcześniej niż za tydzień, 99 brak informacji o dostępności status sprawdź w sklepie. Podane wartości muszą być zgodnie ze stanem faktycznym. 1 W zakładce [Ceneo.pl Pro Konfiguracja Mapowanie podstawowych atrybutów] znajdują się cztery zmienne pozwalające na przypisanie danej grupie produktów odpowiednią wartość atrybutu avail. 1 https://shops.ceneo.pl/documents/informacje%20na%20temat%20struktury%20pliku%20xml.pdf stan na dzień 20.07.2015r.

Grupowanie produktów odbywa się poprzez określenie atrybutu oraz jego wartości. Lista atrybutów pobierana jest zgodnie z ustawieniami w danym sklepie Magento. Jeśli powyższe pola nie zostaną uzupełnione, wówczas atrybut avail będzie posiadał status: 99 brak informacji o dostępności status sprawdź w sklepie Sugerujemy na potrzeby tego mapowania stworzyć nowy atrybut produktu z wartościami pasującymi do tych z Ceneo.pl. 2.2.2 Pozostałe atrybuty Moduł umożliwia mapowanie również trzech innych atrybutów występujących w strukturze pliku. Produkt jest zestawem gdy [ ] ma wartość [ ] konfiguracja umożliwia przypisanie danej grupie towarów oznaczenia zestawu, zgodnie z wytycznymi Ceneo.pl (set - zestaw. Czy oferta jest zestawem. Dostępne opcje [1, 0] gdzie; 1 tak, oferta jest zestawem, 0 nie, oferta nie jest zestawem 2 ). Produkt jest dostępny w Kup na Ceneo, gdy [ ] ma wartość [ ] konfiguracja umożliwia przypisanie danej grupie towarów oznaczenia Kup na ceneo, zgodnie z wytycznymi Ceneo.pl (basket - dotyczy sklepów aktywnych w usłudze Kup na Ceneo. Czy oferta ma być dostępna w Kup na Ceneo. Dostępne opcje [1, 0] gdzie; 1 tak, oferta dostępna w Kup na Ceneo, 0 nie, oferta niedostępna w Kup na Ceneo 3 ). Atrybut z opisem produktu domyślna konfiguracja wybiera atrybut description dla produktów. Jeśli jednak w Państwa sklepie opis towaru znajduje się w innym atrybucie (np. atrybucie dodanym specjalnie przez Państwa), należy wybrać go z listy i zapisać konfigurację. 2 https://shops.ceneo.pl/documents/informacje%20na%20temat%20struktury%20pliku%20xml.pdf stan na dzień 20.07.2015r. 3 Ibidem.

2.4 Mapowanie atrybutów dla niesprecyzowanej branży Jeśli branża w jakiej Państwo prowadzicie swoją działalność handlową nie zostało wyróżnione w konkretnych zakładkach konfiguracji, w celu usprawnienia integracji z Ceneo.pl należy przypisać odpowiednie atrybuty produktu do wymaganych przez Ceneo.pl atrybutów oferty: Producent Kod_producenta EAN Pojemność 2.5 Mapowanie atrybutów dla poszczególnych branży Moduł ORBA Ceneo.pl PRO posiada odrębne zakładki mapowania atrybutów dla poszczególnych branży. 3. Oferta [Katalog ORBA Ceneo.pl Pro Oferta] Ekran oferty zawiera listę produktów znajdujących się w pliku XML, spełniających kryteria wcześniej przeprowadzonej konfiguracji. Z poziomu tego ekranu administrator ma możliwość przejścia do ekranu szczegółu danego produktu w celu jego edycji (przycisk Edytuj ). W tym widoku możliwe jest filtrowanie produktów według poniższych atrybutów: ID SKU Nazwa Kategoria Ceneo Specjalna kolumna Ostrzeżenie informuje administratora, gdy produkt posiada cenę równą 0 zł ( Cena jest ustawiona na 0! ). 3.1 Edycja dodatkowych atrybutów produktu: Moduł ORBA Ceneo.pl PRO wprowadza zmiany również na ekranie szczegółu produktu: Dodawane przez moduł atrybuty umożliwiają dopisanie odpowiedniej kategorii Ceneo do danego produktu z poziomu ekranu szczegółu produktu. Sufiks nazwy produktu w Ceneo może być dowolną wartością, która zostanie przypisana do nazwy produktu w pliku XML:

4. Masowe mapowanie kategorii Przypisywanie produktów do danej kategorii Ceneo jest możliwe z poziomu zakładki [Katalog ORBA Ceneo.pl Pro Masowe mapowanie kategorii]. 4.1 Nowe mapowanie Moduł umożliwia przypisanie odpowiedniej kategorii Ceneo do danej, zdefiniowanej przez administratora, grupy produktów. Mapowanie odbywa się w trzech krokach: 1. Wybranie kategorii Ceneo z listy wcześniej zsynchronizowanych kategorii. 2. Określenie priorytetu mapowania (mapowanie z niższą liczbą będzie wykonywać się przed mapowaniem z wyższą). 3. Zdefiniowanie reguły, warunku dla produktów, które chcemy przypisać do wcześniej określonej kategorii Ceneo. Po wprowadzeniu wszystkich mapowań należy użyć przycisku Uruchom mapowania w celu przypisania kategorii Ceneo. Mapowania będą uruchamiać się również samodzielnie codziennie o północy (używając CRON). Przypisane kategorie Ceneo będą widoczne na ekranie edycji produktu.

Uwaga: Warto posiadać utworzone mapowanie o najniższym priorytecie na pustą kategorię Ceneo.pl. Dzięki temu przed każdym uruchomieniem wszystkich mapowań nastąpi reset przypisania produktów do kategorii Ceneo.pl. Od wersji 1.0.0 modułu takie mapowanie dodawane jest automatycznie podczas instalacji. 5. Odświeżanie danych 5.1 Odświeżanie kategorii Moduł zapewnia automatyczne odświeżanie kategorii Ceneo, jednakże umożliwia również ręczne odświeżenie kategorii Ceneo, rekomendowane szczególnie przed konfigurowaniem nowych mapowań. Odświeżanie wykonujemy poprzez zakładkę Katalog ORBA Ceneo.pl PRO Odświeżanie kategorii]. Poprawne wykonanie synchronizacji zostanie potwierdzone odpowiednim komunikatem: 5.2 Odśwież cache feedów XML W przypadku bardzo dużej liczby produktów w sklepie, rekomendujemy wykorzystanie wbudowanego w moduł cache a feedów (patrz punkt 2.1.2 konfiguracji). Cache można odświeżyć zarówno w zakładce [Katalog ORBA Ceneo.pl Pro Odśwież cache feedów XML], jak i w [System Zarządzanie cache]. 6. URL-e feedów Efektem wszystkich działań konfiguracyjnych jest otrzymanie feeda pliku XML, zawierającego katalog produktów z Państwa sklepu. W zakładce [Katalog ORBA Ceneo.pl Pro URL-e feedów] znajdą Państwo adresy URL plików XML dla każdego ze store view zdefiniowanego w sklepie Magento: Z poziomu tego ekranu można bezpośrednio przejść do widoku pliku XML w oknie przeglądarki lub skopiować adres url w celu przekazania go do serwisu Ceneo.pl.

7. FAQ najczęściej zadawane pytania Pytanie: Czy istnieje możliwość generowania pliku XMLa tak, by w Ceneo było widoczne "dostępne" a nie "sprawdź w sklepie"? Odpowiedź: Tak. Jeśli chcemy aby wszystkie produkty przesłane do Ceneo.pl posiadały status "Dostępne", należy skonfigurować moduł jak na screenshot'cie: Pytanie: Czy istnieje możliwość zmapowania kategorii Ceneo dla jednego widoku sklepu (store view)? *** Odpowiedź: Niestety, nie ma możliwości tworzenia mapowań per store view - zarówno w darmowej jak i płatnej wersji naszego modułu. Pytanie: Czy moduł ORBA Ceneo.pl Pro jest szyfrowany? Czy po zakupie będę mógł go rozwijać? *** Odpowiedź: Nie używamy szyfrowania w żadnym z naszych płatnych modułów. Można nadpisywać nasz dodatek w swoim sklepie. *** Pytanie: Jak wygląda migracja z modułu podstawowego w Magento czy trzeba na nowo wrzucać produkty do kategorii Ceneo.pl?

Odpowiedź: Niestety, ze względu na inny mechanizm mapowania w module PRO istnieje konieczność nowego zmapowania produktów z kategoriami Ceneo.pl. *** Dziękujemy za zainteresowanie modułem ORBA Ceneo.pl Pro W razie dodatkowych pytań związanych z funkcjonalnością oraz rozwojem modułu prosimy o kontakt na adres info@orba.pl Zespół ORBA