Moduł Magento ORBA | Allegro v. 0.1.1

Moduł Magento
ORBA | Allegro v. 0.1.1
Kompatybilny z wersjami Magento: 1,7, 1.8, 1.9
Aktualizacja dokumentacji:
piątek, 11 września 2015
Orba Sp. z o.o.
Roman Baluta
ul. Bukowińska 10/170
02-703 Warszawa
NIP: 521 36 54 780
[email protected]
530 834 300
Kacper Gugała
Adres biura:
ul. Niedźwiedzia 29A
02-737 Warszawa
www.orba.pl
[email protected]
664 320 649
Spis treści
1.
2.
3.
Instalacja.......................................................................................................................................... 4
1.1
Z poziomu serwera .................................................................................................................. 4
1.2
Z poziomu panelu administracyjnego ..................................................................................... 5
Konfiguracja ..................................................................................................................................... 6
2.1
Pierwszy krok ................................................................................................................... 6
2.2
Drugi krok ........................................................................................................................ 6
2.3
Następne etapy konfiguracji............................................................................................ 6
2.2.1
Zamówienia ............................................................................................................. 7
2.2.2
Synchronizacja kategorii .......................................................................................... 7
2.2.3
Domyślny szablon aukcji.......................................................................................... 7
2.2.4
Domyślna lokalizacja Sprzedającego ....................................................................... 8
2.2.5
Domyślne ustawienia zdjęcia produktu................................................................... 8
2.2.6
Domyślne cechy aukcji ............................................................................................ 9
2.2.7
Domyślne formy płatności ....................................................................................... 9
2.2.8
Domyślne formy dostawy ........................................................................................ 9
2.2.9
Narzędzia ................................................................................................................. 9
Aukcje Allegro ................................................................................................................................ 10
3.1
W zakładce [ORBA|Allegro  Aukcje] administrator ma możliwość: .............................. 10
3.1.1 Podglądu wszystkich wystawionych aukcji za pośrednictwem modułu wraz z
informacjami podstawowymi tj................................................................................. 10
3.1.2 Wystawienia nowej aukcji. ............................................................................ 10
3.1.3 Zakończenia aukcji (z możliwością odwołania ofert) [Actions]. .................... 10
3.1.4 Ponownego wystawienia produktu na aukcję (wznowienia aukcji) [Actions].
10
3.1.5 Podgląd aukcji w widoku online. ................................................................... 10
3.2
Wystawianie aukcji ............................................................................................................ 10
3.3
Pola dodatkowe, które należy uzupełnić podczas wystawiania aukcji (pola te nie są
definiowalne podczas konfiguracji): .............................................................................................. 11
3.3.1 Kategorie Allegro / kategorie sklepu Allegro................................................. 11
3.3.2 Planowanie aukcji .......................................................................................... 11
3.3.3 Automatyczne wznowienie oferty w sklepie Allegro .................................... 12
3.3.4 Cena wywoławcza ......................................................................................... 12
3.3.5 Cena minimalna: ............................................................................................ 12
3.3.6 Dodatkowe atrybuty przypisane do danej kategorii Allegro. ........................ 12
3.3.7 Waga z opakowaniem. .................................................................................. 12
3.4
Statusy aukcji ..................................................................................................................... 12
4.
Ustawienia różnych kont Allegro dla store-views w Magento ...................................................... 13
5.
Sprzedaż ........................................................................................................................................ 13
5.1
Oferty kupna .......................................................................................................... 13
5.1.1 Automatyczna synchronizacja Ofert kupna, jakie złożyli klienci w systemie
Allegro. ...................................................................................................................... 13
5.1.2 Lokalne ignorowanie Ofert kupna. ................................................................ 13
5.1.3 Możliwość dodawania komentarzy do Ofert kupna. Komentarze widoczne są
lokalnie - na ekranie danej Oferty kupna. ................................................................. 13
5.1.4 Możliwość Złożenia Zamówienia na podstawie Oferty kupna rozpoczynając
standardowy proces zamówienia Magento. ............................................................. 13
5.1.5 Oferta kupna może posiadać jeden z poniższych statusów: ......................... 13
5.2
Transakcje .............................................................................................................. 14
5.2.1 Ręczna synchronizacja transakcji .................................................................. 14
5.2.2 Lokalne ignorowanie transakcji ..................................................................... 14
5.2.3 Możliwość Złożenia zamówienie ................................................................... 14
6.
Szablony aukcji .............................................................................................................................. 14
7.
Synchronizacja ............................................................................................................................... 15
7.1 Synchronizacja kategorii Allegro .......................................................................... 15
8.
Mapowanie.................................................................................................................................... 17
8.1 Use global mapping .......................................................................................... 17
8.2 Mapowanie szablonów aukcji .......................................................................... 18
8.3 Mapowanie kategorii........................................................................................ 19
8.4 Mapowanie metod dostawy............................................................................. 20
8.5 Mapowanie sposobu płatności......................................................................... 20
9.
FAQ | najczęściej zadawane pytania ............................................................................................. 21
1. Instalacja
Moduł ORBA | Allegro 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|Allegro 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
1.1.2
1.1.3
Jeśli w sklepie jest włączona kompilacja kodu, należy ją wykonać ponownie.
[SystemTools CompilationRun Compilation Process]
Z poziomu panelu administracyjnego należy wyczyścić cache Magento [Cache
Management  Flush Magento Cache oraz Flush Cache Storage]
Należy wylogować się oraz powtórnie zalogować się do panelu administracyjnego
Magento.
Moduł ORBA|Allegro będzie widoczny w zakładce [Sales  ORBA | Allegro].
1.2 Z poziomu panelu administracyjnego
Jeśli dostęp do serwera jest ograniczony, administrator Magento ma możliwość
zainstalowania modułu ORBA|Allegro z poziomu panelu administracyjnego w zakładce:
[SystemMagento ConnectMagento 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 Settings należy zmienić Preferred State na Beta oraz zapisać zmiany.
1.2.2 W zakładce Extentions w sekcji Direct package file upload należy wybrać paczkę
modułu ORBA|Allegro z dysku Waszego komputera, a następnie nacisnąć przycisk
Upload.
1.2.3 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.4 Jeśli w sklepie jest włączona kompilacja kodu, należy ją wykonać ponownie.
[SystemTools CompilationRun Compilation Process]
1.2.5 Z poziomu panelu administracyjnego należy wyczyścić cache Magento [Cache
Management  Flush Magento Cache oraz Flush Cache Storage]
1.2.6 Należy wylogować się oraz powtórnie zalogować się do panelu administracyjnego
Magento.
Poprawnie zainstalowany Moduł ORBA|Allegro będzie widoczny w zakładce [Sales  ORBA |
Allegro].
2. Konfiguracja
2.1 Pierwszy krok
W celu uruchomienia modułu i możliwości jego konfiguracji należy w pierwszym kroku
wprowadzić dane konta Allegro:



Klucz API
Nazwa użytkownika
Hasło
2.2 Drugi krok
Synchronizacja kategorii powinna zostać wykonana jako kolejny krok po integracji danych
konta Allegro z modułem. W tym celu należy przejść do zakładki
[Sprzedaż  ORBA|Allegro  Synchronizacja  Synchronizacja kategorii]
W celu uruchomienia synchronizacji należy naciskać przycisk [Kliknij tutaj, aby rozpocząć
synchronizację].
Synchronizacja może zająć kilka minut. Należy spokojnie odczekać wymagany czas, aż do
momentu otrzymania pozytywnego komunikatu:
2.3 Następne etapy konfiguracji
Po wprowadzeniu poprawnych danych konta uaktywnione zostaną poszczególne etapy
konfiguracji modułu ORBA|Allegro:
2.2.1 Zamówienia
W tej zakładce należy zdefiniować trzy funkcje dotyczące zarządzania zamówieniami z
poziomu panelu administracyjnego:



Automatyczne składanie zamówień [Funkcja w wersji developerskiej – niezależnie od
ustawionej wartości nie zachodzi synchronizacja zamówień Magento oraz zamówień
z systemu Allegro]
TAK – zamówienia złożone przez klientów w systemie Allegro będą automatycznie
uruchamiały proces zamówienia w Magento. Otrzymają status „w realizacji”.
NIE – zamówienia złożone przez klientów w systemie Allegro będą wymagały
dodatkowej autoryzacji oraz ręcznej akceptacji.
Zarejestruj klientów – jeśli Klient nie posiada konta w sklepie, to zostanie ono
automatycznie stworzone w momencie złożenia zamówienia na platformie Allegro.
Nadpisz ceny dostawy – jeśli zdecydujemy się nadpisać ceny dostawy, oznacza to, że
wystawiona przez nas aukcja będzie uwzględniała ceny dostawy zdefiniowane w
systemie Allegro, ignorując warunki dostaw istniejące w sklepie.
2.2.2 Synchronizacja kategorii
Automatyczna synchronizacja kategorii pozwala na automatyczne przypisanie produktom w
Magento atrybutów Allegro tj. kategorii Allegro.
2.2.3 Domyślny szablon aukcji
W tej sekcji istnieje możliwość zdefiniowania podstawowego szablonu aukcji. Jeśli przy
wystawianiu aukcji szablon ten nie zostanie zmieniony, aukcja zostanie wystawiona używając
domyślnego szablonu.
Administrator może zdefiniować trzy podstawowe kolory szablonu (moduł obsługuje paletę
kolorów RGB):
 Kolor nagłówków [Accent color]
 Kolor subkategorii [Text light color]
 Kolor tekstu głównego [Text color]
Definiowalne kolory zostały zaznaczone poniżej:
Accent color
Text color
Text light
color
2.2.4 Domyślna lokalizacja Sprzedającego
Umożliwia konfigurację podstawowych danych lokalizacyjnych Sprzedającego:
 Kraj
 Województwo
 Miejscowość
 Kod pocztowy
Dane te będą automatycznie wprowadzane do formularza wystawiania aucji.
2.2.5 Domyślne ustawienia zdjęcia produktu
Umożliwia konfigurację parametrów zdjęć produktowych wyświetlanych w opisie oraz
szablonie aukcji.




Ilu zdjęć maksymalnie użyć – przy wystawianiu aukcji moduł pobierze taką liczbę
zdjęć jaka zostanie określona w tym punkcie konfiguracji. Zdjęcia zostaną zaciągnięte
w kolejności odpowiadającej kolejności w systemie Magento. Liczba uwzględnia
zdjęcie główne/miniaturkę produktu.
Miniaturka/Zdjęcie główne – przy wystawieniu aukcji moduł ustawi jako
miniaturkę/zdjęcie główne zdjęcie wybrane w tym kroku.
Maksymalna szerokość
Maksymalna wysokość

Zachowaj stały rozmiar (bloku) – jeśli wybierzemy opcję TAK, pobierane przez moduł
zdjęcie zostanie przystosowane do bloku o określonej szerokości oraz wysokości w
krokach poprzedzających.
2.2.6 Domyślne cechy aukcji
Umożliwia konfigurację podstawowych parametrów aukcji, które zostaną automatycznie
uwzględnione przy wystawianiu każdej nowej aukcji.
Sugerujemy wprowadzenie najczęściej stosowanych parametrów.
2.2.7 Domyślne formy płatności
Umożliwia konfigurację formy płatności, które zostaną automatycznie uwzględnione przy
wystawianiu każdej nowej aukcji.
Metody płatności odpowiadają metodom udostępnionym przez platformę Allegro.
Konfiguracja uwzględnia również ustawienie numerów kont bankowych Sprzedawcy.
2.2.8 Domyślne formy dostawy
Umożliwia konfigurację formy dostawy, strony odpowiedzialnej za poniesienie kosztów
wysyłki oraz inne warunki dostawy, które zostaną automatycznie uwzględnione przy
wystawianiu każdej nowej aukcji.
Metody dostawy odpowiadają metodom udostępnionym przez platformę Allegro.
2.2.9


Narzędzia
Tryb debuggowania - zapewnia logowanie danych wysyłanych przez moduł
ORBA|Allegro do API Allegro [/var/log/allegro.log]. Informacje zwracane przez API
Allegro nie są zapisywane.
Unhandled Item Count Mode – zapewnia pobieranie danych dotyczących
„Nieobsłużonej ilości sztuk” za pomocą technologii Ajax:
[Sprzedaż >> ORBA | Allegro >> Sprzedaż >> Oferty Kupna]
W przypadku ustawienia TAK dane dotyczące „nieobsłużonej ilości sztuk” pobierane
są dopiero w momencie kliknięcia na poszczególny wiersz odpowiadający pojedynczej
Ofercie kupna. W przypadku NIE dane o wszystkich „nieobsłużonych ilościach sztuk”
są ładowane w momencie generowania listy Ofert kupna.
W momencie posiadania dużej ilości zamówień oraz produktów w sklepie
zastosowanie opcji NIE może spowodować obciążenie.
3. Aukcje Allegro
3.1 W zakładce [ORBA|Allegro  Aukcje] administrator ma możliwość:
3.1.1 Podglądu wszystkich wystawionych aukcji za pośrednictwem modułu wraz z
informacjami podstawowymi tj.
 Allegro ID;
 Tytuł aukcji;
 Kategoria Allegro;
 Liczba wystawionych sztuk/par/kompletów;
 Liczba sprzedanych sztuk/par/kompletów;
 Stan magazynowy;
 Cena jednostkowa;
 Status aukcji;
 Określony czas, jaki pozostał do końca aukcji (jeśli informacja taka zostanie dodana
podczas tworzenia aukcji);
 Ręcznego odświeżenia aktualnych aukcji;
 Oznaczenie aukcji, których sprzedaż przekroczyła stan magazynowy
3.1.2
3.1.3
3.1.4
3.1.5
Wystawienia nowej aukcji.
Zakończenia aukcji (z możliwością odwołania ofert) [Actions].
Ponownego wystawienia produktu na aukcję (wznowienia aukcji) [Actions].
Podgląd aukcji w widoku online.
3.2 Wystawianie aukcji
Produkt na aukcję można wystawić z poziomu:


Katalogu produktów [Nowa Aukcja]
Panelu do zarządzania aukcjami [ORBA|Allegro  Aukcje]
Podczas wystawiania danego produktu na aukcję większość parametrów aukcji jest pobierana
z wcześniej przeprowadzonej, jednorazowej konfiguracji modułu. Wszystkie zaciągnięte dane
są edytowalne.
Podczas tworzenia aukcji administrator posiada możliwość podglądu aukcji oraz jej
przetestowania przed wystawieniem.
Moduł zwraca użytkownikowi komunikaty dotyczące błędów popełnionych podczas
definiowania aukcji. Jeśli aukcja posiada poprawne parametry, administrator otrzyma
komunikat dotyczący pozytywnej walidacji danych oraz kosztów wystawienia aukcji:
Wystawione aukcje są synchronizowane z Moje Konto w systemie Allegro. Dane aukcji w
obu systemach są tożsame!
3.3 Pola dodatkowe, które należy uzupełnić podczas wystawiania aukcji (pola te
nie są definiowalne podczas konfiguracji):
3.3.1 Kategorie Allegro / kategorie sklepu Allegro
Jeśli nie została wybrana automatyczna synchronizacja kategorii lub kategorie te nie zostały
ustawione w atrybutach produktu.
3.3.2 Planowanie aukcji
Możliwość ustawienia daty wystawienia aukcji (innej niż dzień jej utworzenia w systemie).
Planowanie aukcji odbywa się na określonych poniżej warunkach:
3.3.3 Automatyczne wznowienie oferty w sklepie Allegro
Umożliwia wznowienie oferty po jej zakończeniu.
3.3.4 Cena wywoławcza
Cena, od której rozpocznie się licytacja. Najniższa dopuszczalna cena wywoławcza
to 1 zł. Jeśli wystawiamy produkt na aukcję KUP TERAZ w polu pozostawiamy wartość
0 zł.
3.3.5 Cena minimalna:
Jeśli wystawiamy produkt na aukcję KUP TERAZ w polu pozostawiamy wartość 0 zł.
3.3.6 Dodatkowe atrybuty przypisane do danej kategorii Allegro.
3.3.7 Waga z opakowaniem.
3.4 Statusy aukcji
Statusy aukcji odpowiadają statusom zwracanym przez API Allegro.
Aukcje mogą posiadać jeden z poniższych statusów:
a.
b.
c.
d.
e.
f.
g.
h.
i.
j.
Zapisano lokalnie - wersja robocza stworzona, gdy połączenie z systemem Allegro
nie powiodło się w momencie wykonywania akcji [Zapisz i opublikuj];
Nie zweryfikowano - przez administratora Allegro;
Nadużycie (Zignorowana) - odrzucona przez system Allegro;
Oczekuje – status widoczny zaraz po utworzeniu aukcji bez daty jej
opublikowania;
Umieszczono - obecnie trwająca aukcja, widoczna na Allegro.pl;
Nadchodzące - aukcja z ustawioną data rozpoczęcia różną od daty dnia jej
stworzenia;
Oczekuje (ponowne wystawienie) - aukcja czekająca na ponowne wystawienie
zgodnie z wcześniej określonym atrybutem „Wystaw ponownie”;
Anulowano;
Zakończone przed czasem – aukcja zakończona przez wystawiającego;
Zakończone – aukcja zakończona w określonym czasie jej trwania.
4. Ustawienia różnych kont Allegro dla store-views w Magento
Moduł umożliwia konfigurację wielu kont Allegro dla poszczególnego store-view Magento.
Konfiguracja modułu dla poszczególnych store-view możliwa jest w zakładce:
[System  Konfiguracja  ORBA|Allegro]
W panelu Current Configuration Scope należy wybrać store-view, dla którego planujemy wykonać
odmienną konfigurację modułu ORBA|Allegro.
Domyślnie ustawione zostało pierwsze skonfigurowane konto Allegro. Uzupełniając pierwszą sekcję
„Konfiguracja” modułu należy podać nowe dane konta Allegro, a następnie przeprowadzić ponownie
konfigurację opisaną w punkcie 2.2.
5. Sprzedaż
Moduł umożliwia zarządzaniem transakcjami oraz ofertami kupna dokonanymi za pośrednictwem
systemu Allegro, synchronizowanymi z platformą Magento.
Panel zarządzania sprzedażą znajduje się z zakładce [Sprzedaż  ORBA|Allegro  Sprzedaż]:
5.1 Oferty kupna
5.1.1 Automatyczna synchronizacja Ofert kupna, jakie złożyli klienci w systemie Allegro.
5.1.2 Lokalne ignorowanie Ofert kupna.
Niewpływające na status zamówienia na koncie Allegro) Istnieje możliwość ponownej
aktywacji Oferty.
5.1.3 Możliwość dodawania komentarzy do Ofert kupna. Komentarze widoczne są lokalnie na ekranie danej Oferty kupna.
5.1.4 Możliwość Złożenia Zamówienia na podstawie Oferty kupna rozpoczynając
standardowy proces zamówienia Magento.
Funkcja ta pozwala na gromadzenie informacji sprzedażowych za pośrednictwem systemu
Allegro wraz z zamówieniami dokonanymi w sklepie [Sprzedaż  Zamówienia]. Zamówienie
zostanie złożone w store-view sklepu, w którym została wystawiona aukcja.
5.1.5 Oferta kupna może posiadać jeden z poniższych statusów:
 Sprzedano (status ustawiony jest domyślnie w momencie złożenia Oferty kupna przez
Kupującego)
 Nie sprzedano
 Anulowano
„Nieobsłużona ilości sztuk” – jest to wartość informująca dla ilu produktów zamówionych w
systemie Allegro nie zostało utworzone Zamówienie w systemie Magento.
5.2 Transakcje
5.2.1 Ręczna synchronizacja transakcji
Transakcje są to oferty kupna zakończone wypełnieniem formularza przesyłki i płatności. W
celu zaktualizowania danych transakcji należy użyć przycisku Aktualizuj dane w zakładce:
[Sprzedaż  ORBA|Allegro  Sprzedaż  Transakcje].
5.2.2 Lokalne ignorowanie transakcji
Niewpływające na status zamówienia na koncie Allegro. Istnieje możliwość ponownej
aktywacji transakcji.
5.2.3 Możliwość Złożenia zamówienie
Funkcja rozpoczynają standardowy proces zamówienia Magento. Pozwala na gromadzenie
informacji sprzedażowych za pośrednictwem systemu Allegro wraz z zamówieniami
dokonanymi w sklepie [Sprzedaż  Zamówienia]. Zamówienie zostanie złożone w storeview sklepu, w którym została wystawiona aukcja.
UWAGA!
Podczas tworzenia zamówienia na podstawie danych transakcji lub kupna / sprzedaży istnieje możliwość
utworzenia konta Klienta w systemie Magento.
Należy pamiętać, że Klient, dla którego konto zostanie założone w naszym sklepie otrzyma email
potwierdzający rejestrację w naszym serwisie.
6. Szablony aukcji
Moduł ORBA|Allegro zawiera dwa domyślne szablony z możliwością dostosowania ich kolorystyki z
poziomu konfiguracji modułu (patrz pkt. 2.2.3.):


Default Allegro.pl
Extended Allegro.pl (Rozszerzony o ikonę playera YouTube (iframe) umożliwiającą
wyświetlenie filmu produktowego. Link do filmu produktowego umieszczamy jako atrybut
danego produktu w karcie produktu w zakładce ORBA|Allegro).
Zarządzanie istniejącymi szablonami oraz tworzenie nowych możliwe jest w zakładce:
[Sprzedaż  ORBA|Allegro  Szablony aukcji]
Moduł zapewnia:
6.1 Możliwość utworzenia nielimitowanej liczba szablonów.
6.2 Rozbudowany o dodatkowe parametry system zmiennych szablonów Magento:
6.3
6.4
6.5
6.6
 zmienne pobierane są z konta użytkownika Allegro,
 produkt aukcji i jego dowolne cechy
 linki do stron „o mnie”, „aukcje”, itp. tworzone dynamicznie
Bloki specjalne dla szablonu aukcji:
 tabela atrybutów produktu,
 galeria zdjęć (zdjęcia pobierane z serwera systemu Magento)
 film video (YouTube)
Dodatkowe bloki CMS umieszczane w szablonie, korzystające z danych konta Allegro
oraz lokalnego Magento:
 menu z dynamicznymi linkami
 blok informacyjny (informacje o sklepie)
Możliwość definiowania dowolnych dodatkowych bloków (spójnych z wymogami systemu
Magento).
Edytor HTML.
7. Synchronizacja
Moduł ORBA|Allegro pozwala na uruchomienie automatycznych synchronizacji na poszczególnych
polach działania modułu:





Aukcji
Danych kupujących
Kategorii Allegro,
Transakcji i ich statusów
Ofert Kupna i ich statusów
Większość synchronizacji przebiega automatycznie i nie wymaga dodatkowych ustawień
administratora. Moduł umożliwia jednak w dowolnym czasie na ręczną aktualizację synchronizacji
Aukcji oraz Kategorii Allegro.
Narzędzie do synchronizacji znajduje się w zakładce [Sprzedaż  ORBA |Allegro  Synchronizacja]
7.1 Synchronizacja kategorii Allegro
Specyficzną synchronizacją jest synchronizacja kategorii Allegro. System Allegro posiada
swoją unikalną strukturę kategorii, którą w łatwy sposób możemy aktualizować w naszym
sklepie Magento.
Instalacja modułu ORBA|Allegro automatycznie powoduje utworzenie dodatkowej zakładki
atrybutów produktu [Katalog  Zarządzaj produktami  wybrany produkt  Informacje o
produkcie  ORBA|Allegro]
Moduł umożliwia zdefiniowanie dla każdego poszczególnego produktu dodatkowych
Atrybutów takich jak:




Kategoria Allegro
Kategoria Sklepu Allegro
Domyślny szablon aukcji
YouTube ID (ID filmiku w kanale YouTube, który chcemy umieścić w szablonie aukcji)
Dostępne w atrybutach drzewo kategorii jest zsynchronizowanym drzewem kategorii
Allegro.
8. Mapowanie
Moduł ORBA|Allegro umożliwia mapowanie cech produktów z elementami aukcji:




Szablony aukcji
Kategorie
Wysyłki
Płatność
Panel mapowania poszczególnych danych znajduje się w zakładce [Sprzedaż ORBA|Allegro
Mapowanie]
8.1 Use global mapping
Reguły mapowania są wykonywane tylko dla tych produktów, które posiadają ustawienia
atrybutów produktu ORBA|Allegro: Use global mapping: TAK
[Katalog  Zarządzaj produktami  wybrany produkt  Informacje o produkcie 
ORBA|Allegro]
Domyślna konfiguracja tego pola spełnia powyższy warunek!
Jeśli zatem chcemy, aby dany produkt znajdujący się w kategorii o ID=35, dla której został
stworzony warunek mapowania szablon aukcji default Allegro.pl, miał przypisany szablon aukcji
Extended Allegro.pl należy wybrać konfigurację: Use global mapping: NIE.
Wówczas produkt ten przy wystawianiu na aukcję będzie posiadał dane ustawione na karcie
produktu, ignorując uruchomione globalne mapowania.
8.2 Mapowanie szablonów aukcji
Mapowanie szablonów aukcji pozwala na masowe przypisanie wybranego szablonu aukcji do
produktów spełniających ustalony warunek.
Warunki te mogą dotyczyć wszystkich atrybutów produktów, które zdefiniowane są dla
produktów na platformie Magento. Przykładowe mapowanie szablonu Extended Allegro.pl
dla wszystkich produktów o category_ids równym 35 znajduje się poniżej:
W celu uruchomienia stworzonych mapowań należy użyć przycisku [Uruchom wszystkie
mapowania].
8.3 Mapowanie kategorii
Mapowanie kategorii pozwala na masowe przypisanie danych kategorii Allegro oraz Sklepu
Allegro do produktów spełniających ustalone warunki.
Warunki te mogą dotyczyć wszystkich atrybutów produktów, które zdefiniowane są dla
produktów na platformie Magento. Przykładowe mapowanie kategorii Allegro oraz Sklepu
Allegro dla produktów spełniających warunek category_ids równy jest 8 znajduje się poniżej:
W celu uruchomienia stworzonych mapowań należy użyć przycisku [Uruchom wszystkie
mapowania].
8.4 Mapowanie metod dostawy
Moduł pozwala na zmapowanie dostępnych metod dostawy systemu Allegro z metodami
dostawy zdefiniowanymi (używanymi) w sklepie Magento.
W zakładce do zarządzania metodami dostawy dla aukcji Allegro [Sprzedaż 
ORBA|AllegroMapowanieWysyłki] widoczna jest lista domyślnych metod dostawy
Allegro.
W kolumnie Local method administrator sklepu Magento ma możliwość ustawienia
odpowiedniej lokalnej metody dostawy, jaką chce zapewnić w ramach domyślnej metody
Allegro.
Przykładem mapowania jest zdefiniowanie dla domyślnej dostawy Allegro List ekonomiczny,
lokalnej metody Poczta Polska.
8.5 Mapowanie sposobu płatności
Moduł pozwala na zmapowanie dostępnych sposobów płatności systemu Allegro ze
sposobami płatności zdefiniowanymi (używanymi) w sklepie Magento
W zakładce do zarządzania sposobami płatności dla aukcji Allegro [Sprzedaż 
ORBA|AllegroMapowaniePłatności] widoczna jest lista domyślnych sposobów płatności
Allegro.
W kolumnie Local method administrator sklepu Magento ma możliwość ustawienia
odpowiedniego lokalnego sposobu płatności, jaki chce zapewnić w ramach domyślnej
metody Allegro.
Przykładem mapowania jest zdefiniowanie dla domyślnego sposobu płatności Allegro
mTransfer-mBank, lokalnego sposobu Check/Money order..
9. FAQ | najczęściej zadawane pytania
Pytanie:
Jak moduł radzi sobie z opóźnieniami w synchronizacji danych?
Odpowiedź:
Synchronizacja następuje w poniższych cyklach powtarzających się co:
5min - sprawdzenie czy nowo wystawiona aukcja jest już opublikowana (zweryfikowana) na Allegro.
10min - sprawdzenie nowych ofert kupna, transakcji, synchronizacja klientów którzy kupili towar,
synchronizacja statusu aukcji
30min – ponowne wystawienie zakończonych aukcji
24h - odświeżenie drzewa kategorii Allegro oraz Sklepu Allegro (dla kont typu Sklep).
***
Pytanie:
Czy przesyłanie szablonu na Allegro przez API jest możliwe?
Odpowiedź:
Moduł posiada mechanizm szablonów stworzony w oparciu o EAV, dzięki czemu jeden szablon może
posiadać różne zawartości dla różnych store view.
Można stworzyć nieograniczoną liczbę szablonów wzbogaconych m.in. o:
- dane produktu Magento (nazwa, cena, opis etc.)
- galerię zdjęć produktu
- tabelę atrybutów produktu
- (opcjonalnie) film Video powiązany z produktem
- dane użytkownika Allegro (tel, email, konto etc.)
- linki do stron Allegro (komentarze, o mnie, etc.) tworzone dynamicznie
Poniżej lista dostępnych znaczników:
{{var product.name}} - Nazwa wystawianego produktu
{{store direct_url=''}} - URL Sklepu (Default Magento Config)
{{var logo_url}} - Logo Sklepu (Default Magento Config)
{{config path='orbaallegro/template_design/ ... }} - Szereg ustawien Styli CSS z ustawien modułu
Allegro
{{var user.getUserPhone()}} - Telefon (Default Magento Config)
{{var user.getUserEmail()}} - Email (Default Magento Config)
{{var product.getFormatedPrice()}} - Cena Produktu
{{var product.getProductUrl()}} - URL Głównego zdjęcia Produktu
{{var product_photo_url}} - SRC Pliku Głównego zdjęcia
{{var youtube_url}} - YouTube URL - definiowany na poziomie produktu
{{var product.description}} || {{var parent.description}} - dostępny opis produktu prostego lub
konfigurowalnego
{{var attributes}} - Atrybuty Produktu, które są pokazywane na karcie produktu
{{var gallery}} - Galeria produktu o ile jest dostępna
{{block type="orbaallegro/cms_block" block_id="orbaallegro_topmenu"}} - Statyczny Blok CMS:
ORBA | Allegro: topmenu (ID: orbaallegro_topmenu)
{{block type="orbaallegro/cms_block" block_id="orbaallegro_about"}} - Statyczny Blok CMS: ORBA |
Allegro: about (ID: orbaallegro_about)
{{block type="orbaallegro/cms_block" block_id="orbaallegro_other"}} - Statyczny Blok CMS: ORBA |
Allegro: other (ID: orbaallegro_other)
***
Pytanie:
W jaki sposób odbywa się synchronizacja stanów magazynowych?
Odpowiedź:
Moduł nie umożliwia automatycznej synchronizacji stanów magazynowych. Utworzenie oferty kupna
oraz transakcji nie powoduje zejścia towaru ze stanu. Dopiero w momencie ręcznego utworzenia
zamówienia na podstawie oferty kupna lub transakcji towar jest rezerwowany w systemie Magento
(konfiguracja zamówień, to już kwestia indywidualna każdego zamówienia).
Proces rezerwacji towaru w Magento (zdjęcie towaru ze stanu) wygląda następująco:
1. Administrator wystawia aukcję na dany produkt i wprowadza liczbę sztuk dostępną w danej aukcji.
2. Za pośrednictwem serwisu Allegro użytkownik dokonuje transakcji lub składa ofertę kupna.
3. Transakcja i/lub oferta kupna widoczne są w panelu administracyjnym w zakładce Sprzedaż -->
Moduł Allegro ----> Transakcje/Oferty kupna.
4. Administrator ręcznie zatwierdza Transakcję lub Ofertę kupna i konwertuje ją w Zamówienie
Magento.
5. W tym momencie towar zostaje zdjęty ze stanu magazynowego.
Jednakże, aby administrator posiadał wiedzę na temat liczby zamówionych towarów vs liczby
towarów w magazynie, moduł allegro podświetla wszystkie aukcje, których liczba dostępnych
produktów jest większa niż liczba produktów w magazynie.
***
Pytanie:
Czy moduł oferuje masowe wystawianie aukcji?
Odpowiedź:
Moduł nie oferuje masowego wystawiania aukcji. Masowo można ponownie wystawić aukcje z
poziomu ekranu [ORBA | Allegro --> Aukcje]. Zatem masowo mogą Państwo wystawiać cykliczne
aukcje. Aukcja --> Wystaw ponownie --> Data wystawienia aukcji (może być pusta) --> Zatwierdź. .
Moduł wymaga aby za pierwszym razem wszystkie aukcje zostały wprowadzone ręcznie. Należy
pamiętać, że akcja "Wystaw ponownie" pozwala na wystawienie aukcji tożsamej (bez zmiany jej
danych np. liczby dostępnych sztuk, cen produktu).
***
Pytanie:
Czy istnieje możliwość pobrania obecnie istniejących aukcji do modułu (zmapowania ich)?
Odpowiedź:
Nie ma takiej możliwości, tylko aukcje wystawione przez moduł znajdą się na odpowiednich
widokach. Ręcznie tworzone aukcje w Allegro nie pojawią się w Magento / odpowiednich widokach
modułów.
***
Pytanie:
Czy synchronizacja obejmuje również zmianę cen?
Odpowiedź:
Nie, nie obejmuje. Nie obejmuje również zmian stanów magazynowych czy aktualizacji opisu, galerii i
innych elementów związanych z produktem.
Zatem zmiana cenników produktów lub stanów magazynowych etc. zmusza administratora do
wystawienia nowej aukcji na dany produkt. Nie można wówczas skorzystać w akcji: Wystaw
ponownie, ponieważ nie umożliwia ona edycji danych aukcji.
***
Dziękujemy za zainteresowanie modułem ORBA | Allegro.
W razie dodatkowych pytań związanych z funkcjonalnością oraz rozwojem
modułu prosimy o kontakt na adres [email protected]
Zespół ORBA