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 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.

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.

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.

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.