Skip to Content

Mimik Ingest

by ,
Odoo

$ 289.76

v 19.0 Third Party
This module requires Odoo Enterprise Edition.
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Documents (documents)
• Discuss (mail)
Community Apps Dependencies
• Vault
• Foundation
• Base
Lines of code 16844
Technical Name nexumis_mimik_ingest
LicenseOPL-1
Websitehttps://praetorx.net
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Documents (documents)
• Discuss (mail)
Community Apps Dependencies
• Vault
• Foundation
• Base
Lines of code 16844
Technical Name nexumis_mimik_ingest
LicenseOPL-1
Websitehttps://praetorx.net

Mimik Ingest

SharePoint API Mimic — Scanner Document Ingestion for Odoo 19

v19.0.2.0.0 Enterprise Odoo.sh Requires Vault + Documents OPL-1

Turn any HP printer or SharePoint-compatible scanner into an Odoo document source. Mimik Ingest exposes a minimal SharePoint REST API and WebDAV surface so devices upload scanned documents directly into your Vault DMS inbox — with structured naming, audit logging, and optional AI processing.

praetorx.net | Syntax & Sabotage

Scanner Integration

SharePoint API Mimic

Exposes a minimal SharePoint REST API surface that HP printers and other SharePoint-compatible scanners recognize. Devices connect to Odoo as if it were a SharePoint site — no firmware modifications needed.

WebDAV Support

Full WebDAV endpoint (PROPFIND, PUT, OPTIONS) for HP printers that use WebDAV instead of the SharePoint REST API. Both protocols route to the same ingestion pipeline.

Structured Document Naming

Every uploaded document receives a sequential name using the pattern INB-YYYYMMDD-NNNN.pdf. The sequence is date-range aware and company-dependent.

Vault AI Pipeline

When auto-process is enabled on an ingest source, uploaded documents are automatically queued for Vault’s AI classification and extraction pipeline.

Complete Audit Trail

Every upload is logged with original filename, generated filename, file size, MIME type, source IP, auth user, request path, processing state, and timing. Failed uploads include error details and can be retried.

Ingest Source Configuration

Each printer/scanner gets its own source record with target folder, credentials, IP whitelist, auto-process toggle, and upload statistics. API URL is auto-computed and copyable.

Security

Authentication

HTTP Basic Auth per ingest source. Credentials are auto-generated (secure random username + 32-byte API key). Keys can be regenerated at any time. Domain prefix stripping handles DOMAIN\user format from HP printers.

Rate Limiting & IP Whitelist

5 failed auth attempts within 15 minutes triggers a 1-hour IP lockout. Optional IP whitelist per source restricts access to specific network addresses. Supports X-Forwarded-For for reverse proxy setups.

Upload Validation

500 MB file size limit. Allowed extensions: PDF, JPG, JPEG, PNG, TIFF, TIF, GIF, BMP. Invalid uploads are rejected before processing.

Access Control

Dedicated “Ingest Manager” security group for source configuration and log management. Documents users get read-only log access. Multi-company support with company-scoped sources.

Technical Reference

ComponentDetails
mimik.ingest.sourcePrinter/scanner configuration — name, source type (HP/Generic/API), target folder, Basic Auth credentials, IP whitelist, auto-process toggle, computed API URL and upload statistics
mimik.ingest.logUpload audit log — original + generated filename, file size, MIME type, source IP, processing state (received → created → queued → done / error), timing, retry action
documents.documentExtended with vault_ingest_source_id field to track which scanner/printer uploaded each document
SharePoint REST APIEndpoints: /_api/contextinfo (auth test), /_api/web/GetFolderByServerRelativeUrl/Files/add (upload), folder check, file info
WebDAVEndpoints: PROPFIND /_api/sites/... (folder check), PUT /_api/sites/... (file upload), OPTIONS (capability discovery)
ir.sequenceDocument naming: INB-%(y)s%(month)s%(day)s-NNNN, date-range aware, company-dependent

How It Works

1

Create Ingest Source

Configure your printer with credentials and target folder

2

Configure Printer

Enter the computed API URL in your printer’s SharePoint settings

3

Scan Documents

Use “Scan to SharePoint” on your printer as usual

4

Automatic Processing

Documents land in Vault with structured names and optional AI classification

Screenshots

Screenshots will be added in a future update.

Setup Guide

  • Odoo 19.0 Enterprise (required for the documents module)
  • Python 3.10+
  • Required modules: praetorx_vault, documents (Enterprise)
  • No external Python dependencies
  • No external services or API keys

Enterprise dependency. The documents module is part of Odoo Enterprise. This module does not work on Community Edition.

Install from the Odoo Apps menu. Search for “Mimik Ingest” or “Scanner”.

Mimik Ingest requires praetorx_vault and documents — these will be installed automatically as dependencies.

Upgrading from nexumis_mimik_ingest? A pre-init hook handles the migration automatically. Replace the module directory and run odoo -u praetorx_mimik_ingest. Existing ingest sources, logs, and sequences are preserved.

  1. Navigate to Documents → Ingest → Sources
  2. Click New and name the source (e.g., “Office Printer”)
  3. Select the Source Type: HP Printer (SharePoint API), Generic Printer (WebDAV), or Direct API
  4. Choose the Target Folder in Documents (e.g., “Inbox”)
  5. Credentials are auto-generated — copy them from the form
  6. Optionally set Allowed IPs for network-level restriction
  7. Enable or disable Auto-Process for Vault AI pipeline integration
  8. Click Test Configuration to verify the target folder exists

In your HP printer’s web admin panel, configure “Scan to SharePoint” with:

SharePoint Pathhttps://your-odoo.com/_api/sites/docs/Inbox
Domainyour-odoo.com
UsernameCopy from the Ingest Source form (auto-generated)
PasswordCopy the API Key from the Ingest Source form

The exact API URL is computed and displayed on the Ingest Source form — use the copy button to avoid typos.

View upload activity at Documents → Ingest → Upload Logs. The default filter shows today’s uploads.

Each log entry tracks: original filename, generated filename, file size, source IP, processing state, and timing. Failed uploads show the error message and can be retried.

The Ingest Source form also shows a stat button with total upload count and today’s uploads.

Ingest Manager: Full access to ingest sources (create, edit, delete) and upload logs (read, write). Implies Documents User.

Documents User: Read-only access to upload logs.

FAQ

Any printer or MFP that supports “Scan to SharePoint” or WebDAV file upload. This includes HP LaserJet Enterprise MFP series, HP OfficeJet Pro series, and other devices with SharePoint integration. The module also exposes a Direct API source type for custom integrations.
Yes. Mimik Ingest depends on praetorx_vault and documents. The documents module is part of Odoo Enterprise. Community Edition is not supported.
PDF, JPG, JPEG, PNG, TIFF, TIF, GIF, and BMP. Other file types are rejected at the endpoint level before any processing occurs. The maximum file size per upload is 500 MB.
After 5 failed authentication attempts within a 15-minute window, the source IP is locked out for 1 hour. Successful authentication clears the rate limit counter. The rate limit state is held in memory and resets on server restart.
Yes. Each ingest source has its own credentials, target folder, and configuration. Create one ingest source per printer or per department and point each to a different Documents folder. Each source has independent upload statistics and logs.
Replace the module directory and run odoo -u praetorx_mimik_ingest. A pre-init hook automatically renames the module records in ir_module_module and ir_model_data, so Odoo treats it as an upgrade. All existing ingest sources, logs, and sequences are preserved. No manual migration steps required.
The module works over both HTTP and HTTPS, but HTTPS is strongly recommended since credentials are sent via HTTP Basic Auth (base64-encoded, not encrypted). In production, always use HTTPS with a valid certificate.

Release History

v19.0.2.0.0 — March 2026

Current Release

  • BREAKING: Renamed module from nexumis_mimik_ingest to praetorx_mimik_ingest (ADR-008 brand retirement)
  • Version bumped to 2.0.0 to signal breaking change
  • Updated website URL to praetorx.net
  • Category changed to PRAETORX/Integrations
  • Added pre_init_hook for seamless upgrade from old module name

v19.0.1.0.0 — December 2025

Initial Release

  • SharePoint REST API mimic for HP MFP and compatible scanners
  • WebDAV endpoint (PROPFIND, PUT, OPTIONS) for HP WebDAV printers
  • Ingest Source model with per-device credentials, target folder, and IP whitelist
  • Ingest Log model with complete audit trail and retry action
  • Structured document naming via ir.sequence (INB-YYYYMMDD-NNNN)
  • Rate limiting: 5 failed attempts / 15 min → 1 hour lockout
  • Upload validation: 500 MB limit, file extension whitelist
  • Auto-process toggle for Vault AI pipeline integration
  • Multi-company support
  • i18n: English, German, French

You May Also Like

Vault DMS Required

AI-powered document management — classification, extraction, routing, and retention policies.

€199
SharePoint Sync

Bidirectional sync between Odoo Documents and Microsoft SharePoint Online.

€99
PraetorX Shell

Branded backend theme with sidebar, home tiles, activity dashboard, and per-role color theming.

Free
Cockpit

Role-based tile dashboard — counters, queues, charts, actions, and real-time updates.

Free

Made 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

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.