[PL] Shopify

Owned by Paweł Milewski, created
Last updated: Nov 15, 2024
11 min read

 

Poniżej znajduje się dokumentacja do autorskiego rozwiązania InPost Shopify. Zawiera informację o instalacji oraz konfiguracji pluginu.

Wtyczka dostępna jest na app strore Shopify

 

 

Shopify od 1 stycznia 2023 zmieniło zasady przyznawania dostępu dla Carrier Service API co pozwala naszej aplikacji działać dopiero od planu SHOPIFY

W związku ze zmianami w Shopify musieliśmy wyłączyć “Tryb Zaawansowany” czyli Geowidget w Shopify Plus. Od dnia 04.01 będzie dostępna tylko lista punktów a “Tryb Zaawansowany” zostanie dezaktywowany.

 

 

Wtyczka

17.05.2023

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

 

! Po instalacji wtyczki należy dodać adres webhook w panelu Manager Paczek:

Manager Paczek → Moje Konto → API → Ustawienia Organizacji → Adres Webhook i podajemy:

https://shop-plugin-api.inpost.pl/api/inpost/webhook

 

! Do poprawnego działania aplikacji InPost wymagana jest aktywacja carrier-calculated shipping

Aktywować CCS można poprzez kontakt z supportem Shopify

Po aktywowaniu należy przeinstalować aplikację InPost

 

Changelog - rozwiń

Changelog:

15.11.2024 → Poprawione zostało masowe generowanie etykiet

→ Dodany został format A4 dla usługi InPost Paczkomat 24/7 (generowanie kilku etykiet na jednej stronie)

→ Dodane anulowanie etykiet (po 30 dniach etykieta nie nadana zostaje usunięta z zakładki “Przesyłki”)

→ Dodane zostało stronnicowe w zakładce “Przesyłki”

27.08.2024 → Dodanie usługi COD (pobranie) dla metody dostawy Kurier C2C

→ Dodana edycja danych kupującego (jeśli edytujemy dane w zamówieniu w Shopify - zmienią się też w panelu InPost podczas tworzenia paczki)

→ Udostępnienie możliwości edycji kwoty COD (pobrania) podczas tworzenia przesyłki

31.07.2024 → Dodanie zakładki “wyłączone produkty” , która pozwala wyłączyć metody dostawy InPost w konkretnych produktach

→ Dodanie możliwości wyświetlania punktów Paczkomat/Paczkomat i PaczkoPunk lub sam Paczkopunkt w metodach dostawy InPost Paczkomat

→ Poprawa masowego pobierania etykiet

→ Poprawa filtrowania przesyłek w zakładce “Przesyłki” - zapamiętywanie filtrów

04.06.2024 → Dodanie automatycznego uzupełniania numeru tracking w zamówieniu gdy zostanie zmieniony status zamówienia na “zrealizowany”

18.04.2024 → Dodanie wyświetlania błędów

→ Blokowanie nadmiernej ilości requestów wysyłanych przez sklep

04.01.2024 → Aktualizacja API Shopify w aplikacji

→ Wyłączenie trybu zaawansowanego (geowidget)

→ Zmiana sposobu wyświetlania nazwy usług w koszyku

→ FIX: Etykieta w formacie A6

08.12.2023 → Umieszczenie numeru zamówienia Shopify na etykiecie

31.10.2023 → Dodanie informacji o wymaganym Checkout liquid

→ Zmiana nazwy POP/Paczkomat

25.10.2023 → FIX: Zmieniający się Paczkomat® odbiorczy (po zmianie nadawczego)

05.10.2023 → FIX: Wyszukiwanie Paczkomat po adresie (nie kodzie pocztowym)

 


Na tej stronie:



Autoryzacja

Środowisko produkcyjne (Produkcja)

Środowisko testowe (Sandbox)

 

Instalacja wtyczki

 

Zainstaluj aplikację ze sklepu Shopify App Store

Kroki:

  • Zaloguj się do Shopify App Store

  • Znajdź aplikację Inpost, 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. Pojawia się tam kilka zakładek poniżej informację 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.

 

Autoryzacja (Dane logowania)

 

ID organizacji

Należy uzupełnić z Manager Paczek (zakładka Moje konto - API, format – 5 cyfr)

Autoryzacja (Token API)

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

Autoryzacja (Token Geowidget) Shopify Plus

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.

 

Usługi

 

Tryb

Należy wybrać plan, który Państwo posiadają w sklepie:

W związku ze zmianami w Shopify musieliśmy wyłączyć “Tryb Zaawansowany” czyli Geowidget w Shopify Plus. Od dnia 04.01 będzie dostępna tylko lista punktów a “Tryb Zaawansowany” zostanie dezaktywowany.

 

Standard: nie wyświetla mapy Geowidget, nie ma możliwości wgrania logo 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:

 

 

Metody dostawy

Dostępne metody:

  • InPost Paczkomat® 24/7 - Dostawa przesyłki do punktów odbioru Paczkomat®/PaczkoPunkt

  • InPost Kurier - Dostawa przesyłki na adres podany przez klienta. Usługa dostępna tylko dla klienta biznesowego (umowa)

  • InPost Kurier C2C - Dostawa przesyłki na adres podany przez klienta. Usługa dostępna dla klienta detalicznego - prepaid (stawki zgodnie z cennikiem na stronie InPost.pl

  • InPost Paczka w Weekend - Dostawa przesyłki do punkt odbioru Paczkomat® w weekend dostępnego 24/7

 

Pozwala skonfigurować metody dostawy:

  • nazwa usługi

  • liczba paczkomatów, które wyświetlą się w koszyku (najbliższe od adresu, który podał klient)

  • rodzaje punktów odbioru, które mają pojawiać się w checkoucie

  • koszt dostawy

  • próg darmowej dostawy

  • maksymalną dopuszczalną wagę dla produktów przy których ta usługa dostawy będzie się wyświetlać w koszyku

  • pozycjonowanie usług (poprzez kliknięcie w strzałkę do góry lub w dół)

  • logo (tylko przy Shopify Plus)

! Ważne jest ustawienie wagi dla poszczególnych produktów w sklepie

 

 

 

Poradnik implementacji dostaw znajdziesz pod adresem:
https://inpost.pl/sites/default/files/docs/regulaminy/instrukcja-ekspozycji-dostawy-paczkomat-inpost-247-w-twoim-sklepie-777232.pdf

 

Dodatkowo dla Paczki w Weekend nalezy podać:

  • Dostępność od / do  dnia tygodnia

  • Dostępność od / do godziny

 

Szybkie Zwroty

Umożliwia konfigurację usługi Szybkie Zwroty

  1. W konfiguracji wtyczki należy podać link do formularza Szybkich Zwrotów (np. https://szybkiezwroty.pl/pl/Nazwa_sklepu). Link tworzy się po założeniu konta w tej usłudze poprzez Przedstawiciela Handlowego

  2. 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ą.

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:

  1. Automatyczny - klient w momencie uzupełnienia formularza otrzymuje kod zwrotu, który musi podać będąc przy maszynie

  2. Ręczna akceptacja - klient składa formularz ale to Państwo akceptują bądź nie dany zwrot. Dopiero po akceptacji klient otrzymuje kod zwrotu

 

Domyślna wartość ubezpieczenia

Domyślna kwota, która będzie wyświetlać się podczas tworzenia przesyłek InPost (puste wskazuje 0)

Ustawienia nadania

  • pozwala ustawić domyślny rozmiar paczki, który będzie automatycznie podstawiał się podczas tworzenia paczki

  • domyślny sposób nadania przesyłek paczkomatowych

  • domyślny paczkomat nadawczy dla przesyłek paczkomatowych

  • domyślny punkt POP

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 (nawet jeśli nie będzie używany)

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.

 

 

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.

Jest widok na wszystkie ważne informację - nr przesyłki, nr zamówienia, status, cena, usługa, sposób nadania, nr telefonu, email odbiorcy, czy nadano paczkę i data.

 

Filtrowanie przesyłek

Odbywa się przez wisanie lub wybór danej opcji orza kliknięcie ‘Szukaj przesyłek’

  • Sposób nadania

  • Status

  • Usługa

  • Ilość pokazanych przesyłek na stroniw

  • Nr referencyjny

  • Nr zamówienia

  • Nr telefonu

  • E-mail odbiorcy

 

Lista przesyłek

Na liście przesyłek dostępne są kolumny:

 

Checkbox — służy do wykonywania grupowych akcji jak:

 

  • Zamawianie podjazdu 

  • Drukowanie etykiet

  • Drukowanie etykiet zwrotnych

  • Drukuj zleceń odbioru

 

 

Nr przesyłki:

 

  • Nr przesyłki utworzony: kliknięcie przenosi do śledzenia przesyłki

  • Nr przesyłki nie utworzony: kliknięcie w ‘+’ przenosi do ustawień danego zamówienia

Nr zam:

  • Unikatowy numer zamówienia dla systemu InPost

  • Jest to inny numer zamówienia, niż w danym sklepie Shopify

 

Status — status przesyłki danego zamówienia

Cena — łączna wartość zamówienia

Usługa — wybrana usługa dostawy

Sposób nadania — wybrany sposób nadania

Nr tel. - dane klienta, który złożył dane zamówienia

E-mail odbiorcy — dane klienta, który złożył dane zamówienia

Nadano — data nadania

Utworzono — data utworzenia

Akcje — więcej informacji poniżej:

 

  • Drukuj etykietę

    • Akcja pozwala na wygenerowanie etykiet w 3 formatach PDF, format A6 / EPL / ZPL

    • Akcja jest dostępna po utworzeniu przesyłki

  • Drukuj etykietę zwrotną

    • Akcja dostępna tylko dla usług kurierskich

  • Drukuj zlecenie odbioru

    • Opcja dostępna po zamówieniu podjazdu

  • Zamów podjazd

    • Opcja umożliwia, zamówienie podjazdu dla wprowadzonych miejsc odbioru paczek. Wymagane jest wybranie lub zdefiniowanie miejsca odbioru

    • Opcja jest dostępna po wygenerowaniu numeru przesyłki

 

Przesyłki - tworzenie przesyłek

 

Z poziomu Aplikacji w zakładce Przesyłki

W zakładce przesyłki znajdują się wszystkie zamówienia złożone w sklepie, dla których wybrana została forma dostawy InPost

 

Aby utworzyć przesyłkę należy:

  1. W kolumnie ‘Nr przesyłki ‘ należy kliknąć przycisk ‘+’

 

  • Przycisk jest dostępny dla zamówień, dla których nie wygenerowano numeru przesyłki

 

  1. Admin zostaje przeniesiony do szczegółów danego zamówienia. 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.

 

W panelu obsługi przesyłki admin może:

 

  • Usługa — zweryfikować lub zmienić wybraną formę dostawy

  • Paczkomat odbiorczy klienta — zweryfikować lub zmienić Paczkomat odbiorczy klienta

  • Status przesyłki — podgląd statusu przesyłki

  • Domyślny rozmiar paczki — wybrać rozmiar paczki, która zostanie nadana

  • Wartość ubezpieczenia — zmienić domyślną wartość ubezpieczenia [podaną w zakładce usługi

  • Numer referencyjny

  • Sposób nadania

  • Punkt odbioru — lista punktów odbiorów dostępna dla danego sposobu nadania, punkty są dodawane w zakładce ‘usługi’

  • Numer przesyłki — Numer przesyłki zostanie automatycznie nadany po utworzeniu przesyłki

    1. Po wygenerowaniu numeru przesyłki można przejść bezpośrednio do  śledzenia przesyłki https://inpost.pl/sledzenie-przesylek  

    2. Po wygenerowaniu numeru przesyłki można również pobrać etykiety paczki

 

Z poziomu danego zamówienia

 

Przesyłkę InPost można utworzyć bezpośrednio z poziomu zamówienia, aby to zrobić należy:

  1. Wejść w dane zamówienie

  2. W prawym górnym rogu wybrać opcję ‘ More Actions’ > ‘Utwórz przesyłkę InPost’

  3. Admin zostanie przeniesiony do panelu tworzenia przesyłki w aplikacji Inpost

 

Uzupełnianie numer przesyłki w zamówieniu

Numer trackingowy automatycznie zostanie dodany do zamówienia w Shopify lecz muszą być spełnione dwa warunki:

  1. Utworzenie przesyłki w aplikacji InPost

  2. Na liście zamówień zmiana statusu na ZREALIZOWANE

 

Lista zamówień:

 

 

W zamówieniu pojawi się:

 

 

Zlecenia - podjazd kuriera

Panel do podglądu złożonych zleceń podjazdu

Kolumny: nr przesyłki, data nadania, punkty odbioru, status

 

 

Produkt

W każdym z produktów należy ustawić wagę by w zamówieniu można było wygenerować przesyłkę:

 

 

Pomoc

Miejsce z informacjami o dokumentacji (powyższej) i formularzem kontaktowym w celu dodatkowych pytań

 

 

 

Rozwiązania problemów

Uwaga ! Podano błędny token

Należy zweryfikować czy dane, które podajemy są poprawne. Jeśli tak to:

  1. Proszę usunąć wpisane dane

  2. Odświeżyć stronę

  3. Przestawić Tryb API na Produkcję

  4. Status wtyczki ustawić na Włączona

  5. Zapisać ustawienia

  6. Teraz można dodać token i ID organizacji

  7. Zapisać ustawienia

 

Podawanie numeru telefonu przy wybieraniu punkty odbioru

 

Problem z przekazywaniem numeru telefonu do aplikacji można rozwiązać poprzez umożliwienie podania numeru telefonu w sekcji 'dane adresowe' w kasie sklepu.

 

Aby włączyć opcję, należy w panelu admin sklepu przejść do "Ustawienia" >> "Realizacja zakupu". W sekcji "Informacje dotyczące klienta" należy zaznaczyć opcje dotyczące wymagania podania adresu e-mail lub numeru telefonu przez klientów.

Jeżeli dane o numerze telefonu są podane w koszyku, automatycznie zaczytują się do pola 'numer telefonu' w aplikacji

 

Brak usług w koszyku


Problem się pojawia gdy w ustawieniach sklepu w zakładce “Wysyłka i dostawa” nie są zaznaczone opcje InPost i nie ma odznaczonej opcji “Standard” (musi być ta opcja odznaczona)

 

  1. Należy przejść do zakładki “Wysyłka i dostawa” a następnie w “Niestandardowe stawki wysyłki”

 

  1. Następnie jeśli nie ma konfiguracji dostawy to należy kliknąć “Dodaj stawkę” a następnie wybrać “Użyj przewoźnika lub aplikacji do obliczenia stawek“ i zaznaczyć InPost (Stawki dostarczane z aplikacji)

 

  1. Jeśli już jest konfiguracja należy ją zweryfikować i kliknąć na “Edytuj stawkę”

 

Przesyłka się nie tworzy - “Spróbuj później”

 

Błąd może powodować:

  1. Problemu z walidacją danych takich jak dane nadawcy w zakładce “Usługi” - Każde pole musi być uzupełnione (poprawny email, numer budynku, ulica, miasto)

  2. Brak ustawionej wagi w produkcie (konfiguracja produktu)

  3. Brak dodanego punktu odbioru w zakładce “Usługi”

 

 

 

Kontakt

W przypadku pytań zapraszamy do skorzystania z formularza kontaktowego Działu integracji, który dostępny jest tu: https://inpost.pl/formularz-wsparcie  

 Po wejściu w formularz wystarczy z listy wybrać opcję "Wsparcie Klienta”, w kategorii wybrać: Moduł InPost, a w polu "Proszę podać nazwę modułu” podajemy: Shopify