GLS Shipment Setup
Central setup page for the GLS ShipIT REST API Connector. This is where API credentials, shipper address, and default settings for GLS shipping are configured.
Opening the Page
- Via search: GLS Shipment Setup
- Via the merchantCENTRAL Dashboard → Shipping Carriers → GLS
Fields
API Credentials
Credentials for the GLS ShipIT REST API v3.2.9.
| Field | Description |
|---|---|
| API Base URL | Base URL of the GLS ShipIT API |
| Sandbox Mode | Activates sandbox mode for test environments |
| Basic Auth User | Username for HTTP Basic Authentication |
| Basic Auth Password | Password for HTTP Basic Authentication (masked) |
GLS-specific Headers
The GLS API expects a special Accept header: application/glsVersion1+json. This is automatically set by the connector.
Account
| Field | Description |
|---|---|
| Contact ID | GLS Contact ID (assigned during GLS registration) |
Shipper Address
Shipper address for all GLS shipments.
| Field | Description |
|---|---|
| Shipper Name 1 | Shipper name (line 1) |
| Shipper Name 2 | Additional shipper name (line 2) |
| Shipper Name 3 | Additional shipper name (line 3) |
| Shipper Street | Shipper street |
| Shipper Street No. | Shipper house number |
| Shipper ZIP Code | Shipper postal code |
| Shipper City | Shipper city |
| Shipper Country Code | Country code (ISO alpha-2, e.g., DE, AT) |
| Shipper Contact Person | Contact person at the shipper |
| Shipper Email | Shipper email address |
| Shipper Phone | Shipper phone number |
Default Settings
Default values for label creation.
| Field | Description |
|---|---|
| Default Product | Default GLS product: PARCEL (BusinessParcel — national/EU/international), EXPRESS (ExpressParcel), FREIGHT (General cargo) |
| Default Weight (kg) | Default weight in kilograms (decimal value) |
| Default Label Format | Label format: PDF, PNG, ZEBRA (ZPL) |
| Default Template Set | GLS template set for label design: None (Default), ZPL 200 dpi, ZPL 300 dpi |
| Incoterm Code | Default Incoterm for international shipments (numeric, e.g., 10 = DDP, 20 = DAP, 30 = EXW) |
| Default Export Type | Default export type for customs declarations: P (Permanent/Sale), T (Temporary), R (Return). Default: P |
Tracking
GLS Print Formats in the Hub
The GLS Connector extends the hub print format with the following GLS-specific options: GLS A4 PDF, GLS Thermal ZPL 200 dpi, GLS Thermal ZPL 300 dpi. These are available in the hub shipping rules.
| Field | Description |
|---|---|
| Tracking URL Template | URL template for shipment tracking. The placeholder is replaced with the Track ID |
Status
Current status information for the GLS integration.
| Field | Description |
|---|---|
| Last Label Created | Date and time of the last created label |
| Labels Created Today | Number of labels created today (highlighted in green) |
| Last Error Message | Last error message from the GLS API (red on error) |
| Last Error DateTime | Timestamp of the last error |
Actions
| Action | Description |
|---|---|
| Test Connection | Tests the connection to the GLS ShipIT API with the current credentials |
Notes
GLS Specifics
- Country Codes: GLS uses ISO alpha-2 (e.g.,
DE) — unlike DHL, which uses ISO alpha-3 (e.g.,DEU) - Weight: GLS expects weights in kilograms (decimal), not in grams
- Errors in HTTP Headers: GLS error messages are returned in HTTP response headers (
X-GLS-ErrorCode,X-GLS-ErrorMessage,X-GLS-ErrorArgs), not in the JSON body
Singleton Page
This page has exactly one record. When opened for the first time, the record is automatically created.