• GN8 — dokumentacja integracji Allegro

GN8 · Integrator MPM-24

Integracja z Allegro

Dokumentacja aplikacji wewnętrznej MPM-24. Aktualizacja: 17 października 2026 r.

Cel aplikacji

GN8 jest rozwijanym integratorem sprzedaży, katalogów dostawców i Subiekta GT ze Sferą. Aplikacja jest przeznaczona do obsługi własnych kont sprzedawcy: MPMgrupa oraz MPM_24. Nie jest publiczną usługą dla innych sprzedawców.

Etap pierwszego połączenia

Pierwszy etap integracji Allegro obejmuje autoryzację kont oraz odczyt ofert, zamówień i opłat. Testy nie zmieniają ofert ani zamówień Allegro i nie zapisują danych do produkcyjnej bazy Subiekta. Obecna integracja sprzedawcy pozostaje uruchomiona podczas przygotowania GN8.

Połączenie konta

  1. Administrator wpisuje dane własnej aplikacji Allegro w module połączeń GN8.
  2. Wybiera konto i rozpoczyna autoryzację OAuth 2.0 Device Flow.
  3. Loguje się bezpośrednio w Allegro i zatwierdza wyświetlony zakres dostępu. GN8 nie pobiera hasła Allegro.
  4. GN8 sprawdza tożsamość sprzedawcy przez API przed uznaniem konta za połączone. Każde konto jest autoryzowane osobno.

Początkowe uprawnienia

Zakres Zastosowanie
allegro:api:profile:read Weryfikacja konta sprzedawcy.
allegro:api:sale:offers:read Odczyt i dopasowanie istniejących ofert.
allegro:api:orders:read Odczyt zamówień i ich statusów, w tym anulowania.
allegro:api:billing:read Odczyt opłat do rozliczenia transakcji.

Docelowy zakres — kolejne etapy

Planowane są: aktualizacja cen i dostępności, wystawianie ofert, przekazywanie zamówień do Subiekta GT, faktury PDF z QR oraz obsługa przesyłek i etykiet. Czynności wymagające zapisu w Allegro zostaną uruchomione dopiero po przyznaniu odpowiednich uprawnień, dodatkowej autoryzacji i testach. Początkowy zakres tylko do odczytu ich nie umożliwia.

Ochrona danych i ciągłość sprzedaży

  • Dane połączenia i tokeny są zapisywane lokalnie w zaszyfrowanym magazynie chronionym przez Windows DPAPI.
  • Połączenia z Allegro używają HTTPS z weryfikacją certyfikatu.
  • GN8 korzysta z własnej rejestracji API; nie przejmuje tokenów dotychczasowego integratora.
  • Powiązania uwzględniają konto oraz identyfikator zamówienia. Przed zapisem dokumentu sprawdzane jest jego wcześniejsze utworzenie.
  • Nieznany wynik zapisu wymaga uzgodnienia stanu przed ponowieniem.
  • Dostęp można odwołać w ustawieniach konta Allegro. Dane klientów są przeznaczone do obsługi zamówień i nie są publikowane w tej dokumentacji.

Stan wdrożenia

Moduł autoryzacji i adaptery zamówień są przygotowane oraz sprawdzone testami lokalnymi. Połączenie własnych kont Allegro oczekuje na rejestrację GN8 i autoryzację sprzedawcy. Testy na produkcyjnej bazie Subiekta oraz uruchomienie zapisów Allegro stanowią osobne etapy wdrożenia.

Dokument nie zawiera kluczy API, haseł, danych klientów ani konfiguracji serwerów.