- Created by Paweł Milewski, last modified on Jun 16, 2023
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 6 Next »
![](https://dokumentacja-inpost.atlassian.net/wiki/download/thumbnails/126582785/image-20220719-082918.png?version=1&modificationDate=1677235937174&cacheVersion=1&api=v2&width=204&height=153)
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
Plugin: (latest version 15.06.2023r)
https://inpost.pl/sites/default/files/2023-06/ocs.inpostshipping.ocmod_.zip
Na tej stronie:
Authorization
Production environment
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
Go to the Extensions tab and select Installer
![](https://dokumentacja-inpost.atlassian.net/wiki/download/thumbnails/126582785/image-20230224-115741.png?version=1&modificationDate=1677239863239&cacheVersion=1&api=v2&width=442&height=308)
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
![](https://dokumentacja-inpost.atlassian.net/wiki/download/thumbnails/126582785/image-20230224-120200.png?version=1&modificationDate=1677240122706&cacheVersion=1&api=v2&width=550&height=122)
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)
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
Poradnik implementacji dostaw znajdziesz pod adresem:
https://inpost.pl/sites/default/files/docs/Przewodnik-skutecznej-implementacji-dostaw-InPost-w-koszyku-e-commerce.
![](https://dokumentacja-inpost.atlassian.net/wiki/download/thumbnails/126582785/image-20230216-102200.png?version=1&modificationDate=1677235935043&cacheVersion=1&api=v2&width=442&height=313)
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
![](https://dokumentacja-inpost.atlassian.net/wiki/download/thumbnails/126582785/image-20230203-110920.png?version=1&modificationDate=1677235936353&cacheVersion=1&api=v2&width=442&height=477)
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
![](https://dokumentacja-inpost.atlassian.net/wiki/download/thumbnails/126582785/image-20230203-111318.png?version=1&modificationDate=1677235936199&cacheVersion=1&api=v2&width=544&height=223)
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)
![](https://dokumentacja-inpost.atlassian.net/wiki/download/thumbnails/126582785/image-20230203-112521.png?version=1&modificationDate=1677235935933&cacheVersion=1&api=v2&width=680&height=104)
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
![](https://dokumentacja-inpost.atlassian.net/wiki/download/attachments/126582785/image-20230203-113019.png?version=1&modificationDate=1677235935816&cacheVersion=1&api=v2)
3. Po kliknięciu na przycisk Nowa dostawa otwiera się panel do edycji danych podanych przez klienta jak i ich akceptacji
![](https://dokumentacja-inpost.atlassian.net/wiki/download/thumbnails/126582785/image-20230216-102532.png?version=1&modificationDate=1677235934926&cacheVersion=1&api=v2&width=442&height=468)
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
![](https://dokumentacja-inpost.atlassian.net/wiki/download/attachments/126582785/image-20230216-110956.png?version=1&modificationDate=1677235934805&cacheVersion=1&api=v2)
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 (
![](https://dokumentacja-inpost.atlassian.net/wiki/download/thumbnails/126582785/image-20230216-112924.png?version=1&modificationDate=1677235934689&cacheVersion=1&api=v2&width=340&height=125)
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:
![](https://dokumentacja-inpost.atlassian.net/wiki/download/thumbnails/126582785/image-20230216-113102.png?version=1&modificationDate=1677235934563&cacheVersion=1&api=v2&width=340&height=162)
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.
![](https://dokumentacja-inpost.atlassian.net/wiki/download/attachments/126582785/image-20230216-113302.png?version=1&modificationDate=1677235934439&cacheVersion=1&api=v2)
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ę
![](https://dokumentacja-inpost.atlassian.net/wiki/download/attachments/126582785/image-20230216-113710.png?version=1&modificationDate=1677235934316&cacheVersion=1&api=v2)
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®
![](https://dokumentacja-inpost.atlassian.net/wiki/download/thumbnails/126582785/image-20230216-114116.png?version=1&modificationDate=1677235934100&cacheVersion=1&api=v2&width=544&height=248)
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
- No labels