Przejdź do głównej zawartości

Integracja z Allegro

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

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.

wapro aukcje konfiguracja

  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.

wapro aukcje konfiguracja

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.

wapro aukcje konfiguracja

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 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):

integracja-allegro-weryfikacja

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

integracja-allegro-weryfikacja2

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

wapro aukcje konfiguracja

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

wapro aukcje konfiguracja

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.

wapro aukcje konfiguracja

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.