Italy: Orders that flag errors and cannot be processed due to invalid address

Italy: Orders that flag errors and cannot be processed due to invalid address

🧭GLS Italy: Error validating addresses

❓ Why does this error occur?
GLS Italy is particularly strict with address validation. Every time a shipment is generated, the GLS system checks the recipient's address against its own database . If it detects that any field does not match exactly—for example, the street number , the street name format , or any abbreviation details —the order is rejected and marked as an error.

🧩 Important:
Even if the address appears correct on Google Maps or in the original order, GLS may still reject it if it does not match its internal format.

⚠️ Example of a common case
  1. Address entered in the order: Nontolana number 110n
  2. GLS returns error: invalid address.
  3. Upon review, it is discovered that the number or format does not exactly match what GLS expects (the valid address is Via Nonatolala, 110 but Nontolana 110 was entered and the validator accepted it)
  4. Result: the order is not processed and remains blocked.

🧰 Solution: Automatic real-time address validation

We have included a feature that allows you to verify and correct the data directly from the system, before resubmitting the order.

This tool includes:
  1. A button to return the order to "Pending" status.
  2. An editable field to modify the address.
  3. A "Check address in real time" button, which validates the address against the GLS database.

🪜 How to solve the error step by step

  1. Open the order with the error : Locate the order in the "With Error and Review" column of the Orders module. Open it by clicking on the eye icon .
  2. Change the status to "Pending" : Use the yellow "Return to Pending" button. This will allow you to edit the shipment details.
  3. Edit the recipient's address : Pay special attention to: Street number, Street name (make sure it doesn't have any abbreviations other than those used by GLS), Postal code and city (just to confirm)
  4. Check the address in real time : Click the “Check address” button. A window will open showing whether the address is valid or not according to the GLS database.
  5. Correct if necessary : If the system indicates that it is not valid , modify the fields until it appears as correct .
  6. Save the changes : Once the address is accepted, save the order changes. The system will process it normally again.
  7. Confirm the final status : Verify that the order has changed from pending to confirmed . If it is already marked as confirmed, the problem is resolved ✅.

💡 Useful tips

  1. Always verify the address on Google Maps before entering it, but keep in mind that GLS may use a different format.
  2. If in doubt, try different variations of the number or format.
  3. If the error persists after several attempts, contact support to have them review the automatic validation.

✅ Expected final result

Once the address has been corrected and successfully validated:
  1. The order status changes to “Confirmed”.
  2. It is sent to GLS without errors.
  3. It is not necessary to repeat the process manually.