Skip to main content
Odoo Community Association

Account Edi Ubl Cii Purchase Match

Beta License: AGPL-3 OCA/edi Translate me on Weblate Try me on Runboat

This module extends the UBL vendor bill import process to improve how vendor bill lines are linked to purchase order lines.

Instead of replacing the imported UBL lines with the purchase order lines (standard behavior), this module:

  1. Reads the OrderReference in the UBL document.

  2. Identifies the corresponding Purchase Order using the vendor reference (partner_ref) or the purchase order ref.

  3. Matches each UBL line with a purchase order line based on:

    • product name,

    • supplier product name

  4. Links the vendor bill line to the matched PO line

  5. When a user manually selects a purchase order line from the bill:

    • the system stores the supplier product name,

    • future imports will auto-match using that supplier information.

This ensures accurate line-level linking while preserving the supplier’s invoice data.

Table of contents

Use Cases / Context

In the standard behavior, when importing a vendor bill from a UBL document:

  • If a Purchase Order is found, all imported UBL lines are replaced by the Purchase Order lines.

  • This causes a loss of original UBL data, such as:

    • line-level descriptions,

    • quantities,

    • pricing,

    • tax information received from the supplier.

  • Additionally, the standard flow performs no matching based on product labels, so incorrect PO lines may be added if PO content does not reflect what is actually on the invoice.

Configuration

No configuration is required to use this module.

However, for optimal matching:

  • Ensure that OrderReference in the vendor UBL document corresponds to the Purchase Order Ref or the Vendor Reference (partner_ref).

  • Maintain consistent product names or supplier product names so that UBL line descriptions can be matched to the correct purchase order line.

Optional but recommended:

  • Define supplier product names (product.supplierinfo) to improve matching accuracy.

Usage

  1. Import a vendor bill in UBL format through: Accounting / Vendors / Bills / Upload

  2. The module will automatically:

    • Extract the OrderReference from the UBL.

    • Find the matching purchase order via partner_ref or purchase order ref.

    • Attempt to match each UBL line with the correct purchase order line using:

      • product name,

      • supplier product name

  3. When a match is found: the vendor bill line is linked to the purchase order line.

  4. If no match is found:

    • Click “Select purchase line” button in invoice line

    • Select a purchase order and a purchase order line

Known issues / Roadmap

This module implements custom purchase order line matching and replaces the standard behavior of linking vendor bills to purchase orders via UBL.

Before migrating to future versions, it is recommended to verify whether:

  • Odoo natively supports precise line-level matching,

  • supplier product names and UBL descriptions are matched out of the box,

  • and the original UBL lines are preserved.

If the standard behavior evolves to fully cover this business requirement, this module may become unnecessary.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

Credits

Authors

  • ACSONE SA/NV

Contributors

Maintainers

This module is maintained by the OCA.

Odoo Community Association

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

Current maintainer:

sbejaoui

This module is part of the OCA/edi project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

Metadata

Release files for odoo-addon-account-edi-ubl-cii-purchase-match 16.0.1.1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for odoo-addon-account-edi-ubl-cii-purchase-match 16.0.1.1.0.1
File Interpreter ABI Platform
odoo_addon_account_edi_ubl_cii_purchase_match-16.0.1.1.0.1-py3-none-any.whl Python 3 none any Details

Release files / odoo_addon_account_edi_ubl_cii_purchase_match-16.0.1.1.0.1-py3-none-any.whl

Download URL odoo_addon_account_edi_ubl_cii_purchase_match-16.0.1.1.0.1-py3-none-any.whl
Size 58.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e7ef76cd5a3f08c03b2de9daa790285f7cb280c6f79c0cd242e8447fafc1b235
BLAKE2b-256 checksum
How to use checksums
ce14226fc043cc9f6a789a75a7b1a035f1751fcc6bac5cfe029ced46fdc3964b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.4

Security for odoo-addon-account-edi-ubl-cii-purchase-match 16.0.1.1.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page