[PL] Shopify
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
Na tej stronie:
- 1 Wtyczka
- 2 Autoryzacja
- 3 Instalacja wtyczki
- 4 Konfiguracja wtyczki
- 4.1 Autoryzacja (Dane logowania)
- 4.1.1 Autoryzacja (Token API)
- 4.1.2 Autoryzacja (Token Geowidget) Shopify Plus
- 4.1.3 Tryb API
- 4.1.4 Status wtyczki
- 4.2 Usługi
- 4.2.1 Tryb
- 4.2.2 Numer zamówienia na etykiecie
- 4.2.3 Metody dostawy
- 4.2.4 Szybkie Zwroty
- 4.2.5 Domyślna wartość ubezpieczenia
- 4.2.6 Ustawienia nadania
- 4.2.7 Punkt odbioru
- 4.2.8 Nadawca
- 4.3 Przesyłki - zarządzanie
- 4.3.1 Filtrowanie przesyłek
- 4.3.2 Lista przesyłek
- 4.4 Przesyłki - tworzenie przesyłek
- 4.5 Zlecenia - podjazd kuriera
- 4.1 Autoryzacja (Dane logowania)
- 5 Produkt
- 6 Pomoc
- 7 Częste problemy
- 8 Kontakt
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:
Pozwala skonfigurować metody dostawy:
! Ważne jest ustawienie wagi dla poszczególnych produktów w sklepie
Poradnik implementacji dostaw znajdziesz pod adresem:
Dodatkowo dla Paczki w Weekend nalezy podać:
|
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) |
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 (nawet jeśli nie będzie używany) |
Nadawca | Należy określić nadawcę paczek - wszystkie pola muszą być uzupełnione |
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:
W kolumnie ‘Nr przesyłki ‘ należy kliknąć przycisk ‘+’
Przycisk jest dostępny dla zamówień, dla których nie wygenerowano numeru przesyłki
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
Po wygenerowaniu numeru przesyłki można przejść bezpośrednio do śledzenia przesyłki https://inpost.pl/sledzenie-przesylek
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:
Wejść w dane zamówienie
W prawym górnym rogu wybrać opcję ‘ More Actions’ > ‘Utwórz przesyłkę InPost’
Admin zostanie przeniesiony do panelu tworzenia przesyłki w aplikacji Inpost
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ń
Częste problemy
Uwaga ! Podano błędny token
Należy zweryfikować czy dane, które podajemy są poprawne. Jeśli tak to:
Proszę usunąć wpisane dane
Odświeżyć stronę
Przestawić Tryb API na Produkcję
Status wtyczki ustawić na Włączona
Zapisać ustawienia
Teraz można dodać token i ID organizacji
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)
Należy przejść do zakładki “Wysyłka i dostawa” a następnie w “Niestandardowe stawki wysyłki”
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)
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ć:
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)
Brak ustawionej wagi w produkcie (konfiguracja produktu)
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