[ENG] PrestaShop 8/9 International
Below is the documentation for InPost's proprietary PrestaShop 8 and 9 solution for InPost International services. It contains information about the installation and configuration of the plugin
The documentation describes the installation and configuration of the module and discusses its individual features, such as creating shipments and generating labels
Dostępna dla: BE - Belgium / ES - Spain / FR - France / IT - Italy / LU - Luxembourg / NL - Netherlands / PT - Portugal / AT - Austria / HU - Hungary
Plugin: 30.06.2025r
New version of the plugin compatible with PrestaShop 8 and PrestaShop 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:
https://inpost.pl/sites/default/files/2025-11/inpostinternational-0.4.0.zip
CHANGELOG
Checkout module compatibility list
Authorization
Production/test environment
Use of the PRODUCTION environment is only possible after signing an INTERNATIONAL service agreement
You must have access credentials to connect to the API before installation:
ClientID and ClientSecret
Login and password
In order to connect to InPost services, it is required to obtain a login and password.
To obtain authorization data, contact InPost via the form:
Grant access to API → API International → Environment: Production or Sandbox (for testing the service only)
https://inpost.pl/formularz-wsparcie
Connecting to InPost services is done by redirecting to the website. Please make sure that you have pop-up permissions enabled in your browser.
- 1 CHANGELOG
- 2 Checkout module compatibility list
- 2.1 Authorization
- 2.2 Installation
- 2.3 Configuration
- 2.3.1 Description of bookmarks
- 2.3.1.1 API configuration
- 2.3.1.2 Services
- 2.3.1.3 Parcel templates
- 2.3.1.4 Orders
- 2.3.1.5 Pickup address (only for courier delivery)
- 2.3.1 Description of bookmarks
- 2.4 Creating delivery methods
- 2.4.1 General settings
- 2.4.1.1 Carrier name
- 2.4.1.2 Transit time
- 2.4.1.3 Speed grade
- 2.4.1.4 Logo
- 2.4.1.5 Tracking URL
- 2.4.2 Shipping locations and costs
- 2.4.2.1 Add service costs
- 2.4.2.2 Free shipping
- 2.4.2.3 Settlement
- 2.4.2.4 Tax
- 2.4.2.5 Behavior/result outside the range
- 2.4.2.6 Scopes
- 2.4.3 Size/weight and availability for groups
- 2.4.4 Displaying the service name and logo for a given country
- 2.4.1 General settings
- 2.5 Configuring delivery methods in products
- 2.6 Order/shipping service
- 2.7 Creation of a courier pickup
- 2.8 Contact
Installation
Log in to the administration panel of your store on the PrestaShop platform
Go to the Modules tab
2. In the Modules tab, select Module Manager
A Load Module button will appear on the right side of the screen.
(Click on the button and download the installation package in the form of an archive)
Configuration
To find the module for further configuration, go to the Modules > Module Manager tab.
Enter InPost in the search engine and click the Configure button
Description of bookmarks
API configuration | Description |
ClientID | ID required for authorization - the AUTHORIZATION tab above describes how to obtain this information. |
ClientSecret | Key required for authorization - the AUTHORIZATION tab above describes how to obtain this data. |
Active environment | Production Mode - allows you to generate real shipments, Sandbox Mode - allows you to generate shipments, pickup orders, and download labels free of charge. |
Token production Geowidget | You need to add a token to Geowidget to enable service visibility at checkout (production environment only). The token should be generated at https://manager.paczkomaty.pl/auth/login, under the My Account tab - API - Geowidget. |
Token sandbox Geowidget | You need to add a token to Geowidget to enable service visibility at checkout (Sandbox environment only). The token should be generated at https://sandbox-manager.paczkomaty.pl/auth/login, under the My Account tab - API - Geowidget. |
Services | Description |
|---|---|
New service | Adding InPost International services at checkout - description can be found in the section: https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/1122893826/PL+PrestaShop+8+9+International#Creating-delivery-methods |
Shipping | Description |
|---|---|
Sender details | Należy uzupełnić swoje dane nadawcy, które będą znajdować się w systemie |
Default shipping method | Określamy domyślny sposób nadania przesyłki (można go zmienić podczas tworzenia paczki) → Nadanie u kuriera lub w punktach |
Default reference | Wskazujemy co ma się znajdować domyślnie w numerze referencyjnym przesyłki |
Default customer reference |
|
Default insurance | Wartość ubezpieczenia, która będzie przypisywana do przesyłek (waluta EURO) |
Parcel templates | Description |
|---|---|
New parcel templates | Allows you to create package templates that can be selected when creating a shipment for a specific order. Default - setting whether a given template should be used by default when creating a shipment. Name - any name that allows you to distinguish the template. Parcel type - standard (at this time) Dimensions - length/width/height - unit CM/MM/M Weight - maximum allowable 25kg |
Orders | Description |
|---|---|
Managing order settings | Enables:
|
Pickup address (only for courier delivery) | Description |
|---|---|
New pickup address | Allows you to specify the pickup point for the shipment Default - setting whether a given template should be used by default when creating a shipment Name - any name that allows you to distinguish the template Contact person: First name/Last name/Email/Phone number - persons to receive the shipment Address: Street/Building number/Apartment number/Postal code/City/Country/Description - data for the courier to pick up the shipment |
Creating delivery methods
For the InPost International service to work properly, you need to add the delivery method to your PrestaShop settings.
In the module, go to the Services tab
We choose a new carrier
Select a zone for a specific country or create one with several countries and add a shipping method.
Available for: BE - Belgium / ES - Spain / FR - France / IT - Italy / LU - Luxembourg / NL - Netherlands / PT - Portugal
Click Save
The following settings are made directly in PrestaShop:
General settings |
|
|---|---|
Carrier name | Default name assigned by the InPost plugin |
Transit time | We indicate the delivery time per country |
Speed grade | You can skip this |
Logo | Preloaded by default - no need to change |
Tracking URL | Default settings - no need to change |
Shipping locations and costs |
|
Add service costs | Additional shipping costs |
Free shipping | Free shipping or not |
Settlement | By weight or total price |
Tax | With regard to preferences |
Behavior/result outside the range | Action taken when, for example, the maximum order weight is exceeded |
Scopes | Specification of kg and price from to = shipping price depending on the selected country |
Size/weight and availability for groups | We specify the maximum dimensions of the shipment + for which group a given shipping method is to be available |
Displaying the service name and logo for a given country
In the carrier edition, change the name and logo for: Netherlands, France, Belgium, Luxembourg (after creating the International delivery method)
Italy, Spain, Portugal:
Logo: InPost → Name: InPost International
The Netherlands, France, Belgium, Luxembourg:
Logo: Mondial Relay → Name: Mondial Relay International
Logo:
Configuring delivery methods in products
In the product configuration, you can specify whether a given delivery method (in this case, InPost International) will be available for a specific product.
Order/shipping service
Creating a shipment and downloading a label
Enables shipment generation and label retrieval
When proceeding to a specific order after the customer has selected the InPost International service, a window appears regarding InPost shipping (below the payment status).
We choose New Shipment
We define the data
Creating a shipment | Description |
|---|---|
Recipient | Data that the customer provided when placing an order in the store |
Service | Delivery method |
Destination | Pickup point selected by the customer from Geowidget |
Method of delivery | Delivery at a point or by courier |
Parcel template | We select the template that we previously specified in the module configuration |
Dimensions | Replaced by template - can be edited here |
Weight | Weight indicated by the template - can be edited here |
Customer reference number | Order number or custom text on the label |
Insurance | Default value assigned in the module configuration |
Reference | Additional references regarding the shipment, the ability to dynamically create key-value pairs tailored to individual customer needs |
Finally, select Create (creates a shipment) or Create and download label (creates a shipment and immediately downloads the label in PDF format)
Bulk shipment creation and label retrieval
It is possible to create bulk shipments (those that do not yet have a tracking number) by going to orders.
In orders, you must select specific orders
Click on Bulk Actions - there you can choose to create shipments and download labels.
Creation of a courier pickup
You can order a courier pickup in the plugin settings under Shipping → InPost International Shipments
In the International plugin in the courier pickup section, we specify the date and day of pickup for shipments:
→ the latest pickup time is determined by the postal code and the cutoff time for sending the shipment, which can be checked in this tab
Then select the day and time:
Created orders can be checked in the tab - Pickup orders
Contact
If you have any questions, please use our contact form available at https://inpost.pl/formularz-wsparcie . Once you have accessed the form, simply select Customer Support from the list, select InPost International Module from the category, and enter PrestaShop in the Please enter the name of the module field.