# DataFirefly Amazon Connector: integracja PrestaShop z Amazon Seller Central
> Instalacja Zainstaluj moduł w Moduły > Menedżer modułów > Prześlij moduł, wysyłając plik ZIP. Wymagane jest rozszerzenie PHP cURL. Podczas instalacji moduł tworzy swoje tabele, zakładkę Amazon Connector w menu…
- Strona:
- Język: pl
- Zaktualizowano: 2026-10-07
- Inne języki: [fr](https://www.datafirefly.com/documentation/dfamazonconnector/index.md), [en](https://www.datafirefly.com/en/documentation/dfamazonconnector/index.md), [es](https://www.datafirefly.com/es/documentation/dfamazonconnector/index.md), [de](https://www.datafirefly.com/de/documentation/dfamazonconnector/index.md), [it](https://www.datafirefly.com/it/documentation/dfamazonconnector/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfamazonconnector/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfamazonconnector/index.md)
- Indeks:
## Instalacja
Zainstaluj moduł w **Moduły > Menedżer modułów > Prześlij moduł**, wysyłając plik ZIP. Wymagane jest rozszerzenie PHP cURL.
Podczas instalacji moduł tworzy swoje tabele, zakładkę **Amazon Connector** w menu Sprzedaż, przewoźnika „Amazon” zarezerwowanego dla importowanych zamówień (klient nigdy go nie widzi) oraz dwa statusy zamówień: „Amazon: oczekuje na wysyłkę” i „Amazon FBA: wysłane”.
## Przygotowanie konta Amazon
Moduł łączy się z kontem sprzedawcy przez Twoją własną prywatną aplikację Selling Partner API. Potrzebne jest profesjonalne konto Seller Central.
1. W Seller Central otwórz **Aplikacje i usługi > Tworzenie aplikacji** i zarejestruj się jako prywatny deweloper, jeśli jeszcze tego nie zrobiłeś.
2. Utwórz aplikację i wystąp o role potrzebne do funkcji, z których będziesz korzystać: Product Listing i Pricing dla katalogu, Inventory and Order Tracking dla zamówień, Direct-to-Consumer Shipping (Restricted), aby otrzymywać adres dostawy i e-mail kupującego, Amazon Fulfillment dla stanu FBA, Finance and Accounting dla zwrotów, Tax Invoicing dla przesyłania faktur.
3. Autoryzuj aplikację na własnym koncie, aby uzyskać **refresh token**, i zanotuj **ID klienta LWA** oraz **sekret klienta**.
4. Skopiuj swój **Merchant Token** z **Ustawienia > Informacje o koncie**.
Bez roli Direct-to-Consumer Shipping zamówienia są importowane bez adresu dostawy. Moduł tworzy wtedy adres zastępczy i zaznacza to w adresie zamówienia.
## Połączenie i marketplace'y
W **Amazon Connector > Ustawienia** wybierz region (Europa, Ameryka Północna lub Daleki Wschód), wpisz klienta LWA, sekret, refresh token i Merchant Token, a następnie zapisz. Sekrety są szyfrowane w bazie; pozostaw pola puste, aby zachować zapisane wartości.
Na pulpicie kliknij **Testuj połączenie**. Marketplace'y Twojego konta pojawią się w zakładce **Marketplace'y**, domyślnie wyłączone. Dla każdego ustaw:
- aktywację;
- język wysyłanych treści (tytuł, opis);
- ceny brutto lub netto, zależnie od kraju;
- synchronizację cen, którą wyłączasz, jeśli korzystasz z repricera Amazon;
- narzut procentowy, stałą kwotę i zaokrąglenie (brak, x,99, x,90, liczba całkowita).
## Zadanie cron
Synchronizacja działa przez zadanie cron, najlepiej co 5 do 15 minut. Pulpit pokazuje adres URL zabezpieczony tokenem i polecenie wiersza poleceń:
```
php /sciezka/do/modules/dfamazonconnector/cron.php --shop=1
```
Przy każdym uruchomieniu moduł importuje zamówienia, potwierdza wysyłki, wysyła faktury i anulowania, odczytuje zwroty i stan FBA, a potem wysyła oczekujące oferty, stany i ceny w zbiorczych feedach. W module pojawia się czerwony komunikat, jeśli zadanie nie działało od ponad godziny. Przycisk **Nowy token** unieważnia stary adres URL.
## Mapowanie kategorii
Mapowanie jest potrzebne tylko do tworzenia nowych kart na Amazon. Produkt sprzedawany na istniejącym ASIN lub podłączony przez EAN wymaga jedynie oferty.
W zakładce **Mapowanie kategorii** wybierz kategorię PrestaShop i typ produktu Amazon (wbudowane wyszukiwanie po słowach kluczowych). Produkt korzysta z mapowania swojej kategorii domyślnej, a jeśli go brak, z najbliższej zmapowanej kategorii nadrzędnej.
- **Browse node**: węzeł nawigacji Amazon, opcjonalny zależnie od typu produktu.
- **Motyw wariantów**: na przykład `SIZE_NAME/COLOR_NAME`. Jeśli jest ustawiony, kombinacje są grupowane w rodzinę nadrzędny-podrzędny; jeśli pusty, każda kombinacja jest publikowana jako osobny produkt.
- **Atrybuty kombinacji** i **Cechy**: łączą atrybut Amazon z grupą atrybutów lub cechą PrestaShop.
- **Stałe atrybuty**: wartości wysyłane bez zmian w formacie Listings Items. Dostępne zmienne: `{marketplace_id}`, `{language_tag}`, `{currency}`, `{reference}`, `{ean13}`, `{mpn}`, `{brand}`.
Przycisk **Wymagane atrybuty** odczytuje schemat typu produktu w Amazon i wymienia atrybuty, których moduł nie wypełnia sam. Dla każdego wybierz źródło (stała wartość, cecha, atrybut kombinacji), a następnie **Zastosuj**: pola JSON zostaną uzupełnione automatycznie.
## Publikacja produktów
### Z karty produktu
Zakładka Moduły na karcie produktu zawiera blok Amazon:
- **Sprzedawaj na Amazon** włącza produkt.
- **Tryb publikacji**: automatyczny, oferta na istniejącym produkcie (ASIN lub EAN) albo utworzenie pełnej karty.
- **Realizacja**: przez Ciebie (FBM) lub przez Amazon (FBA).
- **ASIN**, **typ produktu**, **stan** i **stała cena Amazon** zastępują wartości domyślne dla tego produktu.
- **Dodatkowe atrybuty**: JSON scalany po stałych atrybutach kategorii; wartość `null` usuwa atrybut.
- **Marketplace'y**: odznacz kraj, aby usunąć produkt z tego marketplace'u.
Tabela „Co zostanie wysłane do Amazon” pokazuje dla każdej kombinacji i kraju cenę, cenę promocyjną z datami, cenę minimalną, cenę Business i ilość. Dostępne są cztery akcje: **Sprawdź w Amazon** (walidacja bez publikacji, błędy dla każdego atrybutu), **Wyślij teraz**, **Dodaj do następnej synchronizacji** i **Odśwież status**.
### Hurtowo
Zakładka **Produkty** wyświetla katalog ze statusem każdego produktu dla każdego kraju (aktywny, w toku, nieaktywny, błąd). Filtruj po nazwie, kategorii lub stanie, zaznacz produkty albo opcję „Wszystkie produkty pasujące do filtra” i zastosuj akcję: włącz i opublikuj, opublikuj ponownie, wyślij ceny, wyślij ilości, wyłącz (ilość 0) lub usuń z Amazon.
### Oferty już obecne na Amazon
Przycisk **Powiąż istniejące oferty Amazon** na pulpicie zamawia w Amazon raport Twoich ofert. Przy następnym uruchomieniu crona każdy SKU zostaje powiązany z produktem PrestaShop o tym samym SKU, indeksie lub EAN. Nieznalezione SKU są wymienione w dzienniku.
### SKU Amazon
SKU jest tworzony przy pierwszej publikacji zgodnie z wybranym ustawieniem: indeks, EAN13 lub wzorzec (domyślnie `PS{id_product}-{id_product_attribute}`). Istniejący SKU nigdy się nie zmienia, nawet gdy zmieni się indeks.
## Ceny
Cena jest liczona w walucie marketplace'u z wybraną grupą cenową, a następnie stosowane są narzut, stała kwota i zaokrąglenie kraju. Opcje w zakładce Ustawienia:
- **Stosuj rabaty sklepu**: ceny specyficzne i reguły katalogowe wliczone w cenę Amazon.
- **Wysyłaj rabaty sklepu jako ceny promocyjne Amazon**: cena regularna pozostaje ceną referencyjną, a rabat staje się ceną promocyjną z datami rabatu PrestaShop. Utworzenie, zmiana lub usunięcie rabatu od razu aktualizuje Amazon; datowane promocje i reguły katalogowe są sprawdzane ponownie co noc.
- **Minimalna marża od ceny zakupu**: wysyła cenę minimalną (przeliczona cena zakupu plus marża, z VAT kraju), poniżej której repricer nie może sprzedawać.
- **Ceny Amazon Business**: cena wybranej grupy klientów staje się ceną Business, a jej rabaty ilościowe progami (maksymalnie 5). Tylko dla sprzedawców zarejestrowanych w Amazon Business.
Aktualizacje cen dotyczą tylko ofert zarządzanych przez moduł: oferta utworzona ręcznie w Seller Central dla innej grupy odbiorców zostaje zachowana.
## Stany i FBA
Każdy ruch magazynowy w PrestaShop dodaje SKU do kolejki wysyłki. Dostępne ustawienia: zapas bezpieczeństwa (jednostki niewystawiane na Amazon), maksymalna ilość, czas realizacji, ilość 0 dla wyłączonych produktów i pełna resynchronizacja co noc po 3:00.
Produkty FBA nie otrzymują ilości z PrestaShop. Opcja **Odczyt stanu FBA** co godzinę pobiera ilość dostępną w magazynach Amazon i pokazuje ją na karcie produktu; **Kopiuj stan FBA do PrestaShop** przenosi ją do stanu sklepu dla produktów FBA.
## Zamówienia
Zamówienia są odczytywane przez Orders API v2026-01-01 od skonfigurowanej daty początkowej. Zamówienie oczekujące na płatność jest zapamiętywane bez tworzenia; zostaje zaimportowane, gdy tylko Amazon zwolni je do wysyłki.
Każde zaimportowane zamówienie tworzy lub wykorzystuje ponownie klienta-gościa (jednego na kupującego albo jednego wspólnego, do wyboru), adres „Amazon + numer zamówienia” oraz zamówienie PrestaShop z przewoźnikiem Amazon, cenami i kosztami wysyłki z Amazon, numerem zamówienia Amazon jako identyfikatorem transakcji i opcjonalnie datą zakupu z Amazon. Stan jest zmniejszany jak przy sprzedaży w sklepie.
Zamówienia FBA są importowane po wysyłce, ze statusem „Amazon FBA: wysłane”. Opcja „Zamówienia FBA nie zmieniają stanu sklepu” przywraca ilości po utworzeniu zamówienia.
Amazon zabrania kontaktu z kupującym poza swoim systemem wiadomości. Pozostaw włączoną opcję „Blokuj e-maile sklepu do kupujących z Amazon”: e-maile na adresy Amazon są blokowane, a Twoje własne powiadomienia o zamówieniach nadal docierają.
Zakładka **Zamówienia** wyświetla wszystkie zamówienia Amazon z filtrami „Do wysyłki”, „Prośby o anulowanie”, „Zwrócone” i „Niezaimportowane”. Zamówienie niezaimportowane (nieznany SKU, nieskonfigurowana waluta lub kraj) pokazuje przyczynę i przycisk **Ponów**.
## Wysyłki
Wybierz w ustawieniach statusy, które potwierdzają wysyłkę (na przykład Wysłane). Gdy zamówienie Amazon otrzyma jeden z tych statusów, moduł wysyła do Amazon kod przewoźnika, numer przesyłki i datę wysyłki. Jeśli numer przesyłki nie został jeszcze wpisany, czeka do godziny, zanim potwierdzi wysyłkę bez numeru.
Tabela mapowania przewoźników łączy każdego przewoźnika PrestaShop z kodem przewoźnika Amazon. Importowane zamówienia korzystają z przewoźnika Amazon: zmień przewoźnika zamówienia przed wysyłką, aby przesłać właściwy kod. Blok Amazon na stronie zamówienia ma też przycisk **Potwierdź wysyłkę teraz**.
## Faktury
Jeśli korzystasz z usługi obliczania VAT Amazon z opcją przesyłania własnych faktur, włącz **Przesyłaj faktury PrestaShop do Amazon**. Po potwierdzeniu wysyłki faktura PDF zamówienia jest wysyłana wraz z numerem, sumą i kwotą VAT. Status (wysłana, oczekuje, odrzucona) widać na liście i na stronie zamówienia.
Amazon odrzuca przesyłanie, jeśli w Seller Central włączone jest automatyczne generowanie jego własnych faktur. Wyłącz je w ustawieniach usługi obliczania VAT.
## Anulowania
Gdy kupujący prosi o anulowanie niewysłanego zamówienia, zamówienie jest oznaczane na czerwono na liście i na jego stronie, z powodem podanym przez kupującego. Nie wysyłaj: anuluj zamówienie w bloku Amazon, wybierając powód, albo włącz opcję **Anuluj na Amazon, gdy zamówienie zostanie anulowane w PrestaShop**. Anulowanie na prośbę kupującego jest wysyłane z powodem BuyerCanceled i nie obniża Twojego wskaźnika anulowań.
W drugą stronę: zamówienie anulowane na Amazon otrzymuje w PrestaShop wybrany status anulowania, bez e-maila do klienta.
## Zwroty
Przy włączonej opcji **Odczytuj zwroty Amazon** zwroty wykonane w Seller Central są odczytywane przez Finances API. Każdy jest odnotowywany w prywatnej notatce zamówienia z datą, pozycjami i kwotą netto. Gdy wszystkie jednostki zostaną zwrócone, zamówienie otrzymuje wybrany status (domyślnie Zwrócono). Wyświetlana kwota to kwota netto zaksięgowana na koncie Amazon, po zwróconych opłatach.
## Pulpit, alerty i dziennik
Pulpit pokazuje aktywne oferty i oferty z błędem, zamówienia z ostatnich 24 godzin i 30 dni, oczekujące zadania, ostatnią synchronizację, najczęstsze błędy Amazon pogrupowane według kodu i ostatnio wysłane feedy.
Codzienny e-mail z alertami jest wysyłany po 8:00 do wybranych odbiorców, tylko gdy trzeba działać: prośby o anulowanie, zamówienia niepotwierdzone ponad 2 dni po zakupie, niezaimportowane zamówienia, odrzucone faktury, oferty z błędem, odrzucone feedy, zatrzymany cron. Przycisk **Wyślij testowy e-mail** sprawdza konfigurację.
Zakładka **Logi** przechowuje każdą operację (feedy, zamówienia, wysyłki, zwroty, FBA, błędy) ze szczegółami technicznymi, z filtrami poziomu i kanału. Okres przechowywania ustawiasz w ustawieniach.
## Rozwiązywanie problemów
### Test połączenia kończy się błędem
Sprawdź wybrany region, klienta LWA, sekret i refresh token. Refresh token należy do jednej aplikacji i jednego konta: wygeneruj go ponownie po zmianie ról aplikacji.
### Oferta ma błąd
Otwórz kartę produktu: błędy Amazon są widoczne pod każdą ofertą. Kod 90220 oznacza brak wymaganego atrybutu, który należy uzupełnić w mapowaniu kategorii lub w dodatkowych atrybutach produktu. Użyj **Sprawdź w Amazon**, aby zweryfikować poprawkę przed wysłaniem.
### Zamówienie nie jest importowane
Przyczyna jest widoczna w zakładce Zamówienia. Najczęściej jest to SKU Amazon, który nie odpowiada żadnemu produktowi: powiąż istniejące oferty lub popraw indeks, a następnie kliknij Ponów. Sprawdź też, czy waluta i kraj dostawy są aktywne w PrestaShop.
### Stany lub ceny się nie aktualizują
Sprawdź ostatnią synchronizację na pulpicie i w dzienniku. Aktualizacje są wysyłane przy następnym uruchomieniu crona, a Amazon przetwarza je w ciągu kilku minut. Aby wymusić pełną wysyłkę, użyj **Wyślij ponownie wszystkie ilości**.
## Zgodność
- PrestaShop 8.0 do 9.x, ten sam plik ZIP obsługuje obie gałęzie.
- Multisklep i wielojęzyczność.
- Regiony Amazon: Europa, Ameryka Północna i Daleki Wschód.
- Architektura ModuleAdminController, bez zależności Composer.
- Interfejs dostępny po francusku, angielsku, hiszpańsku, niemiecku, włosku, niderlandzku, polsku i portugalsku.