Versions Compared

Version Old Version 4 New Version 5
Changes made by

Paweł Milewski

Paweł Milewski

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Panel
panelIconIdatlassian-warning
panelIcon:warning:
bgColor#FFBDAD

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

Info

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

Panel
panelIconIdatlassian-info
panelIcon:info:
bgColor#FFFAE6

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ń

Expand
titleChangelog

Changelog:

XX.XX.2025 → Udostępnienie wtyczki w App market Shopify

Autoryzacja

Środowisko produkcyjne / testowe

Info

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:

image-20250113-105211.png

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.

image-20250113-105759.png

  • [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

Panel
panelIconIdatlassian-info
panelIcon:info:
bgColor#FFF0B3

Ś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

image-20250113-110745.png

Usługi

Zakładka umożliwia konfigurację usług wysyłki

Note

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)

image-20250113-111636.png

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

Note

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

Note

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

image-20250113-112656.png

Nadawca

Dane nadawcy, które pojawią się na etykiecie i w systemie InPost