Jak działa integracja z Amazon Seller Central?
Integracja z Amazon Seller Central pozwala połączyć konto sprzedawcy z systemem magazynowym, ERP, programem do fakturowania lub platformą e-commerce. Dzięki temu zamówienia z Amazon mogą być pobierane automatycznie, a informacje o stanach magazynowych, cenach, wysyłkach i produktach przekazywane bez ręcznego przepisywania danych. Dobrze skonfigurowana integracja ogranicza pomyłki i pozwala obsługiwać sprzedaż na wielu marketplace'ach z jednego miejsca.
Integracja Amazon Seller Central działa dwukierunkowo: pobiera informacje o sprzedaży i zamówieniach, a jednocześnie może przekazywać do Amazon stany, ceny, oferty oraz statusy realizacji.
Amazon Seller Central jest centrum zarządzania sprzedażą na Amazon. Sprzedawca może z jego poziomu między innymi dodawać oferty, zarządzać cenami, kontrolować zapasy, obsługiwać zamówienia, śledzić realizację oraz analizować wyniki sprzedaży.
Przy kilku zamówieniach dziennie część operacji można wykonywać ręcznie.
Problem pojawia się, gdy firma jednocześnie korzysta z:
- własnego sklepu internetowego,
- magazynu,
- systemu ERP,
- programu do faktur,
- Amazon,
- innych marketplace'ów.
Ręczne przenoszenie danych między tymi systemami szybko staje się nieefektywne.
Dlatego Seller Central można połączyć z zewnętrznym oprogramowaniem za pomocą Selling Partner API, czyli SP-API. Amazon określa SP-API jako interfejs umożliwiający programowy dostęp między innymi do zamówień, przesyłek, płatności, ofert i zapasów.
W praktyce oznacza to, że system przedsiębiorcy może automatycznie komunikować się z Amazon bez konieczności ręcznej obsługi każdej operacji.
Co to jest Amazon Seller Central?
Seller Central to panel przeznaczony dla sprzedawców prowadzących sprzedaż poprzez Amazon.
Z jego poziomu można zarządzać między innymi:
- ofertami produktów,
- zamówieniami,
- cenami,
- stanami magazynowymi,
- realizacją wysyłek,
- zwrotami,
- płatnościami,
- raportami,
- kondycją konta sprzedawcy.
Amazon opisuje Seller Central jako główne miejsce zarządzania codziennymi operacjami sprzedażowymi.
Integracja nie zastępuje samego konta Seller Central.
Pozwala natomiast przenieść dużą część codziennych operacji do programu, z którego firma korzysta już do obsługi sprzedaży.
Na czym polega integracja z Amazon Seller Central?
Najprościej można przedstawić ją w postaci:
Amazon Seller Central ↔ SP-API ↔ system sprzedawcy
Systemem sprzedawcy może być przykładowo:
- ERP,
- WMS,
- program magazynowy,
- platforma e-commerce,
- system OMS,
- program do fakturowania,
- platforma integrująca marketplace'y.
SP-API działa jako warstwa komunikacyjna.
Amazon udostępnia określone dane oraz operacje, a zewnętrzny system może je odczytywać albo przesyłać informacje z powrotem do Amazon.
Amazon wskazuje, że dzięki SP-API aplikacje mogą między innymi zarządzać ofertami, zapasami, cenami i zamówieniami oraz pobierać raporty.
Jak wygląda integracja w praktyce?
Załóżmy, że firma sprzedaje ten sam produkt:
- we własnym sklepie,
- na Amazon,
- w sprzedaży stacjonarnej.
W centralnym magazynie znajduje się:
25 sztuk produktu A.
Klient kupuje 2 sztuki na Amazon.
Po poprawnej synchronizacji proces może wyglądać tak:
- Amazon rejestruje zamówienie.
- System pobiera zamówienie z Seller Central.
- W magazynie rezerwowane są 2 sztuki.
- Stan dostępny spada z 25 do 23.
- Aktualny stan może zostać wysłany ponownie do Amazon.
- Zamówienie trafia do realizacji.
- Powstaje odpowiedni dokument sprzedaży, jeżeli proces firmy tego wymaga.
- Przesyłka zostaje nadana.
- Informacja o realizacji trafia do Amazon.
Sprzedawca nie musi ręcznie kopiować danych z jednego panelu do drugiego.
To właśnie jest największą zaletą integracji.
Jakie dane można synchronizować z Amazon?
Zakres zależy od możliwości konkretnego systemu i uprawnień przyznanych integracji.
Najczęściej synchronizowane są:
| Obszar | Kierunek |
|---|---|
| Zamówienia | Amazon → system |
| Statusy zamówień | Amazon ↔ system |
| Produkty i oferty | System ↔ Amazon |
| Stany magazynowe | System → Amazon |
| Ceny | System → Amazon |
| Informacje o wysyłce | System → Amazon |
| Dane katalogowe | Amazon ↔ system |
| Raporty | Amazon → system |
| Dane finansowe | Amazon → system |
Nie oznacza to jednak, że każda integracja automatycznie obsługuje wszystkie te funkcje.
Program do faktur może potrzebować przede wszystkim zamówień i danych niezbędnych do dokumentów.
System magazynowy będzie natomiast koncentrował się na:
SKU → ilości → rezerwacji → wysyłce.
Pobieranie zamówień z Amazon Seller Central
To jedna z najczęściej wykorzystywanych funkcji.
Gdy klient złoży zamówienie na Amazon, zewnętrzny system może pobrać je poprzez Orders API.
W 2026 roku Amazon udostępnia nową wersję Orders API v2026-01-01, a wcześniejsza wersja v0 została oznaczona jako przestarzała. Nowa wersja upraszcza pobieranie danych do dwóch głównych operacji: searchOrders oraz getOrder.
Integracja może na tej podstawie otrzymać między innymi:
- numer zamówienia Amazon,
- marketplace,
- datę zakupu,
- pozycje zamówienia,
- ilości,
- dane dotyczące ceny,
- sposób realizacji,
- status zamówienia,
- określone informacje związane z dostawą.
Zakres dostępnych danych zależy od wykorzystywanych funkcji i uprawnień aplikacji.
Czy zamówienie pojawia się od razu po zakupie?
Nie zawsze należy traktować każde pojawiające się zamówienie jako gotowe do natychmiastowej realizacji.
Amazon posiada różne statusy zamówień, w tym między innymi:
- PENDING,
- UNSHIPPED,
- PARTIALLY_SHIPPED,
- SHIPPED,
- CANCELLED.
Nowa wersja Orders API wykorzystuje właśnie takie statusy realizacji.
Przykładowo zamówienie w statusie oczekującym może nie być jeszcze gotowe do kompletacji.
Dlatego dobra integracja nie tylko pobiera zamówienie, ale interpretuje również jego aktualny status.
Amazon może również wysyłać powiadomienia o zmianach
Integracja nie zawsze musi co kilka minut pytać Amazon:
„Czy pojawiło się nowe zamówienie?”
SP-API posiada mechanizm Notifications API, dzięki któremu aplikacje mogą reagować na określone zdarzenia.
Amazon udostępnia między innymi powiadomienia związane ze zmianami zamówień, ofert czy dostępnych ilości.
Pozwala to budować bardziej zdarzeniową integrację:
zdarzenie na Amazon → powiadomienie → reakcja systemu
zamiast ciągłego odpytywania API.
W praktyce wiele integracji wykorzystuje oba rozwiązania jednocześnie: powiadomienia oraz okresową synchronizację kontrolną.
Synchronizacja stanów magazynowych
To jeden z najważniejszych elementów sprzedaży wielokanałowej.
Załóżmy, że przedsiębiorca ma w magazynie:
10 sztuk produktu X.
Towar jest wystawiony jednocześnie:
- na Amazon,
- w sklepie internetowym,
- na innym marketplace.
Klient kupuje 3 sztuki w sklepie.
Jeżeli Amazon nie otrzyma aktualizacji, nadal może pokazywać:
10 sztuk dostępnych.
W rzeczywistości zostało 7.
Przy dużym ruchu może dojść do sprzedaży większej liczby produktów, niż firma rzeczywiście posiada.
Dlatego system centralny powinien obliczyć aktualny stan dostępny i przekazać go do Amazon.
Amazon wskazuje wprost, że SP-API umożliwia programowe aktualizowanie poziomów zapasów.
Stan fizyczny nie zawsze powinien być stanem wysłanym do Amazon
To ważne przy projektowaniu integracji.
Jeżeli w magazynie znajduje się:
100 sztuk produktu,
nie oznacza to automatycznie, że na Amazon należy wystawić 100.
Firma może zdecydować, że:
- 10 sztuk jest rezerwą bezpieczeństwa,
- 20 zostało zarezerwowanych przez inne zamówienia,
- część znajduje się w kontroli jakości.
Wtedy stan może wyglądać tak:
| Rodzaj stanu | Ilość |
|---|---|
| Fizycznie w magazynie | 100 |
| Zarezerwowane | 20 |
| Bufor bezpieczeństwa | 10 |
| Dostępne dla Amazon | 70 |
Integracja powinna więc korzystać ze stanu dostępnego do sprzedaży, a nie bezrefleksyjnie przesyłać stan fizyczny.
Po co stosować bufor magazynowy?
Przy sprzedaży wielokanałowej bardzo dobrym rozwiązaniem jest bufor bezpieczeństwa.
Przykładowo:
stan magazynowy: 15
bufor: 3
stan wysyłany do Amazon: 12
Gdy w magazynie pozostają 3 sztuki, oferta może zostać oznaczona jako niedostępna.
Bufor ogranicza ryzyko oversellingu, czyli sprzedaży produktu, którego w rzeczywistości już nie ma.
Jest szczególnie przydatny, gdy:
- produkt sprzedaje się bardzo szybko,
- kilka kanałów korzysta z tego samego magazynu,
- aktualizacje nie są natychmiastowe,
- występują różnice między stanem fizycznym a systemowym.
Jak system rozpoznaje ten sam produkt?
Najczęściej podstawowym identyfikatorem po stronie sprzedawcy jest SKU.
SKU powinno jednoznacznie wskazywać konkretną ofertę lub wariant w systemie przedsiębiorcy.
Amazon wykorzystuje również między innymi ASIN, czyli własny identyfikator produktu w katalogu Amazon.
W dużym uproszczeniu:
SKU identyfikuje ofertę sprzedawcy,
ASIN identyfikuje produkt w katalogu Amazon.
To rozróżnienie jest bardzo ważne.
Kilku sprzedawców może oferować produkt posiadający ten sam ASIN, ale każdy z nich może używać własnych SKU.
Co się dzieje, jeżeli SKU w systemach się różnią?
Integracja potrzebuje mapowania.
Przykładowo:
| System ERP | Amazon |
|---|---|
| BUT-001-CZ-42 | SHOES-BLACK-42 |
| BUT-001-CZ-43 | SHOES-BLACK-43 |
System powinien wiedzieć, że:
BUT-001-CZ-42
oraz
SHOES-BLACK-42
oznaczają ten sam wariant produktu.
Bez takiego mapowania automatyczna synchronizacja magazynu może być niemożliwa albo prowadzić do błędów.
Dlatego przed uruchomieniem integracji warto uporządkować identyfikatory produktów.
Synchronizacja ofert produktów
SP-API nie służy tylko do pobierania zamówień.
Amazon posiada między innymi Listings Items API umożliwiające programowe tworzenie i utrzymywanie ofert produktów. Dostępne są również Catalog Items API oraz Product Type Definitions API, pomagające obsługiwać dane katalogowe i wymagania poszczególnych typów produktów.
W zależności od integracji możliwe może być:
- tworzenie nowych ofert,
- aktualizowanie istniejących,
- zmiana ceny,
- aktualizacja ilości,
- aktualizacja określonych danych produktu,
- wykrywanie problemów z ofertą.
Nie każda informacja może być jednak dowolnie zmieniana przez sprzedawcę.
Amazon posiada wspólny katalog produktów oraz własne reguły dotyczące danych ofertowych.
Oferta Amazon a produkt w systemie ERP
Warto rozdzielić te dwa pojęcia.
W ERP można mieć kartotekę:
Ekspres do kawy ABC 500
z własnym SKU:
EKSP-ABC500.
Na Amazon produkt może być powiązany z:
- ASIN,
- SKU sprzedawcy,
- marketplace'em,
- ceną,
- stanem,
- statusem oferty.
Integracja tworzy powiązanie między kartoteką przedsiębiorcy a konkretną ofertą Amazon.
Dzięki temu jedna kartoteka magazynowa może być wykorzystywana do synchronizacji sprzedaży w wielu kanałach.
Jak działa aktualizacja ceny?
Cena może być kolejną informacją przesyłaną automatycznie do Amazon.
Przykładowo firma ustala cenę podstawową w ERP:
100
Następnie posiada osobne reguły:
sklep internetowy → 100
Amazon → 108
inny marketplace → 105
Różnice mogą wynikać między innymi z:
- prowizji,
- kosztów logistycznych,
- strategii sprzedażowej,
- promocji.
Integracja może obliczyć cenę zgodnie z regułą i zaktualizować ofertę Amazon.
SP-API obsługuje operacje związane z zarządzaniem cenami i ofertami, a Amazon wymienia automatyzację cen jako jedno z podstawowych zastosowań swoich narzędzi integracyjnych.
Synchronizacja nie powinna tworzyć pętli zmian
To problem, który pojawia się w źle zaprojektowanych integracjach.
Załóżmy:
- ERP ustawia cenę 100.
- Integracja wysyła ją do Amazon.
- Integracja pobiera cenę 100 z Amazon.
- Traktuje ją jako nową zmianę.
- Ponownie aktualizuje ERP.
- ERP ponownie uruchamia synchronizację.
Dlatego trzeba jasno ustalić:
który system jest źródłem prawdy dla danej informacji.
Przykładowo:
| Dane | System nadrzędny |
|---|---|
| Stan magazynowy | WMS |
| Cena | ERP |
| Zamówienie | Amazon |
| Status kompletacji | WMS |
| Dokument sprzedaży | system finansowy |
Takie podejście znacznie upraszcza integrację.
FBM i FBA – dlaczego trzeba je rozróżniać?
Sprzedaż na Amazon może być realizowana w różnych modelach logistycznych.
Dwa podstawowe to:
FBM – Fulfilled by Merchant
oraz
FBA – Fulfillment by Amazon.
W nowej wersji Orders API kanały te są reprezentowane odpowiednio jako MERCHANT oraz AMAZON.
Różnica ma ogromne znaczenie dla integracji.
Jak działa integracja przy FBM?
Przy FBM sprzedawca sam odpowiada za realizację zamówienia.
Typowy proces wygląda tak:
Amazon → zamówienie → system → magazyn → kompletacja → wysyłka → informacja do Amazon
Integracja może więc odpowiadać za:
- pobranie zamówienia,
- rezerwację towaru,
- przekazanie zamówienia do magazynu,
- utworzenie przesyłki,
- zapis numeru śledzenia,
- przekazanie informacji o wysyłce.
Tutaj synchronizacja magazynu oraz terminów realizacji jest szczególnie ważna.
Jak działa integracja przy FBA?
Przy FBA zapas jest przekazany do sieci logistycznej Amazon, a Amazon zajmuje się jego realizacją.
W takim modelu przedsiębiorca nie kompletuje każdej paczki we własnym magazynie.
Integracja może natomiast pobierać informacje związane między innymi z:
- zamówieniami,
- stanem zapasów FBA,
- realizacją,
- opłatami,
- rozliczeniami,
- raportami.
Amazon oddziela w Seller Central zarządzanie zapasami FBA i FBM, dlatego również system zewnętrzny powinien rozumieć, z którego modelu pochodzi dana sprzedaż.
Czy można jednocześnie obsługiwać FBA i FBM?
Tak.
Firma może mieć część ofert realizowanych przez Amazon, a część wysyłać samodzielnie.
Integracja powinna wtedy rozróżniać źródło realizacji.
Przykładowo:
| Zamówienie | Realizacja |
|---|---|
| A001 | FBA |
| A002 | FBM |
| A003 | FBM |
| A004 | FBA |
Zamówienie FBA nie powinno niepotrzebnie trafiać do kolejki kompletacyjnej własnego magazynu.
Jak przekazywana jest informacja o wysyłce?
W sprzedaży realizowanej przez sprzedawcę Amazon musi otrzymać informację, że zamówienie zostało wysłane.
Proces może wyglądać następująco:
- zamówienie trafia do magazynu,
- magazyn kompletuje produkty,
- generowana jest przesyłka,
- system otrzymuje numer śledzenia,
- zamówienie otrzymuje odpowiedni status,
- dane o realizacji są przekazywane do Amazon.
Amazon udostępnia poprzez SP-API operacje związane z obsługą wysyłek i potwierdzaniem realizacji.
W nowej wersji Orders API możliwe jest również pobieranie bardziej szczegółowych danych o paczkach, np. przewoźnika, numeru trackingowego czy statusu przesyłki.
Jak integracja działa przy wielu marketplace'ach Amazon?
Firma może sprzedawać jednocześnie np. na kilku europejskich marketplace'ach Amazon.
Integracja musi wtedy przechowywać informację, z którego rynku pochodzi zamówienie.
To ważne dla:
- waluty,
- języka,
- cen,
- stanów,
- podatków,
- numeracji dokumentów,
- księgowości,
- raportowania.
Nie należy więc traktować całej sprzedaży Amazon jako jednego anonimowego kanału.
Przykładowo system może przechowywać:
Amazon.de → zamówienie A
Amazon.fr → zamówienie B
Amazon.it → zamówienie C
choć wszystkie trafiają do tego samego centralnego panelu obsługi.
Czy jedno połączenie może obsługiwać wiele marketplace'ów?
SP-API zostało zaprojektowane do obsługi sprzedawców działających na różnych marketplace'ach i regionach. Amazon wskazuje, że aplikacja może zostać autoryzowana przez partnera sprzedażowego z różnych regionów i marketplace'ów.
Szczegółowy zakres zależy jednak od konfiguracji samego konta oraz integracji.
Dlatego system powinien przechowywać identyfikator marketplace'u razem z zamówieniem.
Jak wygląda autoryzacja integracji z Amazon?
Zewnętrzny program nie powinien otrzymywać loginu i hasła użytkownika do Seller Central.
Integracja działa poprzez mechanizmy autoryzacyjne Amazon.
Aplikacja musi być zarejestrowana i otrzymać odpowiednie uprawnienia. Następnie sprzedawca autoryzuje ją do wykonywania określonych operacji w imieniu swojego konta.
W praktyce użytkownik:
- rozpoczyna połączenie w systemie,
- przechodzi do procesu autoryzacji Amazon,
- loguje się do swojego konta,
- zatwierdza dostęp,
- wraca do aplikacji,
- integracja zapisuje dane umożliwiające dalszą komunikację.
Użytkownik nie powinien przekazywać dostawcy programu swojego hasła do Seller Central.
Czy integracja ma dostęp do wszystkiego?
Nie.
Amazon stosuje system uprawnień i ról.
Aplikacja powinna mieć dostęp tylko do danych potrzebnych do realizacji określonych funkcji.
Innych uprawnień potrzebuje system:
- zarządzający produktami,
- obsługujący magazyn,
- pobierający dane finansowe,
- realizujący przesyłki,
- przetwarzający dane klientów.
To ważne zarówno dla bezpieczeństwa, jak i zgodności z wymaganiami Amazon.
Co z danymi osobowymi klientów?
Nie wszystkie dane dotyczące zamówienia są zwykłymi danymi biznesowymi.
Niektóre informacje zawierają dane osobowe kupującego.
Amazon ogranicza dostęp do PII i wymaga odpowiednich ról oraz spełnienia wymogów bezpieczeństwa.
Warto przy tym zwrócić uwagę na aktualny stan API.
W starszej wersji Orders API dostęp do części danych osobowych wymagał używania Restricted Data Token, czyli RDT. W nowym Orders API v2026-01-01 Amazon uprościł ten model dla danych zamówień – dokumentacja migracyjna wskazuje, że dostęp do PII odbywa się na podstawie odpowiednich ról bez konieczności generowania RDT dla tych operacji.
Nie oznacza to jednak, że RDT całkowicie zniknął ze SP-API. Nadal jest wykorzystywany w innych ograniczonych operacjach i zasobach.
Jak często wykonywana jest synchronizacja?
Nie istnieje jedna częstotliwość odpowiednia dla wszystkich danych.
Można zastosować kilka modeli.
Synchronizacja cykliczna
System np. okresowo sprawdza:
- nowe zamówienia,
- zmiany statusów,
- stany,
- raporty.
Synchronizacja zdarzeniowa
System otrzymuje powiadomienie i wykonuje operację dopiero po zmianie.
Synchronizacja mieszana
Najczęściej jest najbezpieczniejsza.
Przykładowo:
powiadomienie → natychmiastowe pobranie zamówienia
oraz dodatkowo:
okresowa kontrola → sprawdzenie, czy niczego nie pominięto.
Amazon udostępnia Notifications API właśnie po to, aby aplikacje mogły reagować na określone zdarzenia bez nieustannego odpytywania API.
Dlaczego nie można wykonywać nieograniczonej liczby zapytań?
SP-API posiada limity wywołań.
Jeżeli aplikacja wykonuje zbyt wiele zapytań w zbyt krótkim czasie, część z nich może zostać ograniczona.
Amazon opisuje ten mechanizm jako rate limiting lub throttling.
Dlatego źle zaprojektowana integracja:
„sprawdź wszystkie zamówienia co sekundę”
nie jest dobrym rozwiązaniem.
Lepsze jest wykorzystanie:
- synchronizacji przyrostowej,
- powiadomień,
- kolejek,
- ponawiania nieudanych operacji,
- zapamiętywania ostatniego punktu synchronizacji.
Integracja powinna być odporna na chwilowe błędy
API nie należy traktować jak lokalnej funkcji programu, która zawsze odpowiada natychmiast.
Może wystąpić:
- timeout,
- chwilowa niedostępność,
- ograniczenie liczby żądań,
- błąd sieci,
- błąd autoryzacji,
- nieprawidłowe dane.
Dlatego ważny jest mechanizm ponawiania.
Przykładowo:
wysłanie stanu → błąd → kolejka retry → ponowna próba
zamiast:
wysłanie stanu → błąd → utrata aktualizacji.
Bardzo ważna jest idempotencja
Załóżmy, że system pobrał zamówienie Amazon:
123-1234567-1234567
Zapisał je w bazie, ale przed potwierdzeniem operacji wystąpił timeout.
Podczas kolejnej synchronizacji system otrzymuje to samo zamówienie.
Nie powinien utworzyć drugiego dokumentu sprzedaży.
Powinien rozpoznać:
to zamówienie już istnieje.
Dlatego numer zamówienia Amazon powinien być jednym z kluczowych identyfikatorów integracji.
Jak obsługiwać anulowane zamówienia?
Synchronizacja musi reagować również na anulowanie.
Przykładowo:
- Amazon przesyła zamówienie.
- Towar zostaje zarezerwowany.
- Zamówienie zostaje anulowane przed wysyłką.
- Integracja otrzymuje zmianę.
- Rezerwacja magazynowa zostaje zwolniona.
- Stan dostępny ponownie rośnie.
Jeżeli krok 4 lub 5 nie działa, w systemie powstaje sztuczny niedobór magazynowy.
Towar fizycznie istnieje, ale pozostaje niepotrzebnie zarezerwowany.
Co ze zwrotami?
Zwrot jest osobnym procesem biznesowym.
Nie należy automatycznie zakładać:
„zwrot = zwiększenie stanu dostępnego”.
Zwrócony produkt może być:
- pełnowartościowy,
- uszkodzony,
- niekompletny,
- wymagający kontroli,
- nienadający się do dalszej sprzedaży.
Poprawny proces wygląda więc raczej tak:
zwrot → przyjęcie → kontrola → decyzja → właściwy stan magazynowy.
Dopiero po kontroli produkt powinien wrócić do puli dostępnej, jeżeli jego stan na to pozwala.
Jak pobierać raporty z Amazon?
SP-API udostępnia Reports API, dzięki któremu aplikacje mogą pobierać różne rodzaje danych raportowych.
Amazon wskazuje, że raporty mogą służyć między innymi do pobierania danych dotyczących zapasów czy historii zamówień.
Raporty są przydatne szczególnie do:
- kontroli stanów,
- analiz okresowych,
- uzgodnień,
- rozliczeń,
- weryfikacji poprawności synchronizacji.
Nie każda informacja powinna być pobierana przez raport. Do bieżących zamówień bardziej naturalne jest Orders API, natomiast raporty dobrze sprawdzają się przy danych zbiorczych.
Integracja a rozliczenia Amazon
Sprzedaż przez marketplace oznacza, że kwota wpłacona przez Amazon na rachunek firmy nie musi być równa prostemu:
liczba zamówień × cena sprzedaży.
W rozliczeniu mogą występować między innymi:
- prowizje,
- opłaty,
- zwroty,
- korekty,
- koszty usług,
- inne obciążenia.
Dlatego system finansowy powinien rozróżniać:
wartość sprzedaży
od
kwoty wypłacanej przez Amazon.
SP-API umożliwia dostęp również do danych finansowych i płatności.
Integracja z Amazon a faktury
Jeżeli zewnętrzny program odpowiada za dokumenty sprzedaży, zamówienie pobrane z Amazon może stać się podstawą do przygotowania odpowiedniego dokumentu.
Proces może wyglądać następująco:
Amazon → zamówienie → program → dokument sprzedaży → zapis → dalsza obsługa
Nie oznacza to jednak, że dla każdego zamówienia należy automatycznie wystawić dokładnie ten sam rodzaj dokumentu.
Sposób dokumentowania sprzedaży zależy między innymi od:
- rodzaju nabywcy,
- marketplace'u,
- kraju sprzedaży,
- modelu rozliczenia,
- obowiązujących przepisów,
- ustawień sprzedawcy.
Dlatego mechanizm fakturowania powinien być konfigurowalny.
Jak powinny być rozpoznawane zamówienia Amazon w systemie?
Każde zamówienie warto oznaczać co najmniej informacjami:
- źródło: Amazon,
- marketplace,
- numer zamówienia Amazon,
- data zamówienia,
- waluta,
- model realizacji,
- status,
- identyfikator konta sprzedawcy.
Dzięki temu później można łatwo uzyskać raport:
sprzedaż Amazon.de w lipcu
albo:
zamówienia Amazon realizowane przez FBM.
Integracja wielu kont Seller Central
Większa firma może posiadać więcej niż jedno konto lub obsługiwać różne podmioty.
System integracyjny powinien wtedy zachować dodatkowy poziom identyfikacji:
konto sprzedawcy → marketplace → zamówienie
Nie wystarczy samo oznaczenie:
źródło = Amazon.
W przeciwnym razie łatwo pomieszać:
- zamówienia,
- dokumenty,
- magazyny,
- ceny,
- rozliczenia.
Co się dzieje po odłączeniu integracji?
Sprzedawca powinien mieć możliwość cofnięcia dostępu aplikacji.
Po utracie autoryzacji system nie może dalej poprawnie wykonywać operacji wymagających dostępu do konta.
Dlatego integracja powinna:
- wykryć błąd autoryzacji,
- zatrzymać operacje zależne od połączenia,
- oznaczyć integrację jako wymagającą interwencji,
- poinformować użytkownika,
- umożliwić ponowną autoryzację.
Nie powinno dochodzić do sytuacji, w której przez kilka dni system po cichu nie synchronizuje zamówień.
Jak sprawdzić, czy integracja działa prawidłowo?
Samo pojawienie się komunikatu:
„Połączono z Amazon”
nie wystarczy.
Po konfiguracji warto wykonać kontrolny scenariusz.
Test 1 – zamówienie
Sprawdź, czy nowe zamówienie pojawia się w systemie tylko raz.
Test 2 – stan magazynowy
Zmień stan testowego produktu i sprawdź jego aktualizację na Amazon.
Test 3 – anulowanie
Sprawdź, czy anulowane zamówienie zwalnia rezerwację.
Test 4 – wysyłka
Zrealizuj zamówienie i zweryfikuj przekazanie właściwych danych.
Test 5 – SKU
Upewnij się, że warianty produktów są prawidłowo zmapowane.
Test 6 – błąd API
Sprawdź, czy nieudana operacja trafia do ponowienia, zamiast zniknąć.
Test 7 – wielokrotna synchronizacja
Uruchom synchronizację tego samego okresu ponownie.
Nie powinny powstać duplikaty.
Jak powinien wyglądać panel dobrej integracji?
Użytkownik nie powinien być zmuszony do przeglądania logów technicznych.
Panel powinien jasno pokazywać:
| Informacja | Przykład |
|---|---|
| Status | Połączono |
| Konto | Amazon Seller DE |
| Ostatnia synchronizacja | 10:32 |
| Ostatnie zamówienie | 10:29 |
| Błędy | 2 |
| Produkty bez mapowania | 4 |
| Operacje oczekujące | 1 |
Najważniejsza zasada:
użytkownik powinien wiedzieć, czy jego sprzedaż jest aktualnie synchronizowana.
Kolejka błędów jest niezbędna
Wyobraźmy sobie, że Amazon odrzuca aktualizację jednego produktu z powodu błędnych danych.
System nie powinien zatrzymywać synchronizacji pozostałych 500 produktów.
Powinien:
- zapisać błąd konkretnej operacji,
- kontynuować pozostałe,
- pokazać problem użytkownikowi,
- umożliwić poprawienie danych,
- ponowić operację.
Przykładowy komunikat:
SKU ABC-001 – nie udało się zaktualizować oferty. Sprawdź wymagane dane produktu.
Jest znacznie bardziej użyteczny niż:
Error 400.
Najczęstsze problemy z integracją Amazon Seller Central
Niepoprawne mapowanie SKU
Najczęstsza przyczyna problemów ze stanami i zamówieniami.
Duplikowanie zamówień
Powstaje, gdy system nie kontroluje unikalnego identyfikatora zamówienia Amazon.
Brak aktualizacji po anulowaniu
Prowadzi do niepotrzebnych rezerwacji magazynowych.
Wysyłanie całego stanu fizycznego
Może powodować overselling, jeżeli część produktów jest już zarezerwowana.
Brak rozróżnienia FBA i FBM
Może powodować kierowanie zamówień FBA do własnego magazynu.
Brak obsługi limitów API
Integracja zaczyna otrzymywać błędy przy większej skali.
Brak mechanizmu retry
Chwilowy problem z API prowadzi do trwałego pominięcia aktualizacji.
Zbyt szerokie uprawnienia
Aplikacja otrzymuje dostęp do danych, których nie potrzebuje.
Brak monitorowania synchronizacji
Firma odkrywa problem dopiero wtedy, gdy klient zgłasza nieaktualny stan albo brak realizacji zamówienia.
Amazon Seller Central i inne kanały sprzedaży – gdzie powinien być główny stan?
Przy sprzedaży wielokanałowej najlepiej wyznaczyć jeden system jako nadrzędne źródło stanów.
Może nim być:
- ERP,
- WMS,
- centralny program magazynowy,
- platforma OMS.
Schemat wygląda wtedy tak:
magazyn centralny
↓
Amazon
sklep internetowy
pozostałe marketplace'y
Każde zamówienie zmniejsza wspólny stan, a nowe wartości są rozsyłane do pozostałych kanałów.
Pozwala to uniknąć sytuacji, w której Amazon uważa, że dostępnych jest 10 sztuk, sklep pokazuje 8, a ERP 6.
Czy Amazon powinien być systemem nadrzędnym?
Jeżeli firma sprzedaje wyłącznie na Amazon, w pewnych obszarach może to być wystarczające.
Przy sprzedaży wielokanałowej zazwyczaj lepiej utrzymywać centralny stan poza marketplace'em.
Amazon jest wtedy jednym z kanałów sprzedaży, a nie główną bazą całego przedsiębiorstwa.
Daje to większą kontrolę nad:
- rezerwacjami,
- wieloma magazynami,
- sklepem internetowym,
- innymi marketplace'ami,
- sprzedażą offline.
Jak przygotować sklep lub firmę do integracji z Amazon?
Przed połączeniem warto uporządkować dane.
1. Sprawdź SKU
Każdy produkt i wariant powinien mieć jednoznaczny identyfikator.
2. Wybierz źródło stanów
Określ, który system decyduje o rzeczywistej dostępności.
3. Wybierz źródło cen
Nie pozwalaj kilku systemom niezależnie modyfikować tej samej ceny.
4. Określ obsługę FBA i FBM
Procesy muszą być rozdzielone.
5. Ustal zasady dokumentowania sprzedaży
Określ, kiedy i na podstawie jakich danych powstaje dokument.
6. Ustal obsługę anulowań i zwrotów
Nie projektuj integracji wyłącznie dla idealnego scenariusza sprzedaży.
7. Przygotuj monitoring
System powinien informować o problemach automatycznie.
Co powinna obsługiwać dobra integracja z Amazon Seller Central?
| Funkcja | Znaczenie |
|---|---|
| Pobieranie zamówień | Podstawa automatycznej sprzedaży |
| Rozpoznawanie marketplace'u | Prawidłowe rozliczenie sprzedaży |
| Obsługa FBA i FBM | Poprawna realizacja logistyczna |
| Mapowanie SKU | Powiązanie produktów |
| Synchronizacja stanów | Ograniczenie oversellingu |
| Synchronizacja cen | Automatyczne zarządzanie ofertami |
| Obsługa anulowań | Zwolnienie rezerwacji |
| Obsługa wysyłek | Aktualizacja realizacji |
| Raportowanie błędów | Szybkie wykrywanie problemów |
| Retry | Odporność na chwilowe błędy API |
| Historia synchronizacji | Możliwość audytu |
| Obsługa wielu kont | Skalowanie sprzedaży |
Jak działa integracja z Amazon Seller Central krok po kroku?
Cały proces można sprowadzić do dziewięciu etapów.
Krok 1. Połączenie konta
Sprzedawca autoryzuje aplikację do komunikacji z Seller Central.
Krok 2. Pobranie konfiguracji
System rozpoznaje konto, marketplace'y i dostępne funkcje.
Krok 3. Mapowanie produktów
SKU Amazon zostają powiązane z produktami w systemie.
Krok 4. Synchronizacja stanów
Amazon otrzymuje aktualną dostępność.
Krok 5. Pobieranie zamówień
Nowa sprzedaż trafia automatycznie do systemu.
Krok 6. Rezerwacja magazynowa
System blokuje produkty potrzebne do realizacji.
Krok 7. Realizacja
Dla FBM zamówienie trafia do magazynu i wysyłki.
Krok 8. Aktualizacja Amazon
Informacje o realizacji są przekazywane z powrotem.
Krok 9. Kontrola
System monitoruje błędy, anulowania, zwroty i rozbieżności.
Najważniejsza zasada integracji z Amazon
Integracja nie powinna oznaczać prostego:
„kopiuj wszystko z Amazon do programu”.
Dobrze zaprojektowany system musi wiedzieć:
które dane pochodzą z Amazon,
które są nadrzędne w ERP lub magazynie,
oraz
w którym kierunku dana informacja powinna być synchronizowana.
Przykładowo:
zamówienie → Amazon jest źródłem
stan magazynowy → WMS jest źródłem
cena → ERP może być źródłem
realizacja FBM → magazyn jest źródłem
Dopiero takie rozdzielenie pozwala uniknąć konfliktów i automatyzować sprzedaż na większą skalę.
Podsumowanie
Integracja z Amazon Seller Central pozwala zamienić oddzielny panel marketplace'u w element większego systemu sprzedażowego firmy.
Za pomocą Selling Partner API zewnętrzne oprogramowanie może automatycznie obsługiwać dane związane między innymi z zamówieniami, ofertami, zapasami, cenami, wysyłką, raportami i finansami.
Dobrze wdrożona integracja pozwala ograniczyć ręczne przepisywanie danych i sprawia, że proces może wyglądać niemal automatycznie:
klient kupuje na Amazon → zamówienie trafia do systemu → magazyn rezerwuje produkt → zamówienie zostaje zrealizowane → informacja wraca do Amazon.
Najwięcej problemów nie wynika jednak z samego połączenia API, lecz z niewłaściwego zaprojektowania procesów wokół niego.
Trzeba jednoznacznie określić źródło stanów, sposób mapowania SKU, zasady obsługi FBA i FBM, anulowania, zwroty, dokumenty oraz mechanizm reagowania na błędy.
Wtedy Amazon może stać się kolejnym w pełni zintegrowanym kanałem sprzedaży zamiast osobnym systemem wymagającym ciągłej ręcznej obsługi.
FAQ – integracja z Amazon Seller Central
Co to jest integracja z Amazon Seller Central?
To połączenie konta sprzedawcy Amazon z zewnętrznym systemem, takim jak ERP, WMS, program magazynowy, platforma e-commerce lub system do obsługi dokumentów. Komunikacja może odbywać się poprzez Selling Partner API.
Co to jest SP-API?
Selling Partner API to REST-owe API Amazon umożliwiające aplikacjom programowy dostęp między innymi do danych o zamówieniach, przesyłkach, płatnościach, ofertach i zapasach.
Czy integracja może automatycznie pobierać zamówienia?
Tak. Orders API służy do pobierania informacji o zamówieniach i umożliwia budowanie automatycznej synchronizacji sprzedaży. Aktualną wersją jest Orders API v2026-01-01, a wcześniejsze v0 zostało oznaczone jako deprecated.
Czy można synchronizować stany magazynowe?
Tak. Jednym z podstawowych zastosowań SP-API jest programowe aktualizowanie stanów produktów. W sprzedaży wielokanałowej warto jednak wysyłać stan dostępny, uwzględniający rezerwacje i ewentualny bufor bezpieczeństwa.
Czy można synchronizować ceny?
Tak. Amazon udostępnia funkcje umożliwiające programowe zarządzanie ofertami i cenami. Zakres synchronizacji zależy od używanego systemu oraz konfiguracji integracji.
Czy integracja obsługuje FBA i FBM?
Może obsługiwać oba modele, ale system musi je rozróżniać. Przy FBM sprzedawca realizuje zamówienie samodzielnie, natomiast przy FBA realizacją zajmuje się Amazon.
Czy do integracji trzeba podać hasło do Seller Central?
Nie powinno się przekazywać hasła zewnętrznemu systemowi. Aplikacje korzystające z SP-API przechodzą proces autoryzacji, w którym sprzedawca udziela im odpowiedniego dostępu.
Czy aplikacja ma dostęp do danych klientów?
Tylko w zakresie wynikającym z przyznanych uprawnień i potrzebnego zastosowania. Amazon stosuje dodatkowe ograniczenia dla danych osobowych i określone role dostępu.
Jak szybko zamówienie z Amazon pojawia się w systemie?
Zależy to od sposobu działania integracji. Może ona korzystać z cyklicznego pobierania danych albo z powiadomień o zdarzeniach. SP-API posiada Notifications API umożliwiające reagowanie na zmiany bez ciągłego odpytywania Amazon.
Czy można połączyć kilka marketplace'ów Amazon?
Tak, integracje SP-API mogą obsługiwać sprzedaż na wielu marketplace'ach. System powinien jednak zachowywać informację o rynku, z którego pochodzi dane zamówienie.
Co się stanie, jeżeli API Amazon chwilowo nie odpowiada?
Dobra integracja zapisuje nieudaną operację i ponawia ją później. Jednorazowy błąd komunikacji nie powinien powodować trwałego pominięcia zamówienia lub aktualizacji stanu.
Jak uniknąć podwójnego pobrania zamówienia?
System powinien używać identyfikatora zamówienia Amazon jako unikalnego klucza i przed utworzeniem kolejnego dokumentu sprawdzać, czy zamówienie zostało już wcześniej zaimportowane.
Co jest najważniejsze przy wdrażaniu integracji z Amazon Seller Central?
Najważniejsze jest ustalenie źródła prawdy dla poszczególnych danych. Firma powinna wiedzieć, który system odpowiada za stan magazynowy, który za cenę, skąd pochodzi zamówienie i który system przekazuje informację o jego realizacji. Dzięki temu automatyzacja nie prowadzi do konfliktów między Amazon, magazynem, ERP i innymi kanałami sprzedaży.