Error when transferring to GLS
Overview of typical GLS transfer errors in Shoporama and solutions for them.
When you transfer orders to GLS from Shoporama, errors may occur. Here are the most common errors and their solutions.
"Not allowed to generate shipments"
This error means that your GLS customer number does not have permission to create shipments via the API. It must be activated by GLS.
Solution:
- Call GLS IT at 76 33 12 35
- Ask them to activate API access for your customer number
- It typically only takes a few minutes for it to be enabled
Invalid address
GLS validates the recipient’s address. If the address is incomplete or contains errors, the shipment will be rejected.
Solution:
- Verify that the order has a valid address, ZIP code, and city
- Check that the country code is correct (e.g., DK for Denmark)
- Remove any special characters or invalid characters from the address fields
Incorrect package shop ID
If the customer has selected a pickup location for delivery, but the pickup location’s ID is invalid or the pickup location is closed, the transfer may fail.
Solution:
- Verify that the package shop ID is correct on the order
- Try changing the delivery method to a different pickup location or direct delivery
The recipient is missing a first name or last name
If the package is being sent to a package shop, GLS requires that the recipient have both a first name and a last name. If the customer has entered only one name, GLS will reject the shipment, and the order queue will indicate that the recipient must have both a first name and a last name when the package is sent to a package shop.
Solution:
- Click “Edit Order ” under the error in the order queue.
- Enter the recipient’s full name and save the order.
- Return to the order queue and click " Try Again."
GLS’s system did not respond
If the order queue shows that GLS's system did not respond, there was a temporary error on GLS's end. No package has been created, so feel free to click "Try Again " in a little while.
Deposit Service without instructions
If you’ve enabled Deposit Service for a GLS shipping method, the driver must leave the package, for example, at the door. GLS then requires a note specifying where the package should be left. Shoporama uses the customer’s comment on the order, and if the customer hasn’t written anything, the text in the “Default Comment” field for the shipping method. If both are empty, the label will not be sent to GLS. It will appear as “Failed” in the order queue with an explanation that neither the customer nor the shipping method has specified where the package should be left. No package has been created with GLS.
Shoporama does not automatically switch to standard delivery, because you may have promised the customer that the package will be left at a specific location. You can choose between two options:
- Write a standard text and try again. Go to Delivery → Shipping Methods, edit the GLS shipping method, and enter, for example, “Leave at the front door” in the “Default comment” field under GLS settings. Then click “Try Again” next to the label in the order queue. The text will be used going forward for all orders where the customer hasn’t provided their own text.
- Send as standard delivery. Click “Send as standard delivery” next to the label in the order queue. The label will then be created without Deposit Service, the package will not be left at the door, and the order will include a note stating that it was sent as standard delivery at the store’s discretion. This selection applies only to that one label. If there are multiple GLS packages with the same error, you can send them all at once by selecting “Send all as standard delivery” at the top of the order queue.
Read more about the customer’s comment, the default text, and Deposit Service in “Comments on GLS Orders.”
Incorrect API Information
If your GLS API credentials are incorrect, no transfers will work. You can find them under Delivery → Setup in the GLS section.
Check the following fields:
- API Username, your GLS API login
- API Password, your GLS API password
- Customer ID, your GLS customer number
- Contact ID, your GLS contact ID
Tip
If a GLS label fails, it will appear in the order queue under Orders → Order Queue. Select "Failed" in the filter, and the error will be explained in Danish in the "Response" column, along with links to where you can fix it, such as "Correct the order " or " Go to delivery setup." Click Details to view GLS’s exact response. Once the error is fixed, click Try Again. Shoporama does not automatically retry, so you’ll avoid duplicate labels.
Still having problems?
If you continue to experience errors after following the steps above, you can:
- Contact GLS IT at 76 33 12 35 to verify your account configuration
- Contact us at support@shoporama.dk with the exact error message
Related articles
GLS settings on shipping options
Explanation of the GLS-specific settings for each shipping option in Shoporama: Parcel Shop, DepositService, PrivateDelivery, FlexDelivery, and...
Checkout flow and shipping calculation
Guide for developers to implement shipping in the checkout flow of a Shoporama theme.
DHL Parcel Shop
Guide to setting up DHL parcel shop as a shipping method in Shoporama. Let customers choose the nearest DHL ServicePoint at checkout.