Paczuszka.pl dla PrestaShop — wersja beta 0.1.0-beta.1

Instalacja
Wykonaj kopię sklepu. W Menedżerze modułów wybierz instalację modułu z ZIP
i wskaż paczuszka.zip. Pakiet zawiera wszystkie potrzebne pliki;
na serwerze klienta nie są potrzebne Composer ani Node.js.
Moduł pojawi się w menu Dostawa jako Paczuszka.pl.

Konfiguracja
W Ustawieniach zapisz własny token API konta Paczuszki i sprawdź połączenie.
Uzupełnij nadawcę, domyślne wymiary i wagę, a następnie połącz metody
dostawy sklepu z usługami Paczuszki. Nazwy i ceny dostawy dla kupujących
pozostają ustawieniami sklepu. Mapowanie używa referencji przewoźnika,
która nie zmienia się po edycji przewoźnika w PrestaShop.
Jeżeli działa multistore, wybierz jeden sklep. Ustawienia, klucze,
wyceny i dokumenty są osobne dla każdego sklepu.

Praca z zamówieniami
Zaznacz zamówienia → ustaw paczki → wyceń → wybierz oferty → sprawdź koszt
→ zatwierdź → pobierz etykiety.
Możesz przygotować i wycenić wiele zamówień. Zaznaczenie wszystkich obejmuje
wyłącznie bieżącą stronę. Najtańsza zgodna oferta jest wybierana domyślnie.
Zmiana danych usuwa aktualność ofert i wymaga nowej wyceny oraz zgody.
Do akceptacji zachowuje przygotowane zamówienia i aktualne oferty;
otwarcie kolejki nie zaznacza zamówień ani nie zatwierdza nadania.
Przy rozdzielaniu ulicy i numeru sprawdź dane odbiorcy w danych paczki.
Niejednoznaczny drugi wiersz adresu wymaga ręcznego sprawdzenia.

Zakres wersji beta
Krajowe przesyłki w PLN, jedna paczka na zlecenie. Szablony paczek,
kalkulator doręczenia pod adres, wyceny konta i ich porównanie,
obsługa błędów NO_OFFER oraz REMAINING_BALANCE_TOO_LOW.
Ubezpieczenie/deklaracja wartości i SMS wymagają potwierdzenia w katalogu
usługi; brak dodatku powoduje błąd zamiast cichego usunięcia opcji.
Podstawowe moduły pobrania są rozpoznawane zawsze; dodatkowe wskaż
w Ustawieniach. Nadawanie COD pozostaje zablokowane.
Punkt odbioru potwierdza operator przy paczce zgodnie z wyborem klienta.
Moduł nie dodaje selektora do checkoutu i nie importuje punktów innych
modułów. Nie zmienia samodzielnie sieci punktów ani sposobu doręczenia.
Nie zamawia odbioru kuriera i nie wysyła automatycznie wiadomości.

Nadawanie i rozliczenia
Nadawaj pojedynczo, po sprawdzeniu aktualnej oferty i osobnej akceptacji
kosztu. Przygotowanie paczki i jej wycena nie oznaczają zgody na nadanie.
Wycena jest ważna maksymalnie 15 minut. Przed utworzeniem ponownie
sprawdzamy cenę i komplet danych. API nie udostępnia potwierdzonej atomowej
gwarancji maksymalnego kosztu; ponowna wycena nie zastępuje tej gwarancji.
Dla przedpłaty utworzenie zlecenia oznacza opłacenie z salda, jeszcze przed
pobraniem etykiety. Nie jest to bezpłatny szkic do dokończenia w panelu.
Realizacja i pierwsza etykieta są osobnym krokiem po utworzeniu zlecenia.
Ponowny druk korzysta z prywatnej kopii PDF w bazie, bez ponownego nadania.
Nie deklarujemy A6, ZPL ani anulowania i zwrotu bez potwierdzenia w panelu.
Przy niejednoznacznym wyniku użyj odświeżenia stanu i sprawdź panel;
blokada kolejnego POST pozostaje. Samo 404 nie potwierdza anulowania.

Aktualizacje i dane
Aktualizację instaluj z nowego ZIP po wykonaniu kopii sklepu.
Nie ma automatycznego aktualizatora. Deinstalacja usuwa tokeny,
ale zachowuje prywatną historię, etykiety i trwałe blokady nadania,
żeby ponowna instalacja nie prowadziła do powielania zleceń.
Token jest szyfrowany kluczem opartym na sekrecie PrestaShop i sklepie;
zmiana sekretu PrestaShop wymaga ponownego wpisania tokenu.

Kontakt: biuro@paczuszka.pl
Operator: Multikapitał Sp. z o.o.
