Akcje

Allegro Multi

Z Dokumentacja XDEFT

Instrukcja jest w trakcie tworzenia i wciąż może zawierać błędy.

Dla lepszego odbioru instrukcji przygotowany został film instruktażowy dostepny tutaj.

Wstęp

Dodatek allegro dla enova.

http://enova.info/download/allegro4enovaV2.zip

W dzisiejszych czasach wiele firm nie wyobraża sobie już handlu bez wykorzystania internetowych kanałów dystrybucji. Firmy zarówno duże jak i małe potrzebują dobrych systemów do sprzedaży internetowej aby konkurować na rynku. Jedną z możliwości jest skorzystanie z istniejących portali aukcyjnych. Jednak jeśli firma zdecyduje się poważnie rozwinąć ten kanał sprzedaży pojawiają się problemy z ilością dublujących się danych do wprowadzenia zarówno w firmowym ERP jak i w systemie aukcyjnym.

W Polsce niekwestionowanym liderem rynku aukcyjnego jest portal allegro.pl. Ma on największy udział w rynku i daje największe możliwości zarówno sprzedawcom jak i kupującym. Ponieważ allegro udostępnia możliwość integracji z systemami zewnętrznymi w sposób bezpieczny i wygodny, naturalnym wydawało się połączenie go z systemem enova.

Co umożliwia dodatek allegro2enova?
Komunikację w obu kierunkach - odbiera zakończone aukcje przenosząc je jako dowolny dokument w enova (domyślnie jako Zamówienie Odbiorcy - ZO).

Od czego zacząć ?

Widok zainstalowanych dodatków

Instalację dodatku można wykonać na dowolnym stanowisku, nie wymaga dodatkowych usług i programów.


Wymagania i zalecenia:

  • Enova w wersji złotej lub wyższej
  • Załączniki przechowywane w katalogu (nie w bazie)

Całą operację zacznijmy od pobrania dodatku, a następnie jego instalacji. Pamiętajmy o odblokowaniu pobranego archiwum. (Prawym przyciskiem -> Właściwości jeśli jest widoczny przycisk "Odblokuj" w prawym dolnym rogu należy go zaznaczyć)
Instalację możemy przeprowadzić na 2 sposoby:

* Dodać je globalnie do enovy przez  Narzędzia -> Opcje -> Systemowe -> Rozszerzenia i przyciskiem "Dodaj/Aktualizuj rozszerzenie" (należy zaznaczyć opcję "Aktualizuj okienka")
* Lokalnie wrzucić je do folderu Assemblies 

Wszystkie dll znajdujące się w zipie instalujemy do enovy dowolną metodą. Gdy będą już zainstalowane, przechodzimy do kolejnego punktu.

Konfiguracja wstępna

Allegro licencje.png

Po zainstalowaniu dodatku należy przygotować swoje dane do konta (lub kont) allegro, i w uruchomionej Enovie przejść do opcji.
Konfiguracje rozpoczniemy od pobrania licencji. jeśli nie zakupili państwo licencji, dodatek przejdzie w okres 7-dniowej wersji demo.
Aby to zrobić w Narzędzia>Opcje znajdujemy (zapewne na samym dole listy) pozycję XDEFT. Po jej rozwinięciu, jedną z trzech opcji będzie własnie licencja.

Konto i cechy

Opis Screen
W zakładce ustawień, klikamy na przycisk "Generuj cechy".
W rezultacie wszystkie cechy wymienione w oknie zostaną wypełnione.
Kolejnym etapem jest utworzenie konta w dodatku.
Ustawienia allegro.png
Klikamy na przycisk "Nowy (ConfigAccountAllegro"),
wyświetli to kolejne okienko które pozwoli nam na połączenie dodatku z kontem allegro.
Na tym etapie podajemy nazwę konta, nastepnie otwieramy stronę: https://apps.developer.allegro.pl/
Na stronie logujemy się danymi do konta Allegro.
Pierwsza sekcja ustawień konta.png
W prawym górnym rogu klikamy na przycisk "Zarejestruj nową aplikację"
Allegro -rejestracja.png
Na tym etapie podajemy do Allegro dane dotyczące aplikacji.
Nazwa i opis mogą być dowolne, istotnym jest aby przy rodzaju aplikacji
zaznaczyć opcje taka jak na screenie.
Allegro token.png
Po dodaniu aplikacji, zostanie wyświetlony Client ID oraz Client secret.
Ich wartości przekopiowujemy do konfiguracji.
Allegro klucze.png
Po wykonaniu powyższych czynności zapisujemy wszelkie zmiany za pomocą kolejnych przycisków "Zapisz i Zamknij".
Z poziomu Enovy musimy teraz udać się do Zamówień odbiorców.
Teraz, klikamy prawym przyciskiem w puste miejsce okna i z menu czynności wybieramy "XDEFT Allegro rest".
Proszę zwrócić uwagę, że pozycja ta pojawia się na liście 2 razy -my wybieramy tę w pierwszej sekcji (wyżej).
Wybieramy opcję "logowanie"
Menu xdeft allegro.png
Wybieramy konto, na które chcemy się logować i klikamy przycisk "Pobierz token".
To zaskutkuje otwarciem przeglądarki internetowej. Logujemy się i kopiujemy ukazany kod, następnie powiązujemy konta
Token allegro.png
Allegro token2.png
Potwierdzenie tokena.

Na koniec wyświetli się komunikat świadczący o poprawnie wygenerowanym tokenie.
Uzyskany token jest ważny 3 miesiące. Operacje tę będzie trzeba okresowo powtarzać!









Dokumenty

Kolejnym krokiem jest otwarcie w Opcjach ustawień: Handel>Definicje dokumentów>Wszystkie. W kategorii "Zamówienia odbiorcy", tworzymy nową definicje.
Można posiłkować się powyższym screenem. Symbol wydruku to domyślnie dla nas "ALL", można jednak nazwać go dowolnie.
Na koniec, przechodzimy w zakładkę "Relacje". Usuwamy te relacje które już tam są i tworzymy relacje kopiowania do zamówienia odbiorcy - zgodnie z drugim screenem.
Zapisujemy opcje i przechodzimy dalej.
W zależności od Państwa konfiguracji, możliwym jest iż będzie trzeba jeszcze wskazać magazyn w zakładce magazyn oraz nadać prawa danych operatorom.

Końcowa konfiguracja konta

Na tym etapie konfiguracji wracamy do konfiguracji dodatku allegro.

W pierwszej sekcji klikamy przycisk "Pobierz USER ID".
W ustawieniach dokumentów, ustawiamy kolejno:
-Definicje którą wczesniej utworzyliśmy - ALL
-Definicje koszyków allegro - ZO
-Magazyn dla pobieranych aukcji - zgodny z Państwa bazą

Teraz w sekcji konfiguracji dostaw musimy wybrać domyślny sposób dostawy - będący usługą z bazy kartotek towarów, które znajdują się w bazie.
Z poziomu tej sekcji możemy wybrać kolejne definicje sposobów dostawy na podstawie wybranej usługi przez kupującego. Należy pamiętać aby po takiej konfiguracji użyć przycisku "przypisz".
Jeżeli w systemie skonfigurowanych będzie więcej kont, wszystkie te ustawienia można łatwo przenieść do pozostałych kont stosując przycisk do tego służący.
Istnieje również opcja dodania własnej funkcjonalności przy użyciu algorytmów.

Na tym etapie konfiguracja konta allegro z naszym dodatkiem (w podstawowym zakresie) została wykonana pomyślnie.

Funkcjonalności




Pobieranie koszyków

Opis Screeny
Przechodzimy do widoku zamówień odbiorców.
Podobnie jak wcześniej, z menu Czynności możemy pobrać wszystkie zamówienia i aukcje.
Po zakończeniu tej czynności zostanie stworzony dokument ALL, a do niego pobrane zostaną koszyki jako ZO.
Parowanie jest jednorazowe, jeśli aukcja raz zostanie sparowana - kolejne zamówienia automatycznie utworzą się do relacji.
Pobieranie aukcji 1.png
Następnie dodatek zapyta nas o okres z którego ma pobrać aukcje, oraz dla jakiego konta.
W wyświetlonym oknie znajduje się też zakładka "Parametry" która wyświetli dane produktu z allegro.
Pobieranie aukcji 3.png
Teraz wybieramy towary . Jeżeli aukcja dotyczy jednego towaru - cena nie musi być uzupełniona, gdyż zostanie uzupełniona z aukcji.
W innym wypadku należy ją wprowadzić.
Przycisk "Otwórz aukcje" pozwoli szybko podejrzeć parowana aukcje z poziomu przeglądarki.
Pobieranie aukcji 4.png
Tutaj widzimy podsumowanie pobierania aukcji. Jak widzimy stworzono dokument ALL (na screenie akurat z nazwą ALLI) o raz ZO z koszyka.
Pobieranie aukcji 4.png
Screen obok prezentuje poprawne działanie relacji.
Warto zwrócić uwagę na ilość sztuk podanych przy pozycji dokumentu.
Pobieranie aukcji 5.png

Wystawianie aukcji

Opis Screeny
Wystawianie aukcji może odbywać się z poziomu listy towarów
Z poziomu Czynności wybieramy XDEFT Allegro rest (tym razem to usytuowane niżej) i wybieramy opcję: Wystaw surową aukcję.
Pierwsze wystawienie aukcji może zająć dłuższą chwilkę, gdyż dodatek pobiera z allegro kategorie.
Przy kolejnych aukcjach dodatek pobierze je z pamięci.
Wystawianie Aukcji Allegro.png
W wyświetlonym oknie musimy podac tytuł aukcji, cenę i kategorię.
Przy wyborze kategorii pojawi się okno z kategoriami z allegro. Należy pamiętać aby zawsze wybrać kategorię końcową.
Dla przykładu dodatek nie pozwoli wystawić oferty z laptopem w kategorii elektronika gdyż jest ona nadrzędna.
Po wybraniu wszystkich opcji, klikamy przycisk "Stwórz szkic i dokument ALL"
Wystawienie aukcji 2.png
Jeżeli wszystko poszła dobrze, okno poszerzy się o sekcje zawierającą wymagane przez allegro pozycje.
Ich podanie jest niezbędne do wystawienia aukcji, a ich rodzaj zależy od wybranej kategorii.
Wystawianie aukcji 3.png
Wskazane na screenie opcje jako jedyne można ustawić "na sztywno" z poziomu konfiguracji dodatku.
Występują one zawsze na każdym towarze niezależnie od kategorii.

Po zaznaczeniu wszystkich opcji aktualizujemy szkic, co zaktualizuje opis aukcji na allegro.

Wystawianie4.png
Zakładka Parametry opcjonalne pozwoli zdefiniować dodatkowe opcje dostępne w allegro.
Natomiast zakładka Opis aukcji umożliwia skonstruowanie opisu np. w Htmlu.
Opis można w każdej chwili podglądać wybierając rodzaj widoku tekstu.
Każdy towar może mieć swój niezależny opis, jednak można również utworzyć jedne domyślny szablon z poziomu konfiguracji dodatku i wskazywać go w polu Szablon.
Zakładka zdjęcia pozwoli na dodanie do aukcji zdjęć towaru. Z uwagi na rozmiar zdjęć zalecamy aby załączniki w enova były zapisywane w katalogu a nie w bazie danych.
Wystawianie5.png
Ostatnia zakładka pokazuje błędy, przez które nie można aukcji wystawić.
Niestety są one w języku angielskim, gdyż tak zwraca je allegro.
Wystawianie6.png


Konfiguracja




Opisy towarów

Opis.png


Za tworzenie szablonów opisów towarów odpowiada dll "XDDescriptions", będąca jednym z plików wchodzących w skład dodatku.
W Opcjach enovy w drzewku X DEFT znajduje się osobna pozycja "Opisy Towarów".
Z tego poziomu można dodać nowy szablon, aby go edytować należy kliknąć 2 razy jego nazwę na liście. Spowoduje to otwarcie edytora html.
Tak jak nadmienialiśmy wcześniej, w kartotece towarów można będzie narzucić domyślny szablon lub napisać osobny dla konkretnego towaru.

Z poziomu tej zakładki można również skonfigurować uporządkowane wyświetlanie cech.
Na kartotece towaru pojawi się nowa pozycja w której będzie można wyświetlić jedynie konkretne cechy. Rozwiązanie to staje się niezwykle przydatne gdy cech w enovie jest kilkadziesiąt i zamist wszystkich można wyświetlić konkretne dla danej grupy towarów.
W konfiguracji możemy dodać konkretną kategorię cech i wybrać te cechy które są dla nas wskazane.