[ENG] PrestaShop 1.7 / 8 / 9
Below is the documentation for the InPost PrestaShop proprietary plugin. It contains information about the installation and configuration of the plugin
1.7+
Plugin:
https://inpost.pl/sites/default/files/2025-11/inpostshipping-1.28.0.zip
Our plugin is compatible with PrestaShop version 1.7 and above. Version 1.6 as well as some PHP versions may cause errors in operation of the plugin and the store.
Compatibility of PrestaShop version with PHP: https://devdocs.prestashop-project.org/1.7/basics/installation/system-requirements/#php-compatibility-chart
Pre-test the plugin on a trial version of the store
8 i 9
The new version of the plugin is compatible with PrestaShop 8 and 9
PrestaShop version compatibility with PHP: https://devdocs.prestashop-project.org/8/basics/installation/system-requirements/#php-compatibility-chart https://devdocs.prestashop-project.org/9/basics/installation/system-requirements/
Plugin: (latest version 2.15.0- 27.11.2025)
https://inpost.pl/sites/default/files/2025-11/inpostshipping-2.15.0.zip
Changelog
Na tej stronie
- 1 1.7+
- 2 8 i 9
- 3 Changelog
- 4 Checkout module compatibility list
- 5 Authorization
- 6 Plugin installation
- 7 Plugin configuration
- 7.1 Tabs
- 7.1.1 Authorization
- 7.1.2 Geowidget
- 7.1.3 Sender details
- 7.1.4 Sending method / Insurance
- 7.1.5 Shipping services
- 7.1.5.1 InPost Parcel Locker
- 7.1.5.2 InPost Courier Standard
- 7.1.5.3 Positioning of delivery services in the shopping cart
- 7.1.6 Quick Returns
- 7.1.7 Parcel on the Weekend
- 7.1.8 Dispatch points
- 7.1.9 Checkout config
- 7.1.10 Orders
- 7.2 InPost Locker Economy
- 7.1 Tabs
- 8 Order processing/shipping
- 9 Products - templates
- 10 Solutions to problems
- 11 Contact
Checkout module compatibility list
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
Sandbox environment
Access generation
https://sandbox-manager.paczkomaty.pl/ > tab Moje konto > API
To generate a Token and an organization ID in sandbox, 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 your store's admin panel on the PrestaShop platform
Go to Modules tab
2. On the Modules tab, select Module Manager
3. On the right side of the screen you will see the Upload a module button
(Click on the button and upload the installation package as an Archive)
Plugin configuration
Searching for a module for further configuration is done in the Modules tab -> Module Manager
Type "Inpost" into the browser and click the Configure button
Tabs
Authorization | allows configuration of API access (Production and Sandbox) |
GeoWidget | allows you to add a Token to Geowidget (you need to generate a Geowiedget token for the map with InPost points to work properly) |
Sender details | data can be completed or automatically downloaded from the API |
Sending method | allows you to configure the default Pickup/Parcel Locker® and set the default insurance value |
Shipping services | a place to add and configure Parcel Locker® and Courier services |
Weekend delivery | allows you to configure the Parcel on the Weekend service (days and hours of service availability) |
Dispath points | allows you to add/delete/edit Collection Points |
Checkout config |
|
Orders | here are additional options for order processing |
Szybkie Zwroty | allows you to configure the Fast Returns service (having created an account in this service - Sales Representative) |
Important! When the shopping cart in Geowidget shows the error "No access, check if the token has been generated for the correct site" you must re-generate the token for Geowidget in the Parcel Manager but with the correct shop site address.
Authorization
Here you can fill in your API access data (Token, Organization ID), which you can generate yourself in the Parcel Manager under "API" Access to environments is at the beginning of this documentation
It is possible to use only Sandbox mode after switching the switch and completing the sandbox data
Geowidget
For proper operation of the map with InPost points in the shopping cart, you need to add the Geowidget token to the Production or Sandbox configuration
Generate the token in Parcel Manager under My Account → API → Geowidget (specifying the store domain)
Sender details
The form is used to collect information needed to ship packages. It collects the basic data of the sender
It is possible to automatically fill in the fields of the form with data that has been previously defined as organization data in the store configuration. To do this, click on the "Fill with organization data" button
Sending method / Insurance
Allows you to configure the default Pickup Point/Parcel Locker and set the default insurance value
Form field | Description |
Default dispatch point | Selecting the default pickup point from which shipments will be sent |
Default locker | Set the default Parcel Locker to which shipments will be directed |
Default point | Introducing the default Parcel Point (POP) from which shipments will be sent |
Default shipment reference | Designation of what to automatically assign to the reference/remarks field on the labels:
Maximum 90 characters fit on the label - the rest can be cut off)
|
Default insurance amount | Set the default insurance amount for each shipment
|
Shipping services
Here you can configure the delivery methods that will appear in your store
Delivery methods | Description |
|---|---|
InPost Locker 24/7 InPost Locker COD | Delivery of a shipment to Parcel Locker/Parcel Point pickup points
|
InPost Courier InPost Courier COD | Delivery of the shipment to the address provided by the customer Service available only for business customer (contract)
|
InPost Courier C2C InPost Courier C2C COD | Delivery of the package to the address provided by the customer Service available for retail customer - (prepaid) (rates according to the price list on the website InPost.pl
|
InPost Locker Weekend | Delivery of a shipment to Parcel Locker on the weekend available 24/7 |
InPost SmartCourier | Delivery of a shipment to the address provided by the customer. A service dedicated to the delivery of goods that require personal delivery with confirmation of the recipient's data. The delivery process requires verification of the addressee with such data as first name, last name, age of majority, and if delivery of a category of goods requires sobriety of the recipient of the shipment, this will also be verified |
Services with download include COD in the name (only then is the value of the download recorded when the package is created)
Part 1: Configuration
Click Add New -> fill in the service that is imported from the API, the default shipping method, specify the default shipment dimensions or gauge ( depending on the service used), then give the correct service name according to the guidelines in the "Poradniku skutecznej implementacji dostaw InPost w koszyku e-commerce" and click Submit
You can find a delivery implementation guide at:
https://inpost.pl/sites/default/files/docs/Przewodnik-skutecznej-implementacji-dostaw-InPost-w-koszyku-e-commerce.pdf
A view of method creation:
InPost Parcel Locker
Description:
Service | Allows you to select the services that are made available in a given organization ID (it is not possible to select services that are not in the token - they jump and are skipped) |
Weekend delivery | Service that allows delivery of parcels on the weekend - should be treated as a separate service because it only appears in checkout at designated times |
Cash on delivery | A service that allows you to create shipments with a COD amount - should be treated as a separate service because the amount is recorded in the requisition and on the label (the courier will collect the COD from the customer) |
Default sending method | The method of shipment that will be substituted when creating the shipment first |
Automatically fill parcel dimension … | This field assigns the shipment dimensions (in products you can set the default size) of the product that is in the order .When creating the shipment, the size will be selected as it is in the product, for example, gab. C |
Default dimension template | If there is no dimension set in the product - the one selected in this field will be substituted |
Default shipment dimensions | If you do not select the default size A/B/C, you can set the default dimensions |
New carrier name | Allows you to add the name of the service that will appear in the checkout. We recommend using the button Complete service name (agree with the implementation guide) |
Weekend delivery and Cash on Delivery service - when you select these services, specific delivery methods are created. In order to have Parcel on the Weekend and InPost Parcel Post 24/7 in the cart, you need to add each method separately - they do not switch as needed
InPost Courier Standard
Description:
Service | Allows you to select the services that are made available in a given organization ID (it is not possible to select services that are not in the token - they jump and are skipped) |
Cash on delivery | A service that allows you to create shipments with a COD amount - should be treated as a separate service because the amount is recorded in the requisition and on the label (the courier will collect the COD from the customer) |
SMS | Enables the default setting of an additional service (paid), which sends notifications to the customer about the SMS shipment (in the standard, the customer does not receive notifications |
Enables the default setting of an additional service (paid) , which sends notifications to the customer about the Email shipment (in the standard, the customer does not receive notifications) | |
Default sending method | The method of shipment that will be substituted when creating the shipment first |
Automatically fill parcel dimension … | This field assigns the shipment dimensions (in products you can set the default size) of the product that is in the order .When creating the shipment, the size will be selected as it is in the product, for example, gab. C |
In non standard | Service that allows you to specify that the shipment will have non-standard dimensions (NST) |
Default shipment dimensions | If you do not select the default size A/B/C, you can set the default dimensions |
New carrier name | Allows you to add the name of the service that will appear in the checkout. We recommend using the button Complete service name (agree with the implementation guide) |
Payment on delivery service - when you select this service, specific delivery methods are created. In order to have Cash on Delivery and InPost Parcel Post 24/7 (without COD) in the cart, you need to add each method separately - they do not switch as needed
Part 2: Configuration
After adding a service, you have the option to further configure the delivery method. To do so, click GO TO DELIVERY SETTINGS
You will be redirected to the selected service, where you can change the logo, set shipping costs, maximum weight, sizes and availability for guests or customers logged into the store
Positioning of delivery services in the shopping cart
Tab Improve -> Shipping -> Carriers
Here's how you can position InPost services in your customer's shopping cart
Quick Returns
The service allows customers to return shipments ordered from the store via Parcel Locker
In the plugin configuration, you need to provide a short name for the Fast Returns form. The link is created when you create an account for this service through the Sales Representative
The customer who is logged in to the store in the order tab sees a new Return Merchandise button this allows you to move to your form where he can make a return
Returns made through the form have two acceptance options:
Automatic - when the customer completes the form, he or she is given a return code that must be entered while at the machine
Manual acceptance - the customer completes and submits the form but it is the store owner who accepts or not - the given return. Only after acceptance does the customer receive the return code
Parcel on the Weekend
In order to make the Parcel on the Weekend service available, you need to add a new delivery method.
Go to the module configuration and choose Shipping Services → Add New
Configure the method (by selecting Parcel on Weekend):
We then set the availability of the service at the checkout on specific days and times:
Dispatch points
Allows you to add/delete/edit Receipt Points
Form field | Description |
Name | Enter the name of the pickup point to be displayed in the system |
Office hours | Enter the hours during which the pickup point is available for sending and receiving shipments |
Enter the email address assigned to the pickup point to which notifications and other relevant information will be sent | |
Phone | Enter the contact phone number for the pickup point |
Street | Enter the name of the street where the pickup point is located |
Building number | Enter the building number where the pickup point is located |
Postal code | Enter the postal code for the location of the pickup point |
City | Enter the name of the town where the pickup point is located |
Checkout config
Allows you to customize the visibility and function of certain fields in the order process (checkout)
Form field | Description |
The shop is using a custom checkout module | Enable when you use custom checkout in your store (there are modules to choose from) |