Instrukcja użytkownika Integrator Allegro
Spis treści 1. Instalacja integratora... 3 2. Konfiguracja integratora... 3 2.1 Wygenerowanie licencji... 3 2.2 Generowanie cech... 4 2.3 Konfiguracja kont... 5 2.3.1 Ustawienia dostępu... 5 2.3.2 Ustawienia dokumentów... 6 2.3.3 Ustawienia kontrahentów... 7 2.3.4 Cechy dla konta... 7 2.3.5 Parowanie sposobu dostawy / zapłaty / ewidencji... 8 2.3.6 Raporty... 9 2.4 Ustawienia domyślne dla pobieranych zamówień... 9 2.5 Domyślna konfiguracja wystawianych aukcji... 10 3. Opis funkcjonalności integratora... 12 3.1 Pobieranie koszyków i aukcji z Allegro... 12 3.1.1 Pobierz aukcje i zamówienia... 13 3.1.2 Pobierz koszyki... 14 3.1.3 Pobierz tylko aukcje... 14 3.2 Wystawianie aukcji... 15 3.3 Wystaw aukcje z istniejącego ALL... 16 3.4 Pobieranie statusów PayU... 16 3.5 Otwórz aukcje... 17 3.6 Pobierz raporty z PayU... 17
1. Instalacja integratora W paczce pobranej ze strony znajdziemy plik AllegroMulti.dll. Aby został on wczytany przez enove należy umieścić go w folderze C:\Program Files\Common Files\Soneta\Assemblies lub jeśli korzystany z enovy 32 bitowej C:\Program Files (x86)\common Files\Soneta\Assemblies Często podczas pobierania pliku ze strony plik jest blokowany przez system. Należy wejść w jego właściwości kliknąć odblokuj i zastosować zmiany. Operacje należy wykonać przed skopiowaniem do wyżej wymienionych folderów. Po włączeniu enovy możemy zweryfikować czy nasz dodatek został wczytany. Należy z paska wybrać Pomoc -> Wizytówka -> W wyświetlonym oknie wybrać Biblioteki. W wyświetlonej liście powinno być wyświetlona AllegroMulti 2. Konfiguracja integratora 2.1 Wygenerowanie licencji Po prawidłowej instalacji w konfiguracji enovy pojawi się zakładka -> Allegro. Będąc w tym folderze wybieramy zakładkę licencję i klikamy Licencja a następnie Pobierz z WWW. Jeśli licencja już została zakupiona zostanie ustawiona data z ważnością licencji, w przeciwnym razie zostanie ustawiona licencja Demo na okres 7 dni.
Licencja jest integratora generowana jest na podstawie numeru licencji enovy. Dlatego nawet jeśli testy odbędą się na bazie demo musi być w niej wprowadzona licencja. 2.2 Generowanie cech Aby integrator mógł działać niezbędne jest skonfigurowanie cech, w których będą przechowywane dane. W konfiguracji w zakładce Ustawienia Kont znajduje się grupa Ustawienia CECH. Można skorzystać z automatycznego generowania cech Generuj cechy (Zalecane) lub ręcznie wybrać odpowiednie cechy. Omówienie poszczególnych cech : Czy wystawić fakturę cecha dokumentu handlowego typu warunek Jeśli w zamówieniu, które jest pobierane klient wybrał opcję otrzymania FV cecha ta zostanie zaznaczona na tak. Punkt odbioru cecha dokumentu handlowego typu tekst Dotyczy to sposobów dostawy np. Paczkomat. Wtedy do tej cechy zostanie zapisany nr paczkomatu. W konfiguracji obok tej cechy znajduje się check box Pobieraj pełne dane o punkcie odbioru. Zaznaczanie go powoduje pobranie pełnych danych o punkcie odbioru. Nick z Allegro cecha dokumentu handlowego typu tekst W niej zapisywany jest nick zamawiającego z allegro. Nazwa konta cecha dokumentu handlowego typu tekst Przechowuje informacje o naszym koncie allegro z jakiego zeszło zamówienie. Email kontrahenta cecha dokumentu handlowego typu tekst Zapisuje adres email kontrahenta. Status PayU cecha dokumentu handlowego typu tekst Przechowuje informację o statusie PayU. Sposób dostawy cecha dokumentu handlowego typu tekst W niej przechowywana jest informacja o wybranym sposobie dostawy.
2.3 Konfiguracja kont W zakładce ustawienia kont znajduję się lista kont. Jest w nim wygenerowane tyle kont ile jest zakupionych licencji. Domyślnie jest tam wyświetlany tylko numer konta jednak przez Organizuj listę można wyciągnąć sobie dodatkowe informacje o koncie. Aby przejść do konfiguracji konta należy dwukrotnie kliknąć na wybrane konto. Spowoduje to otwarcie okna konfiguracji. 2.3.1 Ustawienia dostępu Login Login do konta allegro Hasło Hasło do konta allegro Nazwa konta Dowolna nazwa identyfikująca to konto. Ta nazwa zostanie wpisana do cechy Nazwa Konta na dokumencie handlowym. Pole wymagane. Klucz Web API należy tutaj wpisać klucz Web API konta z allegro. Po zalogowaniu się na konto w allegro wchodzimy w zakładkę WebAPI -> Informacje i ustawienia. Na tej zakładce generujemy klucz API.
2.3.2 Ustawienia dokumentów Definicja dokument, do którego będą przypisywane aukcje Należy tam wybrać definicję dokumentu Zamówienia odbiorcy. W przykładzie została stworzona definicja o nazwie ALL. Definicja dokument, do którego będą przypisane koszyki z allegro Należy tam wybrać definicję dokumentu Zamówienia odbiorcy. Można wybrać standardowy dokument ZO lub stworzyć własny. Między dokumentem aukcji i koszyka z allegro (w tym przypadku ALL -> ZO) musi być stworzona relacja by z dokumentu ALL dało się utworzyć ZO! Pobieraj opis transakcji do opisu dokumentu Jej zaznaczenie powoduje zapisanie wiadomości od kupującego do opisu dokument Licz wartość dokumentu od Należy wybrać od jakiej wartości jest liczony dokument by ceny zostało prawidłowo pobrane. Zatwierdzaj pobrane dokumenty Jeśli jest zaznaczona pobrane koszyki z allegro nie trafiają do bufora tylko automatycznie się zatwierdzają. Pomijaj koszyki o statusie płatności PayU Anulowana / Rozpoczęta Zaznaczenie tych opcji spowoduje, pominięcie koszyków jeśli płatność nie jest zakończona.
2.3.3 Ustawienia kontrahentów Generuj kontrahentów / Podpinaj kontrahenta incydentalnego dla allegro Zaznaczenie tego pola powoduje generowanie kontrahenta dla każdego pobranego koszyka z allegro. Jeśli ta opcja nie jest zaznaczona do zamówienia podpinany jest kontrahent wybrany w polu Podpinaj kontrahenta incydentalnego dla allegro. Aktualizuj kontrahentów Jeśli kontrahent istnieje w bazie pozwalaj na aktualizacje jego kartoteki. Kontrahent podpinany jako inny odbiorca Kontrahent wybrany w tym polu będzie podpinany jako odbiorca na dokumencie. 2.3.4 Cechy dla konta Cecha sposobu zapłaty, wiążąca sposób zapłaty ze sposobem dostawy Cecha dla SposobyZaplaty typu tekst. W niej będą przechowywane informacje o sparowanych sposobach zapłaty. Cecha Ewidencji SP, wiążąca ewidencję SP ze sposobem dostawy Cecha dla EwidencjeSP typu tekst. W niej będą przechowywane informacje o sparowanych ewidencjach. Cecha Towaru dla sposobu dostawy Cecha dla Towaru typu tekst. W niej będą przechowywane informacje o sparowanych towar do danego sposobu dostawy. Konfiguracja tych cech jest niezbędna dla dokonania parowania. Po ich ustawieniu należy zapisać konfigurację!
2.3.5 Parowanie sposobu dostawy / zapłaty / ewidencji Parowanie sposobów dostawy W sekcji pierwszej następuje parowanie sposobów dostawy. Wybieramy Sposób dostawy z Allegro jaki nas interesuje. Następnie w Usługa dla sposobu dostawy wybieramy kartotekę z enovy odpowiadający wybranemu sposobowi dostawy. Pole tekstowe Sposób dostawy zawiera nazwę sposobu dostawy jaka ma być zaciągnięta jeśli ma być inna niż domyślna. Np. dla listu ekonomicznego można wpisać Poczta. Jest to pole opcjonalne. Po uzupełnieniu danych klikamy przycisk Przypisz. Teraz możemy wybrać kolejny sposób dostawy i dokonać kolejnego parowania. Jeśli dla danego sposobu było już wykonane parowanie pola z towarem z enovy i sposobem dostawy zostaną automatycznie uzupełnione. Domyślna usługa dla sposobu dostawy wybiera się w niej kartotekę towarową jaka ma być zaciągnięta dla nie sparowanych sposobów dostawy. Parowanie sposobów dostawy nie jest konieczne. Domyślna usługa dla sposobu dostawy jest polem obowiązkowym! Sposoby zapłaty oraz ewidencje W sekcji drugiej należy wybrać sposoby płatności dla allegro z systemu PayU oraz przelewów znajdujących się poza systemem PayU. Analogicznie sprawa się ma dla Ewidencji SP. Uzupełnienie tych pól jest konieczne
W sekcji trzeciej możemy sparować sposoby dostaw typu pobranie do sposobu zapłaty oraz ewidencji. Działa to tak samo jak w oposie parowań sposobów dostawy. Parowanie sposobów dostawy typu pobranie nie jest konieczne. Wymagane jest uzupełnienie sekcji Domyślne dla pobrania sposobu zapłaty oraz ewidencji SP w enovie. 2.3.6 Raporty Cecha dla Zapłat, określająca czy wpłata z PayU już była Cecha dla Zapłaty typu tekst w niej przechowywana jest informacja o zapłacie Zezwalaj na wybór ewidencji Jeśli jest zaznaczona użytkownik pobierający zapłaty z PayU może wybrać, do której ewidencji mają one trafić. 2.4 Ustawienia domyślne dla pobieranych zamówień W zakładce Ustawienia kont istnieje pole o nazwie Pobieraj zamówienia z. Jego ustawienie podpowiada domyślną datę od jakiej ma pobierać. W tym przypadku 30 dni wstecz. Podczas pobierania koszyków z allegro zawsze można zmienić podpowiadaną datę, od której mają być pobierane.
2.5 Domyślna konfiguracja wystawianych aukcji Liczba konfigurowalnych pól w szablonie - jeśli korzystamy z szablonu konieczne jest w kilku jego miejscach wprowadzenie tekstu. Parametr ten określa ile tych miejsc znajduje się w szablonie i ułatwia uzupełnianie go poprawnymi danymi w zależności od wystawianego przedmiotu. Konfiguruj powoduje otwarcie nowego okna konfiguracji szablonów integratora oraz pozwala korzystać z szablonów allegro. Wybierz format pole odpowiadające za wybrany domyślny format, który jest modyfikowany. Można tworzyć nowe i modyfikować obecne formaty. Wybierz szablon wyświetla wszystkie zapisany szablony na koncie allegro. Po jego wybraniu pola w integratorze wypełnią się tak jak z szablonu allegro. Obok każdego pola w konfiguracji istnieje check box Widok. Jeśli nie jest zaznaczony podczas tworzenia aukcji przez integrator to pole nie będzie wyświetlane. Dzięki temu niepotrzebne pola podczas wystawiania aukcji zostają ukryte.
UWAGA! Jeśli pole ma odznaczony widok ale wybierzemy format lub szablon z allegro gdzie jego wartość domyślna jest uzupełniona to zostanie ono wysłane podczas tworzenia aukcji do allegro! W polu dodatkowe informacje o przedmiocie należy umieścić swój szablon html. W miejscach gdzie ma być modyfikowany tekst należy wpisać XD:X gdzie x jest nr pola numerując od 0. Teraz tekst z pola XD:0 zostanie wstawiony w szablonie w miejscu XD:0. Obok pola dodatkowe informacje znajduje się podgląd szablonu. Ilość pól XD:X jest konfigurowana w polu Liczba konfigurowalnych pól w szablonie w widoku Ustawienia kont.
3. Opis funkcjonalności integratora 3.1 Pobieranie koszyków i aukcji z Allegro Funkcjonalność programu działa w następujący sposób. Do dokumentu aukcji wskazanego w konfiguracji w relacji tworzony jest dokument zamówienia odbiorcy. W dokumencie aukcji zostaje wskazany towar w enovie, który odpowiada przedmiotowi znajdującemu się na aukcji allegro. Wskazanie tego przedmiotu jest jednorazowe. Później program pamięta relację i kolejne zamówienia są tworzone automatycznie. Pobieranie koszyków z allegro może odbywać się na kilka sposobów. Pobierając tylko koszyki z wybranych aukcji bądź pobierając wszystkie ostatnie koszyki. Powyższa lista czynności powinno się wywoływać z poziomu zamówień odbiorcy.
3.1.1 Pobierz aukcje i zamówienia Po wywołaniu czynności Pobierz aukcje i zamówienia pojawi się okno parametrów. Należy wybrać magazyn,w którym zostaną stworzone dokumenty aukcji i koszyków oraz datę,od której mają zostać zaimportowane zamówienia. Funkcja Pobierz aukcje i zamówienia ma ograniczoną ilość zwracanych informacji. API allegro zwraca około informację o około 100 czynności konta allegro Tzn. zwraca informację o zamówieniach, wystawionych aukcjach, zmianach cen itp. Dlatego ta funkcja pobierze informacje o zamówieniach około 10 dni wstecz. Następnie następuje pobieranie aukcji od wskazanej daty. Jeśli w pobieranych transakcjach istnieje aukcja, która nie była sparowana w naszym systemie pojawi się okno parowania.
Należy wskazać towar w enovie odpowiadający przedmiotowi na aukcji allegro. Dzięki temu zostanie stworzony dokument aukcji ze wskazanym towarem, do którego będą tworzone relacje. Jeśli zakup jednej sztuki na aukcji odpowiada kilku przedmiotom w enovie można stworzyć taki dokument ręcznie. Trzeba stworzyć go o definicji wybranej w konfiguracji. W numer obcy należy wkleić numer aukcji. Dzięki temu integrator rozpozna parowanie i stworzy ZO do tylu przedmiotów ile istnieje w dokumencie aukcji. Czynność wykonujemy dla wszystkich niesparowanych aukcji, które spłynęły w danym okresie. Po dokonaniu tej czynności koszyki z allegro w postaci zamówień odbiorcy zostaną zapisane w enovie. W zależności od konfiguracji mogą zostać również stworzone kartoteki kontrahentów. Na samym końcu zostanie wyświetlony raport z informacją ile zamówień i aukcji zostało stworzonych oraz ile zamówień już znajdowało się w systemie. 3.1.2 Pobierz koszyki Dzięki tej czynności możemy pobrać zamówienia tylko dla zaznaczonych aukcji. Istnieje możliwość,że integrator wyświetli okno parowania innej aukcji. Taka sytuacja wystąpi gdy kupujący kupi więcej niż jeden przedmiot i jeden z nich nie ma stworzonego dokumentu aukcji. Taka sytuacja jest prawidłowa i niezbędna by pobrać wszystkie informacje o zamówieniu. 3.1.3 Pobierz tylko aukcje Funkcja ta pobiera wszystkie aukcje jakie były wystawione z konta allegro. Zostają pobierane wszystkie aukcje i tworzone dokumenty aukcji bez zamówień. Pobierane są nawet aukcje zakończone i nie zawierające żadnej sprzedaży.
3.2 Wystawianie aukcji Aby wystawić aukcje należy wybrać z poziomu zamówień odbiorcy funkcję Wystaw aukcje. Po jej kliknięciu pojawi się okno parametrów. Należy uzupełnić ilość towarów, magazyn,w którym będzie stworzony dokument aukcji oraz towary jakie mają się znajdować w wystawionej aukcji. Ostatni parametr mówi z jakiego konta zostanie wystawiona aukcja. Wprowadzone tutaj parametry dotyczą tylko dokumentu aukcji jaki zostanie stworzony w enovie. Ilość towarów wpisanych tutaj nie musi odpowiadać ilości towarów wystawionych w aukcji. Następnie następuje wybór kategorii,w której chcemy wystawić przedmiot.
Teraz można zając uzupełnianiem danych o produkcie. Możemy korzystać ze skonfigurowanych szablonów aukcji jak i szablonów z allegro. (Opis konfiguracji znajduje się w punkcie 2.5). Po uzupełnieniu niezbędnych informacji należy kliknąć przycisk zapisz i zamknij. Nastąpi wtedy walidacja po stronie allegro. Jeśli jakieś wymagane pole jest niepoprawnie uzupełnione lub pominięte dostaniemy o tym stosowną informację. Jeśli dane są wprowadzone poprawnie pojawi się nam okno z kwotą jaka będzie pobrana za wystawienia aukcji. Dopiero w tym momencie jeśli klikniemy Wystaw aukcja zostanie wystawione i w enovie zostanie stworzony dokument aukcji. 3.3 Wystaw aukcje z istniejącego ALL Można ręcznie stworzyć dokument aukcji, z którego ma być wystawiona aukcja allegro. Funkcja ta działa jak ta opisana powyżej z tym, że nie pojawia się nam pierwsze okno parametrów. 3.4 Pobieranie statusów PayU Wywołanie tej czynności powoduje ponownie sprawdzenie płatności zaznaczonych zamówień. Może być to wymagane np. jeśli zamówienie spłynęło ze statusem Rozpoczęta lub Anulowana. Dane odświeżane są w cesze wybranej w konfiguracji.
3.5 Otwórz aukcje Spowoduje otwarcie wszystkich aukcji w domyślnej przeglądarce systemowej. 3.6 Pobierz raporty z PayU Funkcja dostępna jest z poziomu Ewidencji Środków Pieniężnych -> Raporty. Dzięki niej jesteśmy w stanie pobrać informacje o raportach PayU do wskazanej ewidencji i raportu w wybranym obrębie czasu