- Created by Paweł Milewski on Jan 14, 2025
You are viewing an old version of this content. View the current version.
Compare with Current View Version History
Version 1 Next »

Poniżej znajduje się dokumentacja do autorskiego rozwiązania InPost Shopify dla usług InPost International. Zawiera informację o instalacji oraz konfiguracji pluginu.
Wtyczka dostępna jest na app store Shopify
Aplikacja dostępna dla klientów Shopify (wymaganie funkcjonalne do działania aplikacji:
sklep musi posiadać dostęp do Carrier Service API
plan Advanced lub Shopify opłacony rocznie
Wtyczka nie posiada mapy Geowidget → wymaga od użytkownika podania adresu z poprawnym kodem pocztowym na podstawie którego określone zostaną dostępne punkty odbioru
Wtyczka
XX.XX.2025
Marketplace Shopify
Aktualizacja wtyczki następuje automatycznie
CHANGELOG
Changelog:
XX.XX.2025 → Udostępnienie wtyczki w App market Shopify
Autoryzacja
Środowisko produkcyjne / testowe
Przed przystąpieniem do instalacji należy posiadać dane dostępowe do połączenia z API:
Login oraz hasło
Do połączenia z usługami InPost wymagane jest uzyskanie loginu i hasła.
W celu otrzymania danych autoryzacyjnych należy skontaktować się z InPost poprzez formularz:
Udzielenie dostępu do API → API International → Środowisko: Produkcja lub Sandbox (wyłącznie do testów usługi)
https://inpost.pl/formularz-wsparcie
Połączenie z usługami InPost odbywa się poprzez przekierowanie na stronę www. Prosimy o upewnienie się, że mają Państwo w przeglądarce włączone zezwalanie na wyskakujące okienka.
Instalacja
Zainstaluj aplikację ze sklepu Shopify App Store
Kroki:
Zaloguj się do Shopify App Store
Znajdź aplikację InPost International, a następnie kliknij ją
Na stronie oferty aplikacji kliknij Dodaj aplikację
Aby autoryzować korzystanie z aplikacji, kliknij opcję Zainstaluj aplikację w panelu administracyjnym Shopify
Po zainstalowaniu aplikacji możesz ją przeglądać i wykorzystywać na stronie Aplikacje w panelu administracyjnym Shopify.
Więcej informacji:https://help.shopify.com/pl/manual/apps/installing-apps
Po instalacji w panelu sklepu pojawi się aplikacja po lewej stronie:

Konfiguracja - zakładki
W celu konfiguracji wtyczki przechodzimy do aplikacji InPost International. Pojawia się tam kilka zakładek poniżej wyjaśniamy co oznaczają.
(Wprowadzone zmiany należy zapisywać, przez kliknięcie przycisku Zapisz Ustawienia znajdującemu się na dole ekranu)
Autoryzacja (Dane logowania)
Połącz z kontem InPost | Ten przycisk odpowiada za połączenie z API International. Po naciśnięciu następuje przekierowanie do panelu logowania. Tam należy podać login/email i hasło. Po wprowadzeniu poprawnych danych użytkownik jest przekierowywany do aplikacji a przycisk staje się nieaktywny oraz wyświetla informacje o aktualnie zalogowanym koncie. Aplikacja nie wymaga ponownego logowania się, powiązanie z kontem jest trwałe. ![]()
|
Typ API | Środowisko, które jest aktualnie włączone
Środowisko testowe sandbox nie jest wymagane do uruchomienia aplikacji, która może być uruchomiona od razu w trybie produkcyjnym. |
Status wtyczki | Checkbox pozwalający włączyć lub wyłączyć wtyczkę wraz z widocznością na checkoucie strony |

Usługi
Zakładka umożliwia konfigurację usług wysyłki
Pamiętaj o uzupełnieniu wszystkich sekcji w zakładce Usługi aby aplikacja była możliwa do włączenia udostępnienia użytkownikom. Przed opuszczeniem strony zapisz ustawienia.
Wybierz usługi | Użytkownik może aktywować dostępne dla klientów usługi:
![]() |
Ustawienia nadania | Domyślne parametry tworzonych przesyłek:
Należy pamiętać o maksymalnych dostępnych wymiarach obsługiwanych przez usługę + Shopify nie zbiera wymiarów produktów; wyłącznie wagi poszczególnych produktów, które są opcjonalne z poziomu produktu |
Punkt odbioru przez kuriera | W podobny sposób do wymiarów paczek można zdefiniować dostępne punkty odbioru przesyłek, dla których w kolejnym etapie można tworzyć zlecenia podjazdu:
Różne punkty odbioru posiadają różne dostępne godziny, w których może zostać zlecony odbiór przesyłki → sprawdź tutaj: https://inpost.pl/godziny-odbiorow Zadbaj o to aby wprowadzony adres był zrozumiały dla kuriera. |
Osoba kontaktowa | W podobny sposób do wymiarów paczek można zdefiniować osoby kontaktowe powiązane z tworzonymi zleceniami odbioru przesyłek:
|
Domyślna wartość ubezpieczenia | Umożliwia ustawienia kwoty ubezpieczenia jako domyślna - będzie przypisywać się do każdej z przesyłek ![]() |
Nadawca | Dane nadawcy, które pojawią się na etykiecie i w systemie InPost |
Przesyłki - zarządzanie
Miejsce do zarządzania zamówieniami i przesyłkami. Możemy zarządzać nimi masowo lub wchodząc w poszczególne zamówienia.
Uwaga: zamówienie, które korzysta z dostawy InPost pojawi się automatycznie w aplikacji w zakładce Przesyłki
Lista/Filtrowanie
Tabela zawiera następujące kolumny:
checkbox do zaznaczania przesyłek pojedynczo lub wszystkich na liście
numer przesyłki (link do szczegółów/trackingu, odnośnik zewnętrzny, nowa karta)
numer zamówienia, link do szczegółów zamówienia
status przesyłki
cena przesyłki
usługa
cechy przesyłki
sposób nadania
data stworzenia zamówienia
data nadania
dane odbiorcy
numer referencyjny
akcję drukuj dostępną również masowo
Zapoznanie się z kolejnymi zdarzeniami przesyłki możliwe jest po kliknięciu w pozycję “Nr przesyłki”. Użytkownik przekierowywany jest do systemu śledzenia InPost.
Status przesyłki wyświetlany w tabeli dotyczy zlecenia odpowiedzialnego za stworzenie przesyłki.
Użytkownik ma możliwość przefiltrowania tabeli według następujących filtrów
nr przesyłki (pole tekstowe)
status przesyłki (lista wyboru)
data utworzenia zamówienia (datepicker)
data nadania przesyłki (datepicker)
usługa (lista wyboru)
sposób nadania (lista wyboru)
numer telefonu (pole tekstowe)
adres email (pole tekstowe)
numer referencyjny (pole tekstowe)
Tworzenie przesyłek
Poprzez naciśnięcie przycisku (Przycisk jest dostępny dla zamówień, dla których nie wygenerowano numeru przesyłki) możemy przejść do szczegółowego widoku na konkretne zamówienie w aplikacji InPost International
szczegóły zamówienia to specjalny widok wewnątrz aplikacji Shopify, w którym znajduje się pełne podsumowanie zamówienia użytkownika, wliczając w to produkty, całościowy koszt, dane adresowe i billingowe
Szczegóły zamówienia aplikacji InPost nie są jednoznaczne ze szczegółami zamówienia Shopify (inny widok)
Widok szczegółów zamówienia dzieli się na 2 sekcje
Sekcja lewa to dane klienta oraz szczegóły zamówienia
Sekcja prawa służy do generowania przesyłki
Użytkownik może
zdefiniować usługę → domyślnie zaciągana jest usługa wybrana przez klienta na etapie zamówienia
zmienić wybrany przez klienta paczkomat
zmienić wybrany przez klienta adres odbioru
zdefiniować rozmiar przesyłki
zdefiniować wartość ubezpieczenia
Po weryfikacji danych należy kliknąć Utwórz przesyłkę - zostanie nadany numer przesyłki w polu “Numer przesyłki”
Alternatywną ścieżką do utworzenia przesyłki jest:
Otwarcie widoku zamówień Shopify, na którym widoczne są również szczegóły wysyłki do punktu:
Wyświetlenie szczegółów zamówienia oraz otwarcie menu z wyborem aplikacji “Utwórz przesyłkę InPost International”:
Pobieranie etykiet
Po utworzeniu przesyłki użytkownik może pobrać etykietę i przejść do śledzenia przesyłki:
Klikamy Pobierz etykietę
Wybieramy Drukuj - automatycznie rozpocznie się pobieranie etykiety
Wyłączone produkty
Korzystając z tej zakładki istnieje możliwość wyłączenia produktów dla których możliwe jest wybranie dostawy za pomocą InPost International.
Checkout - list punktów
Przykładowy wygląd checkoutu z adresem we Francji:

- No labels