/
[ENG] PrestaShop 1.7 / 8.X

[ENG] PrestaShop 1.7 / 8.X

 

 

 

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

1.7+

Plugin: (latest version 1.26.0- 16.01.2025r)

https://inpost.pl/sites/default/files/2025-01/PrestaShop1.7.0-1.7.8-ver-1.26.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: System requirements for PrestaShop 1.7

Pre-test the plugin on a trial version of the store

 

8.0+

New plug-in version compatible with PrestaShop 8.X

Plugin: (latest version 2.12.0- 16.01.2025r)

https://inpost.pl/sites/default/files/2025-01/PrestaShop8.ver-2.12.0.zip

Changelog

2.12.0 / 1.26.0: 16.01.2025

  • New: added ability to mark a package as non-standard in the shipment creation form and specify when creating/editing a carrier whether these options should be selected by default

  • New: added option to select additional SMS/email notification services in the shipment creation form and specify when creating/editing a carrier whether these options should be selected by default

  • New: added new option for default shipment reference number: list of product names on the order

  • New: added option to select default shipment label printing format

  • FIX: fixed a bug that could prevent the order details page from displaying if authorization data was not completed in the module configuration

2.11.2 (PS 8 ): 24.10.2024

  • FIX: module installation restriction on PrestaShop 8.2 has been lifted

2.11.1 (PS 8 ): 24.10.2024

  • FIX: fixed a bug that could prevent the creation of an order through the PrestaShop API

1.25.1 / 2.10.1: 06.08.2024

  • FIX: address error in creating shipment removed

1.25.0 / 2.10.0: 18.07.2024

  • New: new delivery method “Smart Courier”

1.24.0 / 2.9.0: 26.04.2024

  • New: added integration with onepagecheckoutps module

  • FIX: resolved bug preventing the order page from being displayed in the administration panel if there are confirmed or earlier status shipments associated with the order

1.23.0 / 2.8.0: 29.03.2024

  • New: added on the order page in the administration panel the possibility to create shipments when the delivery method selected for the order is not linked to the module

  • New: addition of the display of information about the selected Parcel Locker on the order details page on FO

  • New: added option to remove consignment data from the PS via the list of processed consignments and the order page in the administration panel

  • FIX: improved validation of the phone number in the checkout module if the option to enter a separate phone number is disabled in the carrier module

  • FIX: corrected case where a warning was raised on the module configuration page when the open_basedir option was enabled in the PHP configuration open_basedir

  • FIX: updated service name translations

1.22.1 / 2.7.1:

  • FIX: improved compatibility with TheCheckout

  • New: protection against errors that prevent the module from starting up

1.22.0 / 2.7.0:

  • FIX: label printing on SAFARI

  • FIX: improving the performance of CRON queries

 


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


 

Plugin installation

Log in to your store's admin panel on the PrestaShop platform

  1. 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

  • Store uses custom checkout → enable when you use custom checkout in your store (there are modules to choose from)

  • Show field for email address and phone number → number phone and email are pulled from address data, if you need to use the fields when selecting Parcel Locker you can enable them here

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)

 

 

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:

  • Name of the products - those that are in the order

  • Order ID (PrestaShop)

  • Order number

Default insurance amount

Set the default insurance amount for each shipment

  • Setting the amount 0 - packages will not be insured

  • Setting an empty field - in insurance will appear the amount taken from the value of the order

  • Setting a specific amount - we assign it to each shipment


 

Shipping services

Here you can configure the delivery methods that will appear in your store

Delivery methods

Description

Delivery methods

Description

InPost Locker 24/7

InPost Locker COD

Delivery of a shipment to Parcel Locker/Parcel Point pickup points

  • Method with COD (cash on delivery method)

InPost Courier

InPost Courier COD

Delivery of the shipment to the address provided by the customer

Service available only for business customer (contract)

  • Method with COD (cash on delivery method)

  • Additional service for Courier Standard - SMS notification, EMAIL notification (paid)

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

  • Method with COD (cash on delivery method)

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

 

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

 

 

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)

 

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

Email

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)

 

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

  1. 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

  2. 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

 

 


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 ServicesAdd 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

E-mail

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)

Show input email

 

Allows you to enable a field to enter an email address during the checkout process. Email address data is pulled from the address data by default, but if you choose Parcel Locker, you can enable this field here if needed

Show input phone

 

Allows you to display a field for entering a phone number during the checkout process. Phone number data is pulled from the address data by default, but you can enable this field here if needed when selecting Parcel Locker


 

Orders

 

Tab allows additional settings for placed orders

  1. Adds information about the selected pickup point in an email message

  2. Changes the order status after printing the shipment (opens a list with available statuses)

  3. Changes the status of the order after the shipment status is changed to delivered. After enabling this option, select the order status from the list. The list depends on the individual configuration of the store

CRON - updates shipment statuses in the module

Requires the creation of a CRON task that will update the status of shipments (hosting)

 

 

 


 

InPost Locker Economy

Products ordered through the provided InPost Paczkomat® Economy Parcel service get an attractive delivery price. Receiving economy parcels from Paczkomat® InPost is the safest way to carry out online orders, especially with the remote opening of the box through the InPost Mobile application

 

Configuration:

A new shipping method should be added to the operation of the service

  1. Go to Modules → InPost Shipping → Shipping Services tab

  2. We click Add new

  3. We select the Parcel station shipment - economic

  4. We fill in the standard shipping details and the variant code , which was given on the contract

  5. Click Submit

After adding the service, we need to configure it additionally by going to Go to Carrier Settings

 

There let's set the price for the service, whether the price should include tax and for which groups it should be available

After saving the settings, a new service appears to us in the shopping cart:

 


Create shippment:

Once the customer has placed an order, the Carriers tab in the order will show which service the customer has selected and a New shipment can be created.

 

In the place of the Variant code, the value added when adding a new delivery service will be automatically assigned.

 

 

 


Order processing/shipping

 

Order handling

Tab - Orders

Lets you generate labels, create shipments, print pick-up orders

 

A table of InPost services appears in the order where we can create a shipment

 

After clicking on the New Shipment button, a panel opens for editing the data provided by the customer as well as accepting them

 


Printing and label format

Once the shipment is created, you can download the label by clicking ActionsPrint Label

 

We have a choice of label formats:

 

 

 

Shipping service

Tab - Shipping > InPost shipments

 

Here it is possible to handle and view drive-up orders, currently processed and shipped shipments, generate labels, create and print pickup orders

 

When creating a pickup order, we have the option of selecting a pickup point


Removal of consignments from Przesyłki Procesowane

It is possible to remove shipments that have not been sent from the view in the Processed Shipments panel. This will help to tidy up the view of the current orders.

By clicking on the actions at the end of each consignment, the Delete option appears

 

 

 


 

Products - templates

In each product there is an option to specify availability for a specific carrier and default shipment dimensions

This applies to Courier shipments (dimensions in cm) and Parcel Locker® shipments (Gabaryty)

 


 

Solutions to problems

SSL certificate error problem: certificate has expired

→ cURL error 60: SSL certificate problem: certificate has expired

On the hosting side, update ca-certificates (ca-certificates curl openssl command)
Sometimes a reboot of php on the server may also suffice - php may keep the old certificate in cache before changes.


The "Select Parcel Store" button does not work


The reason may be that the URL to the store is incorrectly specified when creating a token for Geowidget in Parcel Manager. When the URL is wrong the map will not open.


Geowidget - no access


When the shopping cart in Geowidget shows the error "No access, check if the token has been generated for the correct site" you need to re-generate the token for Geowidget in Parcel Manager but specifying the correct store site URL. The error is related to providing an incorrect store URL.


 

 

Contact

 

If you have any questions, please use the Integration Department's contact form, which is available here: https://inpost.pl/formularz-wsparcie  

 After entering the form, just select "Customer Support" from the list, in the category select: InPost module, and in the field "Please specify the name of the module" enter: PrestaShop

 

Related pages