Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Poniżej znajduje się dokumentacja do autorskiej wtyczki InPost OpenCart. Zawiera informację o instalacji oraz konfiguracji wtyczki.

Wersja kompatybilna ze wszystkimi wersjami OpenCart 3.0

Panel
panelIconIdatlassian-info
panelIcon:info:
bgColor#FFFAE6

Wtyczka: (najnowsza wersja 15.06.2023r)

https://inpostwww.szybkiplik.pl/sites/default/files/2024-04/ocs.inpostshipping.ocmod__0.zip2y69J5V3sr

Info

W przypadku problemów z instalacją pluginu (brak zapisu jakiś plików) należy doinstalować dodatek:

https://www.opencart.com/index.php?route=marketplace/extension/info&extension_id=33410&filter_search=Ocmod%20installer&filter_license=0

  1. Wymagane jest odświeżenie strony i ponowa instalację modułu




Na tej stronie:

Table of Contents


Autoryzacja

Środowisko produkcyjne

Info

Przed przystąpieniem do instalacji należy posiadać dane dostępowe do połączenia z API:

  • Access Token

  • ID organizacji

Pobierz poradnik wyjaśniający jak szybko we własnym zakresie utworzyć dostęp do API ShipX:

https://inpost.pl/sites/default/files/2022-03/instrukcja-konfiguracji-api-shipx.pdf

https://manager.paczkomaty.pl/ > zakładka Moje konto > API

Info

Środowisko testowe

Generowanie dostępu

https://sandbox-manager.paczkomaty.pl/ > zakładka Moje konto > API

Aby wygenerować Token i ID organizacji należy uzupełnić wszystkie dane, łącznie z danymi do faktury w zakładce Moje konto > Dane. Do utworzenia przesyłki Paczkomat® niezbędne są środki na koncie, konto doładujesz wirtualnie w zakładce Płatności.

Testy:

Na środowisku sandbox nie ma możliwości przetestowania wysyłki przesyłek i zamawiania podjazdu kuriera - te opcje dostępne są tylko na produkcji. Wynika to z możliwości API Sandbox.


Instalacja wtyczki

Zaloguj się do panelu administracyjnego Twojego sklepu na platformie OpenCart

  1. Przejdź do zakładki Rozszerzenia i wybierz Instalator

2. Kliknij Upload i wybierz 2 pliki z wtyczką instalacyjną w formacie .zip. Należy je zainstalować jeden po drugim.

3. Wtyczka po instalacji pojawi się w zakładce poniżej w zestawieniu zainstalowanych wtyczek Rozszerzenia → Rozszerzenia


Konfiguracja wtyczki

Wyszukiwanie modułu w celu dalszej konfiguracji następuje w zakładce Rozszerzenia → Rozszerzenia

W tej zakładce wybierz InPost Shipping → Edytuj

Zakładki

Ogólne– umożliwia konfigurację dostępu do API (Produkcyjnego i Sandboxowego)

GeoWidget- umożliwia dodanie Tokenu do Geowidget (do poprawnego działania mapy z punktami InPost należy wygenerować token Geowiedget)

Panel
panelIconIdatlassian-info
panelIcon:info:
bgColor#FFEBE6

Ważne! Gdy w koszyku w Geowidget pokazuje się błąd “Brak dostępu, sprawdź czy token został wygenerowany dla odpowiedniej witryny” należy ponownie wygenerować token do Geowidget w Manager Paczek ale podając poprawny adres witryny sklepu. Błąd dotyczy podania błędnego adresu url sklepu.

Ustawienia - po dodaniu formy dostawy w Usługi Dostaw umożliwia ustawienie ceny, logo, darmowej dostawy, podatku i maksymalnych wymiarów przesyłek

Dane nadawcy – dane można uzupełnić lub automatycznie pobrać z API

Metody wysyłki – umożliwia konfigurację domyślnych Punktów Odbioru/Paczkomat® i ustawienia domyślnej wartości ubezpieczenia

Usługi dostawy– miejsce do dodania i skonfigurowania usług Paczkomat® i Kurierskich

Paczka w Weekend – pozwala na konfigurację usługi Paczka w Weekend (dni i godziny dostępności usługi)

Punkty Odbioru– umożliwia dodanie/usuwanie/edycję Punktów Odbioru

Zamówienia– znajdują się tu opcje dodatkowe do obsługi zamówień, możemy wybrać status, przy którym w profilu klienta pojawi się przycisk do Szybkich Zwrotów

Szybkie Zwroty – umożliwia konfigurację usługi Szybkie Zwroty (mając utworzone konto w tym serwisie - Przedstawiciel Handlowy)

Autoryzacja

W tym miejscu możesz uzupełnić dane dostępowe do API (Token, ID organizacji), która można wygenerować samemu w Managerze Paczek w zakładce „API”
Dostęp do środowisk znajduje się na początku tej dokumentacji

Możliwe jest użycie tylko trybu Sandbox po przełączeniu switch’a i uzupełnieniu danych sandboxowych

Geowidget

Do poprawnego działania mapy z punktami InPost w koszyku należy dodać token Geowidget do konfiguracji Produkcyjnej lub Sandboxowej

Token należy wygenerować w Manager Paczek w zakładce Moje kontoAPI Geowidet(podając domenę sklepu)

Usługi dostaw - konfiguracja metody dostawy w koszyku

W tym miejscu możesz skonfigurować metody dostaw, jakie pojawią się w Twoim sklepie
Kliknij Dodaj usługę -> uzupełnij usługę, która jest importowana z API, domyślną metodę nadania, określ domyślne wymiary przesyłki lub gabaryt ( w zależności od użytego serwisu), następnie nadaj poprawną nazwę usługi zgodnie z wytycznymi zawartymi w „Poradniku skutecznej implementacji dostaw InPost w koszyku e-commerce” i kliknij Save

 

Info

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

Po dodaniu usługi masz możliwość dalszej konfiguracji metody dostawy. Można to zrobić od razu po kliknięciu Save - pojawi się okno do konfiguracji logo, cen, wagi lub po przejściu do zakładki Ustawienia

Ceny ustawiamy w Miejsca i koszty wysyłki

Poniżej przykład cen w zależności od wagi produktu (wagę ustawiamy bezpośrednio w produkcie zakładka Dane → Waga)

Struktura: 3:8.99, 10:10.99,25:13.99 → cena do 3 kg to 8,99, cena do 10 kg 10,99, cena do 25kg 13:99

Pozycjonowanie usług dostawy w koszyku

Tutaj możesz pozycjonować usługi InPost w koszyku klienta

  1. W konfiguracji wtyczki należy przejść do zakładki Ustawienia

  2. Wybrać Edit w konkretnej formie dostawy i w edycji Kolejność sortowania uzupełnić kolejność licząc od 0 (pierwsza pozycja)

Szybkie Zwroty

Usługa pozwala klientom na zwrot przesyłki zamówionej w sklepie poprzez Paczkomat®

  1. W konfiguracji wtyczki zakładka Szybkie Zwroty należy podać skróconą nazwę do formularza Szybkich Zwrotów. Link tworzy się po założeniu konta w tej usłudze poprzez Przedstawiciela Handlowego

  2. Klient, który jest zalogowania w sklepie w zakładce zamówienia widzi nowy przycisk Zwrot to pozwala na przeniesienie się do Państwa formularza gdzie może dokonać zwrotu

! Ważne jest by w zakładce Zamówienia ustawić kiedy takie przycisk ma być widoczny - w zależność od statusu zamówienia.


Obsługa zamówień/wysyłki

Obsługa zamówienia

Zakładka - Sprzedaż → Zamówienia

  1. Otwiera podgląd na zamówienia złożone przez klientów. Przechodzimy do zamówienia klikając Widok (zaznaczone na czerwono)

2. W zamówieniu pojawia się tabelka z usługami InPost i numerem Paczkomat® gdzie możemy utworzyć przesyłkę. Umożliwia generowanie etykiet, tworzenie przesyłek, drukowanie zleceń odbioru

3. Po kliknięciu na przycisk Nowa dostawa otwiera się panel do edycji danych podanych przez klienta jak i ich akceptacji

4. Jeśli dane są poprawne klikamy utwórz Utwórz przesyłkę okno się zamyka a numer trackingowy po kilkunastu sekundach pojawia się w miejscu Numer przesyłki

Drukowanie i format etykiet

Po utworzeniu przesyłki można pobrać etykietę klikając Print Label

Wybieramy format etykieta, która nas interesuje



Obsługa wysyłki - utworzenie podjazdu

Obsługa paczek i ich wysyłka jest dostępna w dwóch miejscach.

  1. Bezpośrednio w zamówieniu po wygenerowaniu paczki pojawia się przycisk Disptach Order (

2. W liście przesyłek - do tej zakładki możemy się dostać poprzez przycisk Wyświetl listę przesyłek w zamówieniu w InPost Shipping lub poprzez zakładkę do konfiguracji wtyczki w prawym górnym rogu Wyświetl listę przesyłek:

Lista przesyłek

Podgląd na wszystkie wygenerowane przesyłki. Po prawej stronie są dostępne akcje w zależności od metody dostawy i formy nadania paczki.


Produkty szablony

W produkcie jest możliwość określenia wymiarów przesyłki dla konkretnego produktu (te dane automatycznie podstawiają się podczas tworzenia przesyłki w zamówieniu)

Należy przejść do zakładki Katalog Produkty → wybrać konkretny produkt

Produkt - zakładka Dane - dla metody wysyłki InPost Kurier możemy ustawić wymiary i wagę

Produkt - zakładka Wysyłka - pozwala ustawić dla jakiej metody dostawy dany produkt będzie dostępny + możemy określić gabaryt przesyłki (A,B,C) dla usługi InPost Paczkomat® (automatycznie będzie podstawiał się podczas tworzenia przesyłki Paczkomat®


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: OpenCart