Start with Shipping Health: it checks the credentials, API connection, sender address, shipping zones, product data, currency, background jobs and label storage. For more detail, turn on Settings → Advanced → Debug logging and check WooCommerce → Status → Logs (source gls-canada). Passwords and personal data are redacted in the logs. The last GLS error for an order is shown in the Label Printer and in the order’s GLS Canada box.
GLS Canada rejected the API username or password (401)
Check the password and that you chose the right environment (Sandbox or Production). If they are correct, GLS Canada may not have enabled API access yet: email [email protected].
Missing a role or permission (403)
Your GLS user lacks a permission, for example "Rate View" for negotiated rates. Ask GLS Canada to grant it on your billing account.
The billing account does not exist for the Parcel category
Use your 6-digit Parcel billing account and ask GLS Canada to link it to your login.
No GLS rates at checkout
Check that GLS Canada is in the shipping zone, the address is in Canada with a valid postal code, the credentials and sender address are saved, and products have a weight (or set a default weight). Turn on Debug logging: store managers then see the reason at checkout.
Only GLS Ground is offered
GLS Air needs parcel dimensions. Add product dimensions, custom boxes or default parcel dimensions.
GLS Canada rejected the request (400)
Read the details under the message (for example an invalid postal code). If GLS requires references for your account, Test Connection lists them; set the Order reference type in Settings → Shipping Labels.
This order already has a GLS shipment
Void the existing shipment, or tick "Yes, create another billable shipment for this order".
Live shipment creation is locked
Production is selected but not confirmed. An administrator turns on Confirm live shipments in Settings → Account.
Shipment created, but the label could not be downloaded
Click Re-download from GLS in the Label Printer. It only downloads the label and never creates a new shipment.
This shipment is part of a pickup (when voiding)
GLS only deletes shipments that are not in a pickup. Delete the pickup in Labels Orders first.
Tracking says "Awaiting pickup" for a long time
Request a pickup for the shipment, then use Refresh tracking later.
Tracking never updates
Check WooCommerce → Status → Scheduled Actions for glsca_tracking_sync; WP-Cron must be running.
The PHP zip extension is required
Bulk label downloads need the PHP zip extension. Ask your host to enable it, or download labels per order.
The GLS Canada API did not respond in time
Increase the API timeout in Settings → Advanced.
The license will not activate
"Reached its site limit": deactivate the license on a site you no longer use. "For a different WPRuby plugin": use your GLS Canada key. "Could not be reached": your site cannot connect to wpruby.com; check your firewall or proxy. Shipping keeps working meanwhile.
Label files on nginx
Labels are stored in wp-content/uploads/glsca-labels/ with random names and are only served to logged-in staff. nginx ignores .htaccess; add location ~* /wp-content/uploads/glsca-labels/ { deny all; } to your server configuration.
Still stuck? Contact WPRuby support and attach the (redacted) log.