Settings
Open Add-ons > Manage add-ons > GLS Shipping Labels & Parcel Shops > Settings.
General
Section titled “General”| Setting | Default | Description |
|---|---|---|
| Enable | On | When off, no new label work is started. Tracking of existing labels goes on. |
| Marketplace owner mode | On | Multi-Vendor. On: every order is shipped with the marketplace owner’s MyGLS account, vendors only see their labels. Off: each vendor connects their own account and creates their labels. |
| Debug log | Off | Also stores every API call with the request shape and the answer. Passwords are never stored. |
| Log retention (days) | 90 | Older log entries are removed by the cron run. |
| Create the label when the order status becomes | empty | Empty = create labels by hand on the order page. |
| Also create a CS-Cart shipment | On | Records the parcel number as a regular shipment, so the customer’s order page and the shipment e-mail show the GLS tracking link. |
| Label format | A4_2x2 | The MyGLS printer type: A4_2x2 or A4_4x1 (A4 sheets), Connect, Thermo, ShipItThermoPdf (PDF), ThermoZPL (ZPL 203 dpi), ThermoZPL_300DPI (ZPL 300 dpi), ShipItThermoZpl (ZPL). |
| A4 start position | 1 | Quarter of the A4 page where the first label is printed (A4 formats only). |
| Cash on delivery payment method | empty | Orders paid with this method are sent with the order total as the COD amount and the order number as the COD reference. |
| Cash on delivery and insurance currency | empty | Empty = the currency of the MyGLS country (HUF, CZK, RON or EUR). The currency must exist in the store: amounts are converted from the primary currency. |
| Return label service | None | SRS (ShopReturnService) or PRS (Pick & Return Service) on return labels, if your contract includes it. |
| Default parcel weight (kg) | 1 | Used when the products of an order have no weight. |
| Send parcel weight and size | On | Sends the parcel properties (content, weight, size). Some GLS client numbers require them. |
| Package length / width / height (cm) | empty | Optional default parcel size. |
| Parcel content text | empty | Printed on the label. {order_id} becomes the order number. Empty = “Order |
| Pickup date: days from today | 0 | The pickup date sent to GLS: today in the store’s time zone plus this many days. |
| Send e-mail and phone number to GLS | Off | For home deliveries the customer’s e-mail and phone are only sent when a service needs them (FDS, FSS, SM2, SAT). Deliveries to a GLS point always send them (GLS requires them). |
| GLS point countries | HU,CZ,SK,RO,SI,HR | Countries whose GLS ParcelShop and Parcel Locker list is kept for the checkout. GLS publishes the list for AT, BE, BG, CZ, DE, DK, ES, FI, FR, GR, HU, HR, IT, LU, NL, PL, PT, RO, SK, SI. |
Connection
Section titled “Connection”Credentials are entered on the Connection page (Orders > GLS shipments > Connection) and stored encrypted (AES-256-GCM, key derived from your store’s own secret). They are never shown again; leave the password empty to keep the saved one. Only the SHA-512 hash of the password is sent to GLS, as the MyGLS API requires.
| Field | Description |
|---|---|
| MyGLS country | The country of your GLS contract: Hungary, Czech Republic, Slovakia, Romania, Slovenia or Croatia. |
| Mode | Test uses the test credentials and the MyGLS test system; Live the live ones. |
| MyGLS user name (e-mail) / password | Your MyGLS login. |
| GLS client number | The client number of your GLS contract (digits). Test and live can differ. |
| Sender | Name, street, house number (digits), house number addition, postal code, city, country, contact person, phone, e-mail. Empty = the company address of the store or vendor. |
The same page shows the stored GLS point lists per country with the date of the last download, and a button to download them now.
Shipping methods
Section titled “Shipping methods”Each GLS method has a Configure tab:
| Field | Description |
|---|---|
| Price | Flat price for the customer, in the primary currency. |
| Price by weight | Optional pairs “up to kg = price”, e.g. 2=990, 5=1290, 40=2490. |
| Free shipping from | Order subtotal from which the price is 0. |
| Countries (zone) | Destination countries, e.g. HU, SK, CZ. For the ParcelShop method, list only countries whose point list is kept. |
| Maximum weight (kg) | Hides the method for heavier carts. |
| Delivery time text | Shown next to the price. |
| Extra GLS services | FDS, FSS, SM2, INS, 24H, T09, T10, T12, SAT, TGS. Use only the services your contract and country include. On the ParcelShop method FDS and FSS are left out. |
The queue runs from cron (labels at a status, tracking every two hours, the daily point list download):
php /path/to/store/admin.php --dispatch=kv_gls.cronhttps://your-store.example/index.php?dispatch=kv_gls.cron&key=<secret>
Log and jobs
Section titled “Log and jobs”- Log lists every call and job with filters (level, action, text, dates) and a CSV export.
- Jobs lists the queue. A failed job is retried after 5 minutes, 15 minutes, 1 hour, 3 hours and 12 hours, then marked “Gave up”; Retry queues it again. Label creation is never retried when GLS may already hold the parcel (see Usage, “Result unknown”).