Integracja z Allegro

Aby rozpocząć integrację systemów, przejdź do modułu Użytkownicy i wywołaj formatkę dodawania nowego konta (ikona ).

Na zakładce Dane konta wpisz nazwę konta, która będzie widoczna w systemie Wapro Aukcje Anywhere, wybierz pozycję Allegro i uzupełnij wszystkie pola:

• Login - login używany w systemie Allegro,
• Hasło - hasło do portalu Allegro,
• Klucz WebAPI - specjalny wygenerowany klucz do łączenia się z aplikacją,
• Client id - identyfikator wymagany do komunikacji z REST API do wygenerowania z apps.developer.allegro.pl,
• Client secret - unikalny tajny klucz używany do komunikacji z REST API do wygenerowania z apps.developer.allegro.pl,
• Imię i nazwisko - dane wprowadzone także w Allegro.
• Adres e-mail - e-mail powiązany z kontem Allegro.

Jak uzyskać klucz WebAPI, Client id oraz Client secret?

W celu wygenerowania klucza WebAPI, Client id oraz Client secret należy zalogować się danymi konta Allegro na stronie: apps.developer.allegro.pl

W prawym górnym rogu wybierz opcję Zarejestruj nową aplikację - pojawi się formularz rejestracji aplikacji.

1. Nazwa aplikacji - własna nazwa aplikacji, dla której generowany jest klucz WebAPI. Nazwa jest ważna, jeśli korzystasz z haseł aplikacyjnych w portalu Allegro.
2. Rodzaj aplikacji - wybierz domyślnie zaznaczoną opcję Aplikacja będzie posiadać dostęp do przeglądarki, za pomocą której użytkownik będzie się logował do Allegro.
3. Adresy URL do przekierowania - wklej link: https://app.wapro.pl/, zaakceptuj regulamin i kliknij Dodaj. Na kolejnym oknie zarządzania aplikacjami został wygenerowany klucz WebAPI, który wklejamy w danych konta.

Jak wygenerować hasła aplikacyjne?

Jeżeli w Allegro włączone są hasła aplikacyjne, w celu poprawnej autoryzacji programu wygeneruj hasło dla aplikacji aukcyjnej.

Hasła do aplikacji możesz sprawdzić na Allegro, wchodząc w Moje Konto | Bezpieczeństwo | Hasła do aplikacji.

Jeżeli hasła aplikacyjne są włączone, wygeneruj hasło dla aplikacji aukcyjnej. W tym celu wpisz nazwę aplikacji, która została podana podczas generowania klucza WebAPI i kliknij Wygeneruj hasło. Allegro utworzy hasło do aplikacji. Zostanie ono wyświetlone TYLKO jeden raz. Hasło powinieneś wkleić w ustawieniach konta w programie Wapro Aukcje Anywhere.

Jak autoryzować aplikację?

Uwaga

Autoryzacja aplikacji wymagana jest w celu nawiązania połączenia z API usługi Allegro.

Czym jest REST API?

Rest API to dodatkowa usługa sieciowa udostępniona przez Allegro do komunikacji z portalem. REST API jest odrębnym zestawem funkcji niż obecna usługa WebAPI Allegro - ma udostępniony inny zestaw funkcji, a sama integracja odbywa się w innej technologii niż z WebAPI, które wykorzystuje tzw. protokół SOAP.

Konsekwencją wprowadzenia nowego typu API przez Allegro jest dodanie dodatkowej warstwy uwierzytelniania żądań od użytkownika do Allegro.

W praktyce dla użytkownika oznacza to dodatkowe logowanie w aplikacji Wapro Aukcje Anywhere danymi z Allegro po to, aby aplikacja w imieniu użytkownika mogła odpytywać usługę REST API.

Jak zweryfikować konto?

Proces autoryzacji polega na uruchomieniu w aplikacji opcji weryfikacji, która wyświetla stronę logowania do Allegro. Po wprowadzeniu danych do logowania (na stronie dostarczonej przez Allegro) i wyrażeniu akceptacji co do autoryzacji danej aplikacji (aplikacja przedstawia się w formie unikalnego identyfikatora) nastąpi zamknięcie okna autoryzacji.

Opcja weryfikacji jest dostępna w dwóch miejscach:

• w oknie edycji danych użytkownika (po wstępnej synchronizacji):

• w prawym górnym rogu obok listy wyboru kont:

Następnie pojawi się okno z logowaniem do aplikacji:

Po wprowadzeniu danych do logowania nastąpi przekierowanie do akceptacji autoryzacji aplikacji. Po jej wykonaniu okno zamknie się automatycznie.

Jeśli autoryzacja przebiegnie prawidło, zostanie pobrany tzw. token aplikacji - jest on ważny 12 h. Dodatkowo aplikacja pobierze tzw. token odświeżenia, dzięki któremu będzie mogła przedłużać o kolejne 12 h token podstawowy aplikacji w cyklicznych zapytaniach do usługi Allegro.

Ważne jest jednak to, że tokenem odświeżającym można przedłużyć ważność tokena podstawowego do maksymalnie 365 dni. W związku z tym użytkownik będzie musiał się zalogować do Allegro przynajmniej raz w danym roku, aby uwierzytelnić aplikację.

Po pobraniu tokena system automatycznie próbuje pobrać warunki posprzedażowe z danych konta Allegro (należy je uzupełnić o informacje o sprzedającym po zalogowaniu się do Allegro). Ich lista dostępna jest w menu Aukcje | Kartoteka | Warunki posprzedażowe.

Warunki można uzupełnić w trakcie wystawiania lub grupowej edycji aukcji. W trakcie wystawiania lista dostępna jest w zakładce Płatność i dostawa, a w trakcie edycji w zakładce Podstawowe.

Podpowiedź

Dla kont sklepowych należy uzupełnić wszystkie warunki posprzedażowe, w przeciwnym razie API Allegro odrzuci aukcje.