GLS in PrestaShop – Track and Trace Pro | PrestaDev
GLS in PrestaShop – Track and Trace Pro | PrestaDev
GLS in PrestaShop – Track and Trace Pro | PrestaDev
GLS in PrestaShop – Track and Trace Pro | PrestaDev

GLS Track and Trace Pro - automatic GLS parcel tracking in PrestaShop

Module version: 1.2.0

PrestaShop compatibility: 1.7.x 8.x 9.x

Module file updated: 03/28/2026 11:12:00

Product data updated: 03/28/2026 11:37:09


GLS Track and Trace Pro is the only PrestaShop module on the market that fully automates the process of tracking GLS courier shipments. The module connects directly to the official GLS Group API, retrieves delivery events in real time, and automatically updates order statuses in your store — without any intervention on your part.

If you run an online store on the PrestaShop platform and ship parcels with GLS, this module will save you hours of manual work spent checking shipment statuses, copying tracking numbers, and manually changing order states. Everything happens automatically, in the background, thanks to the cron mechanism.

License type / update
zł 118.00
zł 95.93no tax
Price history:

Description

How does it work?

After installing the module and entering your GLS API credentials (which you receive from your account manager at GLS Poland), the module starts working immediately. When an order in your store reaches the "Shipped" status, the module automatically starts tracking the assigned parcel number. From that moment on, it periodically queries GLS servers for current delivery events — parcel pickup, transit, delivery, delivery issue, or return to sender.

Each event is saved in the history along with the date, time, event code, location, and country. Based on these events, the module automatically changes the order status in PrestaShop — for example, it sets "Delivered" when the courier confirms that the customer has received the parcel. The customer then receives an email notification about the status change, exactly as with a manual status change made by the administrator.

Full list of features

  • Automatic parcel tracking — the module starts monitoring the parcel on its own when the order changes to the "Shipped" status. You do not need to click anything or copy tracking numbers manually.
  • Direct integration with the GLS Group API — the module communicates with the official GLS API (api.gls-group.eu) using the REST protocol and HTTP Basic Auth authentication. Parcel data is retrieved in JSON format, ensuring speed and reliability.
  • Automatic order status changes — based on GLS event codes, the module recognizes five key parcel states and updates the order accordingly:
    • In transit — the parcel has been collected by the courier and is on its way (event codes 1.x, 2.x, 11.x, 67.x)
    • Delivered — the courier has confirmed delivery of the parcel to the recipient (event code 3.x)
    • Delivery issue — unsuccessful delivery attempt, recipient unavailable at the address (codes 4.x, 12.x)
    • Return to sender — the parcel is being returned to you as the sender (code 5.x)
    • Awaiting verification — the tracking number has been added, but the API has not returned any events yet
    You can map each of these states to any order status in your store. If you do not want a given state to change the order status — simply select the "Do not change" option.
  • Complete event history — every parcel event is saved with the exact date and time, GLS code, text description, sorting facility or courier branch location, and country code. The history is available both to the store administrator and to the customer on the order details page.
  • Email notifications for customers — when the module changes the order status (e.g. to "Delivered"), PrestaShop automatically sends the customer an email notification with the new status. The customer stays up to date on their parcel's progress without any effort on your part.
  • Tracking panel for the customer — on the order details page, the customer sees a clear timeline with successive delivery events. They can see the parcel number, the current status in the form of a colored label, and a tracking link to the official GLS website.
  • Administrative panel with parcel list — a "GLS Tracking" tab appears in the PrestaShop administration menu with a complete list of all tracked parcels. The list includes filters, sorting, CSV export, bulk actions, and search by parcel number, status, event code, and date range.
  • Status filter in the form of a dropdown list — in the header of the "Status" column, there is a dropdown with the following options: Delivered, Returned, In transit, Issue, Awaiting verification. One click filters the list to the selected state — ideal when you want to quickly see, for example, all parcels with issues.
  • Event history preview in a modal window — clicking the "View events" icon next to any parcel opens a popup with the full event timeline, without leaving the list. Quick preview without reloading the page, thanks to AJAX technology.
  • Bulk status refresh — the "Refresh all tracking" button in the toolbar retrieves current data from the GLS API for all undelivered and non-returned parcels at once. You can also select specific parcels and refresh only their statuses.
  • Automatic import from the GLS Poland module — if you use the official glspoland module to generate shipping labels, the GLS Track and Trace Pro module can automatically import parcel numbers from that module's tables. You do not need to rewrite numbers manually — just select the "GLS Poland module" data source in the configuration.
  • Two parcel number sources — the module supports two modes of obtaining tracking numbers:
    • Native PrestaShop — reads the number from the "Carrier tracking number" field in the order shipping details
    • GLS Poland module — reads directly from the gls_poland_parcel table created by the official glspoland module
  • Cron mechanism with two phases — the cron job consists of two phases:
    • Phase 1 — automatic import of new parcel numbers from the GLS Poland module (run on every cron call)
    • Phase 2 — querying the GLS API for current events for all active parcels (run according to the configured interval, every 15 minutes by default)
  • Two ways to run cron — you can configure cron in two ways:
    • HTTP — paste the provided URL into your hosting panel as a cron job (e.g. in cPanel, DirectAdmin, Plesk)
    • CLI — run the PHP command from the command line, which is more efficient on VPS and dedicated servers
    In the module configuration, you will find ready-to-copy addresses and commands, along with a sample crontab entry.
  • Configurable query interval — you decide how often the module should check parcel statuses in the GLS API. The default value is 15 minutes. The GLS API caches responses for 5 minutes, so values shorter than 5 minutes make no sense and will not speed up updates.
  • API connection test button — in the configuration form, you will find the "Test API connection" button, which immediately checks whether the provided login details are correct and whether the GLS server is responding. You do not need to wait for the first cron run to find out whether the configuration is correct.
  • Test and production environments — the module supports both the GLS production environment (api.gls-group.eu) and the test environment (qs1.gls-group.eu). You can safely test the integration on a development server before launching it on the production store.
  • Full multistore support — the module has been designed for PrestaShop multistore setups. Each store in the multistore network can have its own GLS API credentials, its own cron interval settings, and its own order status mappings. The parcel list in the administration panel automatically filters results to the currently selected store, store group, or all stores.
  • Manual addition of tracking numbers — on the order page in the administration panel, you will find a form for manually entering a GLS parcel number. The module validates the number (letters, digits, and hyphens only, maximum 64 characters) and starts tracking immediately.
  • Protection against duplicates — the module does not allow the same parcel number to be added twice to the same order. Both the user interface and the database mechanism (unique key) protect against duplicate entries, even in the case of simultaneous requests.
  • Tracking link on the GLS website — for each parcel, a link is displayed that leads directly to the tracking page on the official GLS portal. Both the administrator and the customer can check full parcel information on the carrier's website with a single click.
  • Colored status labels — parcel statuses are marked with colored badges for immediate readability:
    • green — delivered
    • red — returned to sender
    • blue — in transit
    • orange — delivery issue
    • gray — awaiting verification
  • Compatibility with PrestaShop 1.7.6 to 9.x — the module is compatible with PrestaShop from version 1.7.6 through the entire 8.x series up to the latest 9.x versions. It supports both the older legacy and the new PrestaShop translation system. It uses the bootstrap mechanism for proper display in the administration panel.

Who is this module for?

GLS Track and Trace Pro is intended for any PrestaShop online store that uses GLS Poland courier services or GLS in another European country. The module will work well both in a small store shipping a few parcels a day and in a large store processing hundreds of orders — thanks to the batch API query mechanism (batch processing, up to 20 parcels in a single request), the module efficiently handles large volumes.

If until now you have been checking GLS parcel statuses manually on the carrier's website and manually changing order statuses in PrestaShop — this module completely eliminates that work. Customers are kept informed in real time, orders update themselves, and you gain more time to grow your business.

Requirements

  • PrestaShop version 1.7.6 or newer (including 8.x and 9.x)
  • GLS WebAPI credentials (username and password) — you will receive them from your sales representative at GLS Poland
  • Server with support for PHP 7.1+ and the cURL extension
  • Ability to configure a cron job on the hosting server (available in most hosting panels)

Support and updates

The module is developed and supported by PrestaDev.pl — a Polish team specializing in creating modules and solutions for PrestaShop. If you have questions, configuration issues, or need the module adapted to your individual requirements — contact us at info@prestadev.pl.

Product Details

Prestashop 9.x support
Yes
Support for Prestashop 8.x
Yes
Prestashop 1.7.x support
Yes
Free support
Yes
Free updates (1 year)
Yes
Easy Installation
Yes
PDGPRSPRO-FULL

FAQ

Find answers to the most common questions about this product.

The module automatically tracks GLS courier shipments in your PrestaShop store. Once a parcel has been dispatched, the module connects to the official GLS API, retrieves delivery events (pickup, transit, delivery, issue, return), and automatically updates order statuses based on them. The customer is notified by email of every status change. You do not need to manually check shipments on the GLS website or manually update orders — everything happens automatically in the background.

You need GLS WebAPI access credentials — a username and password. You will receive them from your GLS Poland sales representative after signing a courier services agreement. The module uses the official GLS Group API available at api.gls-group.eu. If you do not yet have API access, contact the GLS Poland helpline and request activation of the WebAPI Track and Trace service for your account.

The GLS API returns event codes for each shipment. The module interprets these codes automatically: code 3.x means the parcel has been delivered, codes 1.x, 2.x, 11.x and 67.x mean the parcel is in transit, codes 4.x and 12.x indicate a delivery issue (e.g. the recipient is absent), and code 5.x means the parcel is being returned to the sender. You can link each of these statuses to any order status in your PrestaShop store.

Yes. On the order details page, the customer can see the GLS tracking number, the current delivery status in the form of a coloured label, and a full timeline with all events — date, description, location, and country. The customer also sees a direct link to track the parcel on the official GLS website. All information is updated automatically after each cron run.

In the module configuration, you will find a ready-made URL and a CLI command with a unique security key — simply copy and paste them as a cron job in your hosting panel (cPanel, DirectAdmin, Plesk). The recommended setting is to run it every 15 minutes. The module itself controls the GLS API polling interval, so even if the cron runs more frequently, it will not burden the API with unnecessary requests.

Yes, this is one of the most important uses of this module. In the configuration, select the shipment number source as the GLS Poland Module. From that moment on, GLS Track and Trace Pro automatically imports shipment numbers from the glspoland module tables (gls_poland_parcel and gls_poland_consignment) and starts tracking them without any manual work. New numbers are imported every time the cron job runs, regardless of the configured interval.

The module does not send its own emails — it uses PrestaShop’s built-in mechanism. When the module changes an order status (e.g. from Shipped to Delivered), PrestaShop will automatically send the customer the email notification assigned to that status. Thanks to this, the emails look exactly the same as when the status is changed manually and use your email templates configured in PrestaShop.

Yes, the module fully supports PrestaShop multistore. Each store in the multistore network can have its own GLS API credentials, its own cron interval, and its own order status mappings. The shipment list in the administration panel automatically filters results to the currently selected store or store group. Each store requires a separate cron entry with the id_shop parameter.

There is no limit. The module groups shipments into batches of 20 numbers (GLS API limit) and sends requests in bulk. If you have 200 active shipments, the module will make 10 API requests in a single cron run. Tracking applies only to shipments that have not yet been delivered or returned — parcels with the status Delivered and Returned are not checked again, which reduces the load on the API.

Yes. On the order page in the PrestaShop administration panel, a GLS Tracking section appears with a form for manually entering the shipment number. The module accepts numbers consisting of letters, digits, and hyphens, up to 64 characters long. After adding the number, the module immediately starts tracking at the next cron run.

In Native PrestaShop mode, the module reads the tracking number from the Carrier tracking number field in the order shipment details. This is a standard PrestaShop field that you fill in when changing the status to Shipped or in the Shipping tab on the order page. Once the number is entered and the order reaches the shipping status, the module will automatically start tracking.

A GLS Tracking tab appears in the PrestaShop menu with a complete list of all tracked shipments. Each shipment displays: order number (with a link), GLS shipment number, current status with a coloured label, last event code, delivery and return flags, date of the last check, and date added. The list includes filters, sorting, CSV export, and bulk actions. The Status column has a filter in the form of a drop-down list with the following options: Delivered, Returned, In transit, Issue, Awaiting verification.

Yes. In the module configuration form, you will find the Test API Connection button. After clicking it, the module immediately checks whether the provided username and password are correct and whether the GLS server is responding. The test result is displayed right away — you do not have to wait for the first cron run to verify that the configuration is correct. The module supports both the production environment (api.gls-group.eu) and the test environment (qs1.gls-group.eu).

The module is compatible with PrestaShop from version 1.7.6 through the entire 8.x series up to the latest 9.x versions. It supports both the older (legacy) and the new PrestaShop translation system. It uses the actionAdminOrdersTrackingNumberUpdate hook available since PrestaShop 8.0, allowing it to immediately capture the tracking number entered by the administrator.

Check in order: whether the cron task is configured correctly and is running (in the module configuration you can see the URL to copy), whether the GLS API data has been entered correctly (use the Test API connection button), whether the cron interval is not set too long, whether the shipments have a status other than Delivered or Returned (the module does not check completed shipments). If you are using the GLS Poland module, make sure that the source is set to GLS Poland module in the configuration.

Reviews (0)

No reviews