GLS CEE Shipping — a shipping module for GLS in OpenCart: home delivery and ParcelShop / ParcelLocker (MyGLS)

GLS CEE Shipping is an independent shipping module for GLS by the CatCode studio for stores in Croatia, Czechia, Hungary, Romania, Slovenia and Slovakia on OpenCart 4, 3 and 2.3. The buyer chooses GLS courier delivery to the address or to a GLS ParcelShop or ParcelLocker right at checkout, and the manager creates the label, prints it and sees the parcel status on the order page through the MyGLS API, without opening the GLS portal.

What you need. A contract with GLS in your country and MyGLS access: login (email), password and client number. Honest note about testing: we have no MyGLS test access — GLS gives it only to customers with a contract. The module is written from the official MyGLS API documentation (version 25.12.11) and tested against a test server that answers like MyGLS per this documentation. We have not created real labels at GLS. Try it on your own account in the 7-day Pro trial — if GLS answers differently from the documentation, we will fix it quickly.

About the trademark. GLS and MyGLS are trademarks of GLS. GLS CEE Shipping is an independent CatCode module, not an official GLS product: GLS does not publish or support it. The module works with your own MyGLS account through the MyGLS API following the GLS documentation.

Running WooCommerce? There is a separate GLS CEE Shipping for WooCommerce plugin: the same two GLS methods and the ParcelShop / ParcelLocker picker at the classic and block checkout, MyGLS labels from the order screen, tracking and cash on delivery.

What the buyer sees

• Two GLS methods in the shipping list: courier to the address and ParcelShop / ParcelLocker. The point method is shown only for countries where you turned points on and downloaded them.
• Point search by postcode, city, street or name, without diacritics. Points for the buyer’s postcode are shown right away.
• The list shows the point type, address, opening hours and a “no cash on delivery” mark. Points on holiday and inactive points are not shown.
• No way on without a point: the server refuses the step, and the confirm block on the page is held with a hint that the point is missing.

What the admin gets

• Settings on six tabs: general, MyGLS account, points, shipments, automation, licence. The account country decides which MyGLS (api.mygls.hr, .cz, .hu, .ro, .si, .sk) the module talks to; the MyGLS test system is supported.
• GLS panel on the order page: the chosen point, the buyer’s own address, label creation with weight, the address split into street / number / extra and cash on delivery, PDF, reprint, delete, status.
• Labels for orders with another shipping method too — to the buyer’s address.
• An email to the buyer with the parcel number and a GLS tracking link — in the order language, plus a record in the order history.
• Shipments list in the Sales menu, with bulk actions in Pro.

How it works — step by step

1. You enter the MyGLS details, test the connection and download the points of the countries you need — they go into the module table and are updated daily.
2. The buyer chooses “GLS ParcelShop or ParcelLocker” and a point in the panel under the method. The point goes into the session on the server; the buyer’s address fields do not change.
3. At checkout the order shipping address becomes the point address, and the buyer’s own address is stored separately. For home delivery — the buyer’s address.
4. On the order page the manager clicks “Create GLS label”: the module sends the data to MyGLS (PrintLabels; for a point — the PSD service with the point code) and stores the PDF and the parcel number.
5. The buyer gets an email with tracking; the parcel status is updated with a button, and in Pro every hour, and a delivered order moves to the chosen status.

Under the hood

• MyGLS REST API per the documentation version 25.12.11: PrintLabels, GetPrintedLabels, DeleteLabels, GetParcelListStatuses, GetParcelList, GetDeliveryPoints (points as compressed JSON, update of changed points only).
• The point lives on the server only. The picker JavaScript does not read or write the buyer’s address fields. Only the point ID goes into the session, the data comes from the module table, and the point gets into the order only for the point method and only for its own country; otherwise the link is erased.
• The no-point check in OpenCart 4 sits on saving the payment method and on confirm; in OpenCart 3 — on the events of the shipping, payment and confirm steps; in OpenCart 2.3 — the same steps through a modification the module registers itself.
• One library for three builds, the code is PHP 7.0 compatible; it also works with the pdo database driver in OpenCart 4.1.
• The MyGLS password — AES-256-CBC with HMAC, not shown again after saving.
• A Pro gate that never bricks the store: when the trial ends, only the Pro features stop; shipping and labels keep working.
• Uninstall removes the events and cron tasks; the module tables and a copy of the settings stay for a reinstall.

How to install

1. OpenCart 4: Extensions → Installer → upload cc_glscee.ocmod.zip (do not rename the archive) and click “Install”. OpenCart 3: Extensions → Installer → cc_glscee-oc3.ocmod.zip, then Extensions → Modifications → “Refresh”. OpenCart 2.3: upload the contents of the upload/ folder from cc_glscee-oc23.ocmod.zip to the store root (FTP or the hosting file manager).
2. Extensions → Extensions → Shipping → GLS CEE Shipping (MyGLS) → “Install”, then “Edit”.
3. OpenCart 2.3: Extensions → Modifications → “Refresh”. The module registers its modification itself, and the settings page reminds you until “Refresh” is clicked.
4. On the “MyGLS account” tab choose the account country, enter the login, password and client number and the sender details, and click “Save and test the connection”.
5. On the “ParcelShops & Lockers” tab tick the countries and click “Download now”; on the “General” tab turn the methods on and set the prices, the free shipping threshold and the weight limit.
6. Place a test order to a point and create a label from the order page.
7. For Pro: paste the licence key from the email after payment or turn on the trial on the “Licence” tab. For OpenCart 3 and 2.3 add the cron URL from the “Automation” tab to the hosting cron, once an hour.