Despatch Advice Import Ubl

This module extends the despatch advice import feature to support UBL XML files, a standard format used for electronic documents. When a user imports a despatch advice file, the system automatically recognises the UBL format and extracts the key information.

• It reads the despatch advice number, the related order reference, the despatch advice type code, the issue date, and the estimated delivery date.
• It identifies the supplier and customer parties by their VAT numbers.
• For each line, it captures the line ID, the related order line ID, the product reference (seller's or buyer's item ID), the delivered quantity, the unit of measure, any outstanding (backorder) quantity, and the lot/serial number if present.
• If package details are included, it also reads the package name, type, and gross weight.
• The import will stop with an error if a line is missing its order line ID, ensuring data consistency.

The module works within the existing despatch advice import wizard, so users access it through the same menu or action used for importing despatch advices. It relies on the base UBL module for parsing common UBL elements like addresses and parties. No new menus or screens are added; it simply adds UBL support to the existing import process.