{"id":1030,"date":"2025-12-25T13:57:46","date_gmt":"2025-12-25T13:57:46","guid":{"rendered":"https:\/\/invoicesreader.com\/?post_type=documentation&#038;p=1030"},"modified":"2025-12-25T13:59:06","modified_gmt":"2025-12-25T13:59:06","slug":"user-manual-invoices-reader","status":"publish","type":"documentation","link":"https:\/\/invoicesreader.com\/en\/documentation\/user-manual-invoices-reader\/","title":{"rendered":"User Manual \u2013 Invoices Reader"},"content":{"rendered":"<h2 class=\"wp-block-heading\">Introduction<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Welcome to the Invoices Reader \u2013 a modern, intelligent application designed to process and extract data from invoice images with advanced AI capabilities.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Key Features:<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Multi-Format Support:<\/strong>\u00a0Processes various invoice formats including Saudi and Egyptian e-invoices<\/li>\n\n\n\n<li><strong>AI-Powered Processing:<\/strong>\u00a0Uses advanced AI models (Gemini, Ollama, OpenRouter, LM Studio) for accurate data extraction<\/li>\n\n\n\n<li><strong>QR Code Reading:<\/strong>\u00a0Specialized support for Saudi and Egyptian QR codes<\/li>\n\n\n\n<li><strong>Batch Processing:<\/strong>\u00a0Process multiple invoices simultaneously<\/li>\n\n\n\n<li><strong>Database Management:<\/strong>\u00a0Store and manage processed invoice data with advanced filtering<\/li>\n\n\n\n<li><strong>Export Options:<\/strong>\u00a0Export data to Excel, CSV, and PDF with field selection<\/li>\n\n\n\n<li><strong>Bilingual Interface:<\/strong>\u00a0Full support for Arabic and English languages<\/li>\n\n\n\n<li><strong>Advanced Filtering:<\/strong>\u00a0Powerful search and filter capabilities with auto-apply and manual modes<\/li>\n\n\n\n<li><strong>Enhanced Sync System:<\/strong>\u00a0Detailed results dialog with user-friendly error messages in Arabic and English<\/li>\n\n\n\n<li><strong>Multiple Accounting Systems:<\/strong>\u00a0Wafeq and Odoo integration with extensible architecture<\/li>\n\n\n\n<li><strong>Progress Tracking:<\/strong>\u00a0Real-time synchronization monitoring with cancellation support<\/li>\n\n\n\n<li><strong>Export Sync Results:<\/strong>\u00a0Save detailed synchronization reports<\/li>\n\n\n\n<li><strong>Improved Decimal Precision:<\/strong>\u00a0All monetary values rounded to 2 decimal places<\/li>\n\n\n\n<li><strong>PDF Export with Arabic Support:<\/strong>\u00a0Professional PDF exports with proper Arabic text rendering<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">System Requirements<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Minimum Requirements:<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Operating System:<\/strong>\u00a0Windows 10 or later<\/li>\n\n\n\n<li><strong>RAM:<\/strong>\u00a04 GB minimum, 8 GB recommended<\/li>\n\n\n\n<li><strong>Storage:<\/strong>\u00a02 GB free space<\/li>\n\n\n\n<li><strong>Internet Connection:<\/strong>\u00a0Required for cloud AI modes (Gemini, OpenRouter); LM Studio and Ollama operate locally once models are installed<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Recommended Requirements:<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>RAM:<\/strong>\u00a016 GB for optimal performance<\/li>\n\n\n\n<li><strong>GPU:<\/strong>\u00a0NVIDIA GPU for local Ollama processing<\/li>\n\n\n\n<li><strong>Storage:<\/strong>\u00a0SSD for faster processing<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Installation<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Download the latest version from the official repository<\/li>\n\n\n\n<li>Extract the files to your desired location<\/li>\n\n\n\n<li>Run\u00a0<code>main.py<\/code>\u00a0to start the application<\/li>\n\n\n\n<li>On first run, select your preferred language (Arabic or English)<\/li>\n\n\n\n<li>Configure your AI settings if needed<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Note:<\/strong>&nbsp;Python 3.8 or later is required. All dependencies are included in the package.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Getting Started<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">First Launch:<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Launch the application<\/li>\n\n\n\n<li>Select your preferred language (Arabic\/English)<\/li>\n\n\n\n<li>Choose a processing mode suitable for your invoices<\/li>\n\n\n\n<li>Configure AI settings if using AI processing modes<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\">Basic Workflow:<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Select Processing Mode:<\/strong>\u00a0Choose the appropriate mode for your invoice type<\/li>\n\n\n\n<li><strong>Open Invoice Folder:<\/strong>\u00a0Select the folder containing your invoice images<\/li>\n\n\n\n<li><strong>Start Processing:<\/strong>\u00a0Click \u201cStart Processing\u201d to begin<\/li>\n\n\n\n<li><strong>Review Results:<\/strong>\u00a0Check extracted data and make corrections if needed<\/li>\n\n\n\n<li><strong>Export Data:<\/strong>\u00a0Save results to Excel, CSV, or PDF<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Processing Modes<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The application offers several processing modes optimized for different invoice types and requirements.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Saudi E-Invoice QR Mode<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Purpose:<\/strong>\u00a0Optimized for Saudi Arabian e-invoice QR codes<\/li>\n\n\n\n<li><strong>Speed:<\/strong>\u00a0Very fast processing<\/li>\n\n\n\n<li><strong>Accuracy:<\/strong>\u00a0High accuracy for Saudi tax authority format<\/li>\n\n\n\n<li><strong>Requirements:<\/strong>\u00a0No internet connection required<\/li>\n\n\n\n<li><strong>Best For:<\/strong>\u00a0Saudi businesses processing ZATCA-compliant invoices<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Egyptian E-Invoice QR Mode<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Purpose:<\/strong>\u00a0Optimized for Egyptian e-invoice QR codes<\/li>\n\n\n\n<li><strong>Speed:<\/strong>\u00a0Very fast processing<\/li>\n\n\n\n<li><strong>Accuracy:<\/strong>\u00a0High accuracy for Egyptian tax authority format<\/li>\n\n\n\n<li><strong>Requirements:<\/strong>\u00a0No internet connection required<\/li>\n\n\n\n<li><strong>Best For:<\/strong>\u00a0Egyptian businesses processing ETA-compliant invoices<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">AI Processing Modes<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">GEMINI \u2013 Smart Processing<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Provider:<\/strong>\u00a0Google Gemini AI<\/li>\n\n\n\n<li><strong>Speed:<\/strong>\u00a0Fast processing<\/li>\n\n\n\n<li><strong>Accuracy:<\/strong>\u00a0Very high accuracy<\/li>\n\n\n\n<li><strong>Requirements:<\/strong>\u00a0Internet connection and API key<\/li>\n\n\n\n<li><strong>Cost:<\/strong>\u00a0Pay-per-use (very affordable)<\/li>\n\n\n\n<li><strong>Best For:<\/strong>\u00a0High-volume processing with excellent accuracy<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">OLLAMA \u2013 Local Processing<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Provider:<\/strong>\u00a0Local AI models<\/li>\n\n\n\n<li><strong>Speed:<\/strong>\u00a0Moderate (depends on hardware)<\/li>\n\n\n\n<li><strong>Accuracy:<\/strong>\u00a0Good accuracy<\/li>\n\n\n\n<li><strong>Requirements:<\/strong>\u00a0No internet required, local GPU recommended<\/li>\n\n\n\n<li><strong>Cost:<\/strong>\u00a0Free (uses local resources)<\/li>\n\n\n\n<li><strong>Best For:<\/strong>\u00a0Privacy-focused processing, offline environments<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">OPENROUTER \u2013 Cloud AI<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Provider:<\/strong>\u00a0Multiple AI models via OpenRouter<\/li>\n\n\n\n<li><strong>Speed:<\/strong>\u00a0Very fast processing<\/li>\n\n\n\n<li><strong>Accuracy:<\/strong>\u00a0Excellent accuracy<\/li>\n\n\n\n<li><strong>Requirements:<\/strong>\u00a0Internet connection and API key<\/li>\n\n\n\n<li><strong>Cost:<\/strong>\u00a0Various pricing options, many free models available<\/li>\n\n\n\n<li><strong>Best For:<\/strong>\u00a0Access to cutting-edge AI models<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">LM STUDIO \u2013 Local Processing<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Provider:<\/strong>\u00a0LM Studio desktop\/server app<\/li>\n\n\n\n<li><strong>Speed:<\/strong>\u00a0Fast to moderate (depends on server\/local machine)<\/li>\n\n\n\n<li><strong>Accuracy:<\/strong>\u00a0High accuracy<\/li>\n\n\n\n<li><strong>Requirements:<\/strong>\u00a0LM Studio application installed and running, OpenAI-compatible API endpoint<\/li>\n\n\n\n<li><strong>Cost:<\/strong>\u00a0Free (uses local resources)<\/li>\n\n\n\n<li><strong>Best For:<\/strong>\u00a0Advanced local processing with custom models<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Switching Processing Modes<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to\u00a0<strong>Tools \u2192 Settings \u2192 Processing Mode<\/strong><\/li>\n\n\n\n<li>Select the desired processing mode<\/li>\n\n\n\n<li>Click\u00a0<strong>Apply<\/strong>\u00a0to confirm<\/li>\n\n\n\n<li>The new mode will be saved and used for future processing<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Tip:<\/strong>&nbsp;The application remembers your last selected mode and will restore it on next startup.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">AI Settings<\/h2>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"screenshots\/unified_settings_ai_en.png\" alt=\"AI Settings Dialog\"\/><figcaption class=\"wp-element-caption\">Figure: AI Models Settings Tab in Unified Settings<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Configure AI processing options by going to&nbsp;<strong>Tools \u2192 Settings \u2192 AI Models<\/strong>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Google Gemini Setup<\/h3>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"screenshots\/gemini_settings_en.png\" alt=\"Gemini Settings Tab\"\/><figcaption class=\"wp-element-caption\">Gemini Settings Tab<\/figcaption><\/figure>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Obtain a Gemini API key from Google AI Studio<\/li>\n\n\n\n<li>Open AI Settings and go to the Gemini tab<\/li>\n\n\n\n<li>Enter your API key<\/li>\n\n\n\n<li>Select your preferred model:\n<ul class=\"wp-block-list\">\n<li><strong>Gemini 2.0 Flash Lite:<\/strong>\u00a0Fastest, 30 requests\/minute<\/li>\n\n\n\n<li><strong>Gemini 2.0 Flash:<\/strong>\u00a0Balanced speed and accuracy, 15 requests\/minute<\/li>\n\n\n\n<li><strong>Gemini 2.0 Flash Thinking:<\/strong>\u00a0Highest accuracy, slower, 10 requests\/minute<\/li>\n\n\n\n<li><strong>Gemini 2.5 Pro:<\/strong>\u00a0Premium model, 2 requests\/minute<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Click\u00a0<strong>Test Connection<\/strong>\u00a0to verify<\/li>\n\n\n\n<li>Save settings<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\">Ollama Setup<\/h3>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"screenshots\/ollama_settings_en.png\" alt=\"Ollama Settings Tab\"\/><figcaption class=\"wp-element-caption\">Ollama Settings Tab<\/figcaption><\/figure>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Install Ollama on your system<\/li>\n\n\n\n<li>Pull a vision-capable model (e.g.,\u00a0<code>ollama pull llava<\/code>)<\/li>\n\n\n\n<li>Open AI Settings and go to the Ollama tab<\/li>\n\n\n\n<li>Configure server address (default: http:\/\/localhost:11434)<\/li>\n\n\n\n<li>Select GPU index if you have multiple GPUs<\/li>\n\n\n\n<li>Choose your installed model from the dropdown<\/li>\n\n\n\n<li>Click\u00a0<strong>Test Connection<\/strong>\u00a0to verify<\/li>\n\n\n\n<li>Save settings<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Note:<\/strong>&nbsp;Ollama requires significant system resources. A GPU with at least 8GB VRAM is recommended for optimal performance.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">OpenRouter Setup<\/h3>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"screenshots\/openrouter_settings_en.png\" alt=\"OpenRouter Settings Tab\"\/><figcaption class=\"wp-element-caption\">OpenRouter Settings Tab<\/figcaption><\/figure>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Create an account at OpenRouter.ai<\/li>\n\n\n\n<li>Generate an API key from your dashboard<\/li>\n\n\n\n<li>Open AI Settings and go to the OpenRouter tab<\/li>\n\n\n\n<li>Enter your API key<\/li>\n\n\n\n<li>Choose a model:\n<ul class=\"wp-block-list\">\n<li>Type a model name directly (e.g.,\u00a0<code>google\/gemini-flash-1.5<\/code>)<\/li>\n\n\n\n<li>Use the \u201cPopular Models\u201d dropdown for quick selection<\/li>\n\n\n\n<li>Click \u201cFetch Free Models\u201d to see available free options<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Optionally configure site URL and name<\/li>\n\n\n\n<li>Click\u00a0<strong>Test Connection<\/strong>\u00a0to verify<\/li>\n\n\n\n<li>Save settings<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Tip:<\/strong>&nbsp;OpenRouter offers many free models. Use the \u201cFetch Free Models\u201d feature to discover the latest available options.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">LM Studio Setup<\/h3>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"screenshots\/lmstudio_settings_en.png\" alt=\"LM Studio Settings Tab\"\/><figcaption class=\"wp-element-caption\">LM Studio Settings Tab<\/figcaption><\/figure>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Install the latest version of\u00a0<a href=\"https:\/\/lmstudio.ai\" target=\"_blank\" rel=\"noreferrer noopener\">LM Studio<\/a>\u00a0on your machine<\/li>\n\n\n\n<li>Launch LM Studio and enable the\u00a0<strong>OpenAI Compatible Server<\/strong>\u00a0(default endpoint:\u00a0<code>http:\/\/localhost:1234<\/code>)<\/li>\n\n\n\n<li>Download or import a vision-capable model inside LM Studio (for example,\u00a0<code>lmstudio-community\/phi-3.1-vision-instruct<\/code>)<\/li>\n\n\n\n<li>Open the application\u2019s\u00a0<strong>AI Settings<\/strong>\u00a0dialog and switch to the\u00a0<strong>LM Studio<\/strong>\u00a0tab<\/li>\n\n\n\n<li>Confirm the server endpoint, provide an API key if you configured one in LM Studio, and enter the exact model identifier<\/li>\n\n\n\n<li>Adjust the timeout if needed, then click\u00a0<strong>Test LM Studio Connection<\/strong>\u00a0to verify connectivity<\/li>\n\n\n\n<li>Click\u00a0<strong>Save LM Studio Settings<\/strong>\u00a0to persist the configuration<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Note:<\/strong>&nbsp;LM Studio keeps all processing on your local machine. Ensure the application remains running in the background while Invoices Reader requests predictions.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Main Interface<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><img decoding=\"async\" src=\"screenshots\/main_window_en.png\" alt=\"Main application interface\"><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Figure 1: Main interface of the Invoices Reader application<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The main interface consists of:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Top toolbar (contains main functions)<\/li>\n\n\n\n<li>Image display area (with smaller navigation buttons to provide more display space)<\/li>\n\n\n\n<li>Invoice information panel<\/li>\n\n\n\n<li>Bottom status bar (shows current processing mode)<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Toolbar<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><img decoding=\"async\" src=\"screenshots\/toolbar.png\" alt=\"Application toolbar\"><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Figure 2: Main toolbar with available functions<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The toolbar contains the following main functions:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>New Operation<\/strong>: Create a new batch of invoices<\/li>\n\n\n\n<li><strong>Open Folder<\/strong>: Select a folder containing invoices<\/li>\n\n\n\n<li><strong>History<\/strong>: View previous invoice records<\/li>\n\n\n\n<li><strong>Processing Mode<\/strong>: Choose invoice processing method<\/li>\n\n\n\n<li><strong>Settings<\/strong>: Configure AI, Integrations, and Application preferences<\/li>\n\n\n\n<li><strong>User Manual<\/strong>: View comprehensive user guide<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Keyboard Shortcuts<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">To make the application easier to use, the following shortcuts are available:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th class=\"has-text-align-left\" data-align=\"left\">Function<\/th><th class=\"has-text-align-left\" data-align=\"left\">Shortcut<\/th><\/tr><\/thead><tbody><tr><td class=\"has-text-align-left\" data-align=\"left\">Open Folder<\/td><td class=\"has-text-align-left\" data-align=\"left\">Ctrl+O<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Start Processing<\/td><td class=\"has-text-align-left\" data-align=\"left\">Ctrl+P<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Stop Processing<\/td><td class=\"has-text-align-left\" data-align=\"left\">Ctrl+S<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Previous Image<\/td><td class=\"has-text-align-left\" data-align=\"left\">Left Arrow<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Next Image<\/td><td class=\"has-text-align-left\" data-align=\"left\">Right Arrow<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">View History<\/td><td class=\"has-text-align-left\" data-align=\"left\">Ctrl+H<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">User Manual<\/td><td class=\"has-text-align-left\" data-align=\"left\">F1<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Focus Search (Advanced Tab)<\/td><td class=\"has-text-align-left\" data-align=\"left\">Ctrl+F<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Clear All Filters (Advanced Tab)<\/td><td class=\"has-text-align-left\" data-align=\"left\">Esc<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Reset Filters (Advanced Tab)<\/td><td class=\"has-text-align-left\" data-align=\"left\">Ctrl+R<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Apply Filters (Manual Mode)<\/td><td class=\"has-text-align-left\" data-align=\"left\">Enter<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Main Features<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Opening Invoice Folders<\/h3>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"screenshots\/folder_selection.png\" alt=\"Folder selection dialog\"\/><figcaption class=\"wp-element-caption\">Figure 3: Folder selection dialog for choosing invoice directory<\/figcaption><\/figure>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Click\u00a0<strong>File \u2192 Open Folder<\/strong>\u00a0or use the toolbar button<\/li>\n\n\n\n<li>Select the folder containing your invoice images<\/li>\n\n\n\n<li>Supported formats: JPG, PNG, PDF, TIFF<\/li>\n\n\n\n<li>The application will load and display all compatible files<\/li>\n\n\n\n<li>The folder path will appear in the window title for easy reference<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\">Processing Mode<\/h3>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"screenshots\/unified_settings_processing_en.png\" alt=\"Unified Settings Dialog - Processing Mode\"\/><figcaption class=\"wp-element-caption\">Figure 4: Unified Settings Dialog (Processing Mode Tab)<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The application provides several modes for processing invoices:<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">QR Code Reading Modes<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Saudi einvoice qr code \u2013 fast<\/strong>: For reading Saudi e-invoice QR codes<\/li>\n\n\n\n<li><strong>Egyptian einvoice qr code \u2013 fast<\/strong>: For reading Egyptian e-invoice QR codes<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">AI Processing Modes<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>GEMINI \u2013 fast<\/strong>: Uses Google Gemini AI model (requires API key)<\/li>\n\n\n\n<li><strong>OLLAMA \u2013 slow<\/strong>: Uses local Ollama models (works offline)<\/li>\n\n\n\n<li><strong>OPENROUTER \u2013 fast<\/strong>: Uses OpenRouter AI models (requires API key)<\/li>\n\n\n\n<li><strong>LM STUDIO \u2013 local<\/strong>: Uses the LM Studio desktop\/server app to run local models through an OpenAI-compatible API<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">To change processing mode:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Click the \u201cProcessing Mode\u201d button in the toolbar<\/li>\n\n\n\n<li>Select the appropriate mode for your invoice type<\/li>\n\n\n\n<li>Click \u201cApply\u201d to activate the new mode<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\">Invoice Processing<\/h3>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"screenshots\/processing.png\" alt=\"Invoice processing screen\"\/><figcaption class=\"wp-element-caption\">Figure 5: Invoice processing screen with progress bar<\/figcaption><\/figure>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Ensure you have selected the appropriate processing mode<\/li>\n\n\n\n<li>Open the folder containing your invoices<\/li>\n\n\n\n<li>Click\u00a0<strong>Start Processing<\/strong><\/li>\n\n\n\n<li>Monitor progress in the status bar<\/li>\n\n\n\n<li>Processing will stop automatically when complete<\/li>\n\n\n\n<li>Review extracted data in the results table<\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The application supports PDF files and images<\/li>\n\n\n\n<li>A progress bar is displayed during processing<\/li>\n\n\n\n<li>You can navigate between invoices using arrow keys<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Note:<\/strong>&nbsp;Processing speed depends on the selected mode, number of invoices, and system performance.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">QR Code Reading<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The application includes specialized QR code readers for:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Saudi E-Invoices:<\/strong>\u00a0ZATCA-compliant QR codes<\/li>\n\n\n\n<li><strong>Egyptian E-Invoices:<\/strong>\u00a0ETA-compliant QR codes<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">QR code processing is automatic when using the corresponding processing modes.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Data Extraction<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The application extracts the following data from invoices:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Invoice number<\/li>\n\n\n\n<li>Invoice date<\/li>\n\n\n\n<li>Supplier\/vendor information<\/li>\n\n\n\n<li>Customer information<\/li>\n\n\n\n<li>Tax numbers<\/li>\n\n\n\n<li>Total amounts<\/li>\n\n\n\n<li>Tax amounts<\/li>\n\n\n\n<li>Line items (when available)<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Database Management<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The invoice history window provides an advanced interface for searching, filtering, and managing previously processed invoices. You can access it through:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Clicking the \u201cHistory\u201d button in the main interface<\/li>\n\n\n\n<li>Selecting File \u2192 Database from the menu<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"screenshots\/database_form_en.png\" alt=\"Invoice history window - Basic tab\"\/><figcaption class=\"wp-element-caption\">Figure 6: Invoice history window \u2013 Basic tab<\/figcaption><\/figure>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"screenshots\/database_form_advanced_en.png\" alt=\"Invoice history window - Advanced tab\"\/><figcaption class=\"wp-element-caption\">Figure 7: Invoice history window \u2013 Advanced tab<\/figcaption><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">Batch View<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">The window contains two main tabs. The first \u201cBatch View\u201d tab displays a list of all processed invoice batches:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>You can filter batches by a specific date range<\/li>\n\n\n\n<li>You can load a complete batch to display in the main interface<\/li>\n\n\n\n<li>You can export a complete batch to an Excel file<\/li>\n\n\n\n<li>You can delete a complete batch from the database<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Advanced View<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">The second \u201cAdvanced View\u201d tab provides an advanced interface for viewing and filtering all individual invoices:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Search:<\/strong>\u00a0You can search for invoices using supplier name, invoice number, or tax number<\/li>\n\n\n\n<li><strong>Filter by Supplier:<\/strong>\u00a0You can select a specific supplier from the dropdown list<\/li>\n\n\n\n<li><strong>Filter by Date:<\/strong>\u00a0You can specify a date range for invoices<\/li>\n\n\n\n<li><strong>Filter by Amount:<\/strong>\u00a0You can specify a range for invoice amounts<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">You can also:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Load a specific invoice in the main interface<\/li>\n\n\n\n<li>Export search and filter results to an Excel file<\/li>\n\n\n\n<li>Delete a specific invoice from the database<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Vendor Trust Center \ud83d\udee1\ufe0f<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The Vendor Trust Center acts as a centralized hub to ensure your vendor database remains clean, accurate, and free of duplicates.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Key Features:<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Smart Duplicate Detection:<\/strong>\u00a0Automatically identifies vendors that are likely the same entity based on name similarity or identical Tax IDs.<\/li>\n\n\n\n<li><strong>Merge Suggestions:<\/strong>\u00a0Instead of blindly merging, the system creates \u201cMerge Suggestions\u201d for you to review.<\/li>\n\n\n\n<li><strong>Deep Comparison:<\/strong>\u00a0Side-by-side comparison of contact details (Address, Phone, etc.) before merging.<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">How to Deduplicate Vendors:<\/h4>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to\u00a0<strong>Tools \u2192 Vendor Trust Center<\/strong>.<\/li>\n\n\n\n<li>Click\u00a0<strong>Run Batch Deduplication<\/strong>.<\/li>\n\n\n\n<li>Review the list of \u201cPending Suggestions\u201d.<\/li>\n\n\n\n<li>For each suggestion, click\u00a0<strong>Review<\/strong>\u00a0to see details.<\/li>\n\n\n\n<li>Click\u00a0<strong>Approve Merge<\/strong>\u00a0to combine them (updating all historical invoices) or\u00a0<strong>Reject<\/strong>\u00a0to keep them separate.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Note:<\/strong>&nbsp;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.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Plugins System<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The application now features a powerful generic Plugins System that allows extending functionality without modifying the core software.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Managing Plugins<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Plugins are automatically discovered from the&nbsp;<code>plugins<\/code>&nbsp;folder. You can view loaded plugins in the startup log or the new&nbsp;<strong>Plugins<\/strong>&nbsp;menu.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Included Plugins<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">Smart Exporter \ud83d\udcca<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">An advanced export tool that allows verifying batch data and exporting specific fields.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Batch Verify:<\/strong>\u00a0Quickly check data quality for the whole batch.<\/li>\n\n\n\n<li><strong>Export to Excel\/CSV:<\/strong>\u00a0Flexible export of current batch data with customizable columns.<\/li>\n\n\n\n<li><strong>Statistics:<\/strong>\u00a0View quick charts about your invoice data.<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Telegram Integration \ud83d\udcf1<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Send invoices directly from Telegram to your desktop application.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Bot Integration:<\/strong>\u00a0Connect a Telegram bot to receive files.<\/li>\n\n\n\n<li><strong>Queue System:<\/strong>\u00a0Files are queued for processing when you are ready.<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Vendor Insights \ud83d\udee1\ufe0f<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Enhances vendor management with data quality tools.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Auto-Tagger:<\/strong>\u00a0Automatically categorizes vendors based on history.<\/li>\n\n\n\n<li><strong>Trust Score:<\/strong>\u00a0Evaluates data consistency for each vendor.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Advanced Features<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Advanced Tab Features<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The Advanced tab in the Database window provides powerful filtering and export capabilities:<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Filter Modes<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Auto-Apply Mode:<\/strong>\u00a0Filters are applied automatically as you type or change filter values. This is the default mode for quick filtering.<\/li>\n\n\n\n<li><strong>Manual Apply Mode:<\/strong>\u00a0Filters are only applied when you click the \u201cApply Filters\u201d button. Use this mode when you want to set multiple filters before applying them.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">To switch between modes:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Click the \u201cAuto Apply\u201d toggle button in the Advanced tab<\/li>\n\n\n\n<li>When disabled, the \u201cApply Filters\u201d button will appear<\/li>\n\n\n\n<li>Click \u201cApply Filters\u201d to manually apply your filter settings<\/li>\n<\/ol>\n\n\n\n<h4 class=\"wp-block-heading\">Loading Indicators<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">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.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Advanced Filtering<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The Advanced tab offers comprehensive filtering options:<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Text Search<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Search across multiple fields: supplier name, invoice number, tax number<\/li>\n\n\n\n<li>Real-time search results (in auto-apply mode)<\/li>\n\n\n\n<li>Case-insensitive matching<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Vendor Filter<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Select one or more vendors from the dropdown list<\/li>\n\n\n\n<li>Filter invoices by specific suppliers<\/li>\n\n\n\n<li>Multiple selection supported<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Date Range Filter<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Filter invoices by date range<\/li>\n\n\n\n<li>Select start and end dates<\/li>\n\n\n\n<li>Clear date filters easily<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Amount Range Filter<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Filter by minimum and maximum invoice amounts<\/li>\n\n\n\n<li>Set either minimum or maximum, or both<\/li>\n\n\n\n<li>Useful for finding invoices within specific price ranges<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Filter Chips<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Active filters are displayed as chips above the table. You can:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>See all active filters at a glance<\/li>\n\n\n\n<li>Remove individual filters by clicking the X on each chip<\/li>\n\n\n\n<li>Quickly understand what filters are currently applied<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Keyboard Shortcuts for Filtering<\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th class=\"has-text-align-left\" data-align=\"left\">Action<\/th><th class=\"has-text-align-left\" data-align=\"left\">Shortcut<\/th><\/tr><\/thead><tbody><tr><td class=\"has-text-align-left\" data-align=\"left\">Focus Search Field<\/td><td class=\"has-text-align-left\" data-align=\"left\">Ctrl+F<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Clear All Filters<\/td><td class=\"has-text-align-left\" data-align=\"left\">Esc<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Reset Filters<\/td><td class=\"has-text-align-left\" data-align=\"left\">Ctrl+R<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Apply Filters (Manual Mode)<\/td><td class=\"has-text-align-left\" data-align=\"left\">Enter<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Export Options<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The application provides flexible export options with field selection:<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Export Formats<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Excel (.xlsx):<\/strong>\u00a0Professional spreadsheet format with formatting<\/li>\n\n\n\n<li><strong>CSV (.csv):<\/strong>\u00a0Comma-separated values for compatibility<\/li>\n\n\n\n<li><strong>PDF:<\/strong>\u00a0Professional document format with invoice images<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Export Types<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Simple Export:<\/strong>\u00a0Invoice summary only (header information)<\/li>\n\n\n\n<li><strong>Detailed Export:<\/strong>\u00a0Includes line items for each invoice<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Field Selection<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">When exporting, you can choose which fields to include:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>ID Number<\/li>\n\n\n\n<li>Batch Number<\/li>\n\n\n\n<li>Supplier Name<\/li>\n\n\n\n<li>Invoice Number<\/li>\n\n\n\n<li>Invoice Date<\/li>\n\n\n\n<li>Tax Number<\/li>\n\n\n\n<li>Total Amount<\/li>\n\n\n\n<li>Tax Amount<\/li>\n\n\n\n<li>Subtotal<\/li>\n\n\n\n<li>Currency<\/li>\n\n\n\n<li>Due Date<\/li>\n\n\n\n<li>Discount<\/li>\n\n\n\n<li>Amount Due<\/li>\n\n\n\n<li>Customer Name<\/li>\n\n\n\n<li>Customer ID<\/li>\n\n\n\n<li>Customer VAT ID<\/li>\n\n\n\n<li>Purchase Order<\/li>\n\n\n\n<li>Payment Terms<\/li>\n\n\n\n<li>Vendor Address<\/li>\n\n\n\n<li>Customer Address<\/li>\n\n\n\n<li>Invoice Category<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Export Sources<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Selected Invoices:<\/strong>\u00a0Export only the invoices you\u2019ve selected in the table<\/li>\n\n\n\n<li><strong>Filtered Results:<\/strong>\u00a0Export all invoices matching your current filters<\/li>\n\n\n\n<li><strong>Entire Batch:<\/strong>\u00a0Export all invoices in a specific batch<\/li>\n\n\n\n<li><strong>Multiple Batches:<\/strong>\u00a0Export invoices from multiple batches in a single file<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">How to Export<\/h4>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Apply your filters or select invoices (if exporting selected items)<\/li>\n\n\n\n<li>Click the \u201cExport\u201d button (Excel or PDF)<\/li>\n\n\n\n<li>In the export options dialog:\n<ul class=\"wp-block-list\">\n<li>Choose export type (Simple or Detailed)<\/li>\n\n\n\n<li>Select file format (Excel, CSV, or PDF)<\/li>\n\n\n\n<li><strong>Select Target System<\/strong>\u00a0for accounting software compatibility<\/li>\n\n\n\n<li>Select which fields to include (for Default format)<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Click \u201cExport\u201d to save the file<\/li>\n\n\n\n<li>Choose the save location and filename<\/li>\n<\/ol>\n\n\n\n<h4 class=\"wp-block-heading\">Target System Export Formats<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">Export invoices in formats compatible with popular accounting systems:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th class=\"has-text-align-left\" data-align=\"left\">System<\/th><th class=\"has-text-align-left\" data-align=\"left\">Format<\/th><th class=\"has-text-align-left\" data-align=\"left\">Key Fields<\/th><\/tr><\/thead><tbody><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Default \/ ZATCA<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">Excel\/CSV<\/td><td class=\"has-text-align-left\" data-align=\"left\">Standard fields with custom selection<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Odoo ERP<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">Excel<\/td><td class=\"has-text-align-left\" data-align=\"left\">partner_id, ref, invoice_date, invoice_line_ids\/*<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>ERPNext<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">Excel<\/td><td class=\"has-text-align-left\" data-align=\"left\">Supplier, Supplier Invoice No, items.*<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>QuickBooks Online<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">Excel<\/td><td class=\"has-text-align-left\" data-align=\"left\">Bill no., Supplier, Account, Line Amount<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Zoho Books<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">Excel<\/td><td class=\"has-text-align-left\" data-align=\"left\">Bill Number, Vendor Name, Tax Registration<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\"><strong>Al-Ameen \/ Al-Manara<\/strong><\/td><td class=\"has-text-align-left\" data-align=\"left\">Excel (RTL)<\/td><td class=\"has-text-align-left\" data-align=\"left\">Bilingual headers, item details<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Note:<\/strong>&nbsp;When selecting a specific target system (other than Default), the \u201cSimple Export\u201d and custom field selection options are disabled to ensure all required fields are included for import compatibility.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">PDF Export<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">PDF export creates professional documents with invoice images and metadata:<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Features<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Invoice Images:<\/strong>\u00a0Each invoice image is included in the PDF<\/li>\n\n\n\n<li><strong>Text Overlay:<\/strong>\u00a0Essential invoice information displayed at the bottom of each page:\n<ul class=\"wp-block-list\">\n<li>Date<\/li>\n\n\n\n<li>Invoice Number<\/li>\n\n\n\n<li>Vendor Name<\/li>\n\n\n\n<li>Invoice Total<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Arabic Text Support:<\/strong>\u00a0Proper rendering of Arabic text with right-to-left alignment<\/li>\n\n\n\n<li><strong>Single Line Format:<\/strong>\u00a0Compact overlay that doesn\u2019t cover the invoice image<\/li>\n\n\n\n<li><strong>Multiple Pages:<\/strong>\u00a0Each invoice appears on its own page<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Export Options<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Export selected invoices<\/li>\n\n\n\n<li>Export filtered results<\/li>\n\n\n\n<li>Export entire batch<\/li>\n\n\n\n<li>Export multiple batches<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Note:<\/strong>&nbsp;PDF export uses proper Arabic text shaping and bidirectional text handling for accurate rendering of Arabic content.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Batch Processing<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Process multiple invoices simultaneously<\/li>\n\n\n\n<li>Automatic progress tracking<\/li>\n\n\n\n<li>Error handling and recovery<\/li>\n\n\n\n<li>Batch results summary<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">System Integrations \ud83d\udd17<\/h3>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"screenshots\/integrations_dialog.png\" alt=\"Integration settings dialog\"\/><figcaption class=\"wp-element-caption\">Figure 9: Integration settings dialog for accounting systems<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The application supports integration with multiple accounting systems for automatic invoice synchronization. Access integration settings through:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Click the \u201cIntegrations\u201d button in the main interface<\/li>\n\n\n\n<li>Select Tools menu \u2192 Accounting System Integrations<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Supported Systems<\/h4>\n\n\n\n<h5 class=\"wp-block-heading\">1. Wafeq System \ud83d\udcb0<\/h5>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"screenshots\/wafeq_settings_en.png\" alt=\"Wafeq Settings Tab\"\/><figcaption class=\"wp-element-caption\">Wafeq Integration Settings<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Advanced cloud-based accounting system with Saudi e-invoice support.<strong>Setup Steps:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to the \u201cWafeq\u201d tab in the integration dialog<\/li>\n\n\n\n<li>Enter your Wafeq account API key<\/li>\n\n\n\n<li>Click \u201cTest Connection\u201d to verify settings<\/li>\n\n\n\n<li>Save the configuration<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Features:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Automatic vendor bill creation<\/li>\n\n\n\n<li>Invoice attachment upload (PDF images)<\/li>\n\n\n\n<li>Multi-line item support<\/li>\n\n\n\n<li>Automatic tax and discount calculations<\/li>\n\n\n\n<li>Automatic vendor\/contact creation<\/li>\n<\/ul>\n\n\n\n<h5 class=\"wp-block-heading\">2. Odoo System \ud83c\udfe2<\/h5>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"screenshots\/odoo_settings_en.png\" alt=\"Odoo Settings Tab\"\/><figcaption class=\"wp-element-caption\">Odoo Integration Settings<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Open-source Enterprise Resource Planning (ERP) system.<strong>Setup Steps:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to the \u201cOdoo\u201d tab in the integration dialog<\/li>\n\n\n\n<li>Enter your Odoo server URL<\/li>\n\n\n\n<li>Enter the database name<\/li>\n\n\n\n<li>Enter username and API key<\/li>\n\n\n\n<li>Click \u201cTest Connection\u201d to verify settings<\/li>\n\n\n\n<li>Save the configuration<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Features:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Vendor bill creation<\/li>\n\n\n\n<li>Automatic product\/service creation<\/li>\n\n\n\n<li>Link invoices to accounting accounts<\/li>\n\n\n\n<li>Tax and discount support<\/li>\n\n\n\n<li>Invoice attachment upload<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Invoice Synchronization \ud83d\udd04<\/h4>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"screenshots\/sync_progress.png\" alt=\"Sync progress dialog\"\/><figcaption class=\"wp-element-caption\">Figure 10: Synchronization progress dialog<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">After configuring integration with an accounting system, you can synchronize invoices:<strong>Synchronization Steps:<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Open the invoice database dialog<\/li>\n\n\n\n<li>Select the batch you want to synchronize<\/li>\n\n\n\n<li>Click the \u201cSync\u201d button<\/li>\n\n\n\n<li>Choose the target accounting system (Wafeq or Odoo)<\/li>\n\n\n\n<li>Monitor progress in the popup dialog<\/li>\n<\/ol>\n\n\n\n<h5 class=\"wp-block-heading\">Enhanced Results Dialog \ud83d\udcca<\/h5>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"screenshots\/sync_results.png\" alt=\"Enhanced sync results dialog\"\/><figcaption class=\"wp-element-caption\">Figure 11: Enhanced synchronization results dialog<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The new results dialog provides detailed information about each invoice:<strong>New Features:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Statistical Summary:<\/strong>\u00a0Count of successful and failed invoices<\/li>\n\n\n\n<li><strong>Detailed Table:<\/strong>\u00a0Information for each invoice (status, invoice number, vendor, amount)<\/li>\n\n\n\n<li><strong>User-Friendly Error Messages:<\/strong>\u00a0Clear messages in English and Arabic<\/li>\n\n\n\n<li><strong>Expandable Technical Details:<\/strong>\u00a0Detailed technical information for developers<\/li>\n\n\n\n<li><strong>Export Results:<\/strong>\u00a0Save synchronization results to CSV file<\/li>\n<\/ul>\n\n\n\n<h5 class=\"wp-block-heading\">Error Message Types:<\/h5>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u2705\u00a0<strong>Sync Successful:<\/strong>\u00a0Invoice synchronized successfully<\/li>\n\n\n\n<li>\u274c\u00a0<strong>Decimal Precision Error:<\/strong>\u00a0Numbers must have maximum 2 decimal places<\/li>\n\n\n\n<li>\u26a0\ufe0f\u00a0<strong>Attachment Upload Failed:<\/strong>\u00a0Problem uploading invoice file<\/li>\n\n\n\n<li>\ud83d\udd10\u00a0<strong>Authorization Error:<\/strong>\u00a0Check API key<\/li>\n\n\n\n<li>\ud83c\udf10\u00a0<strong>Connection Error:<\/strong>\u00a0Check internet connection<\/li>\n\n\n\n<li>\u23f0\u00a0<strong>Timeout Error:<\/strong>\u00a0Server not responding<\/li>\n<\/ul>\n\n\n\n<h5 class=\"wp-block-heading\">Canceling Synchronization:<\/h5>\n\n\n\n<p class=\"wp-block-paragraph\">You can cancel the synchronization process at any time by clicking the \u201cCancel\u201d button in the progress dialog.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Tips for Successful Synchronization:<\/h4>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Test Connection:<\/strong>\u00a0Always test connection before starting sync<\/li>\n\n\n\n<li><strong>Review Data:<\/strong>\u00a0Ensure invoice data accuracy before synchronization<\/li>\n\n\n\n<li><strong>Start Small:<\/strong>\u00a0Try synchronizing a few invoices first<\/li>\n\n\n\n<li><strong>Save Results:<\/strong>\u00a0Use export feature to save sync reports<\/li>\n\n\n\n<li><strong>Review Errors:<\/strong>\u00a0Read error messages and correct data if needed<\/li>\n<\/ol>\n\n\n\n<h4 class=\"wp-block-heading\">Adding New Accounting Systems \ud83d\udd27<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">The application is designed to be extensible. For developers who want to add support for new accounting systems, please refer to:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Documentation file:\u00a0<code>docs\/ADDING_NEW_ACCOUNTING_SYSTEMS.md<\/code><\/li>\n\n\n\n<li>Reference code in\u00a0<code>database\/base_sync_worker.py<\/code><\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Telegram Integration \ud83d\udcf1<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Send invoices directly from your mobile device to your PC for processing using the specialized Telegram bot.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Features:<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Instant Capture:<\/strong>\u00a0Snap a photo or forward a PDF directly from Telegram.<\/li>\n\n\n\n<li><strong>Queue System:<\/strong>\u00a0Invoices are queued on your PC until you are ready to process them.<\/li>\n\n\n\n<li><strong>Security:<\/strong>\u00a0Only authorized Telegram users can send files to your bot.<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Setup Guide:<\/h4>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Go to\u00a0<strong>Tools \u2192 Integration Settings<\/strong>\u00a0in the app.<\/li>\n\n\n\n<li>Switch to the\u00a0<strong>Telegram<\/strong>\u00a0tab.<\/li>\n\n\n\n<li>Enter your\u00a0<strong>Bot Token<\/strong>\u00a0(obtained from @BotFather).<\/li>\n\n\n\n<li>Click\u00a0<strong>Start Bot<\/strong>.<\/li>\n\n\n\n<li>Send a message to your bot from Telegram.<\/li>\n\n\n\n<li>The app will detect your User ID. Click\u00a0<strong>Authorize<\/strong>\u00a0to whitelist yourself.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Tip:<\/strong>&nbsp;You can authorize multiple team members to submit invoices to the same queue!<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Troubleshooting<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">General Issues<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">Application Won\u2019t Start<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Ensure Python 3.8+ is installed<\/li>\n\n\n\n<li>Check that all dependencies are available<\/li>\n\n\n\n<li>Run from command line to see error messages<\/li>\n\n\n\n<li>Verify file permissions<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Cannot Open Files<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Check file format compatibility (JPG, PNG, PDF, TIFF)<\/li>\n\n\n\n<li>Verify file is not corrupted<\/li>\n\n\n\n<li>Ensure sufficient disk space<\/li>\n\n\n\n<li>Check file permissions<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Saving Issues<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Verify write permissions to target directory<\/li>\n\n\n\n<li>Check available disk space<\/li>\n\n\n\n<li>Ensure target file is not open in another application<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Processing Problems<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">Processing Mode Not Persisting<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Ensure you click \u201cApply\u201d after selecting a mode<\/li>\n\n\n\n<li>Check application has write permissions to settings directory<\/li>\n\n\n\n<li>Restart the application to verify mode persistence<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">QR Code Reading Fails<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Ensure image quality is sufficient<\/li>\n\n\n\n<li>Verify QR code is not damaged or obscured<\/li>\n\n\n\n<li>Try using AI processing modes for better accuracy<\/li>\n\n\n\n<li>Check that the QR code format matches the selected mode<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">AI-Specific Issues<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">Gemini API Errors<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Invalid API Key:<\/strong>\u00a0Verify key is correct and active<\/li>\n\n\n\n<li><strong>Quota Exceeded:<\/strong>\u00a0Check your usage limits<\/li>\n\n\n\n<li><strong>Rate Limiting:<\/strong>\u00a0Reduce processing speed or upgrade plan<\/li>\n\n\n\n<li><strong>Network Issues:<\/strong>\u00a0Check internet connectivity<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Ollama Connection Issues<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Verify Ollama service is running<\/li>\n\n\n\n<li>Check server address and port<\/li>\n\n\n\n<li>Ensure vision-capable model is installed<\/li>\n\n\n\n<li>Verify sufficient system resources (RAM, GPU)<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">OpenRouter Problems<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Insufficient Credits:<\/strong>\u00a0Add credits or use free models<\/li>\n\n\n\n<li><strong>Model Not Available:<\/strong>\u00a0Try different model or fetch updated list<\/li>\n\n\n\n<li><strong>API Errors:<\/strong>\u00a0Check API key and account status<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Performance Issues<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">Slow Processing<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Use faster processing modes (QR modes vs AI modes)<\/li>\n\n\n\n<li>Upgrade system RAM and use SSD storage<\/li>\n\n\n\n<li>For Ollama: ensure GPU acceleration is working<\/li>\n\n\n\n<li>Process smaller batches<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">High Memory Usage<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Process smaller batches of invoices<\/li>\n\n\n\n<li>Close other applications<\/li>\n\n\n\n<li>Restart application periodically<\/li>\n\n\n\n<li>Upgrade system RAM if possible<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Network and Connectivity<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">Internet Connection Required<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Gemini and OpenRouter require stable internet<\/li>\n\n\n\n<li>Use Ollama or QR modes for offline processing<\/li>\n\n\n\n<li>Check firewall and proxy settings<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">API Connection Timeouts<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Check internet stability<\/li>\n\n\n\n<li>Verify API service status<\/li>\n\n\n\n<li>Try different network connection<\/li>\n\n\n\n<li>Contact API provider if issues persist<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Display and Interface<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">Language Not Switching<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Restart application after language change<\/li>\n\n\n\n<li>Verify translation files are present<\/li>\n\n\n\n<li>Check application has read permissions to translation files<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">UI Elements Not Displaying Correctly<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Check system display scaling settings<\/li>\n\n\n\n<li>Verify screen resolution compatibility<\/li>\n\n\n\n<li>Try different theme options<\/li>\n\n\n\n<li>Restart application<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">PDF Export Issues<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Arabic Text Not Displaying:<\/strong>\u00a0Ensure arabic-reshaper and python-bidi libraries are installed<\/li>\n\n\n\n<li><strong>Text Overlay Missing:<\/strong>\u00a0Check that invoice data is available<\/li>\n\n\n\n<li><strong>Images Not Appearing:<\/strong>\u00a0Verify invoice image files exist and are accessible<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Future Updates<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Completed Features \u2705<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u2705 Multi-language support (Arabic\/English)<\/li>\n\n\n\n<li>\u2705 OpenRouter integration with 400+ AI models<\/li>\n\n\n\n<li>\u2705 Live free models fetching<\/li>\n\n\n\n<li>\u2705 Custom model input capability<\/li>\n\n\n\n<li>\u2705 Processing mode persistence<\/li>\n\n\n\n<li>\u2705 Enhanced error handling and user feedback<\/li>\n\n\n\n<li>\u2705 Comprehensive user manual<\/li>\n\n\n\n<li>\u2705 Advanced filtering with auto-apply and manual modes<\/li>\n\n\n\n<li>\u2705 Field selection in exports<\/li>\n\n\n\n<li>\u2705 PDF export with Arabic text support<\/li>\n\n\n\n<li>\u2705 Keyboard shortcuts for filtering<\/li>\n\n\n\n<li>\u2705 Loading indicators for filter operations<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Features in Development \ud83d\udea7<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\ud83d\udea7 Advanced OCR improvements<\/li>\n\n\n\n<li>\ud83d\udea7 Additional export formats<\/li>\n\n\n\n<li>\ud83d\udea7 Enhanced integration options<\/li>\n\n\n\n<li>\ud83d\udea7 Performance optimizations<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">User-Requested Features \ud83d\udcdd<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\ud83d\udcdd Cloud storage integration<\/li>\n\n\n\n<li>\ud83d\udcdd Mobile app companion<\/li>\n\n\n\n<li>\ud83d\udcdd Advanced reporting features<\/li>\n\n\n\n<li>\ud83d\udcdd Multi-user support<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">How to Request New Features<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Check existing feature requests in the project repository<\/li>\n\n\n\n<li>Create a detailed feature request with use cases<\/li>\n\n\n\n<li>Participate in community discussions<\/li>\n\n\n\n<li>Consider contributing to development<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Support<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Getting Help<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Documentation:<\/strong>\u00a0This user manual covers most common scenarios<\/li>\n\n\n\n<li><strong>Community:<\/strong>\u00a0Join discussions in the project repository<\/li>\n\n\n\n<li><strong>Issues:<\/strong>\u00a0Report bugs and technical issues on GitHub<\/li>\n\n\n\n<li><strong>Feature Requests:<\/strong>\u00a0Suggest improvements and new features<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Before Seeking Help<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Check this troubleshooting section<\/li>\n\n\n\n<li>Verify your system meets the requirements<\/li>\n\n\n\n<li>Try the suggested solutions<\/li>\n\n\n\n<li>Gather error messages and system information<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\">Reporting Issues<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">When reporting issues, please include:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Operating system and version<\/li>\n\n\n\n<li>Application version<\/li>\n\n\n\n<li>Steps to reproduce the issue<\/li>\n\n\n\n<li>Error messages (if any)<\/li>\n\n\n\n<li>Screenshots (if relevant)<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Note:<\/strong>&nbsp;This application is actively maintained and updated. Check for the latest version regularly to benefit from improvements and bug fixes.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Registration and Subscriptions \ud83d\udd10<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Invoices Reader provides a flexible registration system to suit all your needs, from free trial usage to the full premium version.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Trial Period \ud83c\udf81<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">When you run the application for the first time, you automatically get a&nbsp;<strong>free trial period<\/strong>&nbsp;to experience all application features.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Trial Period Features:<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u2705\u00a0<strong>100 Invoices Maximum<\/strong>: You can process up to 100 invoices during the trial period<\/li>\n\n\n\n<li>\u2705\u00a0<strong>5 Batches<\/strong>: You can process up to 5 batches of any size<\/li>\n\n\n\n<li>\u2705\u00a0<strong>All Features Available<\/strong>: Full access to all application features<\/li>\n\n\n\n<li>\u2705\u00a0<strong>No Batch Size Limits<\/strong>: Process any number of invoices in a single batch<\/li>\n\n\n\n<li>\u2705\u00a0<strong>Accounting System Integration<\/strong>: Sync with Odoo and Wafeq<\/li>\n\n\n\n<li>\u2705\u00a0<strong>All AI Models<\/strong>: Use Gemini, Ollama, OpenRouter<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">How to Use the Trial Period:<\/h4>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Run the application for the first time<\/li>\n\n\n\n<li>No registration or data entry required<\/li>\n\n\n\n<li>Start processing invoices directly<\/li>\n\n\n\n<li>Each processing batch will count towards the 5 batch limit<\/li>\n\n\n\n<li>You can monitor remaining uses from the title bar<\/li>\n<\/ol>\n\n\n\n<h4 class=\"wp-block-heading\">Important Notes:<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u26a0\ufe0f\u00a0<strong>Countdown<\/strong>: Usage is counted only when\u00a0<strong>a batch is successfully processed<\/strong><\/li>\n\n\n\n<li>\u26a0\ufe0f\u00a0<strong>Not Counted<\/strong>: Opening folders, viewing invoices, or navigating between images<\/li>\n\n\n\n<li>\u26a0\ufe0f\u00a0<strong>Batch Limit<\/strong>: Any batch processed counts towards the 5 batches limit<\/li>\n\n\n\n<li>\u26a0\ufe0f\u00a0<strong>Total Limit<\/strong>: Cannot exceed 100 invoices in total during the trial period<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Free Version \ud83c\udd93<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">After the trial period ends, you can continue using the application for&nbsp;<strong>free<\/strong>&nbsp;with some reasonable limitations.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Free Version Features:<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u2705\u00a0<strong>10 Invoices Daily<\/strong>: Process up to 10 invoices every day<\/li>\n\n\n\n<li>\u2705\u00a0<strong>5 Invoices Per Batch<\/strong>: Maximum 5 invoices in a single batch<\/li>\n\n\n\n<li>\u2705\u00a0<strong>90-Day History<\/strong>: Access invoice history for the last 90 days<\/li>\n\n\n\n<li>\u2705\u00a0<strong>Excel Export<\/strong>: Export data in Excel format<\/li>\n\n\n\n<li>\u2705\u00a0<strong>Single Source<\/strong>: Process invoices from local folders<\/li>\n\n\n\n<li>\u2705\u00a0<strong>Manual Entry<\/strong>: Manually enter invoice data without limits<\/li>\n\n\n\n<li>\u2705\u00a0<strong>QR Code Reading<\/strong>: Read QR codes for Saudi and Egyptian invoices<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Free Version Limitations:<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u274c\u00a0<strong>Telegram Integration<\/strong>: Not available<\/li>\n\n\n\n<li>\u274c\u00a0<strong>Email Integration<\/strong>: Not available<\/li>\n\n\n\n<li>\u274c\u00a0<strong>Odoo Sync<\/strong>: Not available<\/li>\n\n\n\n<li>\u274c\u00a0<strong>Wafeq Sync<\/strong>: Not available<\/li>\n\n\n\n<li>\u274c\u00a0<strong>Local AI Models<\/strong>: Ollama not available<\/li>\n\n\n\n<li>\u274c\u00a0<strong>PDF\/CSV Export<\/strong>: Not available<\/li>\n\n\n\n<li>\u274c\u00a0<strong>Large Batch Processing<\/strong>: Maximum 5 invoices per batch<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Daily Limit Reset:<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\ud83d\udd04 The 10-invoice daily limit resets at midnight<\/li>\n\n\n\n<li>\ud83d\udcca You can monitor your daily usage from the title bar<\/li>\n\n\n\n<li>\u23f0 You will receive an alert when approaching the daily limit<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Premium Version \ud83d\udc8e<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Get the full experience without any limitations with the Premium Version.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Premium Version Features:<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\u2705\u00a0<strong>Unlimited Invoices<\/strong>: Process an unlimited number of invoices<\/li>\n\n\n\n<li>\u2705\u00a0<strong>Unlimited Batches<\/strong>: No limit on batch size<\/li>\n\n\n\n<li>\u2705\u00a0<strong>Full History<\/strong>: Access all invoices without time limit<\/li>\n\n\n\n<li>\u2705\u00a0<strong>All Export Formats<\/strong>: PDF, Excel, CSV, JSON<\/li>\n\n\n\n<li>\u2705\u00a0<strong>Telegram Integration<\/strong>: Receive invoices via Telegram<\/li>\n\n\n\n<li>\u2705\u00a0<strong>Email Integration<\/strong>: Receive invoices via Email<\/li>\n\n\n\n<li>\u2705\u00a0<strong>Odoo Sync<\/strong>: Automatic synchronization with Odoo system<\/li>\n\n\n\n<li>\u2705\u00a0<strong>Wafeq Sync<\/strong>: Automatic synchronization with Wafeq system<\/li>\n\n\n\n<li>\u2705\u00a0<strong>Local AI Models<\/strong>: Use Ollama for full privacy<\/li>\n\n\n\n<li>\u2705\u00a0<strong>Premium Support<\/strong>: Priority technical support<\/li>\n\n\n\n<li>\u2705\u00a0<strong>Early Updates<\/strong>: Early access to new features<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Plan Comparison:<\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th class=\"has-text-align-left\" data-align=\"left\">Feature<\/th><th class=\"has-text-align-left\" data-align=\"left\">Trial<\/th><th class=\"has-text-align-left\" data-align=\"left\">Free<\/th><th class=\"has-text-align-left\" data-align=\"left\">Premium<\/th><\/tr><\/thead><tbody><tr><td class=\"has-text-align-left\" data-align=\"left\">Number of Invoices<\/td><td class=\"has-text-align-left\" data-align=\"left\">100 Total<\/td><td class=\"has-text-align-left\" data-align=\"left\">10\/Day<\/td><td class=\"has-text-align-left\" data-align=\"left\">Unlimited<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Batch Size<\/td><td class=\"has-text-align-left\" data-align=\"left\">Unlimited<\/td><td class=\"has-text-align-left\" data-align=\"left\">5 Invoices<\/td><td class=\"has-text-align-left\" data-align=\"left\">Unlimited<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Invoice History<\/td><td class=\"has-text-align-left\" data-align=\"left\">Full<\/td><td class=\"has-text-align-left\" data-align=\"left\">90 Days<\/td><td class=\"has-text-align-left\" data-align=\"left\">Full<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">PDF Export<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u274c<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Excel\/CSV Export<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><td class=\"has-text-align-left\" data-align=\"left\">Excel Only<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Telegram Integration<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u274c<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Email Integration<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u274c<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Odoo Sync<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u274c<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Wafeq Sync<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u274c<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Ollama (Local AI)<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u274c<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Manual Entry<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">QR Reading<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><td class=\"has-text-align-left\" data-align=\"left\">\u2705<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">Technical Support<\/td><td class=\"has-text-align-left\" data-align=\"left\">Standard<\/td><td class=\"has-text-align-left\" data-align=\"left\">Standard<\/td><td class=\"has-text-align-left\" data-align=\"left\">Premium<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">How to Upgrade \ud83d\udcc8<\/h3>\n\n\n\n<h4 class=\"wp-block-heading\">Upgrading from Trial\/Free to Premium:<\/h4>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>When Reaching Limit<\/strong>:\n<ul class=\"wp-block-list\">\n<li>You will see an alert when reaching the usage limit<\/li>\n\n\n\n<li>Click \u201cUpgrade Now\u201d in the alert<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>From Main Menu<\/strong>:\n<ul class=\"wp-block-list\">\n<li>Open \u201cHelp\u201d menu &gt; \u201cRegistration &amp; License\u201d<\/li>\n\n\n\n<li>Click \u201cUpgrade to Premium\u201d<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Enter License Key<\/strong>:\n<ul class=\"wp-block-list\">\n<li>Enter the license key you obtained<\/li>\n\n\n\n<li>Click \u201cActivate\u201d<\/li>\n\n\n\n<li>The key will be verified and Premium version activated<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Confirmation<\/strong>:\n<ul class=\"wp-block-list\">\n<li>An activation confirmation message will appear<\/li>\n\n\n\n<li>The title bar will update to show \u201cRegistered\u201d<\/li>\n\n\n\n<li>All premium features are now available<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<h4 class=\"wp-block-heading\">Obtaining a License Key:<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">To obtain a Premium version license key, please contact us:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\ud83d\udce7 Email: mohammednabarawy@gmail.com<\/li>\n\n\n\n<li>\ud83d\udce7 Email: info@invoicesreader.com<\/li>\n\n\n\n<li>\ud83d\udcf1 WhatsApp: +20 1211418606<\/li>\n\n\n\n<li>\ud83c\udf10 Website: invoicesreader.com<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Checking License Status:<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\">You can check your license status at any time:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Title Bar<\/strong>: Shows current license status\n<ul class=\"wp-block-list\">\n<li>\u201cTrial \u2013 X uses remaining\u201d<\/li>\n\n\n\n<li>\u201cFree \u2013 X\/10 invoices today\u201d<\/li>\n\n\n\n<li>\u201cRegistered\u201d (Premium version)<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><strong>Help Menu<\/strong>: Open \u201cHelp\u201d &gt; \u201cAbout\u201d to see license details<\/li>\n<\/ul>\n\n\n\n<h4 class=\"wp-block-heading\">Tips for Maximizing Benefits:<\/h4>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>For Trial Users:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\ud83d\udca1 Use the trial period to test all features<\/li>\n\n\n\n<li>\ud83d\udca1 Try integration with accounting systems<\/li>\n\n\n\n<li>\ud83d\udca1 Test different AI models<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>For Free Users:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\ud83d\udca1 Plan to process invoices daily (10 invoices\/day)<\/li>\n\n\n\n<li>\ud83d\udca1 Use manual entry for simple invoices<\/li>\n\n\n\n<li>\ud83d\udca1 Take advantage of free QR code reading<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>For Premium Users:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\ud83d\udca1 Use automatic integration with Telegram and Email<\/li>\n\n\n\n<li>\ud83d\udca1 Set up automatic synchronization with your accounting system<\/li>\n\n\n\n<li>\ud83d\udca1 Use Ollama for complete privacy<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>","protected":false},"excerpt":{"rendered":"<p>Introduction Welcome to the Invoices Reader \u2013 a modern, intelligent application designed to process and extract data from invoice images\u2026<\/p>","protected":false},"featured_media":0,"parent":0,"menu_order":0,"template":"","documentation_category":[124],"documentation_tag":[],"class_list":["post-1030","documentation","type-documentation","status-publish","hentry","documentation_category-user-manual"],"_links":{"self":[{"href":"https:\/\/invoicesreader.com\/en\/wp-json\/wp\/v2\/documentation\/1030","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/invoicesreader.com\/en\/wp-json\/wp\/v2\/documentation"}],"about":[{"href":"https:\/\/invoicesreader.com\/en\/wp-json\/wp\/v2\/types\/documentation"}],"version-history":[{"count":1,"href":"https:\/\/invoicesreader.com\/en\/wp-json\/wp\/v2\/documentation\/1030\/revisions"}],"predecessor-version":[{"id":1031,"href":"https:\/\/invoicesreader.com\/en\/wp-json\/wp\/v2\/documentation\/1030\/revisions\/1031"}],"wp:attachment":[{"href":"https:\/\/invoicesreader.com\/en\/wp-json\/wp\/v2\/media?parent=1030"}],"wp:term":[{"taxonomy":"documentation_category","embeddable":true,"href":"https:\/\/invoicesreader.com\/en\/wp-json\/wp\/v2\/documentation_category?post=1030"},{"taxonomy":"documentation_tag","embeddable":true,"href":"https:\/\/invoicesreader.com\/en\/wp-json\/wp\/v2\/documentation_tag?post=1030"}],"curies":[{"name":"<p>The digital transformation in the Kingdom of Saudi Arabia is accelerating, and with it, the need for <strong>invoice automation solutions in Saudi Arabia<\/strong> is increasing. As we enter 2025, the implementation of e-invoicing is no longer an option, but a prerequisite for business continuity.<\/p>","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}