Module overview

This module adds an AI-powered vendor bill import to Odoo (supplier/AP invoices). It lets you upload a PDF and automatically extract fields using pluggable OCR/AI providers - ideal for OCR vendor bills / vendor bills OCR use cases.

Also searched as OCR vendor bills, vendor bills OCR, supplier invoice OCR and AP invoices OCR.

Highlights:

• Clean UI action: Import vendor bill (AI) directly from the vendor bill form
• Pluggable providers: Mindee, Azure Document Intelligence, and Invoice2Data (local & free)
• Robust mapping: vendor detection (name/VAT), invoice number, international date parsing, totals & currency
• Configurable behavior:
  • Auto-create supplier if not found (or keep blank)
  • Import all lines or one single "totals" line (per-import)
  • Admin-defined extra labels per field (invoice number, date, vendor, VAT, totals...) to improve accuracy
• International: built-in multilingual labels + company locale aware date/currency detection
• Detailed Odoo logging for troubleshooting
• PDF attachment is saved on the created/updated bill

How it works

1. Install AZ AI OCR Vendor Bills (this base module) and at least one provider plugin from Apps.
2. Configure the provider in:
   Accounting → Configuration → Settings → AI OCR for Vendor Bills
   
   There you can:
   • Select the active provider
   • Enable/disable Auto-create supplier if not found
   • Set the default product for single-line imports
   • Add extra labels per field (comma-separated) to fine-tune extraction for your documents
   • Provider-specific keys/options (e.g., API keys)
3. Import a bill:
   Accounting → Vendors → Bills → New
   In the bill form, click Import vendor bill (AI), upload the PDF, and choose whether to import as a single "totals" line or full line items.
   
   
   

   The module will call the selected provider, normalize the response, create/update a draft vendor bill, and attach the original PDF. Extensive logs help diagnose mapping issues (e.g., labels or formats).

Configuration tips

• Set generic options for all providers in Settings → AI OCR for Vendor Bills and select provider from list.
• 
• Set the provider-specific configuration options.

International support

The heuristic layer is language-aware and uses your company locale for date and currency detection, while amounts are parsed with a country-neutral parser (no thousands separators, "," as decimal if needed internally). Out-of-the-box label sets cover many languages. You can extend them via settings with your own extra labels.

Built-in label coverage + admin extra labels work well with (including but not limited to):
ar, ca, de, es, eu, fr, gl, hi, it, nl, pl, pt, ru, tr, zh

Security & attachments

Imported PDFs are attached to the bill as standard Odoo attachments. Provider calls use the configured credentials. Please ensure you review your data processing and compliance requirements when using external AI services.

Provider plugins

Install one or more provider plugins. You can switch providers at any time in Settings.

• Invoice2Data (local, free)
  Module: az_invoice_provider_ai_ocr_invoice2data
  Requirements: invoice2data, plus either poppler-utils (pdftotext) or pdfminer.six.
  Notes: Works offline, provides heuristic fallback, configurable extra labels.
  
• Mindee
  Module: az_invoice_provider_ai_ocr_mindee
  Requirements: Mindee API key.
  Notes: High-quality invoice extraction; supports many locales and fields.
  
• More providers
  Additional plugins can be added following the same interface. Ask us if you need a specific provider.