This module will support import despatch advice file
auto_awesome What this module does
AI-generated from the code · Odoo 19.0Lets you upload a supplier despatch advice (XML or PDF) and automatically update the matching purchase order receipt: confirm, postpone or cancel delivered quantities.
This module adds an import wizard for supplier despatch advices (delivery notes sent by vendors). You upload an XML file or a PDF that contains an embedded XML file, and Odoo reads it and applies the supplier's announcement to the corresponding incoming receipt.
Where it appears: - A menu entry "UBL Despatch Advice Importer" under the Purchase > Orders area opens a pop-up form. - The form has a file field, a file name field and a checkbox "Allow Validate Over Quantity" (on by default). - The "Import document" button runs the process; "Cancel" closes the window.
What it does:
- Reads the uploaded file, checks it is XML or PDF, and rejects other formats with an error.
- For PDFs, it looks for an embedded XML file and tries to parse it.
- Matches the advice lines to purchase.order.line records and checks the purchase order reference.
- If the announced quantity equals the ordered quantity, the delivery is marked as confirmed.
- If the supplier announces more than ordered and the over-quantity option is enabled, the higher quantity is recorded.
- If the supplier announces nothing, the delivery is cancelled and a message is added.
- For partial deliveries, quantities are split: confirmed quantities are marked done, postponed quantities stay open for a backorder, and the rest is cancelled.
- Messages such as "Delivery confirmed by the supplier" or "Delivery cancelled by the supplier" are logged.
- The uploaded file is stored as an attachment.
It works on purchase orders, stock moves and receipts, and requires the XML format support module (for example UBL) to be installed for XML files.
Depends on
Required by other modules
Models and fields (1)
- despatch.advice.import · new modeldocument (XML or PDF Despatch Advice), filename (File Name), allow_validate_over_qty (Allow Validate Over Quantity)
Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 2 confirmed, 7 with no information of 9 versions.
Sources · Odoo 16.0
Confirmed on 2026-11-03 in branch 16.0 of OCA/edi.
terminal Installation and usage
OCA documentation · Odoo 19.0Configuration
Source · Odoo 19.0The final picking validation triggered from process_data is opt-in.
Validating the picking by default turns an import step into a workflow-orchestration step and introduces non-obvious side effects. Implicitly calling validation also breaks command/query separation and can make integration flows less predictable and less idempotent.
The default picking validation was introduced in version 16.0: f9a4c0f#diff-ba317b47ca5c669f7eb8f157d21581ec7a424e672eccfdf785c0cf2dc97517aaR191 It was removed from the base module and made opt-in in version 19.0.
By default, the wizard only applies despatch advice data and does not validate the picking.
To enable it for a single execution, pass this context key when calling process_data:
- despatch_advice_import__picking_validation=True
No verified information in OCA: Installation, Usage.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.