---
title: Troubleshooting common issues
description: "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**…"
url: "https://wpruby.com/knowledgebase/gls-canada-troubleshooting/"
updated: "2026-11-21"
category: WooCommerce GLS Canada Shipping Pro
---

# Troubleshooting common issues

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.

Table of Contents

 [Toggle](#)

- [GLS Canada rejected the API username or password (401)](#GLS_Canada_rejected_the_API_username_or_password_401)
- [Missing a role or permission (403)](#Missing_a_role_or_permission_403)
- [The billing account does not exist for the Parcel category](#The_billing_account_does_not_exist_for_the_Parcel_category)
- [No GLS rates at checkout](#No_GLS_rates_at_checkout)
- [Only GLS Ground is offered](#Only_GLS_Ground_is_offered)
- [GLS Canada rejected the request (400)](#GLS_Canada_rejected_the_request_400)
- [This order already has a GLS shipment](#This_order_already_has_a_GLS_shipment)
- [Live shipment creation is locked](#Live_shipment_creation_is_locked)
- [Shipment created, but the label could not be downloaded](#Shipment_created_but_the_label_could_not_be_downloaded)
- [This shipment is part of a pickup (when voiding)](#This_shipment_is_part_of_a_pickup_when_voiding)
- [Tracking says "Awaiting pickup" for a long time](#Tracking_says_%22Awaiting_pickup%22_for_a_long_time)
- [Tracking never updates](#Tracking_never_updates)
- [The PHP zip extension is required](#The_PHP_zip_extension_is_required)
- [The GLS Canada API did not respond in time](#The_GLS_Canada_API_did_not_respond_in_time)
- [The license will not activate](#The_license_will_not_activate)
- [Label files on nginx](#Label_files_on_nginx)

## 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 tech.support@gls-canada.com.

## 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](https://wpruby.com/submit-ticket/) and attach the (redacted) log.
