Quick Start
Your first complete GLS shipment from a sales order in the sandbox, with verification and the subsequent switch to production.
In this procedure, you ship a sales order from start to finish: create packages, transmit them to GLS, check the label and print it. Work in a Business Central sandbox with GLS sandbox credentials. Switching to production follows at the end as a separate step.
Prerequisites
The app is installed, with the GLS Super User (setup) or GLS Integration User (shipping) permission set.
Setup completed with the Sandbox environment and a successful Test Connection.
At least one GLS box or a default maximum weight.
A test customer with a complete domestic ship-to address and an item with a maintained weight. Use fictitious test data or the test addresses provided by GLS.
Label format PNG if you want to test integrated printing.
Procedure
Create packages
On the sales order, choose GLS Shipping → Distribute Items to Packages.
Explicitly set Number of Packages to 1; the dialog initially suggests 2.
If required, select a suitable Box Code and confirm with OK.
The app creates the package and its item lines with the distributed quantities. No package needs to exist beforehand, and you do not need to add the same items again. Nothing is transmitted to GLS yet.
This action replaces any existing packages of the order that have not been uploaded yet. Therefore, start the quick start with a new test order. Packages that have already been uploaded are kept.
For automatic suggestions, use Smart Packing later. Create Multiple Packages, in contrast, initially creates empty package headers. Details: Multi-Package and Batch Processing.

Check the packages
Open the created packages, for example through GLS Packages.
Check the items and quantities, recipient, actual total weight, box, product and service.
Correct the weight if it does not match the actual package.


Transmit to GLS
On the sales order, choose Upload Packages to GLS.
Before transmission, the app checks, among other things, the weight (fixed upper limit of 40 kg and box maximums), the incoterm for shipments crossing a customs border, and the pickup date for pickup services.
All open packages of the order are transmitted to GLS as one shipment. If there are several open packages, the shipment contains several parcels.
Check the result
Open the package card. Uploaded is selected, and Parcel Number, Track ID and Upload Date are filled in. With PNG, you see the image in the Label section.
Choose Download Label and check the address, product and legibility.
On the sales order, choose Print GLS Labels and print through your usual Business Central print option.



English names in the screenshots
The example images show the German interface. Use these equivalents when following the English instructions.
GLS Shipping
GLS-Versand
Distribute Items to Packages
Artikel auf Pakete verteilen
Number of Packages
Anzahl Pakete
Upload Packages to GLS
Pakete an GLS übertragen
Generate Label
Etikett generieren
Download Label
Etikett herunterladen
Print Label
Etikett drucken
Reprint Label
Etikett erneut drucken
Print GLS Labels
GLS-Etiketten drucken
GLS Generate Labels
GLS Etiketten erzeugen
Transmit to GLS
An GLS übertragen
Skip Orders with Packages
Aufträge mit Paketen überspringen
If something goes wrong
Transmission is rejected with a weight message
Correct the weight or the box selection; if necessary, distribute the items across several packages
Message about a missing incoterm
Check the ship-to address; for an international shipment, set the incoterm on the package card
Timeout or unclear response
Do not transmit again immediately. First check the package card, the API call log and GLS
No image in batch printing
Use the PNG label format; see Labels, Printing and Tracking
More cases: Monitoring and Troubleshooting.
Switching to production
Verify production separately; a successful sandbox test does not carry over automatically.
Install the app in the production environment and assign the permissions.
Open the wizard, select the production environment and confirm the warning.
Enter the new Client ID, Client Secret and Contact ID of your production credentials. Empty fields would keep the previous values.
Choose Test Connection and then Finish.
Create boxes and master data if they do not exist yet.
Before the first real shipment, confirm with GLS that the products and services you use are approved.
Then ship a first real order in a controlled way and check the label, printing and track ID.

