Allegro: klucze, autoryzacja OAuth i synchronizacja

Do czego to służy

Konektor Allegro pobiera zamówienia z Twojego konta sprzedawcy, wysyła stany (i opcjonalnie ceny) ofert oraz przekazuje numery przesyłek. Korzysta z oficjalnego REST API Allegro i autoryzacji OAuth, więc Zaksio nigdy nie widzi hasła do Twojego konta Allegro.

Gdzie to znaleźć w aplikacji

Sprzedaż i logistyka, „Kanały sprzedaży”, „Dodaj kanał sprzedaży”, rodzaj „Allegro”. Potem zakładka „Połączenie” z polami „Client ID”, „Client Secret” i „Środowisko” (do wyboru „Produkcja (allegro.pl)” albo „Sandbox (allegro.pl.allegrosandbox.pl)”).

Skąd wziąć Client ID i Client Secret

1. Zaloguj się na konto sprzedawcy i wejdź na apps.developer.allegro.pl (dla sandboxa: apps.developer.allegro.pl.allegrosandbox.pl).
2. Dodaj nową aplikację: wpisz nazwę i wybierz typ z dostępem do przeglądarki (kod autoryzacji). Przepływ urządzenia też działa, jeśli aplikacja ma włączoną opcję „Device flow”. Nazwy typów po stronie Allegro bywają zmieniane.
3. W polu adresu zwrotnego (Redirect URI) wpisz dokładnie ten adres, który Zaksio pokazuje przy łączeniu konta. Allegro wymaga zgodności co do znaku, także końcowego ukośnika.
4. Aplikacja potrzebuje zakresów: odczyt profilu, odczyt i zapis zamówień oraz odczyt i zapis ofert (allegro:api:profile:read, allegro:api:orders:read, allegro:api:orders:write, allegro:api:sale:offers:read, allegro:api:sale:offers:write). Zwroty korzystają z odczytu zamówień.
5. Skopiuj Client ID i Client Secret do formularza w Zaksio, wybierz środowisko i kliknij „Zapisz poświadczenia”.
6. Autoryzuj konto Allegro i zatwierdź zakresy dostępu na stronie Allegro, a po powrocie kliknij „Sprawdź połączenie”. Powinieneś zobaczyć „Połączono jako” z Twoim loginem.

Oficjalna instrukcja: developer.allegro.pl, tutorial „Uwierzytelnianie i autoryzacja”. Wygląd panelu Allegro mógł się zmienić od czasu napisania tego artykułu.

Dwa sposoby autoryzacji

• Kod autoryzacji z PKCE: Zaksio przekierowuje Cię do Allegro, Ty zatwierdzasz dostęp i wracasz do aplikacji. Wymaga zarejestrowanego adresu zwrotnego. Jednorazowy identyfikator „state” jest ważny 10 minut.
• Kod urządzenia: Zaksio pokazuje krótki kod i adres, który wpisujesz na stronie Allegro. Nie potrzeba przekierowania, a Zaksio sprawdza w tle, czy zatwierdziłeś dostęp.

Tokeny są przechowywane zaszyfrowane i odświeżane automatycznie. Token odświeżania Allegro wygasa po 3 miesiącach, a każdy jest jednorazowy, więc po dłuższej przerwie trzeba połączyć konto od nowa.

Sandbox

Sandbox to osobne środowisko testowe Allegro. Konta z produkcji tam nie istnieją, więc załóż konto na allegro.pl.allegrosandbox.pl i aplikację na apps.developer.allegro.pl.allegrosandbox.pl, a w Zaksio wybierz środowisko „Sandbox”. Client ID i Client Secret z produkcji nie działają na sandboxie i odwrotnie.

Co synchronizuje

• Zamówienia: od zdarzenia „gotowe do realizacji” (opłacone online albo za pobraniem). Niezapłacone pojawiają się po zapłacie. Allegro udostępnia zdarzenia przez 60 dni. Anulowanie przed wysyłką anuluje zamówienie w Zaksio.
• Oferty: lista do mapowania. Lista z Allegro zwykle nie zawiera EAN, więc dopasowanie opiera się na SKU wpisanym w ofercie jako sygnatura.
• Stany: wysyłane komendami zbiorczymi z wynikiem dla każdej oferty. Stan 0 kończy ofertę na Allegro.
• Ceny: tylko gdy włączysz ustawienie kanału „syncPrices”, dla rynku Allegro.pl.
• Numer przesyłki: przekazywany na Allegro po wysyłce w Zaksio.
• Zwroty: Zaksio tylko powiadamia zespół o zwrocie zgłoszonym na Allegro (zasób w wersji beta), nie tworzy zwrotu w systemie.

Znane niepewności

W kodzie oznaczono miejsca, których nie dało się potwierdzić w dokumentacji: dokładny kształt zadań komend zbiorczych, ustawianie stanu 0, lista przewoźników, stawka VAT na pozycji zamówienia, pola wiadomości dla sprzedawcy i nazwy firmy, zakres w przepływie urządzenia oraz identyfikator rynku dla cen. Dopiero test na żywym koncie je rozstrzygnie.

Czego jeszcze nie ma

• Weryfikacji na żywym koncie i na sandboxie.
• Webhooków Allegro: zamówienia pobieramy odpytywaniem.
• Automatycznego zwrotu z Allegro i pokazywania adresu zwrotnego do skopiowania w formularzu połączenia (jego ustalenie jest jeszcze otwartą decyzją).
• Własnej, zweryfikowanej aplikacji Zaksio: dziś każdy klient zakłada aplikację na własnym koncie Allegro.