User Manual – Invoices Reader

Introduction

Welcome to the Invoices Reader – a modern, intelligent application designed to process and extract data from invoice images with advanced AI capabilities.

Key Features:

• Multi-Format Support: Processes various invoice formats including Saudi and Egyptian e-invoices
• AI-Powered Processing: Uses advanced AI models (Gemini, Ollama, OpenRouter, LM Studio) for accurate data extraction
• QR Code Reading: Specialized support for Saudi and Egyptian QR codes
• Batch Processing: Process multiple invoices simultaneously
• Database Management: Store and manage processed invoice data with advanced filtering
• Export Options: Export data to Excel, CSV, and PDF with field selection
• Bilingual Interface: Full support for Arabic and English languages
• Advanced Filtering: Powerful search and filter capabilities with auto-apply and manual modes
• Enhanced Sync System: Detailed results dialog with user-friendly error messages in Arabic and English
• Multiple Accounting Systems: Wafeq and Odoo integration with extensible architecture
• Progress Tracking: Real-time synchronization monitoring with cancellation support
• Export Sync Results: Save detailed synchronization reports
• Improved Decimal Precision: All monetary values rounded to 2 decimal places
• PDF Export with Arabic Support: Professional PDF exports with proper Arabic text rendering

System Requirements

Minimum Requirements:

• Operating System: Windows 10 or later
• RAM: 4 GB minimum, 8 GB recommended
• Storage: 2 GB free space
• Internet Connection: Required for cloud AI modes (Gemini, OpenRouter); LM Studio and Ollama operate locally once models are installed

Recommended Requirements:

• RAM: 16 GB for optimal performance
• GPU: NVIDIA GPU for local Ollama processing
• Storage: SSD for faster processing

Installation

1. Download the latest version from the official repository
2. Extract the files to your desired location
3. Run main.py to start the application
4. On first run, select your preferred language (Arabic or English)
5. Configure your AI settings if needed

Note: Python 3.8 or later is required. All dependencies are included in the package.

Getting Started

First Launch:

1. Launch the application
2. Select your preferred language (Arabic/English)
3. Choose a processing mode suitable for your invoices
4. Configure AI settings if using AI processing modes

Basic Workflow:

1. Select Processing Mode: Choose the appropriate mode for your invoice type
2. Open Invoice Folder: Select the folder containing your invoice images
3. Start Processing: Click “Start Processing” to begin
4. Review Results: Check extracted data and make corrections if needed
5. Export Data: Save results to Excel, CSV, or PDF

Processing Modes

The application offers several processing modes optimized for different invoice types and requirements.

Saudi E-Invoice QR Mode

• Purpose: Optimized for Saudi Arabian e-invoice QR codes
• Speed: Very fast processing
• Accuracy: High accuracy for Saudi tax authority format
• Requirements: No internet connection required
• Best For: Saudi businesses processing ZATCA-compliant invoices

Egyptian E-Invoice QR Mode

• Purpose: Optimized for Egyptian e-invoice QR codes
• Speed: Very fast processing
• Accuracy: High accuracy for Egyptian tax authority format
• Requirements: No internet connection required
• Best For: Egyptian businesses processing ETA-compliant invoices

AI Processing Modes

GEMINI – Smart Processing

• Provider: Google Gemini AI
• Speed: Fast processing
• Accuracy: Very high accuracy
• Requirements: Internet connection and API key
• Cost: Pay-per-use (very affordable)
• Best For: High-volume processing with excellent accuracy

OLLAMA – Local Processing

• Provider: Local AI models
• Speed: Moderate (depends on hardware)
• Accuracy: Good accuracy
• Requirements: No internet required, local GPU recommended
• Cost: Free (uses local resources)
• Best For: Privacy-focused processing, offline environments

OPENROUTER – Cloud AI

• Provider: Multiple AI models via OpenRouter
• Speed: Very fast processing
• Accuracy: Excellent accuracy
• Requirements: Internet connection and API key
• Cost: Various pricing options, many free models available
• Best For: Access to cutting-edge AI models

LM STUDIO – Local Processing

• Provider: LM Studio desktop/server app
• Speed: Fast to moderate (depends on server/local machine)
• Accuracy: High accuracy
• Requirements: LM Studio application installed and running, OpenAI-compatible API endpoint
• Cost: Free (uses local resources)
• Best For: Advanced local processing with custom models

Switching Processing Modes

1. Go to Tools → Settings → Processing Mode
2. Select the desired processing mode
3. Click Apply to confirm
4. The new mode will be saved and used for future processing

Tip: The application remembers your last selected mode and will restore it on next startup.

AI Settings

Configure AI processing options by going to Tools → Settings → AI Models.

Google Gemini Setup

1. Obtain a Gemini API key from Google AI Studio
2. Open AI Settings and go to the Gemini tab
3. Enter your API key
4. Select your preferred model:
   • Gemini 2.0 Flash Lite: Fastest, 30 requests/minute
   • Gemini 2.0 Flash: Balanced speed and accuracy, 15 requests/minute
   • Gemini 2.0 Flash Thinking: Highest accuracy, slower, 10 requests/minute
   • Gemini 2.5 Pro: Premium model, 2 requests/minute
5. Click Test Connection to verify
6. Save settings

Ollama Setup

1. Install Ollama on your system
2. Pull a vision-capable model (e.g., ollama pull llava)
3. Open AI Settings and go to the Ollama tab
4. Configure server address (default: http://localhost:11434)
5. Select GPU index if you have multiple GPUs
6. Choose your installed model from the dropdown
7. Click Test Connection to verify
8. Save settings

Note: Ollama requires significant system resources. A GPU with at least 8GB VRAM is recommended for optimal performance.

OpenRouter Setup

1. Create an account at OpenRouter.ai
2. Generate an API key from your dashboard
3. Open AI Settings and go to the OpenRouter tab
4. Enter your API key
5. Choose a model:
   • Type a model name directly (e.g., google/gemini-flash-1.5)
   • Use the “Popular Models” dropdown for quick selection
   • Click “Fetch Free Models” to see available free options
6. Optionally configure site URL and name
7. Click Test Connection to verify
8. Save settings

Tip: OpenRouter offers many free models. Use the “Fetch Free Models” feature to discover the latest available options.

LM Studio Setup

1. Install the latest version of LM Studio on your machine
2. Launch LM Studio and enable the OpenAI Compatible Server (default endpoint: http://localhost:1234)
3. Download or import a vision-capable model inside LM Studio (for example, lmstudio-community/phi-3.1-vision-instruct)
4. Open the application’s AI Settings dialog and switch to the LM Studio tab
5. Confirm the server endpoint, provide an API key if you configured one in LM Studio, and enter the exact model identifier
6. Adjust the timeout if needed, then click Test LM Studio Connection to verify connectivity
7. Click Save LM Studio Settings to persist the configuration

Note: LM Studio keeps all processing on your local machine. Ensure the application remains running in the background while Invoices Reader requests predictions.

Main Interface

Figure 1: Main interface of the Invoices Reader application

The main interface consists of:

• Top toolbar (contains main functions)
• Image display area (with smaller navigation buttons to provide more display space)
• Invoice information panel
• Bottom status bar (shows current processing mode)

Toolbar

Figure 2: Main toolbar with available functions

The toolbar contains the following main functions:

• New Operation: Create a new batch of invoices
• Open Folder: Select a folder containing invoices
• History: View previous invoice records
• Processing Mode: Choose invoice processing method
• Settings: Configure AI, Integrations, and Application preferences
• User Manual: View comprehensive user guide

Keyboard Shortcuts

To make the application easier to use, the following shortcuts are available:

Function	Shortcut
Open Folder	Ctrl+O
Start Processing	Ctrl+P
Stop Processing	Ctrl+S
Previous Image	Left Arrow
Next Image	Right Arrow
View History	Ctrl+H
User Manual	F1
Focus Search (Advanced Tab)	Ctrl+F
Clear All Filters (Advanced Tab)	Esc
Reset Filters (Advanced Tab)	Ctrl+R
Apply Filters (Manual Mode)	Enter

Main Features

Opening Invoice Folders

1. Click File → Open Folder or use the toolbar button
2. Select the folder containing your invoice images
3. Supported formats: JPG, PNG, PDF, TIFF
4. The application will load and display all compatible files
5. The folder path will appear in the window title for easy reference

Processing Mode

The application provides several modes for processing invoices:

QR Code Reading Modes

• Saudi einvoice qr code – fast: For reading Saudi e-invoice QR codes
• Egyptian einvoice qr code – fast: For reading Egyptian e-invoice QR codes

AI Processing Modes

• GEMINI – fast: Uses Google Gemini AI model (requires API key)
• OLLAMA – slow: Uses local Ollama models (works offline)
• OPENROUTER – fast: Uses OpenRouter AI models (requires API key)
• LM STUDIO – local: Uses the LM Studio desktop/server app to run local models through an OpenAI-compatible API

To change processing mode:

1. Click the “Processing Mode” button in the toolbar
2. Select the appropriate mode for your invoice type
3. Click “Apply” to activate the new mode

Invoice Processing

1. Ensure you have selected the appropriate processing mode
2. Open the folder containing your invoices
3. Click Start Processing
4. Monitor progress in the status bar
5. Processing will stop automatically when complete
6. Review extracted data in the results table

• The application supports PDF files and images
• A progress bar is displayed during processing
• You can navigate between invoices using arrow keys

Note: Processing speed depends on the selected mode, number of invoices, and system performance.

QR Code Reading

The application includes specialized QR code readers for:

• Saudi E-Invoices: ZATCA-compliant QR codes
• Egyptian E-Invoices: ETA-compliant QR codes

QR code processing is automatic when using the corresponding processing modes.

Data Extraction

The application extracts the following data from invoices:

• Invoice number
• Invoice date
• Supplier/vendor information
• Customer information
• Tax numbers
• Total amounts
• Tax amounts
• Line items (when available)

Database Management

The invoice history window provides an advanced interface for searching, filtering, and managing previously processed invoices. You can access it through:

• Clicking the “History” button in the main interface
• Selecting File → Database from the menu

Batch View

The window contains two main tabs. The first “Batch View” tab displays a list of all processed invoice batches:

• You can filter batches by a specific date range
• You can load a complete batch to display in the main interface
• You can export a complete batch to an Excel file
• You can delete a complete batch from the database

Advanced View

The second “Advanced View” tab provides an advanced interface for viewing and filtering all individual invoices:

• Search: You can search for invoices using supplier name, invoice number, or tax number
• Filter by Supplier: You can select a specific supplier from the dropdown list
• Filter by Date: You can specify a date range for invoices
• Filter by Amount: You can specify a range for invoice amounts

You can also:

• Load a specific invoice in the main interface
• Export search and filter results to an Excel file
• Delete a specific invoice from the database

Vendor Trust Center 🛡️

The Vendor Trust Center acts as a centralized hub to ensure your vendor database remains clean, accurate, and free of duplicates.

Key Features:

• Smart Duplicate Detection: Automatically identifies vendors that are likely the same entity based on name similarity or identical Tax IDs.
• Merge Suggestions: Instead of blindly merging, the system creates “Merge Suggestions” for you to review.
• Deep Comparison: Side-by-side comparison of contact details (Address, Phone, etc.) before merging.

How to Deduplicate Vendors:

1. Go to Tools → Vendor Trust Center.
2. Click Run Batch Deduplication.
3. Review the list of “Pending Suggestions”.
4. For each suggestion, click Review to see details.
5. Click Approve Merge to combine them (updating all historical invoices) or Reject to keep them separate.

Note: Merging vendors is a powerful action that updates all past invoices to point to the primary vendor. This action is backed by a safety rollback system.

Plugins System

The application now features a powerful generic Plugins System that allows extending functionality without modifying the core software.

Managing Plugins

Plugins are automatically discovered from the plugins folder. You can view loaded plugins in the startup log or the new Plugins menu.

Included Plugins

Smart Exporter 📊

An advanced export tool that allows verifying batch data and exporting specific fields.

• Batch Verify: Quickly check data quality for the whole batch.
• Export to Excel/CSV: Flexible export of current batch data with customizable columns.
• Statistics: View quick charts about your invoice data.

Telegram Integration 📱

Send invoices directly from Telegram to your desktop application.

• Bot Integration: Connect a Telegram bot to receive files.
• Queue System: Files are queued for processing when you are ready.

Vendor Insights 🛡️

Enhances vendor management with data quality tools.

• Auto-Tagger: Automatically categorizes vendors based on history.
• Trust Score: Evaluates data consistency for each vendor.

Advanced Features

Advanced Tab Features

The Advanced tab in the Database window provides powerful filtering and export capabilities:

Filter Modes

• Auto-Apply Mode: Filters are applied automatically as you type or change filter values. This is the default mode for quick filtering.
• Manual Apply Mode: Filters are only applied when you click the “Apply Filters” button. Use this mode when you want to set multiple filters before applying them.

To switch between modes:

1. Click the “Auto Apply” toggle button in the Advanced tab
2. When disabled, the “Apply Filters” button will appear
3. Click “Apply Filters” to manually apply your filter settings

Loading Indicators

When filters are being applied, a loading indicator appears to show that the system is processing your request. Filter controls are temporarily disabled during this time to prevent conflicts.

Advanced Filtering

The Advanced tab offers comprehensive filtering options:

Text Search

• Search across multiple fields: supplier name, invoice number, tax number
• Real-time search results (in auto-apply mode)
• Case-insensitive matching

Vendor Filter

• Select one or more vendors from the dropdown list
• Filter invoices by specific suppliers
• Multiple selection supported

Date Range Filter

• Filter invoices by date range
• Select start and end dates
• Clear date filters easily

Amount Range Filter

• Filter by minimum and maximum invoice amounts
• Set either minimum or maximum, or both
• Useful for finding invoices within specific price ranges

Filter Chips

Active filters are displayed as chips above the table. You can:

• See all active filters at a glance
• Remove individual filters by clicking the X on each chip
• Quickly understand what filters are currently applied

Keyboard Shortcuts for Filtering

Action	Shortcut
Focus Search Field	Ctrl+F
Clear All Filters	Esc
Reset Filters	Ctrl+R
Apply Filters (Manual Mode)	Enter

Export Options

The application provides flexible export options with field selection:

Export Formats

• Excel (.xlsx): Professional spreadsheet format with formatting
• CSV (.csv): Comma-separated values for compatibility
• PDF: Professional document format with invoice images

Export Types

• Simple Export: Invoice summary only (header information)
• Detailed Export: Includes line items for each invoice

Field Selection

When exporting, you can choose which fields to include:

• ID Number
• Batch Number
• Supplier Name
• Invoice Number
• Invoice Date
• Tax Number
• Total Amount
• Tax Amount
• Subtotal
• Currency
• Due Date
• Discount
• Amount Due
• Customer Name
• Customer ID
• Customer VAT ID
• Purchase Order
• Payment Terms
• Vendor Address
• Customer Address
• Invoice Category

Export Sources

• Selected Invoices: Export only the invoices you’ve selected in the table
• Filtered Results: Export all invoices matching your current filters
• Entire Batch: Export all invoices in a specific batch
• Multiple Batches: Export invoices from multiple batches in a single file

How to Export

1. Apply your filters or select invoices (if exporting selected items)
2. Click the “Export” button (Excel or PDF)
3. In the export options dialog:
   • Choose export type (Simple or Detailed)
   • Select file format (Excel, CSV, or PDF)
   • Select Target System for accounting software compatibility
   • Select which fields to include (for Default format)
4. Click “Export” to save the file
5. Choose the save location and filename

Target System Export Formats

Export invoices in formats compatible with popular accounting systems:

System	Format	Key Fields
Default / ZATCA	Excel/CSV	Standard fields with custom selection
Odoo ERP	Excel	partner_id, ref, invoice_date, invoice_line_ids/*
ERPNext	Excel	Supplier, Supplier Invoice No, items.*
QuickBooks Online	Excel	Bill no., Supplier, Account, Line Amount
Zoho Books	Excel	Bill Number, Vendor Name, Tax Registration
Al-Ameen / Al-Manara	Excel (RTL)	Bilingual headers, item details

Note: When selecting a specific target system (other than Default), the “Simple Export” and custom field selection options are disabled to ensure all required fields are included for import compatibility.

PDF Export

PDF export creates professional documents with invoice images and metadata:

Features

• Invoice Images: Each invoice image is included in the PDF
• Text Overlay: Essential invoice information displayed at the bottom of each page:
  • Date
  • Invoice Number
  • Vendor Name
  • Invoice Total
• Arabic Text Support: Proper rendering of Arabic text with right-to-left alignment
• Single Line Format: Compact overlay that doesn’t cover the invoice image
• Multiple Pages: Each invoice appears on its own page

Export Options

• Export selected invoices
• Export filtered results
• Export entire batch
• Export multiple batches

Note: PDF export uses proper Arabic text shaping and bidirectional text handling for accurate rendering of Arabic content.

Batch Processing

• Process multiple invoices simultaneously
• Automatic progress tracking
• Error handling and recovery
• Batch results summary

System Integrations 🔗

The application supports integration with multiple accounting systems for automatic invoice synchronization. Access integration settings through:

• Click the “Integrations” button in the main interface
• Select Tools menu → Accounting System Integrations

Supported Systems

1. Wafeq System 💰

Advanced cloud-based accounting system with Saudi e-invoice support.Setup Steps:

1. Go to the “Wafeq” tab in the integration dialog
2. Enter your Wafeq account API key
3. Click “Test Connection” to verify settings
4. Save the configuration

Features:

• Automatic vendor bill creation
• Invoice attachment upload (PDF images)
• Multi-line item support
• Automatic tax and discount calculations
• Automatic vendor/contact creation

2. Odoo System 🏢

Open-source Enterprise Resource Planning (ERP) system.Setup Steps:

1. Go to the “Odoo” tab in the integration dialog
2. Enter your Odoo server URL
3. Enter the database name
4. Enter username and API key
5. Click “Test Connection” to verify settings
6. Save the configuration

Features:

• Vendor bill creation
• Automatic product/service creation
• Link invoices to accounting accounts
• Tax and discount support
• Invoice attachment upload

Invoice Synchronization 🔄

After configuring integration with an accounting system, you can synchronize invoices:Synchronization Steps:

1. Open the invoice database dialog
2. Select the batch you want to synchronize
3. Click the “Sync” button
4. Choose the target accounting system (Wafeq or Odoo)
5. Monitor progress in the popup dialog

Enhanced Results Dialog 📊

The new results dialog provides detailed information about each invoice:New Features:

• Statistical Summary: Count of successful and failed invoices
• Detailed Table: Information for each invoice (status, invoice number, vendor, amount)
• User-Friendly Error Messages: Clear messages in English and Arabic
• Expandable Technical Details: Detailed technical information for developers
• Export Results: Save synchronization results to CSV file

Error Message Types:

• ✅ Sync Successful: Invoice synchronized successfully
• ❌ Decimal Precision Error: Numbers must have maximum 2 decimal places
• ⚠️ Attachment Upload Failed: Problem uploading invoice file
• 🔐 Authorization Error: Check API key
• 🌐 Connection Error: Check internet connection
• ⏰ Timeout Error: Server not responding

Canceling Synchronization:

You can cancel the synchronization process at any time by clicking the “Cancel” button in the progress dialog.

Tips for Successful Synchronization:

1. Test Connection: Always test connection before starting sync
2. Review Data: Ensure invoice data accuracy before synchronization
3. Start Small: Try synchronizing a few invoices first
4. Save Results: Use export feature to save sync reports
5. Review Errors: Read error messages and correct data if needed

Adding New Accounting Systems 🔧

The application is designed to be extensible. For developers who want to add support for new accounting systems, please refer to:

• Documentation file: docs/ADDING_NEW_ACCOUNTING_SYSTEMS.md
• Reference code in database/base_sync_worker.py

Telegram Integration 📱

Send invoices directly from your mobile device to your PC for processing using the specialized Telegram bot.

Features:

• Instant Capture: Snap a photo or forward a PDF directly from Telegram.
• Queue System: Invoices are queued on your PC until you are ready to process them.
• Security: Only authorized Telegram users can send files to your bot.

Setup Guide:

1. Go to Tools → Integration Settings in the app.
2. Switch to the Telegram tab.
3. Enter your Bot Token (obtained from @BotFather).
4. Click Start Bot.
5. Send a message to your bot from Telegram.
6. The app will detect your User ID. Click Authorize to whitelist yourself.

Tip: You can authorize multiple team members to submit invoices to the same queue!

Troubleshooting

General Issues

Application Won’t Start

• Ensure Python 3.8+ is installed
• Check that all dependencies are available
• Run from command line to see error messages
• Verify file permissions

Cannot Open Files

• Check file format compatibility (JPG, PNG, PDF, TIFF)
• Verify file is not corrupted
• Ensure sufficient disk space
• Check file permissions

Saving Issues

• Verify write permissions to target directory
• Check available disk space
• Ensure target file is not open in another application

Processing Problems

Processing Mode Not Persisting

• Ensure you click “Apply” after selecting a mode
• Check application has write permissions to settings directory
• Restart the application to verify mode persistence

QR Code Reading Fails

• Ensure image quality is sufficient
• Verify QR code is not damaged or obscured
• Try using AI processing modes for better accuracy
• Check that the QR code format matches the selected mode

AI-Specific Issues

Gemini API Errors

• Invalid API Key: Verify key is correct and active
• Quota Exceeded: Check your usage limits
• Rate Limiting: Reduce processing speed or upgrade plan
• Network Issues: Check internet connectivity

Ollama Connection Issues

• Verify Ollama service is running
• Check server address and port
• Ensure vision-capable model is installed
• Verify sufficient system resources (RAM, GPU)

OpenRouter Problems

• Insufficient Credits: Add credits or use free models
• Model Not Available: Try different model or fetch updated list
• API Errors: Check API key and account status

Performance Issues

Slow Processing

• Use faster processing modes (QR modes vs AI modes)
• Upgrade system RAM and use SSD storage
• For Ollama: ensure GPU acceleration is working
• Process smaller batches

High Memory Usage

• Process smaller batches of invoices
• Close other applications
• Restart application periodically
• Upgrade system RAM if possible

Network and Connectivity

Internet Connection Required

• Gemini and OpenRouter require stable internet
• Use Ollama or QR modes for offline processing
• Check firewall and proxy settings

API Connection Timeouts

• Check internet stability
• Verify API service status
• Try different network connection
• Contact API provider if issues persist

Display and Interface

Language Not Switching

• Restart application after language change
• Verify translation files are present
• Check application has read permissions to translation files

UI Elements Not Displaying Correctly

• Check system display scaling settings
• Verify screen resolution compatibility
• Try different theme options
• Restart application

PDF Export Issues

• Arabic Text Not Displaying: Ensure arabic-reshaper and python-bidi libraries are installed
• Text Overlay Missing: Check that invoice data is available
• Images Not Appearing: Verify invoice image files exist and are accessible

Future Updates

Completed Features ✅

• ✅ Multi-language support (Arabic/English)
• ✅ OpenRouter integration with 400+ AI models
• ✅ Live free models fetching
• ✅ Custom model input capability
• ✅ Processing mode persistence
• ✅ Enhanced error handling and user feedback
• ✅ Comprehensive user manual
• ✅ Advanced filtering with auto-apply and manual modes
• ✅ Field selection in exports
• ✅ PDF export with Arabic text support
• ✅ Keyboard shortcuts for filtering
• ✅ Loading indicators for filter operations

Features in Development 🚧

• 🚧 Advanced OCR improvements
• 🚧 Additional export formats
• 🚧 Enhanced integration options
• 🚧 Performance optimizations

User-Requested Features 📝

• 📝 Cloud storage integration
• 📝 Mobile app companion
• 📝 Advanced reporting features
• 📝 Multi-user support

How to Request New Features

1. Check existing feature requests in the project repository
2. Create a detailed feature request with use cases
3. Participate in community discussions
4. Consider contributing to development

Support

Getting Help

• Documentation: This user manual covers most common scenarios
• Community: Join discussions in the project repository
• Issues: Report bugs and technical issues on GitHub
• Feature Requests: Suggest improvements and new features

Before Seeking Help

1. Check this troubleshooting section
2. Verify your system meets the requirements
3. Try the suggested solutions
4. Gather error messages and system information

Reporting Issues

When reporting issues, please include:

• Operating system and version
• Application version
• Steps to reproduce the issue
• Error messages (if any)
• Screenshots (if relevant)

Note: This application is actively maintained and updated. Check for the latest version regularly to benefit from improvements and bug fixes.

Registration and Subscriptions 🔐

Invoices Reader provides a flexible registration system to suit all your needs, from free trial usage to the full premium version.

Trial Period 🎁

When you run the application for the first time, you automatically get a free trial period to experience all application features.

Trial Period Features:

• ✅ 100 Invoices Maximum: You can process up to 100 invoices during the trial period
• ✅ 5 Batches: You can process up to 5 batches of any size
• ✅ All Features Available: Full access to all application features
• ✅ No Batch Size Limits: Process any number of invoices in a single batch
• ✅ Accounting System Integration: Sync with Odoo and Wafeq
• ✅ All AI Models: Use Gemini, Ollama, OpenRouter

How to Use the Trial Period:

1. Run the application for the first time
2. No registration or data entry required
3. Start processing invoices directly
4. Each processing batch will count towards the 5 batch limit
5. You can monitor remaining uses from the title bar

Important Notes:

• ⚠️ Countdown: Usage is counted only when a batch is successfully processed
• ⚠️ Not Counted: Opening folders, viewing invoices, or navigating between images
• ⚠️ Batch Limit: Any batch processed counts towards the 5 batches limit
• ⚠️ Total Limit: Cannot exceed 100 invoices in total during the trial period

Free Version 🆓

After the trial period ends, you can continue using the application for free with some reasonable limitations.

Free Version Features:

• ✅ 10 Invoices Daily: Process up to 10 invoices every day
• ✅ 5 Invoices Per Batch: Maximum 5 invoices in a single batch
• ✅ 90-Day History: Access invoice history for the last 90 days
• ✅ Excel Export: Export data in Excel format
• ✅ Single Source: Process invoices from local folders
• ✅ Manual Entry: Manually enter invoice data without limits
• ✅ QR Code Reading: Read QR codes for Saudi and Egyptian invoices

Free Version Limitations:

• ❌ Telegram Integration: Not available
• ❌ Email Integration: Not available
• ❌ Odoo Sync: Not available
• ❌ Wafeq Sync: Not available
• ❌ Local AI Models: Ollama not available
• ❌ PDF/CSV Export: Not available
• ❌ Large Batch Processing: Maximum 5 invoices per batch

Daily Limit Reset:

• 🔄 The 10-invoice daily limit resets at midnight
• 📊 You can monitor your daily usage from the title bar
• ⏰ You will receive an alert when approaching the daily limit

Premium Version 💎

Get the full experience without any limitations with the Premium Version.

Premium Version Features:

• ✅ Unlimited Invoices: Process an unlimited number of invoices
• ✅ Unlimited Batches: No limit on batch size
• ✅ Full History: Access all invoices without time limit
• ✅ All Export Formats: PDF, Excel, CSV, JSON
• ✅ Telegram Integration: Receive invoices via Telegram
• ✅ Email Integration: Receive invoices via Email
• ✅ Odoo Sync: Automatic synchronization with Odoo system
• ✅ Wafeq Sync: Automatic synchronization with Wafeq system
• ✅ Local AI Models: Use Ollama for full privacy
• ✅ Premium Support: Priority technical support
• ✅ Early Updates: Early access to new features

Plan Comparison:

Feature	Trial	Free	Premium
Number of Invoices	100 Total	10/Day	Unlimited
Batch Size	Unlimited	5 Invoices	Unlimited
Invoice History	Full	90 Days	Full
PDF Export	✅	✅	❌
Excel/CSV Export	✅	Excel Only	✅
Telegram Integration	✅	❌	✅
Email Integration	✅	❌	✅
Odoo Sync	✅	❌	✅
Wafeq Sync	✅	❌	✅
Ollama (Local AI)	✅	❌	✅
Manual Entry	✅	✅	✅
QR Reading	✅	✅	✅
Technical Support	Standard	Standard	Premium

How to Upgrade 📈

Upgrading from Trial/Free to Premium:

1. When Reaching Limit:
   • You will see an alert when reaching the usage limit
   • Click “Upgrade Now” in the alert
2. From Main Menu:
   • Open “Help” menu > “Registration & License”
   • Click “Upgrade to Premium”
3. Enter License Key:
   • Enter the license key you obtained
   • Click “Activate”
   • The key will be verified and Premium version activated
4. Confirmation:
   • An activation confirmation message will appear
   • The title bar will update to show “Registered”
   • All premium features are now available

Obtaining a License Key:

To obtain a Premium version license key, please contact us:

• 📧 Email: mohammednabarawy@gmail.com
• 📧 Email: info@invoicesreader.com
• 📱 WhatsApp: +20 1211418606
• 🌐 Website: invoicesreader.com

Checking License Status:

You can check your license status at any time:

• Title Bar: Shows current license status
  • “Trial – X uses remaining”
  • “Free – X/10 invoices today”
  • “Registered” (Premium version)
• Help Menu: Open “Help” > “About” to see license details

Tips for Maximizing Benefits:

For Trial Users:

• 💡 Use the trial period to test all features
• 💡 Try integration with accounting systems
• 💡 Test different AI models

For Free Users:

• 💡 Plan to process invoices daily (10 invoices/day)
• 💡 Use manual entry for simple invoices
• 💡 Take advantage of free QR code reading

For Premium Users:

• 💡 Use automatic integration with Telegram and Email
• 💡 Set up automatic synchronization with your accounting system
• 💡 Use Ollama for complete privacy