How to connect GLS Italy

Do you need to connect GLS Italy or check the reference sent for an API-created shipment? Here's where to find connection instructions and how to understand the reported reference issue.

For connection instructions, read the Italian GLS Italy connection guide.

API-created shipments and RiferimentoCliente

Does GLS need your complete Amazon order number in RiferimentoCliente, without the Manual Shipment: prefix, to process Amazon notifications? Here's why that prefix appeared in the reported issue.

Orders created through the API, rather than imported through a direct ShippyPro marketplace integration, were classified as manual shipments. ShippyPro added the manual-shipment prefix to RiferimentoCliente in the request sent to GLS. The prefix was populated by ShippyPro, not added by GLS.

Can you use Bda instead?

The GLSItaly Bda tag contains only TransactionID, without additional wording. However, truncation of the Amazon order number was reported when this alternative was tested, so it is not a proven workaround for sending the complete reference.

⚠️ Important: The reported truncation does not establish a universal length limit for Bda.

For other carrier errors, see How to fix GLS Italy errors. For API basics, see How ShippyPro API works and how to integrate them.