Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Poniżej znajduje się dokumentacja do autorskiej wtyczki Below is the documentation for the proprietary InPost OpenCart . Zawiera informację o instalacji oraz konfiguracji wtyczki.Wersja kompatybilna ze wszystkimi wersjami plugin. It contains information about installation and configuration of the plugin.
Version compatible with all versions of OpenCart 3.0
WtyczkaPlugin: (najnowsza wersja latest version 1.0.0- 23.02.2023r)
https://inpost.pl/sites/default/files/2023-02/opencart-inpost-3-x.zip
Na tej stronie:
Table of Contents |
---|
Authorization
Środowisko produkcyjneProduction environment
Info |
---|
Przed przystąpieniem do instalacji należy posiadać dane dostępowe do połączenia z APIYou must have access credentials to connect to the ShipX API before installation:
and
Download a tutorial explaining how to quickly create access to the ShipX API and Geowidget on your own: https://inpost.pl/sites/default/files/2022-03/instrukcja-konfiguracji-api-shipx.pdf https://manager.paczkomaty.pl/ > zakładka Moje konto > API |
Środowisko testowe
Generowanie dostępu
Test environment
Access generation
https://sandbox-manager.paczkomaty.pl/ > zakładka tab 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.
Instalacja wtyczki
Zaloguj się do panelu administracyjnego Twojego sklepu na platformie OpenCart
Przejdź do zakładki Rozszerzenia i wybierz Instalator
Image Removed
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
Image Removed
To generate a Token and an organization ID, you need to complete all the data, including billing details under My Account > Data. In order to create a Parcel Locker® shipment you need funds in your account, you will top up your account virtually in the Payments tab
Geowidget:
Access Token do Geowidget > tab Moje konto > API > Geowidget
Plugin installation
Log in to the administration panel of your store on the OpenCart platform
Go to the Extensions tab and select Installer
Image Added
2. Click Upload and select 2 zip files of the installation plugin. You should install them one by one.
3. After installation, the plug-in will appear in the tab below in the list of installed plug-ins Extensions → Extensions
Plugin configuration
Searching for a module for further configuration is done under Extensions → Extensions
In this tab, select InPost Shipping → Edit
Image Added
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 | ||||||
---|---|---|---|---|---|---|
| ||||||
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 konto → API → 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: |
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
W konfiguracji wtyczki należy przejść do zakładki Ustawienia
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®
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
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
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.
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