Paczuszka w Shopify — w przygotowaniu

1. Instalacja i aktualizacja

Paczuszka.pl jest brokerem wysyłkowym. Zapewniamy dostęp do ofert przewoźników; odbiór i doręczenie paczki realizuje wybrana firma kurierska. Nie jesteśmy przewoźnikiem z własną siecią doręczeń.

W ofercie Paczuszki są m.in. InPost, DPD, DHL, GLS, UPS, FedEx i Ambro Express. Dostępne oferty zależą od parametrów paczki i usług przypisanych do Twojego konta Paczuszki.

Aplikacja ma jeden plan Free. Koszty rzeczywistych przesyłek rozliczasz osobno na koncie Paczuszki. Nazwy Basic, Grow, Advanced i Plus w tej instrukcji oznaczają abonamenty Shopify, a nie płatne warianty Paczuszki.

Co przygotować?

• Sklep Shopify i uprawnienie do instalowania oraz konfigurowania aplikacji.
• Własne konto Paczuszki, klucz API tego konta i dane nadawcy.
• Metody dostawy skonfigurowane w Shopify oraz wymiary i wagę gotowej paczki.

Obecna wersja jest przeznaczona dla polskich sklepów: interfejs po polsku, wyceny w PLN i doręczenia w Polsce. Przygotowanie obejmuje jedną paczkę krajową w PLN: zamówienia opłacone oraz pobrania po jawnym przypisaniu metody płatności. Zamówienia do punktów InPost i ORLEN wymagają zapisanego, zgodnego punktu. Wybrane usługi dodatkowe są uwzględnione w cenie przed zatwierdzeniem.

Jak zainstalować aplikację?

Po publicznym udostępnieniu aplikacji instalacja będzie odbywać się z Shopify App Store. W okresie wdrożenia używaj wyłącznie udostępnionego przez nas dostępu do uzgodnionego sklepu. Nie ma pliku ZIP do instalowania w Shopify.

Otwórz Paczuszkę w sekcji aplikacji panelu Shopify. Panel roboczy jest osadzony w Shopify. Oddzielny panel klienta Paczuszki pozostaje dostępny do obsługi konta, rozliczeń i pozostałych usług.

2. Połączenie z własnym kontem

Połącz konto

1. Otwórz Paczuszka → Ustawienia.
2. Wpisz klucz API swojego konta Paczuszki. To token integracji, a nie hasło do panelu.
3. Zapisz ustawienia i sprawdź połączenie. Sam zapis klucza nie potwierdza poprawnego połączenia.

Jeśli nie widzisz tokenu w panelu klienta, poproś administratora konta lub obsługę Paczuszki o dostęp. Nie używaj klucza innej firmy. Obecnie konto ma wspólny token — jego odnowienie wymaga aktualizacji wszystkich integracji, które z niego korzystają.

Ustaw nadawcę i paczkę

Wprowadź nazwę nadawcy, adres, kod pocztowy, miejscowość oraz dane kontaktowe wymagane przez usługę. Uzupełnij numer budynku i lokalu, jeśli jest potrzebny. Wagę podawaj dla gotowej paczki wraz z opakowaniem, a wymiary dla jej zewnętrznego obrysu. Zwróć uwagę na jednostki podane przy polach.

Domyślna paczka ułatwia przygotowanie wielu zamówień. W Wysyłkach możesz ustawić wspólne parametry dla zaznaczonych pozycji lub poprawić konkretną paczkę. Nie zakładaj, że masa samego produktu wystarczy do wyceny.

Przypisz metody dostawy

Powiąż dokładne nazwy metod dostawy Shopify z kodami usług dostępnymi na koncie Paczuszki. Nazwa wyświetlana kupującemu nie musi być kodem API usługi. Po zmianie nazwy metody w Shopify popraw także mapowanie w aplikacji.

W tabeli przypisań wpisz dokładną nazwę metody dostawy Shopify i wybierz usługę Paczuszki z listy. Kliknij „Dodaj metodę dostawy”, aby dodać kolejny wiersz. Po połączeniu z kontem zobaczysz dostępne dla niego usługi. Cenę dla kupującego nadal ustalasz w Shopify.

Ceny dostawy dla kupujących ustawiasz osobno w Shopify. Mapowanie nie dodaje automatycznie metody ani stawki do checkoutu. Metoda dostawy do punktu musi odpowiadać właściwej sieci punktów. Backend ponownie weryfikuje zapisany identyfikator, sieć i obsługę pobrania przed wyceną; nie zamienia dostawy do punktu na doręczenie pod adres.

Pobranie i dodatki

W Ustawieniach przypisz dokładne nazwy bramek płatności za pobraniem. Nazwa dostawy nie służy do rozpoznawania pobrania. Kwota pochodzi z pozostałej do zapłaty kwoty Shopify w PLN. Ubezpieczenie InPost dla pobrania jest dodawane automatycznie. Inne dostępne opcje wybierzesz przy paczce, a ich koszt zobaczysz w wycenie.

3. Przygotowanie i wybór oferty

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

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

Pierwsze pięć kroków opisuje obecne przygotowanie. Zatwierdzenie nadania i etykiety zostaną udostępnione po wdrożeniu oraz testach części realizacyjnej.

1. Zaznacz zamówienia w Wysyłkach. Sprawdź liczbę zaznaczonych i zakres listy. Domyślny filtr pokazuje opłacone zamówienia. Aby przygotować pobranie, wybierz filtr wszystkich płatności i wcześniej przypisz dokładną nazwę bramki pobraniowej w Ustawieniach. Pozostała kwota musi być dodatnia i w PLN.
2. Ustaw paczki. W sekcji Masowa zmiana parametrów wpisz wagę i wymiary lub wybierz szablon, następnie kliknij „Zastosuj do zaznaczonych”. Nowy szablon zapiszesz po podaniu nazwy. Paczkę i odbiorcę możesz edytować w wierszu zamówienia. Skontroluj adresy, numery budynków i metodę dostawy.
3. Kliknij „Wyceń i porównaj zaznaczone” w Wysyłkach. Ceny pochodzą z oferty przypisanej do Twojego konta Paczuszki. Wycena nie tworzy zlecenia i nie obciąża konta.
4. Porównaj i wybierz oferty. Oferty, paczka i wynik są widoczne przy zamówieniu w tej samej tabeli. Poprawne oferty są ułożone od najtańszej; najtańsza zgodna oferta jest wybrana domyślnie. Po zmianie przewoźnika kliknij „Zapisz wybór oferty”. Niezapisana zmiana danych lub wyboru jest wyłączana z sumy kosztów.
5. Sprawdź łączny koszt. Zobacz cenę brutto każdej paczki, wybrane usługi, liczbę gotowych pozycji i sumę w PLN. Błędy poszczególnych pozycji wymagają poprawy.

Ważność wyceny

Wycena jest ważna najwyżej 15 minut. Zmiana paczki, adresów, nadawcy, mapowania, katalogu usług lub klucza wymaga ponownego sprawdzenia kosztów. Ponowne sprawdzenie połączenia pobiera aktualny katalog i unieważnia wcześniejsze wyceny. Brak ceny albo błąd API nie oznacza przesyłki za 0 zł.

Domyślny wybór najtańszej oferty nie jest zgodą na nadanie. W docelowym procesie koszt będzie zatwierdzany osobno, po sprawdzeniu podsumowania. Zmiana lub wzrost ceny będzie wymagać ponownej akceptacji.

Koszt sklepu i cena dostawy klienta

Porównanie pokazuje ceny dla Twojego konta Paczuszki. Nie zmienia ceny dostawy zapłaconej przez kupującego ani wartości zamówienia w Shopify.

Powiększ zrzut panelu ↗

4. Saldo, limit i płatny zapis

Przesyłki rozliczasz na swoim koncie Paczuszki, według przypisanej Ci oferty. Przy przedpłacie zadbaj o środki na koncie; przy rozliczeniu kredytowym — o dostępny przyznany limit. Opłacenie zamówienia w sklepie nie jest opłaceniem wysyłki w Paczuszce.

Przy przedpłacie utworzenie zlecenia obciąża saldo już przed pobraniem etykiety. Dlatego najpierw sprawdź łączny koszt i zatwierdź go. Saldo oraz historię rozliczeń sprawdzisz w panelu Paczuszki.

5. Etykiety i ponowny druk

Po utworzeniu zlecenia otwórz Etykiety, sprawdź wynik i pobierz dokument do wydruku. Pierwsze wygenerowanie etykiety może przekazać przesyłkę do przewoźnika. Ponowny druk korzysta z zapisanej kopii i nie tworzy drugiej przesyłki.

W tym samym miejscu sprawdzisz numer śledzenia i ostatni potwierdzony status przesyłki. W razie potrzeby odśwież statusy. Samo utworzenie zlecenia nie oznacza, że paczka została już doręczona. Anulowanie i ewentualny zwrot sprawdzaj w panelu Paczuszki.

W uzgodnionej instalacji testowej możesz przygotować zamówienia i sprawdzić koszt. Płatne nadawanie wymaga uruchomienia dla danego sklepu.

6. Punkty odbioru i pobrania

Aplikacja rozpoznaje abonament sklepu z Shopify. Nie wybierasz płatnej wersji Paczuszki ani nie instalujesz osobnej aplikacji dla Plus. Miejsce wyboru punktu zależy od możliwości Shopify.

Mapa i lista punktów są dostępne w koszyku. W Shopify Plus skonfiguruj właściwy blok w edytorze checkoutu. Sam abonament Plus nie włącza go automatycznie.

Konfiguracja koszyka

1. W panelu Shopify otwórz edycję motywu sklepu internetowego i wybierz szablon koszyka.
2. Dodaj blok aplikacji Punkt odbioru Paczuszka.
3. Skonfiguruj metody dostawy do odpowiednich sieci, np. Paczkomatów InPost lub punktów ORLEN. Zapisz motyw.
4. Sprawdź zwykły koszyk, koszyk boczny, wersję mobilną oraz ścieżki szybkiego zakupu.

Konfiguracja Shopify Plus

Po udostępnieniu rozszerzenia otwórz edytor checkoutu, dodaj Punkt odbioru Paczuszka w kroku dostawy i zapisz. Jeśli ustawienia bloku wymagają adresu HTTPS aplikacji, użyj adresu wskazanego podczas instalacji — nie adresu sklepu ani panelu klienta. Rozszerzenie wymaga również uruchomionego dostępu sieciowego aplikacji po stronie Shopify.

Sieć punktu musi odpowiadać wybranej metodzie dostawy. Po zmianie sieci wybierz nowy punkt. Przy kilku grupach dostawy sprawdź, czy wybór jest przypisany do właściwej przesyłki.

Mapa i lista punktów InPost oraz ORLEN

1. W koszyku wybierz sieć InPost albo ORLEN Paczka, wpisz miejscowość i kliknij Szukaj punktów.
2. Przełączaj Mapa / Lista punktów. Oba widoki pokazują tę samą stronę wyników, wyłącznie z wybranej sieci. Przycisk następnej strony pobiera kolejne punkty; mapa nie pokazuje wszystkich punktów w Polsce naraz.
3. Kliknij znacznik na mapie albo punkt na liście. Komunikat „Wybrany:” z nazwą lub kodem i adresem pojawia się nad mapą oraz listą, pod przełącznikiem widoku. Przełączenie Mapa / Lista zachowuje wybór.
4. Kliknij Potwierdź wybrany punkt. Dopiero ta akcja zapisuje punkt w koszyku. Samo kliknięcie znacznika nie zapisuje wyboru i nie tworzy zamówienia.
5. W checkoutcie wybierz dostawę do tej samej sieci. Zmiana sieci wymaga wyszukania i potwierdzenia nowego punktu.

Mapa w koszyku korzysta z Leaflet i OpenStreetMap; nie wymaga klucza Google Maps. Przy braku mapy lub współrzędnych wybierz punkt z listy. Punkty bez współrzędnych pozostają dostępne na liście.

Mapa w checkoutcie Plus

Opublikowane rozszerzenie używa natywnego komponentu mapy Shopify; działanie trzeba sprawdzić po konfiguracji w checkoutcie sklepu. W ustawieniach bloku podaj Klucz Google Maps do mapy punktów: klucz Maps JavaScript API ograniczony do domen, na których działa checkout. To osobny klucz, nie token Paczuszki. Wymaga konfiguracji usługi Google Maps i jej rozliczeń według zasad Google. Bez niego nadal można wybierać punkty z listy.

Sieć w Plus wynika z przypisanej metody dostawy. Punkt z mapy lub listy trzeba osobno potwierdzić; zapis trafia do atrybutów checkoutu. Jeżeli mapa się nie wczyta, przełącz na listę.

Kup teraz, Shop Pay i koszyk boczny

Te ścieżki mogą ominąć blok zwykłego koszyka. Dlatego nie uruchamiaj dostaw do punktów bez sprawdzenia każdej dostępnej ścieżki zakupu. Jeżeli dana ścieżka nie pozwala zapisać punktu, kieruj klienta przez koszyk i zwykły checkout.

Obecny selektor nie blokuje checkoutu przy braku punktu. Brakujący lub niewłaściwy punkt wymaga uzupełnienia danych przed nadaniem. Nie zamieniaj dostawy do punktu na doręczenie pod adres bez decyzji klienta. Nadania punktowe z aplikacji są obecnie wyłączone.

Przesyłki za pobraniem. W Ustawieniach podaj polski rachunek bankowy do zwrotu pobrań. Dla InPost z pobraniem ubezpieczenie jest dodawane automatycznie na kwotę pobrania lub wyższą wskazaną wartość. Koszt zobaczysz w wycenie przed zatwierdzeniem.

7. Funkcje Shopify i automatyzacje Flow

Paczuszka na karcie produktu

1. Otwórz edytor motywu i wybierz szablon produktu.
2. Dodaj blok aplikacji Dostawa z Paczuszką w sekcji obsługującej bloki aplikacji.
3. Ustaw opis i opcjonalny odnośnik do zasad dostawy Twojego sklepu. Zapisz zmiany.
4. Sprawdź widok na telefonie i każdy szablon produktu, w którym blok ma się pojawiać.

Blok jest informacją o dostawie. Nie pokazuje salda konta ani cen hurtowych i nie wybiera punktu odbioru. Jeśli nie widzisz bloku, sprawdź dostępność rozszerzenia w zainstalowanej wersji oraz obsługę bloków aplikacji w motywie.

Shopify Flow — automatyzacje wysyłek

Shopify Flow łączy zdarzenie → warunek → działanie. Może uporządkować kolejkę pakowania, wyróżnić problemy z dostawą i uruchomić działania po doręczeniu. Poniżej znajdziesz opisy, ilustracje oraz materiały do pobrania w tym samym układzie co w pomocy aplikacji.

Shopify Flow jest bezpłatną aplikacją dostępną w abonamentach Basic, Grow, Advanced i Plus. Akcja Send HTTP request wymaga Grow, Advanced albo Plus. Nie jest potrzebna do prostego oznaczania opłaconych zamówień tagiem. Dostępność Flow — pomoc Shopify ↗

Szkic .flow — import niezweryfikowany

Oznacz opłacone zamówienia

Ułatwia filtrowanie zamówień do pakowania za pomocą tagu PZ_DO_PRZYGOTOWANIA.

Konfiguracja: Plik bazowy ma wyzwalacz Order paid i akcję Add order tags. Przed włączeniem dodaj warunek metod dostawy obsługiwanych przez Paczuszkę. Bez tego warunku oznaczy wszystkie opłacone zamówienia. Tag nie przygotowuje paczki i nie tworzy przesyłki.

Szkic wymaga sprawdzenia importu w środowisku testowym. Nie włączaj go bez przeglądu warunków.

Pobierz szkic .flow

Wymaga synchronizacji statusów

Oznacz paczki w drodze

Tag PZ_W_DRODZE ułatwi odszukanie przesyłek będących w transporcie.

Konfiguracja: Warunek musi opierać się na potwierdzonym zdarzeniu IN_TRANSIT. Samo utworzenie etykiety nie oznacza odbioru paczki przez przewoźnika.

Projekt do późniejszej konfiguracji. Plik JSON opisuje automatyzację; nie jest szablonem importowanym do Shopify Flow.

Pobierz opis automatyzacji (.json)

Wymaga synchronizacji statusów

Wyłap problemy z doręczeniem

Tag PZ_SPRAWDZ_DOSTAWE wyróżni zamówienia wymagające reakcji obsługi.

Konfiguracja: Po potwierdzonej nieudanej próbie doręczenia można dodać wewnętrzny e-mail do pracownika. Ustaw własnego odbiorcę; nie wysyłaj klientowi wiadomości na podstawie ogólnego błędu zlecenia.

Projekt do późniejszej konfiguracji. Plik JSON opisuje automatyzację; nie jest szablonem importowanym do Shopify Flow.

Pobierz opis automatyzacji (.json)

Wymaga synchronizacji i dostawcy wiadomości

Przypomnij o odbiorze paczki

Wiadomość może pomóc klientowi odebrać paczkę czekającą w punkcie.

Konfiguracja: Potrzebny jest potwierdzony status READY_FOR_PICKUP oraz podłączona aplikacja e-mail lub SMS sklepu. Ustaw treść i link śledzenia. Sprawdź, czy przewoźnik nie wysyła już takiego powiadomienia. Samo zdarzenie Paczuszki nie wysyła wiadomości.

Projekt do późniejszej konfiguracji. Plik JSON opisuje automatyzację; nie jest szablonem importowanym do Shopify Flow.

Pobierz opis automatyzacji (.json)

Wymaga synchronizacji statusów

Oznacz doręczone przesyłki

Tag PZ_DORECZONA ułatwi obsługę po zakupie; można połączyć ten moment z aplikacją opinii sklepu.

Konfiguracja: Warunek musi opierać się na potwierdzonym DELIVERED. Status CLOSED zlecenia nie jest dowodem doręczenia. Przy kilku paczkach odróżnij doręczenie jednej przesyłki od doręczenia całego zamówienia.

Projekt do późniejszej konfiguracji. Plik JSON opisuje automatyzację; nie jest szablonem importowanym do Shopify Flow.

Pobierz opis automatyzacji (.json)

Jak zacząć w Shopify Flow?

1. Otwórz aplikację Shopify Flow w panelu swojego sklepu. Jeśli jej nie masz, zainstaluj Shopify Flow.
2. Wybierz przykład i sprawdź wymagania na jego karcie. Opis JSON służy do ręcznej konfiguracji po uruchomieniu integracji statusów.
3. Dla szkicu .flow użyj importu workflow, o ile plik zostanie poprawnie rozpoznany przez Shopify. Import nie został jeszcze zweryfikowany; przy błędzie zbuduj wariant ręcznie według instrukcji poniżej.
4. Sprawdź zdarzenie, warunki, tagi, odbiorców i wymagane aplikacje. Pozostaw workflow wyłączony do weryfikacji na uzgodnionym środowisku testowym.
5. Po uruchomieniu kontroluj historię przebiegów w Flow. Komunikat o błędzie wymaga sprawdzenia konkretnego kroku, nie ponowienia całego nadania.

Wariant ręczny: opłacone zamówienia do pakowania

1. Utwórz workflow z wyzwalaczem Order paid (zamówienie opłacone).
2. Dodaj warunek sprawdzający, czy metoda dostawy zamówienia należy do metod, które obsługujesz z Paczuszką. Użyj nazw faktycznie zapisanych w Twoich zamówieniach.
3. Na ścieżce spełnionego warunku dodaj akcję Add order tags z tagiem PZ_DO_PRZYGOTOWANIA.
4. Zapisz i sprawdź warunki przed włączeniem. W liście zamówień Shopify możesz filtrować po tym tagu. Nie jest to automatyczne przygotowanie paczki w Paczuszce.

Wiadomości, opinie i inne aplikacje

Paczuszka ma dostarczać zdarzenie związane z przesyłką. Wysyłka wiadomości e-mail lub SMS oraz prośba o opinię wymagają wybranej aplikacji sklepu, jej konfiguracji i odpowiednich uprawnień. Nie zakładaj, że sam wyzwalacz Paczuszki wysyła klientowi wiadomość.

Po uruchomieniu synchronizacji buduj warunki dla konkretnej przesyłki i nowego zdarzenia. Identyfikator zdarzenia powinien chronić przed powtórzeniem działań. Sprawdź powiadomienia przewoźnika oraz Shopify, żeby nie dublować wiadomości. Automatyzacja nie zastępuje osobnej akceptacji kosztu nadania.

Zarządzanie workflow i import — pomoc Shopify ↗ · Wymagania akcji HTTP ↗

8. Błędy i niepewny wynik