| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Documents (documents) |
| Community Apps Dependencies | Show |
| Lines of code | 15855 |
| Technical Name |
praetorx_vault |
| License | OPL-1 |
| Website | https://praetorx.net |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Documents (documents) |
| Community Apps Dependencies | Show |
| Lines of code | 15855 |
| Technical Name |
praetorx_vault |
| License | OPL-1 |
| Website | https://praetorx.net |
PraetorX Vault
AI Document Classification, Routing & Retention for Odoo 19
Transform Odoo Documents into an intelligent DMS. AI classifies, routes, and names your documents automatically. German legal compliance built-in — GoBD retention periods, ISO 27001 confidentiality levels, DSGVO data protection. Learns from every correction you make.
praetorx.net | Syntax & Sabotage
AI Processing Pipeline
Documents are automatically categorized with confidence scoring. Classifications above the threshold (default 0.7) are auto-applied; lower scores go to the review queue for human verification.
AI-scored folder matching routes documents to the right location. Two-tier confidence thresholds — high confidence routes automatically, lower confidence flags for review.
Text extraction from PDF (pypdf), Word (.docx), and Excel (.xlsx) documents. Scanned PDFs use Tesseract OCR, AI Vision, or hybrid mode (AI for page 1, Tesseract for the rest).
AI suggests structured filenames based on extracted data. Configurable naming patterns per classification — e.g., {class_code}_{YYYY}-{MM}-{DD}_{partner_short}.
Every correction feeds back into the AI as few-shot context. Routing decisions track corrections, compute learning outcomes (positive/negative), and weekly analysis generates improvement suggestions.
Daily, weekly, or monthly budget limits with automatic fallback to free Tesseract OCR when exhausted. Multi-threshold alerting (default 80% and 95%) with activity notifications.
German Compliance & Security
9 pre-configured German retention policies: 10 years tax/accounting (§147 AO), 6 years trade correspondence (§257 HGB), 30 years legal (§195 BGB), and more. Daily cron enforces retention states and sends expiry notifications.
Four levels — Public, Internal, Confidential, Restricted — with hierarchical clearance groups. Documents are filtered from search results and write/delete-protected based on clearance.
Users request access to confidential documents with justification. Classification managers approve or reject with audit trail. Approved requests grant the required clearance group automatically.
GoBD-compliant destruction workflow with confirmation wizard. Immutable audit records capture document name, classification, hash, and approval. CSV export for external auditors.
Company Template Sets
Pre-configured bundles of classifications, retention policies, confidentiality levels, folder structures, and routing rules. Apply a template set to a company via the wizard and get a complete DMS structure in one click.
Full German business: invoices, HR, payroll, contracts, insurance, GDPR, company docs.
Personal DMS: finances, tax, work, housing, health, insurance, social security.
Property management focus: extended retention for rental contracts and construction records.
Civil law partnerships: essential business categories with standard German compliance.
Corporate group: governance, investments, inter-company transactions.
Non-profit: simplified structure for membership management and association governance.
Processing & Infrastructure
Three-channel queue (urgent, default, bulk) with exponential backoff and dead letter handling. Cron processes every 5 minutes. Configurable batch size and max retries.
Aggregated metrics: retention expirations, classification coverage and confidence, processing queue state, storage by folder, AI budget usage, data quality compliance score.
SHA256 hash-based exact duplicates plus pgvector cosine similarity for near-duplicates (re-scanned PDFs). Configurable threshold (default 0.95). Newer duplicates moved to trash.
Full data isolation per company. Company-scoped classifications, retention policies, and budgets. Folder chatter notifications suppressed to prevent cross-company data leaks.
Technical Reference
| Component | Details |
|---|---|
| vault.classification | Hierarchical document categories with codes, keywords, naming patterns, and per-classification routing folders |
| vault.confidentiality.level | ISO 27001 security levels (Public / Internal / Confidential / Restricted) with clearance group binding |
| vault.retention.policy | Retention periods with legal basis, trigger field (document date or upload date), notification days, auto-delete option |
| vault.processing.queue | Three-channel queue (urgent/default/bulk) with exponential backoff, dead letter state, OCR method tracking |
| vault.routing.decision | AI routing audit trail — confidence, reasoning, correction tracking, learning outcome computation |
| vault.routing.improvement | AI-generated folder improvement suggestions based on routing correction patterns |
| vault.ai.budget | Global or per-company budget with daily/weekly/monthly periods, multi-threshold alerting, fallback-to-free |
| vault.classification.log | Classification audit trail — AI confidence, provider, accept/reject state, previous classification tracking |
| vault.dashboard | Aggregated metrics: retention, classification, processing, storage, security, AI budget, data quality |
| vault.company.template.set | Pre-built bundles (GmbH, Private, Real Estate, GbR, Holding, Verein) with wizard application |
| vault.retention.destruction.log | Immutable GoBD audit trail for destroyed documents — write/unlink blocked, CSV export |
| documents.document (ext) | Extended with classification, confidence, retention policy/date/state, confidentiality, document date, reference period, duplicate hash, AES-encrypted PII, AI processing state |
| Crons (5) | Queue processing (5 min), retention enforcement (daily), learning refresh (daily), routing improvement (weekly), decision archival (monthly) |
| Security | 5 groups (3 clearance + Classification Manager + Administrator), 42 access rules, 10 record rules |
| Tests | 202 test methods across 11 files — classification, confidentiality, retention, dashboard, documents, processing queue, security, AI integration, workflows, retention enforcement |
Screenshots
Screenshots will be added in a future update. Install the module to explore the full interface.
Setup Guide
- Odoo 19.0 Enterprise (requires
documentsmodule) - Python 3.10+
- Required Odoo modules:
foundation(PraetorX Foundation),documents,mail - Python packages:
pypdf,pytesseract,python-docx,openpyxl - System binary:
tesseract(Tesseract OCR engine) - At least one AI provider configured in Foundation (e.g., OpenAI, Azure)
Requires Enterprise. The documents module is Enterprise-only. Vault works on Enterprise and Odoo.sh.
- Install Tesseract OCR on your server:
apt install tesseract-ocr tesseract-ocr-deu - Install Python dependencies:
pip install pypdf pytesseract python-docx openpyxl - Install Foundation from the Odoo Apps menu (free, required dependency)
- Install Vault from the Odoo Apps menu
- Navigate to Settings → Foundation → AI Providers
- Add your provider (OpenAI, Azure, etc.) and verify the connection
- Navigate to Documents → Settings and select the Classification Provider under Vault Intelligence
- Optionally configure a separate OCR AI Provider (must support vision) for AI-based OCR
- Navigate to Documents → Configuration → Vault → Template Sets
- Select a template set (e.g., GmbH, Private, Real Estate)
- Click Apply to Company and select the target company
- The wizard creates classifications, retention policies, confidentiality levels, folder structures, and routing rules
Clearance — Internal: Access to Internal classified documents.
Clearance — Confidential: Access to Confidential documents (implies Internal).
Clearance — Restricted: Access to Restricted documents (implies Confidential).
Classification Manager: Manage classifications, approve access requests (implies Restricted clearance).
Administrator: Full Vault access — all configuration, processing, budgets (implies Documents Manager).
- Documents → Vault Dashboard — Aggregated metrics overview
- Documents → Vault → Review Queue — Low-confidence classifications awaiting human review
- Documents → Vault → Confidentiality → Classification Levels / Access Requests
- Documents → Configuration → Vault → Classifications / Folder Routing
- Documents → Settings — Vault Intelligence configuration (providers, thresholds, OCR, budgets)
FAQ
documents module which is Enterprise-only. You need Odoo 19 Enterprise or an Odoo.sh subscription.Release History
v19.0.3.2.1 — April 2026
Current Release
- i18n refactor: English source strings in Python/XML, German via
de.po
v19.0.3.2.0 — March 2026
- Classification review audit trail (approve/reject with chatter, rejection wizard)
- OCR & processing quality metrics on dashboard
- Routing decision archival (monthly cron, 180-day default)
- Budget multi-threshold alerting with fallback notifications
v19.0.3.1.0 — March 2026
- Retention lifecycle enforcement with daily cron and notifications
- Destruction confirmation wizard with GoBD-compliant audit log
- Near-duplicate detection via pgvector cosine similarity
v19.0.3.0.0 — December 2025
- Company Template Set system (GmbH, Private, Real Estate, GbR, Holding, Verein)
- Vault Dashboard with aggregated metrics
- Apply Template Set wizard
- French translations (fr_FR)
v19.0.1.0.0 — December 2025
Initial Release
- AI-powered document classification with confidence scoring
- ISO 27001 confidentiality classification (4 levels)
- German retention policies (GoBD, DSGVO)
- Tesseract OCR integration
- AI budget management
- Multi-company support with full data isolation
You May Also Like
Unified AI provider management, health monitoring, and shared core services for PraetorX modules.
FreeAI-powered invoice processing — extract data from scanned invoices and auto-create vendor bills.
€49Made with ♥ by Syntax & Sabotage
© 2026 Syntax & Sabotage, Lars Weiler. All rights reserved. OPL-1.
Impressum · support@syntaxandsabotage.io
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module