Paczuszka dla PrestaShop — instrukcja
Instalacja modułu, połączenie konta, przygotowanie paczek i obsługa przesyłek w panelu sklepu.
Pobierz moduł beta (ZIP)1. Instalacja i aktualizacja
- Wykonaj kopię sklepu i pobierz paczuszka.zip. Nie rozpakowuj pliku.
- W panelu PrestaShop przejdź do Moduły → Menedżer modułów i wybierz przesłanie modułu z ZIP.
- Wskaż pobrany plik. Po instalacji otwórz Paczuszka.pl w menu Dostawa lub kliknij konfigurację modułu.
- Ten sam ZIP obsługuje PrestaShop 1.7.8.x, 8.x i 9.0–9.2. Wymagane są PHP 7.4+ zgodne z wydaniem PrestaShop oraz rozszerzenia cURL, OpenSSL i mbstring.
Nowe wydania instaluj z ZIP pobranego z naszej strony, przez standardowy mechanizm aktualizacji modułów. Przed aktualizacją wykonaj kopię sklepu. Nie ma automatycznego aktualizatora.
2. Połączenie własnego konta
W Ustawieniach wpisz token API swojego konta Paczuszki, zapisz ustawienia i kliknij Sprawdź połączenie. Token uzyskasz w panelu Paczuszki po nadaniu odpowiedniego uprawnienia przez administratora. Nie wpisuj hasła do panelu, nie udostępniaj tokenu kupującym i nie przesyłaj go w zgłoszeniach.
Puste pole tokenu zachowuje poprzednią wartość. Zapisany token nie jest wyświetlany. W multistore wybierz jeden sklep; ustawienia, klucze, wyceny i dokumenty są oddzielne dla każdego sklepu.
3. Nadawca, paczka i mapowania
Uzupełnij pełne dane nadawcy, oddzielnie ulicę, numer budynku i numer lokalu. Wpisz wagę oraz wszystkie wymiary domyślnej paczki. Połącz metody dostawy PrestaShop z usługami dostępnymi na swoim koncie Paczuszki.
Moduł nie zmienia cen dostawy kupujących. Mapowanie jest przypisane do stałej referencji przewoźnika, więc edycja przewoźnika w PrestaShop nie wymaga ponownego połączenia tylko z powodu zmiany jego identyfikatora.
Wskaż używane dodatkowe moduły płatności pobraniowej. ps_cashondelivery i cashondelivery są rozpoznawane zawsze. W tej becie zamówienia za pobraniem nie mogą być nadawane — nie zmieniaj ich na opłacone, aby ominąć ograniczenie.
4. Przygotowanie zamówień i wycena
Zaznacz zamówienia → ustaw paczki → wyceń → wybierz oferty → sprawdź łączny koszt → zatwierdź → pobierz etykiety.
- Otwórz Wysyłki i wybierz zamówienia. Zaznacz wszystkie obejmuje wyłącznie bieżącą stronę.
- Wpisz wspólne parametry i kliknij Zastosuj do zaznaczonych. Możesz zapisać własny szablon opakowania.
- W danych konkretnej paczki sprawdź odbiorcę, numer budynku i lokalu, wybrane punkty oraz dodatki. Zapisz zmiany przed wyceną. Korekta danych do nadania nie zastępuje adresu w zamówieniu sklepu.
- Kliknij Wyceń i porównaj zaznaczone. Postęp i wynik są pokazywane osobno dla każdego zamówienia.
- Najtańsza zgodna oferta zostanie zaznaczona domyślnie. Możesz wybrać inną. Porównanie zachowuje sposób doręczenia i sieć punktów.
Wycena jest ważna maksymalnie 15 minut. Zmiana danych wymaga nowej wyceny i ponownej zgody. Brak oferty lub błąd nie oznacza ceny 0 zł. Wstępny koszt przy zamówieniu dotyczy zapisanych danych i jednej przypisanej usługi; nie jest porównaniem wszystkich przewoźników ani zgodą na nadanie.
5. Do akceptacji i zatwierdzenie kosztu
Do akceptacji zawiera przygotowane, jeszcze nienadane zamówienia. Zachowuje aktualne oferty i wybór; samo otwarcie kolejki niczego nie zaznacza ani nie zatwierdza.
Przed nadaniem pozostaw zaznaczone jedno zamówienie, sprawdź usługę i koszt brutto, zaznacz osobną zgodę i zatwierdź utworzenie zlecenia. Przed zapisem ponownie sprawdzamy cenę i dane; wzrost ceny zatrzymuje operację i wymaga ponownej akceptacji.
Przy przedpłacie utworzenie zlecenia oznacza opłacenie z salda już przy zapisie, jeszcze przed etykietą. Zapis do późniejszej realizacji nie jest bezpłatnym szkicem. Środki lub dostępny limit sprawdza API; saldo na Tablicy ma charakter informacyjny. Nie wyliczamy dostępnego kredytu z przyznanego limitu i salda.
6. Etykiety, tracking i ponowny druk
Po potwierdzonym utworzeniu zlecenia otwórz Etykiety. Zatwierdzenie realizacji i wygenerowanie pierwszej etykiety może przekazać przesyłkę do przewoźnika. Pobierany jest oryginalny PDF; nie zamawiamy odbioru kuriera.
Ponowny druk odczytuje prywatną kopię dokumentu w bazie sklepu i nie tworzy kolejnej przesyłki. Odśwież stan pobiera informacje o zleceniu i pozwala zapisać numer przewoźnika przy zamówieniu. Istniejący inny numer nie jest zastępowany bez sprawdzenia.
Anulowanie i ewentualny zwrot sprawdzaj w panelu Paczuszki. Samo 404 nie potwierdza anulowania ani zwrotu. Beta nie deklaruje formatu A6, ZPL ani zbiorczego PDF.
7. Punkty odbioru i dodatki
W tej wersji operator wpisuje i potwierdza kod punktu w danych paczki zgodnie z wyborem kupującego. Punkt jest sprawdzany w katalogu właściwej sieci. Dla usługi Paczkomat–Drzwi potrzebny jest również kod Paczkomatu nadania.
Moduł nie dodaje mapy ani selektora punktów do checkoutu i nie odczytuje automatycznie danych zapisanych przez inne moduły. Nie zastępuj dostawy do punktu kurierem pod adres ani nie zmieniaj sieci bez uzgodnienia z kupującym.
Deklaracja wartości i SMS wymagają obsługi przez aktualny katalog wybranej usługi. Niedostępny dodatek powoduje komunikat; zaznaczona opcja nie jest po cichu usuwana.
8. Gdy pojawi się problem
- Brak połączenia: sprawdź token i wynik Sprawdź połączenie w Ustawieniach.
- Brak mapowania lub danych: połącz metodę dostawy z usługą oraz uzupełnij paczkę i adres.
- Brak oferty: sprawdź wagę, wymiary, kod pocztowy, punkty i dodatki.
- Brak środków lub limitu: sprawdź rozliczenia w panelu Paczuszki.
- Niepewny wynik po przerwaniu połączenia: otwórz Etykiety, odśwież stan i sprawdź zlecenie w panelu. Nie twórz drugiego z inną referencją; blokada ponownego nadania pozostaje do wyjaśnienia wyniku.
- Brak dokumentu: sprawdź stan zlecenia. Nie ponawiaj realizacji w ciemno.
W razie potrzeby napisz na biuro@paczuszka.pl. Podaj wersję modułu, PrestaShop i PHP, nazwę usługi oraz opis błędu. Nie wysyłaj tokenów, haseł ani pełnych danych odbiorców.