[PL] Shopify - Autoryzacja/ Usługi / Wyłączone produkty
Konfiguracja wtyczki
Zakładki
W celu konfiguracji wtyczki przechodzimy do aplikacji InPost. 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
Po zapisaniu ustawień, pojawi się wiadomość potwierdzająca.
Ważne! Gdy pojawi się komunikat “Błędny token” należy usunąć wpisane dane.
Odświeżyć stronę
Przestawić Tryb API na Produkcję
Status wtyczki ustawić na Aktywna
Zapisać ustawienia
Teraz można dodać token i ID organizacji
Zapisać ustawienia
Autoryzacja (Dane logowania)
ID organizacji | Należy uzupełnić z Manager Paczek (zakładka Moje konto - API, format – od 1 do 6 cyfr) |
Token API ShipX | Umożliwia konfigurację dostępu do API ShipX (Produkcyjnego i Sandboxowego). Dane jak ID organizacji oraz token można uzyskać z Manager Paczek. Opisaliśmy to w pierwszej części tej dokumentacji Autoryzacja |
Token Geowidget | Umożliwia dodanie Tokenu do Geowidget (do poprawnego działania mapy z punktami InPost należy wygenerować token Geowiedget) |
Tryb API | Sandbox/Produkcja (dane z produkcji nie działają z trybem sandbox) |
Status wtyczki | Deaktywacja wtyczki nie wpłynie na procesowane zamówienia. Nowi klienci nie będą mogli korzystać ze zdefiniowanych w ustawieniach metod dostawy |
Checkout - lista punktów/Geowidget
Lista punktów
Przykładowy wygląd checkoutu (przy ustawieniu Basic - lista punktów):
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 - potrzebny API Key do Google Maps)
W celu poprawnego działania Geowidget należy podać klucz do Google Maps + Geocoding API, które należy uzyskać z strony:
Google Maps Platform - 3D Mapping & Geospatial Analytics → 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:
Na górze wybieramy Checkout/Thank you page (w zależności od trybu):
Zaznaczamy Sections + Add block wybierając blok z aplikacji InPost "Wybór paczkomatu"
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):
W podsumowaniu będzie możliwość wyboru punktów z listy i mapy:
Po kliknięciu Mapa:
Po wybraniu punktu należy kliknąć ZAPISZ WYBÓR
Usługi
Numer zamówienia na etykiecie | Zaznaczając tą funkcję na etykiecie będzie dodawać się numer zamówienia Shopify w numerze referencyjnym:
Etykieta:
|
Zapobiegaj mnożeniu ceny w przypadku dostawy z wielu lokalizacji | Jeśli dostawa jest realizowana z kilku lokalizacji (2 produkty w koszyku są z innych lokalizacji) należy zaznaczyć tą opcję by cena za dostawę się nie dublowała |
Wysyłaj klientowi powiadomienie o utworzeniu przesyłki | Włącza lub wyłącza wysyłkę mailową o utworzeniu przesyłki (dodatkowy komunikat ponieważ powiadomienia są realizowane przez InPost z aplikacji mobilnej/Mail lub SMS |
Metody dostawy | Dostępne metody:
Pozwala skonfigurować metody dostawy:
Ważne jest ustawienie wagi dla poszczególnych produktów w sklepie (bezpośrednio w produkcie)
Poradnik implementacji dostaw znajdziesz pod adresem:
Dodatkowo dla Paczki w Weekend nalezy podać:
→ W tych dniach usługa pokaże się w checkout |
Szybkie Zwroty | Umożliwia konfigurację usługi Szybkie Zwroty
Kod: {% if shop.metafields.inpost_app.settings.value.fast_returns_url and order.metafields.inpost_app.service %}
<a href="{{ shop.metafields.inpost_app.settings.value.fast_returns_url }}">Zwróć</a>
{% endif %}
* Uzupełnij skróconą nazwę swojego konta założonego w serwisie Szybkie Zwroty * Po dodaniu skróconej nazwy zostanie wygenerowany kod. Kod umożliwia wyświetlenie przycisku przycisk 'zwróć' w panelu klienta skepu. Kod należy skopiować i dodać w szablonie sklepu zgodnie z poniższą instrukcją.
1. Zapoznaj się z instrukcją Shopify Edytowanie kodu szablonu · Centrum Pomocy Shopify Z panelu administracyjnego Shopify przejdź do opcji: Sklep online > Szablony. 2. Upewniamy się, że nasz sklep korzysta z klasycznego panelu klienta oraz czy masz dostęp do edycji kodu szablonu.
3. Zweryfikuj, który z poniższych plików możesz edytować w Twoim sklepie
Ścieżka dla templates/customers/order.json 1. Znajdujemy w pliku templates/customers/order.json nazwę sekcji, której używa nasz szablon
2. W powyższym przypadku jest to main-order, a więc ścieżka do pliku sekcji jest następująca: sections/main-order.liquid Edytujemy plik sections/main-order.liquid dodając kod embed z aplikacji pod tabelą ze szczegółami zamówienia.
Ścieżka dla templates/customers/order.liquid Edytujemy plik templates/customers/order.liquid dodając kod embed z aplikacji pod tabelą ze szczegółami zamówienia.
EFEKT:
Zwroty dokonywane poprzez formularz posiadają 2 opcje akceptacji:
|
Domyślna wartość ubezpieczenia | Domyślna kwota, która będzie wyświetlać się podczas tworzenia przesyłek InPost (puste wskazuje 0 zł) |
Ustawienia nadania |
|
Punkt odbioru | Miejsce do zdefiniowania punkt odbioru paczek podczas tworzenia zlecenia podjazdu Można punkty dodawać, usuwać i edytować Musi być zdefiniowany przy konfiguracji wtyczki (jeśli nadanie będzie poprzez Kuriera) |
Nadawca | Należy określić nadawcę paczek - wszystkie pola muszą być uzupełnione |
Wyłączone produkty
Zakładka pozwala włączyć lub wyłączyć widoczność wszystkich usług InPost w danym produkcie.
Zaznaczone checkboxy oznaczają ,że metoda InPost jest włączona w tych produktach
- 1 Konfiguracja wtyczki
- 1.1 Zakładki
- 1.1.1 Autoryzacja (Dane logowania)
- 1.1.1.1 Token API ShipX
- 1.1.1.2 Token Geowidget
- 1.1.1.3 Tryb API
- 1.1.1.4 Status wtyczki
- 1.1.1.5 Checkout - lista punktów/Geowidget
- 1.1.1.5.1 Lista punktów
- 1.1.1.5.2 Geowidget
- 1.1.1 Autoryzacja (Dane logowania)
- 1.2 Usługi
- 1.2.1 Numer zamówienia na etykiecie
- 1.2.2 Metody dostawy
- 1.2.3 Szybkie Zwroty
- 1.2.4 Domyślna wartość ubezpieczenia
- 1.2.5 Ustawienia nadania
- 1.2.6 Punkt odbioru
- 1.2.7 Nadawca
- 1.3 Wyłączone produkty
- 1.4 Konfiguracja Produktów
- 1.1 Zakładki
- 2 Integracja zewnętrzna – poprawne źródło danych o punkcie odbioru
Konfiguracja Produktów
W każdym z produktów należy ustawić wagę by w zamówieniu można było wygenerować przesyłkę:
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: lockerInPost Paczkomat: RZE285
Dzięki temu są one niezależne od logiki aplikacji i zawsze zgodne z wybraną opcją klienta.
Pobieranie danych po API: