InPost Merchant (znany też jako InPost Buy) to kolejny kanał sprzedaży, w którym warto pokazać swoją ofertę. Problem w tym, że integracja katalogu z marketplace to nie tylko „wyślij produkty”. To mapowanie kategorii, uzupełnianie wymaganych atrybutów, zgodność z GPSR i utrzymanie aktualnych cen oraz stanów magazynowych. W tym poradniku przechodzę przez cały proces integracji sklepu PrestaShop z InPost Merchant krok po kroku, tak żeby po lekturze wiedzieć dokładnie, od czego zacząć i gdzie czają się największe pułapki.
Spis treści
- Czym jest InPost Merchant (InPost Buy)
- Dla kogo jest sprzedaż w InPost Merchant
- Wymagania przed rozpoczęciem integracji
- Metody integracji: pliki XML/CSV kontra API
- Integracja PrestaShop z InPost Merchant krok po kroku
- Najczęstsze problemy przy integracji
- Gotowe rozwiązanie zamiast pisania integracji od zera
- FAQ
1. Czym jest InPost Merchant (InPost Buy)
InPost Merchant to platforma sprzedażowa InPost, w której klienci mogą kupować produkty bezpośrednio z aplikacji i ekosystemu InPost. Dla sprzedawcy oznacza to dodatkowy kanał dotarcia do dużej bazy użytkowników przyzwyczajonych do zakupów z odbiorem w Paczkomatach. Twoja oferta trafia do środowiska, w którym logistyka i płatności są już rozwiązane po stronie InPost. Żeby oferta faktycznie tam działała, musi spełnić wymagania platformy: poprawną kategorię, komplet wymaganych atrybutów oraz dane zgodne z unijnym rozporządzeniem o bezpieczeństwie produktów (GPSR). Właśnie te elementy najczęściej blokują sprzedawców, którzy próbują „po prostu wysłać” swój katalog.2. Dla kogo jest sprzedaż w InPost Merchant
Sprzedaż w InPost Merchant ma sens przede wszystkim dla sklepów, które:- chcą dodatkowego kanału sprzedaży bez budowania własnego ruchu od zera,
- mają uporządkowany katalog z podstawowymi danymi (EAN, producent, zdjęcia),
- są gotowe zadbać o zgodność z GPSR,
- prowadzą sklep na PrestaShop w wersji 8 lub 9 i chcą zarządzać ofertą z jednego miejsca.
3. Wymagania przed rozpoczęciem integracji
Zanim zaczniesz łączyć PrestaShop z InPost Merchant, przygotuj kilka rzeczy:- Konto sprzedawcy w InPost Merchant oraz akceptację regulaminu platformy.
- Dostęp do InPost Merchant API wraz z danymi do autoryzacji (OAuth 2.1).
- Uporządkowany katalog w PrestaShop: nazwy, opisy, ceny brutto, stany magazynowe, EAN, producent, zdjęcia.
- Dane GPSR: nazwa i adres producenta lub osoby odpowiedzialnej, e-mail oraz telefon kontaktowy.
- Środowisko serwerowe z możliwością uruchamiania zadań CRON (do automatycznej synchronizacji).
4. Metody integracji: pliki XML/CSV kontra API
Integrację z InPost Merchant można zrobić na dwa sposoby.Eksport plików XML lub CSV
Prostsze rozwiązania generują plik z ofertą i wysyłają go cyklicznie. Zaleta jest jedna: łatwo to uruchomić. Wady są poważniejsze. Dane aktualizują się z opóźnieniem, łatwo o rozjazd stanów magazynowych i cen, a każda zmiana wymaga przebudowania i ponownego przesłania całego pliku. Przy dużym katalogu to droga do błędów i przeterminowanych ofert.Bezpośrednia integracja przez InPost Merchant API
Integracja przez API komunikuje się z platformą w czasie zbliżonym do rzeczywistego. Zmiana ceny czy stanu w PrestaShop może zostać wysłana od razu, bez eksportu całego katalogu. Do tego dochodzi pełna kontrola nad tym, co i kiedy trafia do sprzedaży, oraz możliwość obsługi wymaganych atrybutów i danych GPSR. Dla sklepów, które traktują InPost Merchant poważnie, API jest jedyną sensowną opcją.5. Integracja PrestaShop z InPost Merchant krok po kroku
Poniżej cały proces w kolejności, w jakiej najlepiej go przeprowadzić.Krok 1. Autoryzacja i połączenie z API
InPost Merchant API korzysta z OAuth 2.1. W praktyce spotkasz dwa przepływy: Authorization Code z PKCE (połączenie kontem InPost) oraz Client Credentials (tryb serwer do serwera). Token dostępowy ma ograniczony czas ważności, więc integracja musi go bezpiecznie przechowywać i automatycznie odświeżać. To ważne zwłaszcza przy zadaniach CRON, które mogą uruchamiać się równolegle.Krok 2. Pobranie i mapowanie kategorii
InPost ma własne drzewo kategorii. Twoje kategorie sklepowe trzeba dopasować do kategorii InPost, schodząc do właściwego „liścia” drzewa. Przy kilku produktach zrobisz to ręcznie. Przy tysiącach kategorii potrzebujesz wyszukiwarki i lokalnego cache drzewa, żeby nie odpytywać API bez końca. Źle zmapowana kategoria to najczęstsza przyczyna odrzuceń oferty.Krok 3. Wymagane atrybuty i dane GPSR
Każda kategoria InPost może wymagać konkretnych atrybutów (na przykład „minimalny wiek dziecka” dla zabawek). Te atrybuty pobierasz z API i uzupełniasz danymi produktu. Do tego dochodzą dane GPSR: producent lub osoba odpowiedzialna, adres, e-mail i telefon. Numer telefonu warto normalizować do formatu akceptowanego przez platformę, inaczej oferta się nie przyjmie.Krok 4. Synchronizacja produktów, cen i stanów
Po ustawieniu kategorii i atrybutów przesyłasz właściwe dane oferty: nazwę, opis, cenę brutto, podatek, walutę, stan magazynowy, producenta, EAN, referencję, zdjęcia oraz wagę i wymiary. Dobrze zaprojektowana integracja wysyła tylko zmienione produkty, a nie cały katalog za każdym razem. To oszczędza czas i limity API.Krok 5. Warianty produktów
Jeśli sprzedajesz produkty z kombinacjami, zdecyduj, czy do InPost trafia tylko produkt główny, czy każda kombinacja jako osobna oferta z własną ceną, EAN, referencją i stanem. Dla odzieży czy obuwia zwykle sensowne jest wystawianie kombinacji osobno.Krok 6. Obsługa zamówień
Integracja nie kończy się na wystawieniu oferty. Zamówienia z InPost trzeba pobierać, akceptować lub odrzucać i przenosić do obsługi w sklepie. Warto rozważyć automatyczną akceptację zamówień opłaconych, żeby nie robić tego ręcznie.Krok 7. Automatyzacja przez CRON
Ostatni element to harmonogram. Synchronizacja produktów, cen, stanów, pobieranie kategorii i zamówień oraz ponawianie błędnych operacji powinny działać w tle przez CRON. Każde zadanie warto zabezpieczyć tokenem i blokadą przed nakładaniem się procesów, żeby dwa uruchomienia nie weszły sobie w drogę.6. Najczęstsze problemy przy integracji
Z doświadczenia najczęściej wykładają się te miejsca:- Błędna kategoria („Incorrect Category”): produkt trafia do złego węzła drzewa i oferta jest odrzucana. Dla produktów znanych z katalogu InPost pomaga dopasowanie kategorii referencyjnej po EAN.
- Braki w atrybutach wymaganych: kategoria wymaga danych, których produkt nie ma. Trzeba je uzupełnić, ręcznie lub automatycznie z cech produktu.
- Niekompletne dane GPSR: brak adresu, telefonu albo zły format numeru blokuje publikację.
- Rozjazd stanów i cen: efekt integracji opartej na plikach albo rzadkiej synchronizacji.
- Wygasające tokeny i równoległe procesy: bez poprawnego odświeżania tokena CRON zaczyna zwracać błędy autoryzacji.
7. Gotowe rozwiązanie zamiast pisania integracji od zera
Jeśli nie chcesz budować całej integracji samodzielnie, jest gotowa opcja. Przygotowałem moduł RB InPost Merchant Pro dla PrestaShop 8 i 9, który łączy sklep bezpośrednio z InPost Merchant API i automatyzuje najtrudniejsze etapy: autoryzację OAuth, mapowanie kategorii, uzupełnianie atrybutów i danych GPSR oraz synchronizację produktów, cen i stanów przez CRON. Moduł dodatkowo wspiera się AI przy mapowaniu kategorii i doborze wymaganych atrybutów, obsługuje warianty, kolejkę z przetwarzaniem wsadowym oraz ponawianie błędnych synchronizacji. Dzięki temu działa stabilnie także przy katalogach liczących setki tysięcy produktów. Jeżeli szukasz sprawdzonej i gotowej do wdrożenia integracji PrestaShop z InPost Merchant, to najszybsza droga do sprzedaży w tym kanale.Sprzedajesz też w aplikacji TikTok? Na tej samej zasadzie działa moduł PrestaShop TikTok Shop: eksport produktów z wariantami, synchronizacja cen i stanów oraz import zamówień do jednego panelu, obok InPost Merchant.
8. FAQ
Czy PrestaShop 8 i 9 obsługuje integrację z InPost Merchant?
Tak. Integracja jest możliwa na obu wersjach, o ile korzystasz z bezpośredniego połączenia z InPost Merchant API.Czy do integracji potrzebuję danych GPSR?
Tak. Dane GPSR (producent lub osoba odpowiedzialna, adres, e-mail, telefon) są wymagane, żeby oferta została przyjęta przez platformę.Czy da się zintegrować duży katalog?
Tak, ale ręczne wystawianie odpada. Potrzebujesz synchronizacji przez API z przetwarzaniem wsadowym i CRON, żeby aktualizować tylko zmienione produkty.Czym różni się integracja przez API od eksportu plików?
API aktualizuje dane niemal w czasie rzeczywistym i wysyła tylko zmiany. Eksport plików działa z opóźnieniem i łatwiej o rozjazd cen oraz stanów magazynowych. Masz pytania o wdrożenie InPost Merchant w swoim sklepie? Napisz, pomogę dobrać rozwiązanie do wielkości katalogu i wersji PrestaShop.
