Wprowadzono nową metodę uwierzytelniania konta Allegro w usłudze Businesscommerce, za pośrednictwem kodu autoryzacji, która zastępuje dotychczasowe wykorzystanie parametrów ClientID oraz ClientSecret. W przypadku integracji z marketplace Allegro wskazane parametry nie będą już wymagane do poprawnej autoryzacji.
Nowa metoda autoryzacji zapewnia dostosowanie sposobu uwierzytelniania kont sprzedażowych do aktualnych standardów integracyjnych. Wprowadzone zmiany ograniczają konieczność zarządzania dodatkowymi danymi dostępowymi i zwiększają zgodność z mechanizmami autoryzacji stosowanymi przez platformę Allegro.
1. Nowy sposób autoryzacji konta Allegro
W słowniku Konta w usłudze Businesscommerce uruchamiamy akcję Nowy. W nowo otwartym oknie edycyjnym wybieramy:
- Typ konta – Marketplace,
- Nazwa platformy – ALLEGRO.
Następnie uzupełniamy pola Identyfikator konta i Opis konta wprowadzając odpowiednie informacje. Na koniec w polu Środowisko konta wybieramy czy konto tworzone jest na środowisku produkcyjnym Allegro czy w środowisku testowym AllegroSandbox (deweloperskie, testowe, demonstracyjne).
Rys. 1. Słownik Konta w usłudze Businesscommerce, okno edycyjne nowego konta
Po zatwierdzeniu wprowadzonych danych należy uruchomić procedurę Utwórz konto. Pojawi się komunikat informujący o konieczności posiadania aktywnego logowania dwuskładnikowego na koncie Allegro oraz komunikat z potwierdzeniem chęci utworzenia nowego konta. Zatwierdzenie komunikatów wywoła okno generowania kodu aktywacyjnego.
Rys. 2. Komunikat informujący o konieczności posiadania logowania dwuskładnikowego na koncie Allegro
Rys. 3. Okno potwierdzenia utworzenia konta Allegro w Businesscommerce
W nowo otwartym oknie operator zostanie poproszony o wygenerowanie i podanie kodu autoryzacji dla aplikacji Allegro. Po wciśnięciu przycisku Wygeneruj kod otworzona zostanie strona, gdzie uzyskać możemy kod autoryzacji powiązany z kontem Allegro.
Rys. 4. Okno procedury generowania kodu autoryzacji
Po uruchomieniu przeglądarki użytkownik zostanie poproszony o zalogowanie się na konto Allegro (jeżeli nie jest zalogowany) oraz zapoznanie się z regulaminem REST API Allegro. Po akceptacji regulaminu możliwe będzie wygenerowanie na stronie kodu autoryzacji.
Rys. 5. Okno przeglądarki, strona akceptacji regulaminu REST API Allegro
Rys. 6. Okno przeglądarki, strona z wygenerowanym kodem autoryzacji
Wygenerowany na stronie kod, należy wprowadzić w systemie w polu Kod autoryzacji i zatwierdzić przyciskiem OK.
Po zatwierdzeniu wprowadzonych danych, do API Allegro zostanie przesłany komunikat BUSINESS_COMMERCE_ACCOUNT_CREATE zawierający potwierdzenie utworzenia konta. W systemie wyświetlony zostanie natomiast komunikat informujący o utworzeniu konta w usłudze Businesscommerce i konieczności aktywowania i powiązania go z kontem Allegro.
Rys. 7. Komunikat informujący o utworzeniu konta i konieczności jego powiązania i aktywacji
Po poprawnym wysłaniu komunikatu z prawidłowym kodem, w oknie przeglądarki, w którym uprzednio wygenerowany został kod autoryzacji, otworzona zostanie strona z prośbą o potwierdzenie powiązania konta Allegro z Businesscommerce.
Rys. 8. Okno przeglądarki, strona potwierdzająca powiązanie konta Allegro z Businesscommerce
Po zatwierdzeniu powiązaniu konta w przeglądarce należy wrócić do systemu i przejść do słownika Konta w usłudze Businesscommerce. Dodane konto posiadać będzie wartość statusu Utworzone. Kolejnym krokiem jest aktywacja konta przez operatora, służy do tego procedura Aktywuj konto.
Rys. 9. Słownik Konta w usłudze Businesscommerce, procedura Aktywuj konto, status konta Utworzone
Na ekranie wyświetlony zostanie komunikat z prośbą o potwierdzenie aktywacji konta. Po jego zatwierdzeniu operator zostanie poinformowany o poprawnym aktywowaniu konta a status konta zostanie zmieniony na Aktywny.
Rys. 10. Okno potwierdzenia aktywacji konta w Businesscommerce
Rys. 11. Komunikat informujący o poprawnej aktywacji konta
2. Modyfikacja uwierzytelnienia konta Allegro
W przypadku konieczności modyfikacji kodu autoryzacji konta Allegro, zmiana odbywa się poprzez użycie akcji Edycja, w słowniku Konta w usłudze Businesscommerce, na aktywnym koncie dla platformy ALLEGRO. Nowy kod należy wpisać w oknie edycyjnym, w polu Kod autoryzacji i zatwierdzić zmianę przyciskiem Zapisz.
Rys. 12. Słownik Konta w usłudze Businesscommerce, okno edycyjne – pole Kod autoryzacji
Nowy kod autoryzacji wygenerować można na dedykowanej stronie portalu Allegro, logując się i postępując tak jak w przypadku generowania kodu dla nowego konta. Adres strony dla odpowiedniego środowiska aplikacji dostępny jest poniżej.
Dla środowiska produkcyjnego Allegro:
Dla środowiska deweloperskiego/testowego/demonstracyjnego:
Zatwierdzenie wprowadzonych danych, wywoła przesłanie do API Allegro komunikatu BUSINESS_COMMERCE_ACCOUNT_MODIFY zawierającego nowy kod autoryzacji. W systemie wyświetlony zostanie natomiast komunikat informujący o zmodyfikowaniu konta w usłudze Businesscommerce i konieczności aktywowania i ponownego powiązania go z kontem Allegro.
Rys. 13. Komunikat informujący o modyfikacji konta i konieczności jego powiązania i aktywacji
Po poprawnym dostarczeniu komunikatu z nowym kodem w oknie przeglądarki, w którym uprzednio wygenerowany został kod autoryzacji, otworzona zostanie strona z prośbą o potwierdzenie powiązania konta Allegro z Businesscommerce. Proces powiązania konta wygląda analogicznie jak w przypadku dodawania tworzenia nowego konta w usłudze.
Po zatwierdzeniu powiązaniu konta w przeglądarce należy wrócić do systemu i przejść do słownika Konta w usłudze Businesscommerce. Dodane konto posiadać będzie wartość statusu Edytowane. Kolejnym krokiem jest aktywacja konta przez operatora, służy do tego procedura Aktywuj konto.
Rys. 14. Słownik Konta w usłudze Businesscommerce, procedura Aktywuj konto, status konta Edytowane
Na ekranie wyświetlony zostanie komunikat z prośbą o potwierdzenie aktywacji konta. Po jego zatwierdzeniu operator zostanie poinformowany o poprawnym aktywowaniu konta, a status konta zostanie zmieniony na Aktywny.
3. Zmiany w słowniku Konta w usłudze Businesscommerce
W związku z wprowadzoną zmianą metody autoryzacji konta Allegro, w oknie edycyjnym w słowniku Konta w usłudze Businesscommerce zostało dodane pole Kod autoryzacji, które służy do uwierzytelniania konta dla marketplace Allegro.
Pole domyślnie jest nieaktywne – zostaje odblokowane do edycji po wybraniu:
- Typ konta – Marketplace,
- Nazwa platformy – ALLEGRO.
Rys. 15. Słownik Konta w usłudze Businesscommerce, nowe pole w oknie edycyjnym – Kod autoryzacji
Konfiguracja
Funkcjonalność wymaga nadania uprawnień: TAK
Funkcjonalność wymaga skonfigurowania: TAK