Wtyczka integracyjna Allegro (yuServer)

Oficjalna strona informacyjna i dokumentacja aplikacji integracyjnej udostępnianej sprzedawcom platformy yuServer.

Aplikacja Produkcyjna & Sandbox

1. Opis i cel aplikacji

Aplikacja yuServer-Allegro służy do dwukierunkowej integracji sklepów internetowych działających na platformie yuServer z kontami sprzedażowymi w serwisie Allegro. Integration-app umożliwia automatyzację kluczowych procesów handlowych, takich jak dwukierunkowa synchronizacja stanów magazynowych i cen, pobieranie zamówień z Allegro do panelu sklepu, zarządzenie statusami realizacji oraz obsługa Centrum Wiadomości i Dyskusji.

2. Identyfikator aplikacji (User-Agent)

Wszystkie wywołania do REST API Allegro wykonywane przez serwer wtyczki posiadają statyczny nagłówek identyfikacyjny zgodny z wytycznymi Allegro:

User-Agent: yuServer-Allegro/0.1.1 (+https://yuserver.com/allegro)

3. Główne funkcjonalności

Zarządzanie ofertami: Wystawianie ofert w oparciu o Katalog Produktów Allegro (OFP), walidacja wymogów GPSR (dane producentów, informacje o bezpieczeństwie i osoby odpowiedzialne w UE).
Synchronizacja stanów i cen: Automatyczne aktualizacje cen i stanów magazynowych w czasie rzeczywistym oraz zamykanie ofert przy braku towaru.
Obsługa zamówień: Pobieranie zamówień (checkout-forms), synchronizacja statusów realizacji, wprowadzanie numerów przesyłek (tracking) oraz przetwarzanie zwrotów wpłat.
Obsługa kupujących: Integracja z Centrum Wiadomości (wątki, odpowiedzi, obsługa załączników) oraz monitorowanie i obsługa zgłoszeń i Dyskusji/Reklamacji.

4. Sposób połączenia z kontem Allegro

Połączenie następuje przy użyciu standardowego i bezpiecznego protokołu OAuth 2.0 (Authorization Code Grant z PKCE S256):

Sprzedawca w panelu administracyjnym swojego sklepu klika przycisk „Połącz konto Allegro”.
Sprzedawca zostaje przekierowany na oficjalną stronę logowania Allegro (https://allegro.pl/auth/oauth/authorize).
Po zalogowaniu i zapoznaniu się z listą uprawnień sprzedawca zatwierdza dostęp.
Allegro przekierowuje użytkownika na zabezpieczony punkt końcowy wtyczki: https://allegro-sklep.placegram.pl/allegro/powrot.
Aplikacja bezpiecznie odbiera token autoryzacyjny i przechowuje go w formie zaszyfrowanej.

5. Wymagane zakresyuprawnień (Scope) i uzasadnienie

Uprawnienie (Scope)	Cel i uzasadnienie użycia
`allegro:api:profile:read`	Pobranie podstawowych danych konta (login, ID) w celu identyfikacji połączonego sprzedawcy w panelu sklepu.
`allegro:api:sale:offers:read` `allegro:api:sale:offers:write`	Odczyt ofert, weryfikacja statusów, pobieranie zdarzeń ofertowych oraz automatyczna edycja cen, stanów magazynowych i danych GPSR.
`allegro:api:sale:settings:read`	Pobieranie definicji cenników dostaw, warunków zwrotów, gwarancji oraz słowników producentów i osób odpowiedzialnych (GPSR).
`allegro:api:orders:read` `allegro:api:orders:write`	Pobieranie zamówień kupujących, aktualizacja statusów realizacji oraz przekazywanie numerów listów przewozowych.
`allegro:api:messaging`	Pobieranie wiadomości od kupujących i udzielanie odpowiedzi w ramach Centrum Wiadomości (beta.v1).
`allegro:api:disputes`	Odczyt zgłoszeń z Dyskusji i Reklamacji oraz prowadzenie korespondencji w sprawach spornych.
`allegro:api:payments:read` `allegro:api:payments:write`	Weryfikacja wpłat oraz zlecanie zwrotów środków kupującym na żądanie sprzedawcy.

6. Bezpieczeństwo i ochrona danych

Szyfrowanie tokenów: Wszystkie tokeny OAuth (access_token i refresh_token) są szyfrowane w bazie danych algorytmem AES-256-GCM z unikalnym kluczem serwera wtyczki.
Minimalizacja danych: Wtyczka przechowuje wyłącznie dane niezbędne do realizacji zamówień i obsługi korespondencji. Treści wiadomości i dane kupujących są retencjonowane maksymalnie przez 12 miesięcy.
Komunikacja: Wszystkie połączenia z API Allegro oraz panelem sklepu szyfrowane są przy użyciu protokołu TLS 1.3 (HTTPS).

7. Wymagania po stronie sprzedawcy

Posiadanie aktywnego konta firmowego w serwisie Allegro.
Włączona weryfikacja dwuetapowa (2FA) na koncie Allegro.
Aktywny sklep internetowy na platformie yuServer ze skonfigurowanym katalogiem produktów (SKU / EAN).

Kontakt z deweloperem i wsparcie techniczne

W przypadku pytań dotyczących integracji, zgłoszeń błędów lub kwestii bezpieczeństwa prosimy o kontakt:

Twórca wtyczki: Markgram
E-mail wsparcia: [email protected]
Strona domowa: https://markgram.pl