Paczuszka w WooCommerce — wersja beta

1. Instalacja i aktualizacja

1. Pobierz ZIP z Paczuszka.pl. Nie rozpakowuj go przed instalacją.
2. Otwórz WordPress → Wtyczki → Dodaj wtyczkę → Wyślij wtyczkę na serwer, wybierz ZIP i zainstaluj.
3. Przy aktualizacji wybierz zastąpienie istniejącej wtyczki. Jeżeli wtyczka była aktywna, pozostaje aktywna; ustawienia i powiązania zamówień są zachowane.
4. Wejdź do WooCommerce → Paczuszka → Ustawienia. Wymagania: WordPress 6.4+, WooCommerce 8.9+, PHP 7.4+.

Przed aktualizacją wykonaj kopię sklepu. Beta nie ma automatycznego aktualizatora; nowe wydania instaluj z ZIP pobranego z naszej strony.

2. Połączenie z własnym kontem

Wpisz token API swojego konta Paczuszki. Token uzyskasz w panelu po nadaniu odpowiedniego uprawnienia przez administratora. Nie wpisuj hasła do panelu i nie przesyłaj tokenu do pomocy technicznej. Każdy sklep używa własnego konta i cennika.

Potwierdź dane nadawcy, wagę i wymiary paczki. Połącz metody dostawy WooCommerce z usługami dostępnymi na swoim koncie. Nazwy metod i ceny dostawy dla kupujących pozostają ustawieniami sklepu.

3. Przygotowanie i wybór oferty

Zaznacz zamówienia → ustaw paczki → wyceń → wybierz oferty → sprawdź koszt → zatwierdź → pobierz etykiety.

1. W Wysyłkach wybierz zamówienia, ustaw paczki pojedynczo lub wspólnie, a następnie zapisz parametry.
2. Kliknij „Wyceń i porównaj zaznaczone”. Wycena nie tworzy przesyłki. Poprawne oferty są od najtańszej, z najtańszą zgodną opcją zaznaczoną domyślnie.
3. Możesz zmienić ofertę. Sprawdź cenę brutto, dane paczki i zgodność sposobu doręczenia.
4. Do nadania zaznacz jedno zamówienie, zaznacz zgodę na aktualny koszt i zatwierdź utworzenie zlecenia. Automatyczne i zbiorcze nadawanie nie jest dostępne w becie.

Wycena jest ważna najwyżej 15 minut; zmiana danych wymaga nowej wyceny. Przed zapisem ponownie sprawdzamy cenę. Jej wzrost zatrzymuje operację i wymaga ponownej akceptacji. API nie udostępnia jeszcze potwierdzonej atomowej gwarancji maksymalnego kosztu.

Powiększ zrzut panelu ↗

4. Saldo, limit i płatny zapis

Konto prepaid musi mieć środki; konto kredytowe — dostępny przyznany limit. API sprawdza finansowanie. Przy prepaid utworzenie zlecenia jest od razu opłacane z salda, przed pobraniem etykiety. Zapis do późniejszej realizacji w panelu nie jest bezpłatnym szkicem. Odczyt salda w aplikacji ma charakter informacyjny.

5. Etykiety i ponowny druk

W Etykietach świadomie zatwierdź realizację istniejącego zlecenia i pobierz oryginalny PDF. Pierwsze wygenerowanie może przekazać przesyłkę do przewoźnika. Ponowny druk korzysta z prywatnej zapisanej kopii, bez ponownej realizacji. Beta nie deklaruje formatów A6/ZPL ani zbiorczego PDF. Nie zamawia automatycznie odbioru kuriera.

6. Punkty odbioru i pobrania

Punkty InPost i ORLEN wymagają mapowania właściwej metody dostawy oraz zgodnego wyboru punktu w checkoutcie. Nie zastępuj dostawy do punktu kurierem pod adres bez uzgodnienia z kupującym. Usługa wymagająca punktu nadania potrzebuje jego wskazania.

COD — przesyłki za pobraniem — nie jest obecnie udostępnione w zweryfikowanym katalogu API. Nie nadawaj zamówienia pobraniowego jako zwykłego opłaconego, aby ominąć ograniczenie. SMS również nie jest potwierdzony. Deklaracja wartości wymaga obsługi dodatku przez wybraną usługę i aktualny katalog konta.

7. Błędy i niepewny wynik

• Brak środków lub limitu: sprawdź rozliczenia w panelu Paczuszki. Jeśli zapis już rozpoczęto, sprawdź jego wynik przed kolejną próbą.
• Brak oferty: sprawdź adres, wagę, wymiary i wybrane dodatki. Nie traktuj błędu jako ceny 0 zł.
• Przerwane połączenie: sprawdź zlecenie po referencji w panelu. Nie twórz drugiego z inną referencją, żeby ominąć blokadę. Przy niepotwierdzonym wyniku wtyczka wstrzymuje ponowne utworzenie.
• Brak etykiety: sprawdź status zlecenia. Nie ponawiaj realizacji w ciemno. Zgłoś problem z numerem zlecenia, bez tokenu i danych osobowych odbiorcy.
• Anulowanie i zwrot: sprawdź w panelu Paczuszki. Samo 404 nie potwierdza anulowania ani zwrotu środków.

Pełny cykl po ostatnich poprawkach API nie został ponownie zweryfikowany produkcyjnie. Beta obsługuje krajowe paczki w PLN, po jednej paczce na zlecenie; dostępność usług zależy od konta.

8. Pomoc

Napisz na biuro@paczuszka.pl. Podaj wersję wtyczki, WordPressa i WooCommerce, nazwę usługi oraz opis problemu. Nie przesyłaj tokenów, haseł ani pełnych danych odbiorców.

← Paczuszka dla WooCommerce