📦 Pakowanie produktów z appką to mniej błędów i szybsza praca Twojego zespołu
Moduł łączy sklep z platformą sprzedażową InPost Von Halsky. Sprawdza, które produkty spełniają wymagania platformy, wystawia je jako oferty, sam przesyła zmiany cen i stanów oraz importuje opłacone zamówienia do panelu PrestaShop - z właściwym przewoźnikiem i statusem.
Wiesz, co blokuje ofertę, zanim ją wystawisz
Weryfikacja gotowości przechodzi przez cały katalog i grupuje problemy: brak EAN, za krótki opis, brak zdjęcia, niezmapowana kategoria. Jedno kliknięcie zawęża listę do jednego problemu.
Ceny i stany idą za sklepem
Zmiany w katalogu PrestaShop są wykrywane i wysyłane na platformę w ustawionych odstępach czasu - osobno dla cen i osobno dla stanów.
Zamówienia trafiają do PrestaShop
Zamówienia z platformy są importowane jako standardowe zamówienia PrestaShop, a dostawy do paczkomatu i kurierem są przypisane do Twoich przewoźników.
Weryfikacja gotowości
- Reguły, których pilnuje platforma, m.in.: EAN (8, 12, 13 lub 14 cyfr z poprawną cyfrą kontrolną), SKU (referencja), nazwa, co najmniej jedno publicznie dostępne zdjęcie, stawka VAT, jednostka, dni wysyłki, opis o długości co najmniej 100 znaków samego tekstu, cena większa od zera po narzucie, zmapowana kategoria z wymaganymi atrybutami oraz istniejąca karta produktowa InPost dla danego EAN. Telefon producenta GPSR, jeśli jest podany, musi mieć format międzynarodowy.
- Liczniki z filtrami. Kolorowe etykiety, np. „Brak EAN” z liczbą produktów, pokazują, ile produktów ma dany problem; kliknięcie etykiety filtruje listę.
- Poprawki na miejscu. Rozwiń „co uzupełnić” przy produkcie, wpisz brakującą wartość i zapisz. Poprawka dotyczy tylko oferty i nie zmienia katalogu.
- Ostrzeżenia, nie blokady. Zerowy stan, brak wagi lub wymiarów oraz brak EAN przy produkcie z marką i numerem producenta są pokazywane jako ostrzeżenia.
Szablony ofert
- Wzorzec tytułu ze zmiennych: nazwa produktu, referencja, EAN, producent, kategoria domyślna i wartości wariantu (np. „Czerwony, XL”).
- Źródło opisu: opis pełny, krótki albo stały tekst.
- Cena: narzut lub rabat procentowy albo kwotowy, albo cena, jaką w sklepie widzi wybrana grupa klientów (ustawiana w cenach specjalnych PrestaShop).
- Czas wysyłki oraz decyzja, czy synchronizować ceny i stany produktów z danego szablonu.
- Nadpisanie dla produktu. Nazwę, opis i dni wysyłki można ustawić dla pojedynczego produktu - nadpisanie zawsze wygrywa z szablonem.
- Szablon można przypisać do zmapowanej kategorii; pozostałe produkty korzystają z szablonu domyślnego.
- Mapowanie pól oferty. Dla każdego pola wybierasz źródło wartości oraz źródło zapasowe, gdy główne jest puste - także dla danych GPSR (dane producenta i osoby odpowiedzialnej, instrukcje bezpieczeństwa, oznakowanie CE, numer partii) oraz polityk zwrotów i reklamacji.
- Mapowanie kategorii z opcją rekursywną dla podkategorii oraz mapowaniem dodatkowych atrybutów, których wymagają niektóre kategorie Von Halsky. Drzewo pokazuje kolorami kategorie zmapowane, niezmapowane i dziedziczące mapowanie.
- Podgląd karty produktowej InPost. Przy każdym produkcie widać, co katalog platformy zawiera dla jego EAN: markę, kategorię, jednostkę, wymiary i atrybuty - z oznaczeniem, gdy kategoria karty różni się od Twojego mapowania.
- Oferta dla każdego wariantu. Każda kombinacja produktu jest osobną ofertą z własną ceną i stanem.
- Wystawianie pojedyncze lub zbiorcze. „Wystaw” wysyła jeden produkt od razu i pokazuje odpowiedź na ekranie. „Wystaw zaznaczone” przekazuje paczkę do kolejki zadań, której postęp widać na ekranie kolejki.
- Tylko potwierdzone wartości. Kolumny „Cena wysłana” i „Stan wysłany” zmieniają się dopiero po potwierdzeniu przez platformę, więc pokazują to, co faktycznie ma InPost.
- Minimalny stan magazynowy. Gdy stan spadnie poniżej progu, oferta zostaje zamknięta, zamiast wystawiać ilość, której może nie być.
- Zamykanie, ponowne otwieranie i odpinanie każdej oferty z listy ofert.
- Żadna oferta nie wisi bez końca. Oferta, która po minucie nadal czeka na weryfikację platformy, jest odczytywana bezpośrednio z platformy, więc ciche odrzucenie widać w panelu.
- Automatyczny import według harmonogramu oraz przycisk „Importuj teraz”. Zamówienie powstaje w PrestaShop po zaakceptowaniu zamówienia na platformie, a każde zamówienie z platformy odpowiada dokładnie jednemu zamówieniu w sklepie.
- Mapowanie przewoźników osobno dla paczkomatu (APM) i kuriera (COURIER). Zamówienie z formą dostawy bez przypisanego przewoźnika nie jest importowane ze „zgadniętym” przewoźnikiem - dostaje czytelny błąd i baner na liście zamówień.
- Mapowanie statusów w obie strony. Statusy platformy są mapowane na statusy zamówień w sklepie, a akceptacja lub odrzucenie trafia z powrotem na platformę, gdy zamówienie osiągnie wybrany status. Opcjonalnie nowe zamówienia mogą być akceptowane automatycznie.
- Ręczne dopasowanie produktu, gdy pozycji zamówienia nie da się przypisać automatycznie.
- E-mail do sklepu o każdym nowym zamówieniu z platformy. Wiadomości o zamówieniu do kupującego są domyślnie wyłączone, bo adres kupującego w tych zamówieniach jest adresem pośredniczącym InPost.
- Panel platformy na stronie zamówienia w panelu administracyjnym: numer zamówienia na platformie, status i forma dostawy.
1
Połącz
Wpisz organization_id, client_id i client_secret z panelu merchanta InPost i zaloguj się przez InPost. Moduł pokazuje wymagane uprawnienia i adres przekierowania do wpisania po stronie InPostu.
2
Ustaw cron
Gotowe polecenie jest w zakładce „Kolejka zadań”. Ekran kolejki pokazuje, czy cron działa.
3
Zmapuj
Kategorie, szablon oferty, statusy zamówień i formy dostawy.
4
Sprawdź i wystaw
Uruchom weryfikację gotowości, uzupełnij braki i wystaw. Od tej chwili ceny, stany i zamówienia obsługuje kolejka.
| Bez modułu | Z modułem | |
| Wiesz, które produkty platforma odrzuci, zanim je wystawisz | ❌ | ✅ |
| Wystawianie zbiorcze przez kolejkę zadań | Pojedynczo | ✅ |
| Aktualizacja cen i stanów | Ręcznie, jeśli w ogóle | ✅ według harmonogramu |
| Zamknięcie oferty przy niskim stanie | ❌ | ✅ |
| Zamówienia z platformy jako zamówienia PrestaShop, z Twoimi przewoźnikami | Przepisywane ręcznie | ✅ |
| Akceptacja i odrzucenie zamówienia wysyłane na platformę | W osobnym panelu | ✅ |
| Log każdego wywołania API z eksportem do CSV | ❌ | ✅ |
- Ekran „Logi i diagnostyka” z kafelkami stanu połączenia i kolejki, logiem wywołań i błędów API oraz eksportem do CSV na potrzeby zgłoszeń do wsparcia.
- Czytelne błędy API. Gdy platforma odrzuci pole, panel pokazuje które i dlaczego.
- Ostrzeżenia, dopóki mapowanie statusów lub przewoźników jest niekompletne - zanim nie uda się zaimportować pierwszego zamówienia.
- OAuth2 Authorization Code z PKCE - przepływ, którego InPost wymaga od integracji sprzedawców.
- Szyfrowany client_secret i tokeny dostępu w bazie danych.
- Token crona domyślnie przekazywany w nagłówku żądania, więc nie trafia do adresów URL ani logów serwera (dla paneli hostingowych, które przyjmują tylko adres, jest wariant z tokenem w URL).
- Narzędzia RODO. Dane modułu są uwzględniane w eksporcie i usuwaniu danych klienta w PrestaShop, a okresy retencji ograniczają czas przechowywania danych zamówień i logów.
- PrestaShop 8 (testowany na 8.0.3), PHP 7.4 z rozszerzeniem cURL.
- Konto sprzedawcy InPost Von Halsky z danymi dostępowymi aplikacji API.
- Zadanie cron wywołujące moduł co minutę - obsługuje wystawianie, synchronizację i import zamówień.
- Panel modułu w języku polskim.
- Multistore: konfiguracja, oferty i zamówienia są prowadzone osobno dla każdego sklepu.
Czy mogę wystawić produkt, którego nie ma jeszcze w katalogu InPost?
Nie. Platforma nie przyjmuje nowych kart produktowych przez API, więc EAN produktu musi już istnieć w katalogu InPost. Moduł sprawdza to podczas weryfikacji gotowości i oznacza takie produkty jako niegotowe, więc nie dowiesz się o tym dopiero z odrzuconej oferty.
Do jakiej kategorii trafi moja oferta?
Gdy dla EAN istnieje karta produktowa InPost, platforma przypisuje ofertę do kategorii karty. Moduł pokazuje kategorię karty przy produkcie i wyróżnia ją, gdy różni się od Twojego mapowania.
Czy moduł działa bez crona?
Wystawienie pojedynczego produktu i „Importuj teraz” działają po kliknięciu. Wystawianie zbiorcze, synchronizacja cen i stanów oraz cykliczny import zamówień wymagają crona. Ekran kolejki pokazuje, czy cron działa, i ostrzega, gdy przestanie.
Czy mogę sprzedawać zestawy produktów?
Nie. Zestawy (pakiety) są zawsze pomijane, bo platforma ich nie obsługuje.
Czy kupujący dostaną e-maile o zamówieniu z PrestaShop?
Domyślnie nie. Adres e-mail kupującego w zamówieniach z platformy jest adresem pośredniczącym InPost, dlatego moduł blokuje te wiadomości, dopóki ich nie włączysz. Sklep dostaje własne powiadomienie o każdym nowym zamówieniu z platformy.
Czy mogę przetestować połączenie przed startem sprzedaży?
Tak. W konfiguracji wybierasz środowisko InPost: testowe (staging) albo produkcyjne.
### Added
* function 1
* function 2
Wymagania techniczne
Wymagania techniczne
- PHP 7.1 - 8.x
- Rozszerzenie serwera ionCube Loader
Wsparcie = Aktualizacje + HelpDesk
Otrzymujesz 90 dni (3 miesiące) dostępu do kompletnego pakietu wsparcia PrestaShow.
Aktualizacje modułów
Moduły poinformują Cię o dostępnych aktualizacjach. Zapoznaj się z listą zmian (changelog) i wykonaj aktualizację modułu 1-kliknięciem bezpośrednio w Twoim sklepie.
Panel HelpDesk
To panel, w którym dostarczymy Ci pomoc. Na HelpDesk możesz zgłaszać problemy, zamówić darmową instalację i aktualizację modułu oraz zamawiać modyfikacje i indywidualne prace programistyczne.
> > > Wydłuż wsparcie
Po wygaśnięciu wsparcia możesz korzystać z modułu bez żadnych ograniczeń. Dostęp do wsparcia możesz odnowić w dowolnym momencie, gdy będziesz tego potrzebował.
Baza Wiedzy & FAQ
Za darmo na zawsze
Baza wiedzy
Jest dostępna dla wszystkich. Znajdziesz w niej dokumentacje modułów oraz instrukcje, filmy i odpowiedzi na najczęściej zadawane pytania.
Dożywotnia licencja na moduł
- Moduł możesz używać bez ograniczeń w 1 sklepie = 1 domena.
- Możesz używać dodatkowej domeny, np. dla kopi developerskiej.
- Za niewielką opłatą możesz samodzielnie zmienić domenę dla modułu.
Dodatkowe domeny dla Multistore
- Wszystkie nasze moduły obsługują PrestaShop Multistore.
- Obsługa nielimitowanej liczby domen dla PrestaShop Multistore wymaga zakupienia obsługi multistore dla modułu.
Modyfikowanie kodu
- Kod modułu związany z integracją ze sklepem oraz z wyglądem (.tpl, .css, .js) ma otwarty kod źródłowy i możesz go dowolnie modyfikować.
- Kod źródłowy modułu (.php) szyfrowany jest ionCube, a jego modyfikacja wiąże się z utratą gwarancji.
Demo
Demo - przetestuj moduł
- Ten moduł nie posiada sklepu demo
Brak powiązanych wpisów blogowych.











Brak komentarzy.