Skip to end of metadata
Go to start of metadata

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

CHANGELOG

 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:

image-20250113-105211.png


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.

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

Ś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

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

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

image-20250113-112656.png

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 image-20250113-114355.png (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:

  1. Otwarcie widoku zamówień Shopify, na którym widoczne są również szczegóły wysyłki do punktu:

  1. 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:

  1. Klikamy Pobierz etykietę

  1. 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:

image-20250113-131444.png


  • No labels