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

Wtyczka dostępna jest na app store Shopify

Changelog - rozwiń

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

Autoryzacja (Dane logowania)

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 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 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: Automatyczny - klient w momencie uzupełnienia formularza otrzymuje kod zwrotu, który musi podać będąc przy maszynie 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

Generowanie etykiet

Masowe generowanie etykiet poprzez przyciski akcji

Należy zaznaczyć konkretne przesyłki (które mają już wygenerowane numer trackingowe), wybrać na dole w czarnym oknie trzy kropki, które rozwijają dodatkowe akcje i zaznaczyć Drukuj etykiety - pojawi się okno z wyborem formatu.

Pojedyncze generowanie etykiet

W zakładce przesyłki należy wybrać przycisk Drukuj etykiety gdzie możemy wybrać format etykiety:

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

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

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

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

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

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”

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

3. 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