[PL] Shopify International

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

https://apps.shopify.com/inpost-oficjalna-aplikacja?locale=pl&search_id=d8ba9002-e8bf-4807-8eba-ebfc96402a1c&surface_detail=inpost&surface_inter_position=1&surface_intra_position=8&surface_type=search

CHANGELOG - rozwiń

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 wtyczki

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 wtyczki

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.

[Usuń powiązanie] Istnieje możliwość usunięcia powiązania poprzez wybranie opcji Usuń powiązanie w wyniku której wyświetla się komunikat z prośbą o potwierdzenie usunięcia powiązania konta (konto użytkownika nie jest usuwane a tylko odłączane, pozostałe dane w aplikacji również pozostają nienaruszone).

Typ API

Środowisko, które jest aktualnie włączone

Sandbox - służy do testowania usług InPost. Umożliwia generowanie przesyłek, zlecanie fikcyjnych podjazdów czy pobieranie etykiety bez opłat
Produkcja - wykorzystanie wtyczki do faktycznego tworzenie przesyłek i zlecenia odbioru przez kuriera

Ś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: może zmienić nazwę własną usługi może wybrać liczbę punktów pokazujących się w pobliżu adresu klienta wskazuje dostępy rodzaj punktów odbioru, który wyświetla się w koszyku (Paczkomat/PaczkoPunkt/Paczkomat i Paczkopunk) może zdefiniować koszt dostawy dla usługi może zdefiniować koszt, od którego zaczyna się darmowa dostawa może zdefiniować maksymalną dopuszczalną wagę może wgrać grafikę usługi (lub nadpisać zdefiniowaną), opcja ta możliwa jest wyłącznie w przypadku klientów Plus (wymaga dostępu do checkoutu)
Ustawienia nadania	Domyślne parametry tworzonych przesyłek: możliwe jest zdefiniowanie kilku gabarytów domyślny gabaryt podpowiadany jest jako pierwszy podczas tworzenia przesyłki raz użyty gabaryt nie może zostać zmodyfikowany domyślny gabaryt nie może zostać usunięty, zanim inny nie zostanie ustawiony jako domyślny 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: możliwe jest zdefiniowanie kilku punktów domyślny punkt podpowiadany jest jako pierwszy podczas tworzenia przesyłki raz użyty punkt nie może zostać zmodyfikowany domyślny punkt nie może zostać usunięty, zanim inny nie zostanie ustawiony jako domyślny 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: możliwe jest zdefiniowanie kilku osób kontaktowych domyślny kontakt jest jako pierwszy podczas tworzenia przesyłki raz użyty kontakt nie może zostać zmodyfikowany domyślny kontakt nie może zostać usunięty, zanim inny nie zostanie ustawiony jako domyślny osoba kontaktowa nie jest widoczna na etykiecie nadawczej
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