Integracja sklepu Agilix z Allegro

• wystawianie produktów sklepu agilix.dog jako ofert na Allegro oraz aktualizowanie ich nazwy, opisu, zdjęć i ceny;
• utrzymywanie jednego wspólnego stanu magazynowego - sprzedaż w sklepie zmniejsza liczbę sztuk w ofercie na Allegro, a sprzedaż na Allegro zmniejsza stan w sklepie, zwykle w ciągu minuty;
• pobieranie opłaconych zamówień z Allegro do panelu zamówień sklepu, aby realizować je razem z zamówieniami złożonymi w sklepie;
• przekazywanie do Allegro statusu realizacji zamówienia i numeru przesyłki.

Z aplikacji korzysta wyłącznie administrator sklepu agilix.dog, w ustawieniach sklepu w panelu administracyjnym. Łączy on z aplikacją jedno konto sprzedawcy Allegro - to, z którego sklep sprzedaje. Kupujący i pozostali użytkownicy Agilix nie logują się do Allegro przez tę aplikację i nie mają dostępu do jej ustawień.

Administrator zaznacza przy produkcie pole "Synchronizuj z Allegro", wybiera kategorię i wymagane parametry oraz cenę na Allegro. Po zapisaniu produktu serwer Agilix w tle przesyła zdjęcia do Allegro, tworzy lub aktualizuje ofertę (produkt, kategoria i parametry, dane producenta i osoby odpowiedzialnej zgodnie z GPSR, cena, liczba sztuk, cennik dostawy, warunki zwrotów i reklamacji) i ją publikuje.

• Odznaczenie pola, dezaktywacja produktu lub wyczerpanie stanu kończy ofertę; ponowna dostępność wznawia ją.
• Zmiany trafiają do kolejki zadań w tle, więc edycja w sklepie nie czeka na odpowiedź Allegro.
• Jeśli Allegro odrzuci ofertę, administrator widzi przy produkcie kod i komunikat błędu z Allegro i może ponowić synchronizację.

• Raz na minutę serwer odczytuje dziennik zdarzeń zamówień od ostatnio przetworzonego zdarzenia.
• Zamówienie trafia do sklepu dopiero wtedy, gdy jest gotowe do realizacji (READY_FOR_PROCESSING) i nie zostało anulowane; każde zamówienie jest importowane dokładnie raz, a stan magazynowy maleje o zamówione sztuki.
• Anulowanie zamówienia na Allegro anuluje je w sklepie i przywraca stan magazynowy.
• Gdy administrator zmienia status zamówienia lub nadaje przesyłkę, aplikacja aktualizuje status realizacji w Allegro i dodaje numer przesyłki.
• Zwroty pieniędzy za zamówienia z Allegro są obsługiwane w panelu Allegro, poza aplikacją.

Aplikacja korzysta ze standardowego przepływu OAuth 2.0 (Authorization Code) udostępnianego przez Allegro. Nikogo nie prosi o login, hasło, Client ID ani Client Secret.

1. Administrator klika "Połącz z Allegro" w ustawieniach sklepu. Serwer tworzy podpisany parametr state, ważny 15 minut i przypisany do tego administratora.
2. Przeglądarka przechodzi na stronę logowania Allegro (https://allegro.pl/auth/oauth/authorize), gdzie sprzedawca loguje się na swoje konto i wyraża zgodę na uprawnienia aplikacji.
3. Allegro przekierowuje na zarejestrowany adres https://api.agilix.dog/allegro/oauth/callback. Serwer sprawdza podpis i ważność state oraz to, że użytkownik nadal jest administratorem sklepu, a następnie wymienia kod na tokeny (https://allegro.pl/auth/oauth/token), uwierzytelniając się własnym Client ID i Client Secret aplikacji.
4. Serwer odczytuje login połączonego konta i zapisuje połączenie. Token odświeżający jest przechowywany wyłącznie na serwerze, zaszyfrowany algorytmem AES-256-GCM. Token dostępowy jest odświeżany automatycznie, a nowy token odświeżający od razu zastępuje poprzedni.

Client Secret i tokeny nigdy nie trafiają do przeglądarki, aplikacji mobilnej ani do innych podmiotów.

Aplikacja przetwarza tylko dane potrzebne do sprzedaży: dane ofert sklepu oraz dane zamówień z Allegro - imię i nazwisko, adres dostawy lub punkt odbioru, telefon, adres e-mail w domenie allegromail.pl, dane do faktury, zamówione produkty i wiadomość do sprzedającego.

Dane zamówień służą wyłącznie do realizacji i wysyłki danego zamówienia. Sklep nie wysyła kupującym z Allegro żadnych wiadomości e-mail - ani transakcyjnych, ani marketingowych - i nie wykorzystuje ich danych do marketingu.

• Aplikacja korzysta wyłącznie z własnego Client ID i Client Secret, przechowywanych jako sekrety serwera; nie udostępnia ich nikomu i nigdy nie prosi użytkowników o ich klucze.
• Dostęp do konta sprzedawcy uzyskuje tylko przez OAuth 2.0, za zgodą sprzedawcy i w zakresie opisanych wyżej uprawnień.
• Każde zapytanie zawiera stały nagłówek User-Agent identyfikujący aplikację: Agilix-Sklep/1.0.0 (+https://agilix.dog/).
• Aplikacja przestrzega limitów: dziennik zamówień odpytuje raz na minutę, oferty aktualizuje tylko po zmianie produktu, a po odpowiedzi 429 czeka tyle, ile wskazuje nagłówek Retry-After.
• Nie pobiera masowo ofert ani danych innych sprzedawców i kupujących; dane z API wykorzystuje wyłącznie do obsługi sprzedaży połączonego konta.
• Komunikacja odbywa się wyłącznie przez HTTPS, a tokeny są przechowywane w postaci zaszyfrowanej.

Administrator może w każdej chwili kliknąć "Odłącz" w ustawieniach sklepu - serwer usuwa wtedy zapisane tokeny i powiązania ofert, a aplikacja przestaje wysyłać zapytania dla tego konta. Dostęp można też cofnąć po stronie Allegro, w ustawieniach konta; aplikacja oznacza wtedy połączenie jako rozłączone i pokazuje to administratorowi.

Pytania dotyczące aplikacji: adam@agilix.dog.