[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

Dostępna dla: BE - Belgium / ES - Spain / FR - France / IT - Italy / LU - Luxembourg / NL - Netherlands / PT - Portugal / AT - Austria / HU - Hungary

https://apps.shopify.com/inpost-international?locale=pl

CHANGELOG

Autoryzacja

Środowisko produkcyjne / testowe

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:

Open

Włączenie widoczności państw w koszyku

Należy sprawdzić czy w ustawieniach Shopify: Settings → Shipping and Delivery → Shipping są właczone odpowiednie kraje dla aplikacji InPost (Rest of World)

BE - Belgium / ES - Spain / FR - France / IT - Italy / LU - Luxembourg / NL - Netherlands / PT - Portugal

Open

Open

Checkout - lista punktów

Przykładowy wygląd checkoutu (przy utstawieniu Basic - lista punktów) z adresem we Francji:

Open

Checkout - geowidget

We wtyczce jest możliwość udostępnienia punktów odbioru w formie Geowidget

W zależności od planu jaki jest w sklepie można wybrać:

Basic - lista punktów (dla planów Shopify)

Checkout - Geowidget w checkoucie (dla planów Shopify Plus)

Thank You Page - Geowidget w podsumowaniu (dla planów Shopify)

Open

W celu poprawnego działania Geowidget należy podać klucz do Google Maps + Geocoding API, które należy uzyskać z strony:

https://mapsplatform.google.com/ → Rozpocznij → Utwórz konto (jeśli Państwo go nie mają)

Następnie należy przejść do konfiguracji konta. Musisz uzupełnić niezbędne dane, w tym dane teleadresowe czy płatnicze.

Przechodząc dalej pojawi się kolejne okno, w którym wyświetli się wygenerowany unikalny klucz API. Wprowadzając go do skryptu swojej strony internetowej umożliwisz użytkownikom witryny korzystanie z funkcjonalności Google Maps.

Podczas tworzenia włącz poniższe interfejsy:

• Directions API

• Geocoding API

• Geolocation API

Skopiuj klucz i wklej do aplikacji InPost

Następnie należy dodać blok z mapą:

Settings > Checkout > Configurations > Customize:

Open

Na górze wybieramy Checkout/Thank you page (w zależności od trybu):

Open

Zaznaczamy Sections + Add block wybierając blok z aplikacji InPost "Wybór paczkomatu"

Open

Po zapisaniu tokenów, dodaniu bloku i utworzeniu nowego koszyka w Państwa sklepie pojawi się metoda InPost International (na zrzucie przykład Thank You Page):

Open

W podsumowaniu będzie możliwość wyboru punktów z listy i mapy:

Open

Po kliknięciu Mapa:

Open

Po wybraniu punktu należy kliknąć ZAPISZ WYBÓR

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. Open   [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

Open

Podgląd po zalogowaniu do API International

Ustawienia

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

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)   Open
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   Open
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.   Open   Open
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 Open Open Formularz pozwala na wprowadzenie danych, które będą przekazywane razem ze zleceniem odbioru
Domyślna wartość ubezpieczenia	Umożliwia ustawienia kwoty ubezpieczenia jako domyślna - będzie przypisywać się do każdej z przesyłek   Open
Nadawca	Dane nadawcy, które pojawią się na etykiecie i w systemie InPost Open

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.

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

Open

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

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

• wybrać sposób nadania przesyłki → Kurier lub Paczkomat/PaczkoPunkt/HUB

Open

Po weryfikacji danych należy kliknąć Utwórz przesyłkę - zostanie nadany numer przesyłki w polu “Numer przesyłki”

Masowe tworzenie przesyłek

W zakładce Przesyłki → należy zaznaczyć zamówienia, w których nie zostały nadane numeru przesyłek a następnie wejść w dodatkowej opcje (trzy kropki) i wybrać utwórz przesyłki

Open

Pojawi się komunikat (klikamy utwórz przesyłki):

Open

Potwierdzenie utworzenia przesyłek, w którym możemy wydrukować etykiety

Open

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:

Open

Open

2. Wyświetlenie szczegółów zamówienia oraz otwarcie menu z wyborem aplikacji “Utwórz przesyłkę InPost International”:

Open

Pobieranie etykiet

Po utworzeniu przesyłki użytkownik może pobrać etykietę  i przejść do śledzenia przesyłki:

1. Klikamy Pobierz etykietę

Open

2. Wybieramy Drukuj - automatycznie rozpocznie się pobieranie etykiety

Open

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.

Open

Integracja zewnętrzna – poprawne źródło danych o punkcie odbioru

W ostatnim czasie odnotowaliśmy przypadki niewłaściwego wykorzystywania pola service_code do integracji zewnętrznych. Pole to służy wyłącznie do wewnętrznych potrzeb aplikacji, takich jak ustalanie kolejności wyświetlania metod dostawy na checkoutcie i może zawierać dodatkowe informacje techniczne (np. :i_0).

📍 Właściwym miejscem do pobierania informacji o wybranym punkcie odbioru oraz nazwie usługi są atrybuty zamówienia (order attributes).
Dane te są zapisywane i dostępne w zamówieniu w panelu Shopify w sekcji Additional details (zob. przykład poniżej) oraz przez API.

➡️ Przykładowe atrybuty:

• InPost usługa: locker

• InPost Paczkomat: RZE285

Dzięki temu są one niezależne od logiki aplikacji i zawsze zgodne z wybraną opcją klienta.

Kontakt

W przypadku pytań zapraszamy do skorzystania z naszego formularza kontaktowego dostępnego pod linkiem  https://inpost.pl/formularz-wsparcie . Po wejściu w formularz wystarczy wybrać z listy opcję   Wsparcie Klienta, w kategorii wybrać:  Moduł InPost International, a w polu  Proszę podać nazwę modułu  podajemy: Shopify