Amazon — jak podłączyć i co robi konektor

Konektor Amazon działa na oficjalnym Selling Partner API. Obsługuje zamówienia realizowane przez sprzedawcę (MFN), potwierdzanie wysyłki i zwroty MFN. Nie synchronizuje ofert, cen ani stanów — to osobny etap.

Krok po kroku

Podłączyć konto sprzedawcy

1. Integracje → Dostępne integracje → Amazon → Dodaj. Nadaj nazwę połączenia.
2. W sekcji Bezpieczeństwo zostaw pola aplikacji puste (identyfikator i sekret aplikacji są wspólne dla całego systemu). Ustaw Seller Central host dla swojego rynku (np. sellercentral.amazon.pl) i Region (EU).
3. Kliknij Autoryzuj w Amazon. Otworzy się okno Seller Central — zaloguj się na konto sprzedawcy i zaakceptuj uprawnienia. Po powrocie karta pokaże „Połączenie OAuth zostało autoryzowane", a pola refresh token i selling partner id wypełnią się same.
4. Sprawdź połączenie. Odpowiedź wymienia rynki, na których konto ma aktywny udział.
5. W sekcji Zamówienia ustaw Marketplace'y (domyślnie DE i PL) i włącz pobieranie zamówień. Pierwszy pull sięga 14 dni wstecz albo od daty w polu Import zamówień zaktualizowanych po. Zaległość wchodzi porcjami, od najstarszych, kilkaset co kilka minut; zamówienie zmienione w ostatnich 3 minutach przychodzi z następnym pobraniem. Przy starcie ustaw tę datę blisko dnia uruchomienia, żeby nie ściągać długiej historii.
6. Statusy zewnętrzne → Pobierz katalog i zmapuj Unshipped na status roboczy, a Canceled na anulowane (Statusy zamówień z marketplace — mapowanie w obie strony).

Wysłać zamówienie

1. Zamówienie przechodzi normalną drogę magazynową (Kanał sprzedaży — integracja, połączenie i ustawienie).
2. Po nadaniu paczki numer przesyłki i kurier trafiają do Amazona automatycznie (potwierdzenie wysyłki). Amazon zna kody swoich kurierów — DPD, DHL, GLS, UPS, InPost…; nieznany kurier jedzie jako „Other" z nazwą. Własne mapowanie: pole Mapowanie kodów kurierów (nazwa albo symbol kuriera w systemie → kod Amazona).
3. Kilka paczek = kilka przesyłek w Amazonie, każda ze swoimi pozycjami. Paczka raz potwierdzona nie jest wysyłana do Amazona drugi raz — jeśli przy kilku paczkach jedna się nie uda, ponowienie dosyła tylko brakujące.

Co warto wiedzieć

• Dane kupującego pobierane są tokenem ograniczonym (RDT) — tak wymaga Amazon. Zamówienie bez adresu nie wchodzi do systemu; jeśli import raportuje „brak adresu", aplikacja nie ma jeszcze zgody Amazona na dane osobowe (rola PII), nie jest to błąd konfiguracji połączenia.
• Zamówienia Pending (płatność jeszcze nieautoryzowana) są pomijane, dopóki nie zmienią statusu. Przełącznik Importuj zamówienia oczekujące je wpuszcza.
• FBA (realizowane przez Amazon) nie jest pobierane, chyba że ustawisz kanał realizacji na AFN lub BOTH — takich zamówień nie wysyła się z magazynu i system nigdy nie potwierdza dla nich wysyłki w Amazonie.
• Zamówienie bez pozycji (Amazon nie oddał linii przy imporcie) nie ginie: trafia do pola Zamówienia czekające na przegląd kompletności i wchodzi przy najbliższym przeglądzie. Pole czyści się samo; ręcznie wyczyść je tylko, jeśli chcesz z tych zamówień zrezygnować.
• Zamówienia firmowe (Amazon Business) wchodzą z nazwą firmy i numerem VAT kupującego na adresie do faktury.
• Ceny na liniach są brutto z VAT (rynki europejskie); rabat promocyjny sprzedawcy wchodzi jako rabat linii. Dopasowanie do produktu idzie po SKU — Amazon nie wysyła EAN.
• Anulowania i zwroty pieniędzy robi się w Seller Central, nie z systemu. Przycisk zmiany statusu w Amazonie nic nie wysyła — status „wysłane" wynika z potwierdzenia przesyłki.
• Zwroty MFN wchodzą z raportu zwrotów co kilka godzin (ustawienie harmonogramu Returns import), z RMA, powodem i numerem przesyłki zwrotnej. Zwroty FBA obsługuje Amazon.
• Retencja: dane kupującego z zamówień Amazona znikają 30 dni po dostawie — to warunek Amazona, niezależny od ustawień firmy.