Dokumentacja PrestaShop Paczkomaty InPost

Kompleksowa dokumentacja dla modułu umożliwiającego integrację PrestaShop z systemem InPost Paczkomaty (cc_ps_paczkomaty).

Spis treści

Wprowadzenie
Instalacja
Aktywacja licencji
Konfiguracja API InPost
Ustawienia nadawcy
Konfiguracja metod dostaw
Zarządzanie przesyłkami
Automatyzacja CRON
Panel administracyjny
Rozwiązywanie problemów
FAQ

1. Wprowadzenie

CC PS InPost Paczkomaty to profesjonalny moduł dla PrestaShop umożliwiający pełną integrację sklepu internetowego z systemem InPost Paczkomaty. Pozwala na automatyczne zarządzanie przesyłkami, wybór paczkomatów przez klientów oraz kompleksową obsługę procesu dostawy.

Moduł zapewnia pełną kontrolę nad:

Wyborem paczkomatu przez klienta podczas składania zamówienia
Automatycznym tworzeniem przesyłek w systemie InPost
Generowaniem i pobieraniem etykiet przesyłkowych
Śledzeniem statusów przesyłek i automatyczną aktualizacją statusów zamówień
Obsługą różnych typów dostaw (standardowe, COD, weekend)
Zarządzaniem przewoźnikami InPost w systemie

2. Instalacja

Wymagania systemowe

PrestaShop 1.7.0 – 9.99.99
PHP 7.0 lub nowszy
Obsługa cURL
Dostęp do bazy danych MySQL

Proces instalacji

Pobierz plik ZIP modułu z oficjalnego sklepu cocos.codes
Zaloguj się do panelu administracyjnego PrestaShop
Przejdź do: Moduły > Manager modułów
Kliknij „Wyślij moduł” i wybierz pobrany plik ZIP
Po zakończeniu instalacji kliknij „Konfiguruj”

Info

Podczas instalacji moduł automatycznie tworzy niezbędne tabele w bazie danych oraz przewoźników InPost w systemie.

3. Aktywacja licencji

Przed rozpoczęciem korzystania z modułu konieczna jest aktywacja licencji:

Po instalacji przejdź do konfiguracji modułu
Wybierz zakładkę „Licencja”
Wprowadź klucz licencyjny otrzymany po zakupie
Kliknij „Aktywuj licencję”
Po pomyślnej aktywacji zobaczysz komunikat potwierdzający

Ostrzeżenie

Bez aktywnej licencji moduł będzie działał w trybie ograniczonym, wyświetlając ostrzeżenia w panelu administracyjnym.

4. Konfiguracja API InPost

Pierwszym krokiem po aktywacji licencji jest konfiguracja połączenia z API InPost:

Dane dostępowe API

ID Organizacji – identyfikator organizacji w systemie InPost
Token API – token autoryzacji do API InPost ShipX
Token Geowidget – token do wyświetlania mapy paczkomatów

Ustawienia trybu pracy

Tryb testowy (Sandbox) – włącz dla środowiska testowego
Tryb debugowania – szczegółowe komunikaty błędów dla deweloperów

Wskazówka

Dane dostępowe do API InPost możesz uzyskać kontaktując się z przedstawicielem InPost lub przez panel partnerski InPost.

5. Ustawienia nadawcy

Konfiguracja danych nadawcy jest kluczowa dla poprawnego funkcjonowania modułu:

Dane osobowe/firmowe

Firma – nazwa firmy (opcjonalnie)
Imię i nazwisko – dane osoby odpowiedzialnej
E-mail – adres kontaktowy nadawcy
Telefon – numer kontaktowy (9 cyfr bez prefiksu)

Adres nadawcy

Ulica – nazwa ulicy
Nr domu/lokalu – numer budynku
Kod pocztowy – w formacie XX-XXX
Miasto – miejscowość nadawcy

Błąd

Wszystkie pola danych nadawcy są wymagane i muszą być poprawnie wypełnione przed utworzeniem pierwszej przesyłki.

6. Konfiguracja metod dostaw

Moduł automatycznie tworzy cztery typy przewoźników InPost:

Dostępne metody dostaw

InPost Paczkomaty – standardowa dostawa przedpłacona
InPost Paczkomaty COD – dostawa za pobraniem
InPost Paczkomaty Weekend – dostawa w weekend przedpłacona
InPost Paczkomaty Weekend COD – dostawa w weekend za pobraniem

Parametry dla każdej metody

Rozmiar paczki – mała, średnia, duża
Ubezpieczenie – włączone/wyłączone
Automatyczne włączanie – dla dostaw weekend
Harmonogram weekend – dni i godziny aktywacji

Notatka

Dostawy weekend można skonfigurować tak, aby automatycznie aktywowały się w określone dni tygodnia i godziny.

7. Zarządzanie przesyłkami

Moduł zapewnia kompleksowe zarządzanie przesyłkami bezpośrednio z panelu PrestaShop:

Panel szczegółów zamówienia
W szczegółach każdego zamówienia z wybranym paczkomatem znajdziesz:

Informacje o wybranym paczkomacie
Status przesyłki InPost
Numer śledzenia
Dostępne akcje

Dostępne akcje

Utwórz przesyłkę – generowanie nowej przesyłki
Pobierz etykietę – download etykiety PDF/EPL/ZPL
Aktualizuj status – synchronizacja statusu z InPost
Śledź przesyłkę – przekierowanie na stronę śledzenia InPost

Automatyczne statusy zamówień
Możesz skonfigurować automatyczną zmianę statusów zamówień na podstawie statusu przesyłki:

Status po nadaniu – gdy przesyłka zostanie nadana
Status po doręczeniu – gdy przesyłka zostanie dostarczona
Statusy aktualizowalne – które statusy mogą być automatycznie zmieniane

8. Automatyzacja CRON

Moduł oferuje system CRON do automatycznej aktualizacji statusów przesyłek:

Konfiguracja CRON

Przejdź do konfiguracji modułu
Znajdź sekcję „Konfiguracja zadań CRON”
Wygeneruj klucz zabezpieczający
Skopiuj URL zadania CRON
Dodaj zadanie do harmonogramu serwera

Przykładowa konfiguracja CRON

*/15 * * * * curl -s "https://twojasklep.pl/index.php?fc=module&module=cc_ps_paczkomaty&controller=cron&key=TWOJ_KLUCZ" > /dev/null 2>&1

Funkcje automatycznego zadania

Aktualizacja statusów przesyłek
Zmiana statusów zamówień
Przetwarzanie doręczonych zamówień
Czyszczenie starych danych

Wskazówka

Jeśli nie masz dostępu do CRON na serwerze, możesz użyć zewnętrznych usług jak cron-job.org lub uruchamiać zadanie ręcznie z panelu administracyjnego.

9. Panel administracyjny

Moduł dodaje dedykowany panel administracyjny do zarządzania przesyłkami:

Lista przesyłek
Dostęp przez: Zamówienia > CC InPost Paczkomaty

Przegląd wszystkich przesyłek InPost
Filtrowanie według statusu, daty, klienta
Masowe akcje na przesyłkach
Pobieranie etykiet
Śledzenie przesyłek

Szczegóły przesyłki
Każda przesyłka zawiera:

Informacje o zamówieniu i kliencie
Dane wybranego paczkomatu
Status i historię przesyłki
Szczegółowe dane z API InPost

Dostępne akcje masowe

Aktualizacja statusów wybranych przesyłek
Tworzenie brakujących przesyłek
Pobieranie etykiet w paczce

10. Rozwiązywanie problemów

Przesyłka nie tworzy się automatycznie

Sprawdź, czy klient wybrał paczkomat podczas zamówienia
Zweryfikuj konfigurację danych nadawcy
Sprawdź poprawność tokenów API InPost
Upewnij się, że funkcja automatycznego tworzenia jest włączona

Błędy walidacji API

Sprawdź format numeru telefonu (9 cyfr bez prefiksu)
Zweryfikuj kod pocztowy (format XX-XXX)
Upewnij się, że wszystkie wymagane pola są wypełnione
Sprawdź poprawność ID organizacji InPost

Geowidget nie wyświetla się

Sprawdź token Geowidget w konfiguracji
Zweryfikuj pozycję wyświetlania w ustawieniach
Sprawdź, czy klient wybrał przewoźnika InPost
Wyczyść cache przeglądarki i sprawdź konsolę błędów

Etykiety nie pobierają się

Sprawdź status przesyłki (musi być „confirmed” lub wyższy)
Zweryfikuj ustawienia formatu etykiet
Upewnij się, że przesyłka istnieje w systemie InPost
Sprawdź uprawnienia do zapisu plików na serwerze

Błąd

Jeśli występują błędy komunikacji z API InPost, upewnij się, że parametry API są aktualne i że serwer ma dostęp do internetu przez HTTPS.

11. FAQ

Czy moduł działa ze wszystkimi wersjami PrestaShop?
Moduł jest kompatybilny z PrestaShop w wersjach od 1.7.0 do 9.x.x. Nie działa z PrestaShop 1.6 i starszymi wersjami.

Ile kosztuje integracja z API InPost?
Koszty zależą od umowy z InPost. Moduł wykorzystuje oficjalne API InPost ShipX, które może wymagać opłat zgodnie z cennikiem InPost.

Czy mogę używać modułu dla wielu sklepów?
Tak, każda licencja pozwala na użycie modułu na jednej instalacji PrestaShop. Dla wielu sklepów potrzebujesz osobnych licencji.

Czy moduł automatycznie aktualizuje statusy zamówień?
Tak, po skonfigurowaniu zadania CRON moduł automatycznie sprawdza statusy przesyłek i aktualizuje statusy zamówień zgodnie z ustawieniami.

Co się dzieje gdy produkt jest niedostępny?
Moduł nie blokuje tworzenia przesyłek dla niedostępnych produktów. Zarządzanie dostępnością produktów leży po stronie administratora sklepu.

Czy obsługiwane są wszystkie rozmiary paczek InPost?
Moduł obsługuje trzy podstawowe rozmiary: małą (8x38x64 cm), średnią (19x38x64 cm) i dużą (41x38x64 cm).

Czy mogę dostosować wygląd geowidget?
Geowidget używa standardowego stylu InPost. Możesz dostosować jego pozycję na stronie, ale nie jego wygląd wewnętrzny.

Czy moduł generuje faktury dla przesyłek?
Nie, moduł nie generuje faktur. Rozliczenia z InPost odbywają się zgodnie z umową zawartą bezpośrednio z InPost.

Czy możliwe jest tworzenie przesyłek hurtowych?
Moduł tworzy pojedyncze przesyłki dla każdego zamówienia. Nie obsługuje przesyłek hurtowych lub grupowych.

Sukces

W przypadku problemów z modułem lub pytań dotyczących jego działania, odwiedź stronę wsparcia na cocos.codes/wsparcie.

PrestaShop Paczkomaty InPost