Versions Compared

Key

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

Below is the documentation for the proprietary InPost OpenCart plugin. It contains information about installation and configuration of the plugin.

Version compatible with all versions of OpenCart 3.0

Panel
panelIconIdatlassian-info
panelIcon:info:
bgColor#FFFAE6

Plugin: (latest version 1.0.0- 23.0215.06.2023r)

https://inpost.pl/sites/default/files/2023-02/opencart-inpost-3-x06/ocs.inpostshipping.ocmod_.zip



Na tej stronie:

Table of Contents


Authorization

Production environment

Info

You must have access credentials to connect to the ShipX API before installation:

  • Access Token (key)

  • ID organization

and

  • Access Token for Geowidget

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

Test environment

Access generation

https://sandbox-manager.paczkomaty.pl/ > tab Moje konto > API

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

  1. Go to the Extensions tab and select Installer

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 ExtensionsExtensions


Plugin configuration

Searching for a module for further configuration is done under Extensions Extensions

In this tab, select InPost Shipping → Edit

Image RemovedImage 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
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/Przewodnik-skutecznej-implementacji-dostaw-InPost-w-koszyku-e-commerce.

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