Amazon.pl (SP-API): klucze LWA, refresh token i synchronizacja

Do czego to służy

Konektor Amazon.pl łączy Zaksio z kontem sprzedawcy przez Selling Partner API (region Europa, rynek Amazon.pl). Pobiera zamówienia wysyłane przez Ciebie, listę ofert po SKU sprzedawcy, wysyła stany i opcjonalnie ceny oraz potwierdza wysyłkę numerem przesyłki.

Czego konektor nie robi: nie tworzy ofert ani nie zmienia ich treści (oferta musi już istnieć w Seller Central), nie obsługuje zwrotów ani powiadomień SP-API, a zamówienia z magazynu Amazon (FBA) pomija, chyba że włączysz ustawienie kanału „includeFba”. Takie zamówienia i tak nie należą do Twojego magazynu.

Gdzie to znaleźć w aplikacji

Sprzedaż i logistyka, „Kanały sprzedaży”, „Dodaj kanał sprzedaży”, rodzaj „Amazon.pl”, a w kanale zakładka „Połączenie”. Pola konektora: „LWA Client ID”, „LWA Client secret”, „Refresh token” i „Merchant token (Seller ID)”. Rynek to domyślnie Amazon.pl, inny ustawisz w ustawieniach kanału („marketplaceId”).

Aplikacja oznacza ten rodzaj kanału jako „W przygotowaniu”: zakładka „Połączenie” pokazuje na razie uproszczony szkic formularza (z mniejszą liczbą pól i innymi nazwami), a przycisków „Sprawdź połączenie” i „Start” jeszcze w niej nie ma. Klucze zapisane w tym szkicu mogą nie trafić do pól konektora, więc po udostępnieniu pełnego ekranu wpisz je ponownie.

Skąd wziąć klucze

1. Zaloguj się do Seller Central jako użytkownik główny konta i wejdź w Aplikacje i usługi, Develop Apps (konsola dewelopera).
2. Zarejestruj profil dewelopera (aplikacja prywatna, własne konto) i poczekaj na zatwierdzenie ról przez Amazon.
3. Dodaj aplikację typu SP-API (region Europa) z tymi rolami i skopiuj z niej Client ID oraz Client secret (opcja „Wyświetl dane logowania LWA”).
4. Na liście aplikacji wybierz „Autoryzuj aplikację” (self-authorization dla własnego konta, aplikacja może mieć status roboczy) i skopiuj Refresh token. Każde kliknięcie tworzy nowy token, a wcześniejsze nadal działają.
5. Merchant token znajdziesz w Ustawienia, Informacje o koncie.
6. Wklej te cztery wartości w zakładce „Połączenie” i użyj „Sprawdź połączenie”, gdy ten przycisk będzie dostępny.

Oficjalna instrukcja: developer-docs.amazon.com/sp-api, temat „self-authorization”. Wygląd konsoli Amazona mógł się zmienić od czasu napisania tego artykułu.

Co synchronizuje

• Zamówienia: tylko wysyłane przez sprzedawcę (FBM), pobierane co 5 minut. Niezapłacone (PENDING) wchodzą po zatwierdzeniu płatności. Limit Amazona to jedno zapytanie o zamówienia na około 3 minuty, więc szybciej się nie da.
• Dane kupującego (adres, telefon, e-mail): tylko z rolą Direct-to-Consumer Shipping (Restricted). Bez niej zamówienie przyjdzie bez adresu i trzeba go uzupełnić.
• Oferty: lista po SKU sprzedawcy do zmapowania na towary.
• Stany: wysyłane do kanału wysyłki przez sprzedawcę, z wynikiem dla każdego SKU. Czas realizacji i data uzupełnienia wracają do ustawień domyślnych oferty.
• Ceny: tylko po włączeniu ustawienia kanału „syncPrices”. Zmiana ceny zastępuje całą ofertę, więc usuwa ceny promocyjne i inne grupy odbiorców.
• Numer przesyłki: potwierdzenie wysyłki z przewoźnikiem zgłaszanym jako „Other” wraz z jego nazwą.

Czego jeszcze nie ma

• Ekranu połączenia dla tej platformy w aplikacji: backend konektora istnieje i jest przetestowany na atrapach serwera, ale interfejs jest w przygotowaniu (patrz wyżej).
• Weryfikacji na żywym koncie: niepewne są m.in. kształt rozbicia podatku w kwotach zamówienia, nazwy statusów i zachowanie nadpisywania stanu.
• Powiadomień SP-API (np. ORDER_CHANGE): zamówienia pobieramy odpytywaniem, co przy dużym ruchu może być za wolne. Nie ma też zwrotów z Amazona.
• Nowszego interfejsu dla potwierdzenia wysyłki: korzysta ze starszej wersji Orders API v0, bo nowa nie ma tej operacji. Amazon wycofuje v0 w marcu 2027, więc konektor będzie wtedy wymagał aktualizacji.