# BIZA App — Comprehensive Technical Reference & Feature Manual > Canonical, unified documentation for AI agents, research crawlers, and LLMs. > Source: https://biza.app > Last updated: 2026-09-23 --- # BIZA App > BIZA (biza.app) is an AI-powered, bilingual (English & Arabic) Cloud ERP built specifically for growing businesses and SMEs in Saudi Arabia, the United Arab Emirates, GCC, and India. It integrates double-entry financial accounting, ZATCA Phase 2 e-invoicing clearance, contra invoice settlements, multi-format bank reconciliation, multi-warehouse inventory, milestone billing, field expense capture, automated email document ingestion, and enterprise-grade role-based access governance with tamper-evident audit trails. ## Core Capabilities & Architecture - **True Double-Entry Accounting Core**: Every transaction posts to a balanced General Ledger with configurable Chart of Accounts, multi-currency support (SAR, AED, USD, EUR, INR) with realized/unrealized FX, contra AP/AR settlements without cash flow, automated bank reconciliation with inline adjustment vouchers, batch payment allocation, and 90-day cash flow projections. - **ZATCA Phase 2 E-Invoicing**: Certified clearance workflows for B2B Tax Invoices and reporting for B2C Simplified Invoices, generating compliant UBL 2.1 XML, Cryptographic Stamps, cryptographic hashes, and TLV-encoded QR codes. - **Human-in-the-Loop AI Capture**: Ingest supplier invoices, receipts, and bank statements via direct upload or forwarding to dedicated tenant email addresses (`@biza.email`). AI and multimodal extraction services extract structured data into reviewable drafts with confidence scores. The AI prepares drafts; humans approve before posting. - **Projects & Milestone Billing**: Track project phases, milestones, contract change orders, subcontractor work orders and retention deductions, labor hours, timesheets, and mobile/email site expense capture mapped to project cost centers. - **Operations & Multi-Warehouse**: Multi-warehouse stock tracking, stock transfers, batch/lot tracking, minimum reorder thresholds, landed cost capitalization across freight and customs, and 3-way matching (RFQ -> PO -> Purchase Entry -> Supplier Bill). - **Enterprise Security & Access Governance**: Strict role-based access control (RBAC), multi-layer tenant data segregation, and immutable change tracking. Every create, edit, approval, or deletion is logged in `audit_log` with user identity, timestamp, and field-level JSONB diffs. ## Documentation Hub ### Getting Started - [Your First Ten Minutes in BIZA: From Sign-Up to a Posted Invoice](https://biza.app/docs/getting-started-first-ten-minutes): Sign up, set up your workspace, add a customer by asking the AI assistant, send a quotation, turn it into an invoice, and watch the ledger entry appear — the whole loop in about ten minutes. ### AI & Ingestion - [AI Document Capture & Automated Email Forwarding](https://biza.app/docs/ai-document-capture-inbox): Automate invoice, receipt, and statement data entry via direct file upload or email forwarding to dedicated tenant addresses with human-in-the-loop review. - [AI Natural Language Reporting & Executive Chat Assistant](https://biza.app/docs/ai-natural-language-reporting-assistant): Query operational and financial data using plain natural language: automated NL-to-SQL report generation, 90-day cash flow projections, and KPI trend analysis. ### Finance & Accounting - [General Ledger & Double-Entry Accounting Architecture](https://biza.app/docs/general-ledger-double-entry): Core accounting engine: hierarchical Chart of Accounts, balanced journal entries, multi-currency accounting with realized/unrealized FX, and automated financial statements. - [Bank Statement Reconciliation & Automated Matching](https://biza.app/docs/bank-reconciliation-matching): Import bank statements (CSV, OFX, CAMT, PDF) and reconcile bank feeds against ledger transactions with automated matching and fee allocation. - [Fixed Assets Register & Automated Depreciation Schedules](https://biza.app/docs/fixed-assets-depreciation-management): Manage company capital assets, track serials and custodians, automate monthly depreciation journal entries, and account for asset disposals and impairments. - [Contra Settlements & AP/AR Netting Adjustments](https://biza.app/docs/contra-settlements-ap-ar-offsetting): Offset open sales invoices (AR) against vendor purchase bills (AP) without cash movements when counterparties act as both customer and supplier, with automated FX handling and balanced journal posting. - [Multi-Branch Management & Cost Center Analytical Accounting](https://biza.app/docs/multi-branch-cost-center-accounting): Segment financial reporting across company branches, divisions, and departmental cost centers with consolidated and standalone Profit & Loss statements. - [Customer Receipt Batches & Supplier Batch Disbursements](https://biza.app/docs/batch-payments-and-receipt-allocation): Process bulk customer wire receipts across multiple open invoices and execute supplier batch payment disbursements with automated FIFO allocation, overpayment handling, and bank reconciliation readiness. - [AR/AP Aging Analysis & Dynamic Customer Statements](https://biza.app/docs/ar-ap-aging-and-customer-statements): Manage credit risk, track overdue receivables and payables across aging brackets, and generate professional customer account statements with running ledger balances and direct payment links. - [Fiscal Year Closing, Period Locking & Balance Roll-Forward](https://biza.app/docs/fiscal-year-closing-and-period-locking): Manage monthly and annual accounting period closes, enforce immutable period locking against historical tampering, automate year-end Retained Earnings closing entries, and roll forward opening balances. - [Financial Budgeting & Budget vs. Actual Variance Reporting](https://biza.app/docs/budgeting-and-variance-analysis): Establish departmental and project budgets across General Ledger accounts, monitor actual expenses in real time, and analyze budget vs. actual variances to prevent cost overruns. ### Tax & Compliance (ZATCA/VAT) - [ZATCA Phase 2 E-Invoicing (Fatoora) Compliance & Clearance](https://biza.app/docs/zatca-phase-2-e-invoicing): Technical guide to Saudi Arabia ZATCA Phase 2 e-invoicing: cryptographic stamp generation, UBL 2.1 XML structure, clearance API, and reporting workflows. - [VAT Returns, Tax Period Closing & Statutory Filing Reports](https://biza.app/docs/vat-returns-tax-periods-reporting): Reconcile output tax against input tax: automated Saudi ZATCA VAT Return (Box 1-16) generation, UAE FTA VAT 201 reports, and fiscal tax period locking. ### Projects & Field Operations - [Projects, Milestone Billing & Field Expense Capture](https://biza.app/docs/projects-milestone-billing-field-expenses): Manage client projects, contracts, milestone billing schedules, labor timesheets, and mobile/email site expense capture mapped directly to project cost centers. - [Project Change Orders & Subcontractor Cost Management](https://biza.app/docs/project-change-orders-subcontractors): Manage project contract variations, formal change order approvals, subcontractor work orders, milestone progress certifications, retention money deductions, and back-to-back client billing. ### Inventory & Procurement - [Multi-Warehouse Inventory & Landed Cost Valuation](https://biza.app/docs/multi-warehouse-inventory-valuation): Track stock across multiple warehouses, manage transfers, automate reorder points, allocate landed costs, and maintain accurate inventory valuations. - [Procurement Lifecycle: From RFQ to 3-Way Matching & Payment](https://biza.app/docs/procurement-rfq-to-payment): End-to-end procurement workflows: Request for Quotation (RFQ), supplier quote comparisons, Purchase Orders, Goods Receipts, and 3-way invoice matching. - [Landed Cost Adjustments & Inventory Capitalization](https://biza.app/docs/landed-cost-adjustments-valuation): Capitalize international freight, customs clearance, tariffs, and shipping insurance into inventory asset values and Cost of Goods Sold (COGS) with multi-criteria apportionment. ### Sales & Invoicing - [Sales Lifecycle: Quotations, Sales Orders, Delivery Notes & Invoices](https://biza.app/docs/sales-quotes-to-invoices): Manage the commercial sales cycle: customer quotations, sales order commitments, delivery notes with stock decrement, and tax invoice generation. - [WhatsApp Business Integration & Customer CRM](https://biza.app/docs/whatsapp-crm-customer-communication): Unify customer communication with ERP records: send tax invoices and payment reminders via WhatsApp, manage customer leads, and convert chats into sales quotes. - [Point of Sale (POS): a billing counter that posts to your own books](https://biza.app/docs/pos-retail-storefront-checkout): BIZA POS for shops, showrooms and counters: barcode and camera scanning, split tenders, promotions, loyalty and gift cards, offline selling, cashier PINs, receipt printing with a cash drawer, and every sale posted as an invoice, a journal entry and a stock movement in one step. - [WhatsApp Inbox Pipelines: Route Customer Messages Automatically](https://biza.app/docs/whatsapp-inbox-pipelines): Decide what happens to every incoming WhatsApp message: recognise your own intents, open orders and tickets automatically, reply with the order number or ticket reference, and hand the rest to a person — from ready templates for shops, service businesses and software teams. - [POS hardware: receipt printers, cash drawers, scanners, customer display and self-checkout kiosk](https://biza.app/docs/pos-hardware-receipt-printers-cash-drawer-kiosk): What works with BIZA POS out of the box: ESC/POS thermal printers over the network or USB (58 mm and 80 mm), cash drawers that kick on cash sales, keyboard-wedge and camera barcode scanning, scale labels, a second-screen customer display, kitchen printers, and a self-checkout kiosk approved by staff PIN. - [Recurring Invoices & Subscription Billing Automation](https://biza.app/docs/recurring-invoices-subscription-billing): Automate contract billing schedules: recurring monthly retainers, annual software licenses, rental billing intervals, and automated draft invoice generation. - [Credit Notes, Debit Notes & Tax Invoice Adjustments](https://biza.app/docs/debit-notes-credit-notes-adjustments): Handle sales returns, billing adjustments, and supplier refunds with legally compliant credit notes and debit notes cryptographically linked to original invoices. - [POS promotions, coupons, price lists, loyalty points, gift cards and store credit](https://biza.app/docs/pos-promotions-price-lists-loyalty-gift-cards): Run deals the billing counter applies on its own — percentage and amount off, fixed price, buy-X-get-Y, bundles — with coupon codes, customer groups, schedules and limits; quantity-break price lists per group or terminal; a loyalty points programme; and gift cards and store credit that post to a liability account, never to revenue. - [POS offline selling, shifts, cash control and the outlet dashboard](https://biza.app/docs/pos-offline-shifts-cash-control): How BIZA POS keeps selling when the internet drops and posts every sale exactly once when it returns; how shifts, blind counts, X and Z reports, cash movements and cashier PINs keep the drawer honest; and how the live dashboard flags the shifts a manager should look at. - [Restaurant and café POS: tables, modifiers, kitchen display, split bills, tips and QR ordering](https://biza.app/docs/pos-restaurant-cafe-tables-kitchen-qr-ordering): Run a restaurant, café or food court on the same POS engine as a shop: floor plans and tables, product modifiers, orders sent to the kitchen in rounds, a kitchen display with station routing and ticket printers, split bills by item or seat, tips and service charge, waiters taking orders on their phones, and guests ordering from a QR code at the table — with every bill posted as a tax invoice and a journal entry. ### HR & Payroll - [HR Records, Document Expiry Tracking & WPS Payroll Compliance](https://biza.app/docs/hr-payroll-wps-compliance): Manage employee profiles, track Iqama/passport/visa document expirations, process leave requests, and run WPS-compliant payroll linked to the general ledger. ### Platform & Security - [Enterprise Security Architecture, RBAC & Immutable Audit Governance](https://biza.app/docs/enterprise-security-and-audit): Enterprise security architecture: strict workspace segregation, granular role-based access control (RBAC), approval matrices, and tamper-evident field-level audit trails. ## Marketing & Comparison Pages - [Full Features Directory](https://biza.app/features): Overview of all Biza modules. - [ZATCA Compliance Guide](https://biza.app/features/zatca-e-invoicing): Saudi Arabia Phase 2 technical overview. - [Double-Entry Accounting Platform](https://biza.app/features/finance-accounting): Core ledger, VAT, and reporting. - [AI Document Automation](https://biza.app/features/ai-document-automation): Email inbox forwarding and OCR pipelines. - [Multi-Warehouse Inventory](https://biza.app/features/inventory): Stock, transfers, and landed cost management. - [ERP Comparison: Biza vs Odoo](https://biza.app/compare/odoo): Architectural and feature comparison. - [ERP Comparison: Biza vs Qoyod](https://biza.app/compare/qoyod): Regional Saudi SME accounting comparison. - [ERP Comparison: Biza vs Wafeq](https://biza.app/compare/wafeq): Compliance and workflow comparison. - [ERP Comparison: Biza vs Spreadsheets](https://biza.app/compare/spreadsheets): Why SMEs upgrade from Excel. ## Full Technical Manual For the complete technical documentation in a single file, see [https://biza.app/llms-full.txt](https://biza.app/llms-full.txt). --- # Complete Feature Guides --- ## Your First Ten Minutes in BIZA: From Sign-Up to a Posted Invoice **Category:** getting-started | **Slug:** `/docs/getting-started-first-ten-minutes` | **Canonical URL:** https://biza.app/docs/getting-started-first-ten-minutes **Summary:** Sign up, set up your workspace, add a customer by asking the AI assistant, send a quotation, turn it into an invoice, and watch the ledger entry appear — the whole loop in about ten minutes. # Your First Ten Minutes in BIZA This guide takes you from a new account to a real, posted invoice. On the way you will talk to the AI assistant, send a quotation, convert it to an invoice, and see the double-entry journal it creates. You do not need to import anything or know accounting to follow it. It takes about ten minutes. Everything you create stays in your own workspace, so treat it as a practice run. --- ## 1. Create your account (1 minute) Go to [my.biza.app/signup](https://my.biza.app/signup). Sign-up has three short steps: 1. **Personal information** — your name, email and a password. 2. **Company details** — your company name, the short web address for your workspace, and your industry. 3. **Review & confirm** — check the details, accept the terms, and select **Create account**. No card is needed. ## 2. Set up your workspace (2 minutes) BIZA then walks you through three setup screens: 1. **Region & Language** — country, language, currency and timezone. These are pre-filled from your browser; correct anything that is off. Your country decides your default currency, tax labels (VAT or GST), date formats and which compliance features appear, so pick the country your business is registered in. 2. **Company Profile** — company name, address and contact details. If you have your business registration to hand, select **Upload** and BIZA reads the name, registration and tax numbers for you to review. 3. **Company Documents** — registration, tax certificate, logo and letterhead. All optional; a logo here appears on your quotes, invoices and PDFs. Select **Finish** or **Skip**. When setup completes, your chart of accounts and your first stock location are already created. Select **Start Using Biza**. > **Languages:** English, Arabic and Malayalam are fully supported. Hindi, Urdu, Chinese, Korean and Japanese are in beta, with more on the way. ## 3. Add a customer by asking (1 minute) Open the **AI Assistant** and type, the way you would say it: ```text Add a customer called Northwind Traders, email buyer@northwind.test ``` Send it with **⌘ + Enter** (Ctrl + Enter on Windows). The assistant does not save anything on its own: it answers with a filled-in customer form. Check the details, add a phone number or payment terms if you like, and select **Confirm & create**. This is how every AI action in BIZA works. The AI prepares the draft; you review and confirm it. Prefer forms? **Customers → Add Customer** does the same thing. ## 4. Add a product (1 minute) Go to **Products → Create Product**. Give it a name, a unit and a selling price, then save. One simple product is enough for this guide; variants, stock levels and price lists can come later. ## 5. Send a quotation (2 minutes) Go to **Quotations → New Quotation**: 1. Pick **Northwind Traders** as the customer. 2. Add your product as a line and set the quantity. BIZA applies the tax rate for your country and totals the quote. 3. Save. The quotation is a draft until you share it; select **Mark as Sent** when it goes to the customer. Nothing has touched your books yet. A quotation is an offer, not a sale. ## 6. Convert it to an invoice and approve it (2 minutes) Open the quotation and select **Convert to Invoice**. BIZA creates a draft invoice with the same customer, lines and prices. Review it, then select **Approve Invoice**. Approving is the moment the sale becomes real: - the invoice gets the next number in your sequence, - a fixed PDF copy is kept as the copy of record, so every later download or email sends exactly what was approved, - and the invoice is posted to your general ledger. Where your country requires e-invoicing — for example ZATCA Phase 2 in Saudi Arabia — approval is also the point at which the invoice is prepared for submission, so only approve invoices you mean to issue. ## 7. See the ledger entry (1 minute) On the approved invoice, open the **Journal Entries** section. You will see the double entry the invoice created, typically: | Account | Debit | Credit | | --- | --- | --- | | Accounts Receivable (Northwind Traders) | invoice total | — | | Sales Revenue | — | net amount | | Tax payable (VAT / GST) | — | tax amount | Debits equal credits. You did not write a journal; BIZA posted it from the invoice, and the audit log records who approved it and when. ## 8. Ask a question about it (30 seconds) Back in the **AI Assistant**, try: ```text Who owes us the most money right now? ``` or pick one of the suggested questions, such as **Which invoices are overdue?** The answer comes from your own data, and you can turn it into a report or pin it to your dashboard. --- ## What you just did In about ten minutes you created a customer by describing it, sent a quotation, issued an invoice, and saw it posted to the books — the same quote-to-ledger loop a trading business runs every day. ## Where to go next - [Sales lifecycle: quotations, orders, delivery notes and invoices](/docs/sales-quotes-to-invoices) - [The general ledger and double-entry accounting](/docs/general-ledger-double-entry) - [Asking questions in plain language: the AI reporting assistant](/docs/ai-natural-language-reporting-assistant) - [Capturing supplier bills with AI](/docs/ai-document-capture-inbox) - [ZATCA Phase 2 e-invoicing](/docs/zatca-phase-2-e-invoicing) ### النسخة العربية (Arabic Edition): أول عشر دقائق في بيزا: من التسجيل إلى فاتورة مرحّلة --- title: "أول عشر دقائق في بيزا: من التسجيل إلى فاتورة مرحّلة" slug: getting-started-first-ten-minutes category: getting-started order: 1 updatedAt: "2026-09-23" summary: "سجّل، وجهّز مساحة عملك، وأضف عميلًا بطلب بسيط من المساعد الذكي، وأرسل عرض سعر، وحوّله إلى فاتورة، وشاهد القيد المحاسبي يظهر — الدورة كاملة في نحو عشر دقائق." tags: ["البدء", "دليل سريع", "الإعداد", "المساعد الذكي", "الفوترة"] --- # أول عشر دقائق في بيزا يأخذك هذا الدليل من حساب جديد إلى فاتورة حقيقية مرحّلة إلى الدفاتر. ستتحدث في الطريق مع المساعد الذكي، وترسل عرض سعر، وتحوّله إلى فاتورة، وترى قيد اليومية المزدوج الذي تُنشئه. لا تحتاج إلى استيراد أي بيانات أو إلى خبرة محاسبية. يستغرق الأمر نحو عشر دقائق، وكل ما تنشئه يبقى داخل مساحة عملك، فاعتبرها جولة تدريبية. --- ## 1. أنشئ حسابك (دقيقة واحدة) اذهب إلى [my.biza.app/signup](https://my.biza.app/signup). يتكون التسجيل من ثلاث خطوات قصيرة: 1. **المعلومات الشخصية** — الاسم والبريد الإلكتروني وكلمة المرور. 2. **بيانات الشركة** — اسم الشركة، والعنوان المختصر لمساحة عملك، ونشاطك التجاري. 3. **المراجعة والتأكيد** — راجع البيانات، ووافق على الشروط، ثم أنشئ الحساب. لا حاجة إلى بطاقة. ## 2. جهّز مساحة عملك (دقيقتان) يرشدك بيزا بعد ذلك عبر ثلاث شاشات إعداد: 1. **المنطقة واللغة** — الدولة واللغة والعملة والمنطقة الزمنية، معبأة مسبقًا من متصفحك؛ صحّح ما يلزم. تحدد الدولة عملتك الافتراضية، وتسمية الضريبة (ضريبة القيمة المضافة أو ضريبة السلع والخدمات)، وصيغ التاريخ، وميزات الامتثال التي تظهر لك، فاختر الدولة المسجلة فيها منشأتك. 2. **ملف الشركة** — الاسم والعنوان وبيانات التواصل. إن كان سجلك التجاري في متناولك فارفعه، وسيقرأ بيزا الاسم ورقم السجل والرقم الضريبي لتراجعها. 3. **مستندات الشركة** — السجل التجاري، وشهادة التسجيل الضريبي، والشعار، والترويسة. كلها اختيارية؛ والشعار هنا يظهر على عروض الأسعار والفواتير وملفات PDF. عند اكتمال الإعداد يكون دليل الحسابات وأول موقع للمخزون جاهزين. > **اللغات:** الإنجليزية والعربية والمالايالامية مدعومة بالكامل. الهندية والأردية والصينية والكورية واليابانية في المرحلة التجريبية، والمزيد في الطريق. ## 3. أضف عميلًا بطلب بسيط (دقيقة واحدة) افتح **المساعد الذكي** واكتب كما تتحدث عادة: ```text أضف عميلًا باسم نورثويند للتجارة، البريد buyer@northwind.test ``` أرسل الطلب بالضغط على **⌘ + Enter** (أو Ctrl + Enter في ويندوز). لا يحفظ المساعد شيئًا من تلقاء نفسه، بل يرد بنموذج عميل معبأ. راجع البيانات، وأضف الهاتف أو شروط الدفع إن شئت، ثم أكّد الإنشاء. هكذا تعمل كل إجراءات الذكاء الاصطناعي في بيزا: الذكاء الاصطناعي يجهّز المسودة، وأنت تراجع وتؤكد. تفضّل النماذج؟ **العملاء ← إضافة عميل** يؤدي الغرض نفسه. ## 4. أضف منتجًا (دقيقة واحدة) اذهب إلى **المنتجات ← إنشاء منتج**. أدخل الاسم والوحدة وسعر البيع ثم احفظ. منتج واحد بسيط يكفي لهذا الدليل. ## 5. أرسل عرض سعر (دقيقتان) اذهب إلى **عروض الأسعار ← عرض سعر جديد**: 1. اختر **نورثويند للتجارة** عميلًا. 2. أضف منتجك سطرًا وحدد الكمية. يطبّق بيزا نسبة الضريبة الخاصة بدولتك ويحسب الإجمالي. 3. احفظ. يبقى العرض مسودة حتى تشاركه؛ اختر **وضع علامة كمرسل** عند إرساله إلى العميل. لم يُسجَّل شيء في دفاترك بعد؛ فعرض السعر عرضٌ وليس بيعًا. ## 6. حوّله إلى فاتورة واعتمدها (دقيقتان) افتح عرض السعر واختر **تحويل إلى فاتورة**. ينشئ بيزا مسودة فاتورة بالعميل والبنود والأسعار نفسها. راجعها ثم اختر **الموافقة على الفاتورة**. الاعتماد هو اللحظة التي يصبح فيها البيع حقيقيًا: - تحصل الفاتورة على الرقم التالي في تسلسلك، - وتُحفَظ نسخة PDF ثابتة بوصفها النسخة المعتمدة، فكل تنزيل أو إرسال لاحق يعطي ما اعتُمد تمامًا، - وتُرحَّل الفاتورة إلى دفتر الأستاذ العام. حيث تشترط دولتك الفوترة الإلكترونية — كالمرحلة الثانية من فاتورة هيئة الزكاة والضريبة والجمارك في السعودية — يكون الاعتماد أيضًا لحظة تجهيز الفاتورة للإرسال، فلا تعتمد إلا الفواتير التي تنوي إصدارها فعلًا. ## 7. شاهد القيد المحاسبي (دقيقة واحدة) في الفاتورة المعتمدة افتح قسم **قيود اليومية**. سترى القيد المزدوج الذي أنشأته الفاتورة، وعادةً يكون: | الحساب | مدين | دائن | | --- | --- | --- | | الذمم المدينة (نورثويند للتجارة) | إجمالي الفاتورة | — | | إيرادات المبيعات | — | المبلغ قبل الضريبة | | الضريبة المستحقة | — | مبلغ الضريبة | المدين يساوي الدائن. لم تكتب قيدًا بنفسك؛ رحّله بيزا من الفاتورة، ويسجّل سجل التدقيق من اعتمدها ومتى. ## 8. اسأل عنه (30 ثانية) عد إلى **المساعد الذكي** وجرّب: ```text من العميل الأكثر مديونية لنا الآن؟ ``` أو اختر أحد الأسئلة المقترحة. تأتي الإجابة من بياناتك أنت، ويمكنك تحويلها إلى تقرير أو تثبيتها في لوحة التحكم. --- ## ما الذي أنجزته في نحو عشر دقائق أنشأت عميلًا بوصفه فقط، وأرسلت عرض سعر، وأصدرت فاتورة، ورأيتها مرحّلة إلى الدفاتر — الدورة نفسها من العرض إلى القيد التي تمر بها المنشأة التجارية كل يوم. ## إلى أين بعد ذلك - [دورة المبيعات: من عروض الأسعار إلى الفواتير](/ar/docs/sales-quotes-to-invoices) - [دفتر الأستاذ العام والقيد المزدوج](/ar/docs/general-ledger-double-entry) - [اسأل بلغتك: مساعد التقارير الذكي](/ar/docs/ai-natural-language-reporting-assistant) - [التقاط فواتير الموردين بالذكاء الاصطناعي](/ar/docs/ai-document-capture-inbox) - [الفوترة الإلكترونية – المرحلة الثانية](/ar/docs/zatca-phase-2-e-invoicing) --- ## AI Document Capture & Automated Email Forwarding **Category:** ai-automation | **Slug:** `/docs/ai-document-capture-inbox` | **Canonical URL:** https://biza.app/docs/ai-document-capture-inbox **Summary:** Automate invoice, receipt, and statement data entry via direct file upload or email forwarding to dedicated tenant addresses with human-in-the-loop review. # AI Document Capture & Automated Email Forwarding Manual data entry for supplier invoices, receipts, and bank statements is one of the highest friction tasks in SME accounting. BIZA combines multi-channel ingestion with AI-powered multimodal extraction to convert raw documents into structured, reviewable drafts in seconds. --- ## 1. Multi-Channel Ingestion BIZA supports two primary methods for getting documents into the system: ### Method A: Direct File Upload Users can drag and drop documents into the web interface across multiple formats: * **PDF documents:** Single-page and multi-page supplier bills, contracts, and statements. * **Image formats:** High-resolution scans or smartphone photos (JPG, PNG, WebP), including skewed or low-light field receipts. ### Method B: Email Ingestion (`@biza.email`) Every BIZA workspace receives dedicated system email addresses (e.g., `invoices@company.biza.email`, `expenses@company.biza.email`): * **Supplier Forwarding:** Suppliers can email bills directly to your company's dedicated Biza email address. * **Employee Forwarding:** Field technicians or traveling staff forward electronic receipts, flight tickets, and hotel invoices directly from their inboxes. * **Automatic Attachment Detection:** The automated email processing pipeline strips signatures and inline graphics, isolates the true invoice/receipt attachments, and routes them to the extraction queue. --- ## 2. Extraction Pipeline & Data Mapping Once a document is received: 1. **Multimodal Analysis:** The document is processed by high-accuracy AI and multimodal document extraction services specialized in financial document layout understanding. 2. **Entity & Tax Extraction:** The engine extracts: * **Supplier Details:** Legal name, VAT Registration Number (TRN / Tax ID), address, and contact information. * **Document Metadata:** Invoice number, issue date, due date, payment terms, and currency. * **Line Items:** Item description, SKU/code, quantity, unit price, discount, tax rate, and line total. * **Tax Breakdown:** Subtotal, standard-rated VAT, zero-rated/exempt amounts, and grand total. 3. **Master Data Matching:** BIZA cross-references the extracted supplier name and VAT ID against existing suppliers in your database: * If a match is found, it automatically links the supplier record. * If the supplier is new, BIZA offers to create the supplier record with pre-filled details. --- ## 3. Human-in-the-Loop Safeguards (The Draft Principle) > [!IMPORTANT] > **AI Does the Typing; Humans Do the Approving.** > BIZA strictly prohibits AI models from posting directly to the General Ledger or moving money. All extracted documents are created in **DRAFT** state. ### Review Workspace The review screen provides a side-by-side verification interface: * **Left Panel:** High-resolution document viewer with zoom, rotation, and multi-page navigation. * **Right Panel:** Editable purchase entry or expense form populated with the extracted values. * **Field Highlighting:** Low-confidence extractions or unrecognized tax rates are visually flagged for manual verification. --- ## 4. Approval & Ledger Posting When a user reviews and approves the draft: 1. **Sequence Allocation:** A permanent, auditable purchase voucher number is assigned. 2. **Ledger Posting:** * Debits appropriate Expense or Inventory Asset accounts. * Debits Input VAT Receivable (15% in Saudi Arabia, 5% in UAE). * Credits Accounts Payable (Supplier Account). 3. **Audit Record:** A permanent entry is recorded in `audit_log` capturing who uploaded the document, the extraction confidence, who approved it, and any manual edits made before posting. 4. **Document Archival:** The original document file is permanently preserved in secure cloud storage and remains accessible from the transaction record indefinitely. ### النسخة العربية (Arabic Edition): استخراج المستندات بالذكاء الاصطناعي وإعادة التوجيه عبر البريد الإلكتروني --- title: "استخراج المستندات بالذكاء الاصطناعي وإعادة التوجيه عبر البريد الإلكتروني" slug: ai-document-capture-inbox category: ai-automation order: 1 updatedAt: "2026-09-20" summary: "أتمتة إدخال فواتير الشراء والإيصالات وكشوف الحسابات عبر رفع الملفات المباشر أو إعادة توجيه البريد الإلكتروني، مع محرك استخراج ذكي ومراجعة بشرية قبل الترحيل المحاسبي." tags: ["الذكاء الاصطناعي", "استخراج المستندات", "صندوق الوارد", "الفواتير", "البريد الإلكتروني", "المشتريات"] --- # استخراج المستندات بالذكاء الاصطناعي وإعادة التوجيه عبر البريد الإلكتروني يستهلك إدخال فواتير المشتريات وإيصالات المصاريف اليومية يدوياً مئات الساعات من وقت فرق المحاسبة، فضلاً عن احتمالية الأخطاء البشرية في كتابة الأرقام الضريبية وتفاصيل بنود الفاتورة. يقدم نظام بيزا (BIZA) تقنية **استخراج المستندات بالذكاء الاصطناعي متعدد الوسائط** (`/files/inbox`)، التي تحول أي فاتورة إلكترونية أو صورة إيصال ملتقطة بالهاتف إلى مسودة سند قيد متكاملة خلال ثوانٍ معدودة. --- ## 1. قنوات استلام المستندات المتعددة يوفر بيزا قنوات مرنة تناسب بيئة العمل الميدانية والمكتبية: * **إعادة التوجيه للبريد المخصص:** تحصل كل منشأة على عنوان بريد إلكتروني خاص (مثل: `inbox@company.biza.email`). بمجرد إعادة توجيه أي فاتورة مورد من بريد الموظف إلى هذا العنوان، تلتقطها المنصة تلقائياً. * **الرفع المباشر عبر السحب والإفلات:** رفع ملفات PDF أو صور ممسوحة ضوئياً مباشرة من شاشة النظام. * **الالتقاط عبر كاميرا الجوال:** تصوير الفواتير الورقية والإيصالات الحرارية في الموقع وحفظها في صندوق الوارد فوراً. --- ## 2. محرك الاستخراج متعدد الوسائط يقوم محرك الذكاء الاصطناعي بتحليل بنية المستند واستخراج الحقول التالية بدقة متناهية: 1. **اسم المورد ورقم سجله الضريبي (VAT ID).** 2. **رقم الفاتورة الأصلي وتاريخ الإصدار.** 3. **تفاصيل الأصناف والبنود (الوصف، الكمية، سعر الوحدة، الإجمالي).** 4. **نسبة ضريبة القيمة المضافة (15%) ومبلغ الضريبة.** 5. **المبلغ الإجمالي للفاتورة والعملة.** --- ## 3. مبدأ المراجعة والاعتماد البشري (Human-in-the-Loop) في بيزا، **لا يرحل الذكاء الاصطناعي أي قيد مالي إلى دفتر الأستاذ دون موافقة المحاسب**: * **إنشاء المسودة (Draft):** يجهز النظام مسودة سند الشراء ويعرضها جنباً إلى جنب مع صورة المستند الأصلي للمطابقة البصرية. * **مؤشرات الثقة (Confidence Scores):** يتم تظليل أي حقل غير واضح بلون تحذيري لتدقيقه سريعاً. * **الاعتماد والترحيل:** بنقرة واحدة يعتمد المحاسب الفاتورة، لتتحول فوراً إلى فاتورة مشتريات معتمدة وقيد محاسبي دائن للمورد ومدين للمخزون أو المصروف. --- ## AI Natural Language Reporting & Executive Chat Assistant **Category:** ai-automation | **Slug:** `/docs/ai-natural-language-reporting-assistant` | **Canonical URL:** https://biza.app/docs/ai-natural-language-reporting-assistant **Summary:** Query operational and financial data using plain natural language: automated NL-to-SQL report generation, 90-day cash flow projections, and KPI trend analysis. # AI Natural Language Reporting & Executive Chat Assistant Extracting custom financial summaries and operational insights from traditional ERP systems often requires submitting tickets to IT or exporting raw spreadsheets for manual pivot-table analysis. BIZA provides an embedded AI assistant that translates natural language questions into secure, read-only SQL aggregations against live tenant data. --- ## 1. Natural Language to SQL Architecture (NL-to-SQL) The reporting engine operates on a strict read-only execution layer: * **Tenant Isolation Context:** All generated queries execute within the authenticated session carrying the active `tenant_id`. It is mathematically impossible for queries to access cross-tenant data. * **Schema Grounding:** The model is grounded with authorized table schemas (invoices, expenses, payments, stock levels, ledger lines) and domain financial rules. * **Deterministic Aggregations:** Translates user questions into standard PostgreSQL aggregations (`SUM`, `AVG`, `COUNT`, `DATE_TRUNC`, `RANK`) rather than hallucinating estimates. * **Grounding Row Provenance:** Every response returns the underlying data row count (e.g. *"Calculated from 1,240 sales invoices and 418 expense vouchers"*), providing complete transparency. --- ## 2. Common Analytical Query Capabilities Business leaders and managers can ask high-level or granular questions across multiple operational domains: ### Financial Performance & Margins * *"What is our gross and net profit for this quarter compared to last quarter?"* * *"Show total operating expenses broken down by category for the last 6 months."* * *"Which product categories generate the highest gross profit margin?"* ### Receivables & Payables (AR/AP) * *"Which customers currently have invoices overdue by more than 60 days?"* * *"Who owes us the most money right now, and when were their last payments?"* * *"Show an AP aging breakdown across 30, 60, and 90-day buckets."* ### Sales & Inventory Intelligence * *"What are our top 10 best-selling products by total revenue this year?"* * *"Which items in the Central Warehouse are currently below their minimum reorder point?"* * *"Show monthly sales trends by sales representative or branch."* --- ## 3. 90-Day Predictive Cash Flow Forecasting Beyond historical reporting, the assistant provides a forward-looking cash flow forecast: * **Inflow Projection:** Calculates scheduled customer collections based on open Accounts Receivable, agreed invoice payment terms, and historical customer settlement speeds. * **Outflow Projection:** Aggregates approved supplier payables, recurring expenses (rent, utilities), and scheduled payroll runs. * **Weekly Net Position:** Displays weekly projected opening balance, expected inflows, expected outflows, and net closing cash position over the next 90 days. --- ## 4. Visual KPI Cards & Dynamic Charts Query results are not limited to text: * **Interactive Data Tables:** Sortable, filterable tables with direct links to view the underlying source document. * **Dynamic Visualizations:** Automatically renders bar charts for period comparisons, line charts for revenue trends, and donut charts for expense breakdowns. * **Export to Excel / CSV:** Download query results with one click for external sharing or board presentations. --- ## General Ledger & Double-Entry Accounting Architecture **Category:** finance-accounting | **Slug:** `/docs/general-ledger-double-entry` | **Canonical URL:** https://biza.app/docs/general-ledger-double-entry **Summary:** Core accounting engine: hierarchical Chart of Accounts, balanced journal entries, multi-currency accounting with realized/unrealized FX, and automated financial statements. # General Ledger & Double-Entry Accounting Architecture At the heart of BIZA is an immutable, double-entry financial core. Every operational transaction—whether an invoice, supplier payment, inventory adjustment, or payroll run—posts balanced debits and credits directly to the General Ledger. --- ## 1. Hierarchical Chart of Accounts (COA) BIZA supports a multi-level, parent-child Chart of Accounts designed for regional compliance (Saudi Arabia, UAE, India) while remaining fully customizable. ### Root Account Categories 1. **Assets (1000):** Current Assets (Cash, Bank, Accounts Receivable, Inventory), Fixed Assets, and Accumulated Depreciation. 2. **Liabilities (2000):** Accounts Payable, Accruals, Retention Payable, and Tax Liabilities (Output VAT Payable). 3. **Equity (3000):** Share Capital, Retained Earnings, and Owner Drawings. 4. **Revenue (4000):** Operating Sales, Service Fees, Project Billings, and Other Income. 5. **Cost of Goods Sold (5000):** Direct Material Purchases, Landed Shipping Costs, Direct Project Labor, and Inventory Adjustments. 6. **Expenses (6000):** Administrative, Rent, Utilities, Depreciation, and Marketing. Each account carries: * **Account Code & Name:** Fully bilingual (English & Arabic). * **Account Type:** Determines behavior on financial reports. * **Currency:** Multi-currency accounts (e.g., USD bank account or EUR supplier ledger). --- ## 2. Inviolable Double-Entry Integrity The ledger enforces mathematical integrity at the database level: * **Zero-Sum Assertion:** A journal entry cannot be posted unless total Debits equal total Credits: $$\sum \text{Debits} - \sum \text{Credits} = 0$$ * **No Direct Row Mutation:** Posted ledger transactions cannot be edited in place. Any correction requires a formal reversal or adjusting journal entry, preserving the complete historical audit trail. * **Fiscal Periods & Hard Locking:** Close past months or financial years to prevent retroactive journal postings. --- ## 3. Multi-Currency Accounting & FX Tracking For businesses dealing with cross-border trade: * **Base Workspace Currency:** Typically SAR, AED, USD, or INR. * **Transaction Currency:** Record invoices or bills in foreign currencies (EUR, GBP, USD, etc.). * **Realized FX Gains/Losses:** Automatically calculated upon invoice settlement when the exchange rate between issue date and payment date fluctuates. * **Unrealized FX Revaluation:** End-of-period revaluation of foreign currency bank accounts and open receivables/payables. --- ## 4. Automated Financial Reporting Financial statements update live with zero batch-processing delays: * **Balance Sheet:** Real-time summary of Assets, Liabilities, and Equity. * **Profit & Loss (Income Statement):** Operating margins, gross profit, and net profit by custom date range, branch, or project cost center. * **Trial Balance:** Full listing of debit and credit balances across all active accounts for period verification. * **General Ledger Statement:** Chronological audit statement for any account with opening balances, running balances, and voucher drill-down. ### النسخة العربية (Arabic Edition): دفتر الأستاذ العام وهندسة المحاسبة بالقيد المزدوج --- title: "دفتر الأستاذ العام وهندسة المحاسبة بالقيد المزدوج" slug: general-ledger-double-entry category: finance-accounting order: 1 updatedAt: "2026-09-20" summary: "المحرك المحاسبي الأساسي: شجرة حسابات هرمية متوافقة مع المعايير الدولية، قيود يومية متوازنة، محاسبة متعددة العملات مع فروق أسعار الصرف، والقوائم المالية الآلية." tags: ["المحاسبة", "دفتر الأستاذ", "القيد المزدوج", "شجرة الحسابات", "ميزان المراجعة", "العملات الأجنبية"] --- # دفتر الأستاذ العام وهندسة المحاسبة بالقيد المزدوج يقوم نظام بيزا (BIZA) على محرك محاسبي صارم يتبع مبدأ **القيد المزدوج (Double-Entry Bookkeeping)**، حيث لا يمكن ترحيل أي معاملة تجارية في النظام ما لم تكن متوازنة حسابياً بالمطلق (إجمالي المدين = إجمالي الدائن). يضمن هذا الالتزام الهندسي سلامة القوائم المالية، وسهولة التدقيق المحاسبي الخارجي، وتوافق الحسابات مع معايير المحاسبة الدولية (IFRS) ومعايير الهيئة السعودية للمراجعين والمحاسبين (SOCPA). --- ## 1. شجرة الحسابات الهرمية (Chart of Accounts) تأتي شجرة الحسابات في بيزا مجهزة مسبقاً وفق أفضل الممارسات المحاسبية في المملكة والخليج: * **1000 — الأصول:** الأصول المتداولة (النقد والبنوك، الذمم المدينة، المخزون) والأصول غير المتداولة (الأصول الثابتة ومجمع الإهلاك). * **2000 — الخصوم والالتزامات:** الالتزامات المتداولة (الذمم الدائنة، ضريبة القيمة المضافة المستحقة، مستحقات التأمينات، الرواتب المستحقة) والالتزامات غير المتداولة. * **3000 — حقوق الملكية:** رأس المال، الأرباح المبقاة (المحتجزة)، واحتياطيات الشركاء. * **4000 — الإيرادات:** إيرادات المبيعات، إيرادات الخدمات، وعقود المشاريع. * **5000 — تكلفة الإيرادات:** تكلفة البضاعة المباعة (COGS) وتكاليف العقود المباشرة. * **6000 — المصروفات التشغيلية والعمومية:** الرواتب، الإيجارات، التسويق، الاستهلاك، ومصاريف البنوك. --- ## 2. القيود الآلية والقيود اليدوية * **القيود الآلية:** تولد العمليات التشغيلية (فواتير المبيعات، فواتير الشراء، سندات التسليم، كشوف الرواتب، إهلاك الأصول) قيودها اليومية تلقائياً في الخلفية دون تدخل بشري. * **القيود اليدوية (`/accounting/journal-entries`):** مخصصة لقيود التسويات الاستثنائية ومخصصات نهاية الخدمة ومصاريف الاستهلاك السنوي مع تدقيق إلزامي لتوازن طرفي القيد. --- ## 3. العملات المتعددة وفروق أسعار الصرف (FX) * **عملة الأساس والعملات الأجنبية:** دعم المعاملات بالريال السعودي، الدرهم الإماراتي، الدولار الأمريكي، اليورو، والجنيه الاسترليني. * **أرباح وخسائر الصرف المحققة وغير المحققة:** تقييم أرصدة الذمم والعملات الأجنبية في نهاية كل فترة مالية وتوليد قيود تسوية فروق الصرف آلياً. --- ## 4. التقارير المالية الفورية * **ميزان المراجعة (Trial Balance):** أرصدة الحسابات الإجمالية اللحظية مع إمكانية الفرز حسب مستوى الشجرة أو مركز التكلفة. * **قائمة الدخل (P&L):** حساب صافي الربح التشغيلي والنهائي لأي فترة محددة. * **الميزانية العمومية (Balance Sheet):** تقرير فوري يعكس المركز المالي الحقيقي للمنشأة. --- ## Bank Statement Reconciliation & Automated Matching **Category:** finance-accounting | **Slug:** `/docs/bank-reconciliation-matching` | **Canonical URL:** https://biza.app/docs/bank-reconciliation-matching **Summary:** Import bank statements (CSV, OFX, CAMT, PDF) and reconcile bank feeds against ledger transactions with automated matching and fee allocation. # Bank Statement Reconciliation & Automated Matching Keeping company bank balances aligned with accounting records is essential for cash visibility and fraud prevention. BIZA's bank reconciliation workspace imports digital statements, matches transactions against open invoices and payments, and posts adjusting bank fees in one streamlined workflow. --- ## 1. Statement Ingestion BIZA supports multiple statement formats from leading regional banks (Al Rajhi, SNB, Riyad Bank, ENBD, FAB, HDFC, SBI): * **Electronic Bank Feeds / File Imports:** Support for standard CSV, Excel, OFX, QIF, and CAMT.053 XML files. * **PDF Statement Ingestion:** Upload scanned or digital PDF bank statements directly; BIZA's document engine extracts transaction dates, reference descriptions, withdrawal/deposit amounts, and running balances into a structured feed. --- ## 2. Reconciliation Workspace The dedicated workspace (`/accounting/bank-reconciliation`) provides an interactive comparison view: * **Left Column:** Bank statement lines extracted from the uploaded statement. * **Right Column:** Internal General Ledger bank transactions (unreconciled customer receipts, supplier payments, transfers). * **Running Difference Tile:** Displays Statement Balance vs. Cleared Ledger Balance vs. Unreconciled Difference. --- ## 3. Matching Engine & Rules BIZA simplifies matching using deterministic heuristics: 1. **Exact Reference Matching:** Matches bank reference IDs, cheque numbers, or transfer descriptions against customer invoices or payment records. 2. **Amount & Date Window Matching:** Identifies candidate transactions matching the exact currency amount within a configurable date tolerance (e.g. ±3 days). 3. **One-Click Split Matching:** Reconcile a single lump-sum bank deposit against multiple individual customer invoices (batch payments). --- ## 4. In-Workspace Instant Adjustments (`CreateAdjustmentDialog`) During reconciliation, bank statements frequently contain items that do not originate as pre-existing vouchers in the ERP—such as monthly maintenance fees, merchant acquiring discount rates (MDR), wire transfer fees, interest income, or direct debit utilities: * **One-Click Adjustment Journal:** Clicking **Create Adjustment** opens an inline modal pre-filled with the statement transaction's date, description, and currency amount. * **Automatic Direction Detection:** * **Negative statement amounts (money out of bank):** Pre-configures a credit to the Bank Account and prompts for the corresponding expense account (e.g., `6010 — Bank Charges & Commission`). * **Positive statement amounts (money into bank):** Pre-configures a debit to the Bank Account and prompts for the income account (e.g., `4800 — Finance & Interest Income`). * **Tax Handling for VAT Recovery:** Automatically applies statutory 15% VAT on bank service charges, booking input VAT to `1150 — Input Tax Recoverable` so your business claims full tax credits. * **Traceable Linkage:** The generated draft journal entry is directly linked to the specific bank statement line ID for end-to-end audit traceability before posting. --- ## 5. Multi-Currency Bank Accounts & FX Variance For businesses holding foreign currency accounts (e.g., USD, EUR, AED, GBP): * **Currency-Specific Reconciliations:** Reconcile foreign bank statements in the account's native denomination. * **Exchange Rate Realization:** When matching a foreign currency payment against an invoice booked at historical rates, BIZA calculates and posts realized foreign exchange gain/loss adjustments automatically. --- ## 6. Reconciliation Sign-Off & Permanent Audit Record Once all statement lines are matched or adjusted and the unreconciled difference reaches **SAR 0.00**: * **Lock Statement Period:** The statement is officially signed off and locked as **Reconciled**. All linked general ledger vouchers are tagged as cleared, preventing duplicate matching in subsequent periods. * **Comprehensive Audit Trail:** The system preserves the original uploaded bank statement file, the reconciliation completion timestamp, the approving accountant's identity, and an unalterable summary report. ### النسخة العربية (Arabic Edition): مطابقة كشوف الحسابات البنكية والمطابقة الآلية --- title: "مطابقة كشوف الحسابات البنكية والمطابقة الآلية" slug: bank-reconciliation-matching category: finance-accounting order: 2 updatedAt: "2026-09-20" summary: "استيراد كشوف الحسابات البنكية (CSV, OFX, CAMT, PDF) ومطابقة الحركات البنكية مع قيود دفتر الأستاذ بدقة مع المعالجة اللحظية لقيود التسوية ورسوم نقاط البيع والضريبة المستردة." tags: ["البنوك", "المطابقة البنكية", "التدفقات النقدية", "دفتر الأستاذ", "الضرائب", "المحاسبة"] --- # مطابقة كشوف الحسابات البنكية والمطابقة الآلية تُعد مطابقة الأرصدة البنكية الفعلية مع السجلات المحاسبية ركيزة أساسية لمنع الاختلاس، وضبط التدفقات النقدية، وضمان دقة التقارير المالية. يوفر نظام بيزا (BIZA) مساحة عمل متكاملة للمطابقة البنكية (`/accounting/bank-reconciliation`) تدعم استيراد الكشوف الإلكترونية، والمطابقة التلقائية الذكية، وتسجيل المصاريف البنكية وتعديلات القيود بضغطة زر. --- ## 1. استيراد كشوف الحسابات البنكية يدعم بيزا مختلف التنسيقات الصادرة من كبرى البنوك في السعودية والخليج (الراجحي، الأهلي SNB، بنك الرياض، الإمارات دبي الوطني، بنك أبوظبي الأول): * **الملفات الرقمية القياسية:** استيراد ملفات CSV، Excel، OFX، و CAMT.053 XML مباشرة من البوابة المصرفية. * **استيراد ملفات PDF الذكي:** رفع كشوف الحسابات المصرفية بصيغة PDF؛ حيث يقوم محرك استخراج المستندات بتحليل النصوص والجداول وتفريغ التواريخ والوصف والمبالغ والأرصدة في جدول تفاعلي منظم. --- ## 2. قواعد وخوارزميات المطابقة الذكية تعتمد مساحة عمل المطابقة في بيزا على واجهة ثنائية تعرض أسطر كشف الحساب البنكي على اليمين، والقيود المسجلة في دفتر الأستاذ على اليسار: 1. **المطابقة بالرقم المرجعي الدقيق:** ربط أرقام الشيكات أو الحوالات السريعة بفواتير العملاء أو سندات الصرف تلقائياً. 2. **المطابقة بفارق التواريخ والمبلغ:** العثور على القيود المتطابقة في القيمة النقدية ضمن نافذة زمنية مرنة (مثلاً: ±3 أيام عمل) لتغطية فترات المقاصة بين البنوك. 3. **تجزئة الإيداعات المجمعة (Batch Receipts):** مطابقة دفعة بنكية واحدة مجمعة مع مجموعة فواتير متعددة تم سدادها معاً. --- ## 3. إنشاء قيود التسوية اللحظية (`CreateAdjustmentDialog`) تتضمن كشوف الحسابات البنكية عادةً خصومات دورية لم تُسجل مسبقاً في الدفاتر (رسوم أجهزة نقاط البيع MDR، رسوم الحوالات، فوائد بنكية، خصومات مباشرة للاتصالات): * **سند تعديل لحظي:** عند النقر على خيار إنشاء تسوية بجوار السطر البنكي، تفتح نافذة مسبقة التعبئة بالتاريخ والوصف والمبلغ. * **تحديد الاتجاه التلقائي:** * **المبالغ المخصومة (سحب من البنك):** يحدد النظام قيد دائن للبنك، ويطلب تحديد حساب المصروف (مثل: `6010 — رسوم وعمولات بنكية`). * **المبالغ المودعة (إيداع للبنك):** يحدد النظام قيد مدين للبنك، ويطلب تحديد حساب الإيراد (مثل: `4800 — إيرادات تمويلية`). * **استرداد ضريبة القيمة المضافة 15%:** تطبيق نسبة الضريبة 15% آلياً على العمولات البنكية وتوجيهها لحساب ضريبة المدخلات القابلة للاسترداد لضمان الاستفادة من الخصم الضريبي في إقرار زاتكا. --- ## 4. إقفال واعتماد المطابقة البنكية عند وصول الفارق بين رصيد كشف الحساب ورصيد دفتر الأستاذ إلى **0.00 ريال**: * **قفل فترة المطابقة:** يتم اعتماد الكشف رسمياً، وتحديد كافة الحركات المرتبطة بأنها «تمت مطابقتها»، لمنع تكرار استخدامها في فترات لاحقة. * **شهادة المطابقة والأرشيف:** حفظ كشف الحساب الأصلي واسم المحاسب وتاريخ الإقفال في سجل تدقيق دائم وغير قابل للتعديل. --- ## Fixed Assets Register & Automated Depreciation Schedules **Category:** finance-accounting | **Slug:** `/docs/fixed-assets-depreciation-management` | **Canonical URL:** https://biza.app/docs/fixed-assets-depreciation-management **Summary:** Manage company capital assets, track serials and custodians, automate monthly depreciation journal entries, and account for asset disposals and impairments. # Fixed Assets Register & Automated Depreciation Schedules Machinery, company vehicles, IT equipment, office furnishings, and leasehold improvements represent significant capital expenditures that must be capitalized and depreciated over their useful economic lives. BIZA Fixed Assets automates asset registration, depreciation calculations, and general ledger postings. --- ## 1. Asset Capitalization & Registration When a capital asset is acquired (via purchase entry, direct cash purchase, or capital project): * **Asset Master Record:** Item name, category (e.g., *Computer Equipment*, *Vehicles*, *Plant & Machinery*), serial number, purchase date, and physical location. * **Custodian & Department:** Assign responsibility to a specific employee or departmental cost center. * **Cost Basis & Salvage Value:** Record initial purchase cost, capitalized installation/freight charges, and estimated residual salvage value at the end of its life. --- ## 2. Depreciation Schedules & Calculation Methods BIZA supports standard financial depreciation methodologies: ### Straight-Line Method (SLM) Depreciates an equal amount each fiscal period over the asset's useful life: $$\text{Periodic Depreciation} = \frac{\text{Asset Cost} - \text{Salvage Value}}{\text{Useful Life in Periods}}$$ ### Reducing / Declining Balance Method (DB) Accelerates depreciation in earlier years by applying a fixed percentage to the diminishing book value: $$\text{Periodic Depreciation} = \text{Book Value at Start of Period} \times \text{Depreciation Rate}$$ --- ## 3. Automated Monthly Depreciation Posting Finance teams no longer need to calculate depreciation spreadsheets and enter manual journals every month: * **Batch Depreciation Run:** Click **Run Monthly Depreciation** at month-end. * **Automated Journal Posting:** BIZA calculates the exact depreciation for all active assets and posts a balanced journal entry: * **Debit:** Depreciation Expense (P&L account mapped by asset category). * **Credit:** Accumulated Depreciation (Balance Sheet contra-asset account). * **Audit Trail:** Each asset's individual depreciation schedule updates with the voucher number, posted date, and remaining net book value. --- ## 4. Asset Disposal, Sale & Scrapping When an asset reaches the end of its life or is sold: * **Sale to Customer:** Record disposal proceeds; BIZA calculates the Net Book Value (Cost minus Accumulated Depreciation) and posts the difference directly to **Gain / Loss on Asset Disposal**. * **Scrapping / Write-Off:** Write off damaged or obsolete equipment, derecognizing the original asset and accumulated depreciation while recognizing an impairment loss. --- ## Contra Settlements & AP/AR Netting Adjustments **Category:** finance-accounting | **Slug:** `/docs/contra-settlements-ap-ar-offsetting` | **Canonical URL:** https://biza.app/docs/contra-settlements-ap-ar-offsetting **Summary:** Offset open sales invoices (AR) against vendor purchase bills (AP) without cash movements when counterparties act as both customer and supplier, with automated FX handling and balanced journal posting. # Contra Settlements & AP/AR Netting Adjustments In commercial trading, construction, distribution, and corporate group operations, businesses frequently conduct bilateral trade with counterparties who act simultaneously as **customers** (purchasing goods or services) and **suppliers** (providing materials, subcontracted labor, or equipment). Instead of wiring redundant cash payments back and forth—incurring banking fees, payment processing delays, and liquidity drag—BIZA provides a dedicated **Contra Settlement** engine (`/accounting/contra-settlements`). This feature allows finance teams to legally and cleanly set off outstanding Accounts Receivable (AR) against Accounts Payable (AP) without touching a bank account. --- ## 1. When to Use a Contra Settlement Contra settlements solve everyday corporate reconciliation scenarios: * **Two-Way Trading Partners:** A distributor supplies finished goods to a vendor while purchasing raw packaging materials from the same entity. * **Subcontractor Material Offsets:** A general contractor purchases building materials on behalf of a drywall subcontractor, deducting the cost from the subcontractor's monthly progress payment. * **Intercompany Clearing:** Sister entities within a corporate group netting cross-charges, management fees, and shared operational costs. * **Barter & Cross-Servicing Agreements:** Mutually agreed trade-ins, equipment exchanges, or reciprocal consulting services. --- ## 2. Setting Up Contra Counterparties In BIZA, counterparties maintain distinct sub-ledger identities for strict auditability while linking seamlessly for contra clearing: 1. The party is registered in the **Customer** master with its dedicated Accounts Receivable sub-account. 2. The party is registered in the **Supplier** master with its dedicated Accounts Payable sub-account. 3. In the Contra Settlement creation workspace (`/accounting/contra-settlements/new`), the accountant selects both the Customer profile and the Supplier profile. BIZA instantly queries open balances across both ledgers. --- ## 3. Allocation Engine: Oldest-First vs. Line-by-Line Selection The workspace presents a synchronized dual-table ledger view: * **Left Table (Accounts Receivable):** All unpaid and partially paid sales invoices issued to the customer, displaying invoice number, issuance date, total amount, and remaining balance. * **Right Table (Accounts Payable):** All approved, unpaid purchase bills and supplier entries, displaying bill reference, entry date, total amount, and outstanding payable. ### Automated Greedy Allocation (Oldest-First) The user enters the desired **Set-Off Amount** (e.g., SAR 25,000.00). Clicking **Auto-Allocate (Magic Wand)** triggers BIZA's allocation algorithm: 1. Evaluates exact-match invoices and bills where the outstanding balance matches the set-off amount. 2. If no single exact match exists, it performs an oldest-first (FIFO) allocation, sequentially exhausting open balances until the entire set-off amount is absorbed on both sides. 3. Both the AR total and AP total must balance exactly to the cent before submission. ### Manual Line-Item Adjustments Accountants can override automated allocations at any time by toggling checkboxes and typing exact partial deduction amounts against specific disputed or milestone invoices. --- ## 4. Multi-Currency & Realized FX Recognition When trading across borders (e.g., customer invoices billed in USD or EUR against supplier bills booked in SAR or AED), exchange rates may have fluctuated between initial billing and settlement date: * **Settlement Exchange Rate:** BIZA records the agreed cross-currency exchange rate as of the settlement voucher date. * **Realized FX Gain/Loss Posting:** If the base-currency value of the cleared receivable differs from the cleared payable, BIZA automatically balances the entry by routing the variance to the designated **Realized Foreign Exchange Gain/Loss** account. --- ## 5. Automated Balanced Journal Posting Upon confirmation, BIZA posts a single atomic, bankless General Ledger journal entry: $$\begin{aligned} \text{DR} \quad & \text{Accounts Payable (2000) — Vendor Sub-Ledger} & \text{SAR } 25,000.00 \\ \text{CR} \quad & \text{Accounts Receivable (1100) — Customer Sub-Ledger} & \text{SAR } 25,000.00 \end{aligned}$$ *(If foreign exchange variance applies, an offsetting entry to `Realized FX Gain (4900)` or `Realized FX Loss (5900)` is included).* ### Downstream System Updates 1. **Invoice Status Update:** Each linked sales invoice has its `paid_amount` credited by the allocated amount. Fully satisfied invoices transition automatically to **Paid**; partially satisfied invoices transition to **Partial**. 2. **Purchase Bill Status Update:** Each linked purchase entry has its payment status updated accordingly. 3. **Traceability:** The settlement produces a permanent **Contra Settlement Voucher** (e.g., `CS-2026-0042`) with clickable hyperlinks to every underlying sales invoice, supplier bill, and posted journal entry. ### النسخة العربية (Arabic Edition): تسويات المقاصة ومقاصة الذمم المدينة والدائنة (Contra Settlements) --- title: "تسويات المقاصة ومقاصة الذمم المدينة والدائنة (Contra Settlements)" slug: contra-settlements-ap-ar-offsetting category: finance-accounting order: 4 updatedAt: "2026-09-20" summary: "تسوية فواتير المبيعات المفتوحة مع فواتير المشتريات المستحقة لنفس الطرف عندما يكون عميلاً ومورداً في نفس الوقت، دون الحاجة لتحويلات نقدية، مع معالجة قيود التسوية وفروق العملة تلقائياً." tags: ["المحاسبة", "المقاصة", "الذمم المدينة", "الذمم الدائنة", "دفتر الأستاذ", "فروق العملة", "القيود المحاسبية"] --- # تسويات المقاصة ومقاصة الذمم المدينة والدائنة (Contra Settlements) في قطاعات التجارة، والمقاولات، وتوزيع السلع، تتعامل الشركات بشكل مستمر مع أطراف تجارية تجمع بين صفتين: **عميل** يشتري المنتجات، و**مورّد** يقدّم خدمات لوجستية أو مواد خام للمنشأة. بدلاً من إرسال واستلام حوالات بنكية متكررة—مما يستنزف السيولة ويكبّد المنشأة رسوم تحويلات بنكية ويؤخر المطابقات—يوفر نظام بيزا (BIZA) محرك **تسويات المقاصة** المعتمد (`/accounting/contra-settlements`)، الذي يتيح إجراء المقاصة القانونية والمحاسبية بين الذمم المدينة والذمم الدائنة بضغطة زر دون الحاجة لأي حركة نقدية في الحساب البنكي. --- ## 1. حالات استخدام تسوية المقاصة * **الشركاء التجاريون المزدوجون:** مورد يقوم بتوريد مواد تغليف ويشتري في المقابل بضائع جاهزة. * **خصومات مقاولي الباطن:** قيام المقاول الرئيسي بتوفير مواد بناء أو معدات لمقاول باطن وخصم قيمتها من مستخلصاته الشهرية. * **التسويات بين الشركات الشقيقة (Intercompany):** تسوية الحسابات الجارية والمصاريف المشتركة ورسوم الإدارة بين فروع أو منشآت المجموعة الواحدة. --- ## 2. آلية توزيع مبالغ المقاصة في بيزا عند فتح شاشة إنشاء تسوية مقاصة جديدة (`/accounting/contra-settlements/new`): 1. يتم اختيار سجل **العميل** وسجل **المورد** للطرف المعني. 2. يعرض النظام جدولين متزامنين: * **الجدول الأيمن (الذمم المدينة AR):** جميع فواتير المبيعات المفتوحة الصادرة للعميل وتواريخ استحقاقها والمتبقي منها. * **الجدول الأيسر (الذمم الدائنة AP):** جميع فواتير الشراء المعتمدة وغير المسددة للمورد. 3. يقوم المحاسب بإدخال **مبلغ المقاصة المتفق عليه** (مثلاً: 50,000 ريال سعودي). 4. **التوزيع الآلي الذكي (الأقدم فالأحدث FIFO):** يوزع النظام المبلغ تلقائياً على الفواتير الأقدم في الجانبين حتى استنفاد مبلغ المقاصة بالكامل مع ضمان تطابق الجانبين تماماً بالهللة. 5. يمكن للمحاسب في أي وقت تعديل المبالغ يدوياً لاستثناء فواتير معينة أو معالجة مطالبات محددة. --- ## 3. المعالجة الآلية لفروق أسعار الصرف (FX) عندما تكون إحدى المعاملات بعملة أجنبية (مثل الدولار أو اليورو) مقابل الريال السعودي، تحسب خوارزمية بيزا فرق العملة المتحقق بين تاريخ الفاتورة وتاريخ المقاصة وتوجّه الفارق تلقائياً إلى حساب **أرباح/خسائر فروق العملة المحققة** لضمان توازن القيد بالكامل. --- ## 4. القيد المحاسبي الموحد للمقاصة بمجرد اعتماد التسوية، يُنشئ النظام قيداً محاسبياً متوازناً دون وسيط بنكي: $$\begin{aligned} \text{مدين: } & \text{حساب الموردين / الذمم الدائنة (2000)} & 50,000.00 \text{ ريال} \\ \text{دائن: } & \text{حساب العملاء / الذمم المدينة (1100)} & 50,000.00 \text{ ريال} \end{aligned}$$ ### الآثار المترتبة على النظام: * تحديث رصيد الفواتير المسددة جزئياً أو كلياً في سجلات العميل والمورد. * استخراج سند تسوية مقاصة رسمي ورقم إسناد فريد (`CS-2026-0042`) مرتبط تشعبياً بكل الفواتير المعنية لتقديمه لمراجعي الحسابات. --- ## Multi-Branch Management & Cost Center Analytical Accounting **Category:** finance-accounting | **Slug:** `/docs/multi-branch-cost-center-accounting` | **Canonical URL:** https://biza.app/docs/multi-branch-cost-center-accounting **Summary:** Segment financial reporting across company branches, divisions, and departmental cost centers with consolidated and standalone Profit & Loss statements. # Multi-Branch Management & Cost Center Analytical Accounting Growing enterprises operating multiple retail outlets, regional showrooms, contracting sites, or service divisions need to track financial performance by business unit without fragmenting the organization into disconnected accounting databases. BIZA provides native multi-branch and multi-dimensional cost center accounting within a single unified workspace. --- ## 1. Branch Segmentation Architecture Define branches matching your real-world corporate structure (e.g. *Riyadh Main Office*, *Jeddah Showroom*, *Dammam Warehouse*, *Dubai Service Center*): * **Branch-Specific Sequences:** Invoices, purchase orders, and receipts can carry branch-specific numbering prefixes (e.g., `INV-RUH-001`, `INV-JED-001`). * **Default Warehouse Linkage:** Every branch is assigned its default storage warehouse, ensuring local inventory decrements upon sale. * **Role-Based Branch Access:** Restrict employee and cashier access so staff only view and transact against their authorized branch location. --- ## 2. Multi-Dimensional Cost Centers In addition to branches, BIZA supports hierarchical cost centers for granular operational tracking: * **Departmental Cost Centers:** Administration, Sales & Marketing, IT, Human Resources, Logistics. * **Operational Projects & Contracts:** Construction sites, client retainers, internal R&D initiatives. * **Equipment & Fleet Centers:** Track fuel, maintenance, insurance, and revenue by specific vehicle or heavy machinery unit. --- ## 3. Transaction Tagging & Split Allocation Every operational voucher allows cost center distribution: * **Line-by-Line Allocation:** Assign individual invoice lines or expense items to different cost centers. * **Shared Expense Splitting:** Apportion shared overhead bills (e.g., corporate HQ rent or bulk software subscriptions) across multiple branches or departments based on fixed percentages. --- ## 4. Segmental Reporting & Consolidated Financials Gain complete visibility into business unit viability: * **Branch P&L Statements:** Filter Profit & Loss reports to inspect revenue, cost of sales, operating expenses, and net profit for a single branch or project. * **Comparative Multi-Branch Reporting:** View side-by-side comparative financial statements comparing the performance of all branches for any calendar period. * **Consolidated General Ledger:** Financial controllers and company executives view the entire organization's consolidated balance sheet and trial balance in real time with zero manual consolidation spreadsheets. --- ## Customer Receipt Batches & Supplier Batch Disbursements **Category:** finance-accounting | **Slug:** `/docs/batch-payments-and-receipt-allocation` | **Canonical URL:** https://biza.app/docs/batch-payments-and-receipt-allocation **Summary:** Process bulk customer wire receipts across multiple open invoices and execute supplier batch payment disbursements with automated FIFO allocation, overpayment handling, and bank reconciliation readiness. # Customer Receipt Batches & Supplier Batch Disbursements In high-volume commercial operations, handling payments on a one-invoice-to-one-transaction basis creates severe administrative bottlenecks. Enterprise customers routinely remit single lump-sum electronic transfers covering dozens of outstanding invoices, while corporate treasury teams execute weekly supplier payment runs disbursing funds across multiple vendor bills. BIZA provides dedicated **Batch Receipt** (`/documents/customer-receipt-batches`) and **Batch Disbursement** (`/procurement/supplier-batch-payments`) modules designed to eliminate manual data entry, prevent unallocated cash suspense, and ensure rapid bank reconciliation. --- ## 1. Customer Batch Receipts (Bulk Inbound Remittances) When an enterprise customer wires a single payment (e.g., SAR 142,500.00) covering a batch of delivery notes and tax invoices: ### Remittance Input & Header Definition 1. Select the **Customer** and the destination **Bank or Cash Account**. 2. Specify the **Remittance Date**, **Total Amount Received**, and bank transaction reference / deposit slip number. 3. Optional: Upload the customer's remittance advice document (PDF or Excel). ### Intelligent Invoice Allocation BIZA fetches all outstanding and partially paid invoices for the customer: * **Oldest-First (FIFO) Auto-Fill:** One click automatically applies the lump sum against the oldest open invoices first, decrementing the unallocated balance to zero. * **Exact Remittance Advice Matching:** Users can toggle specific invoices matching the customer's payment advice, typing partial allocations where discounts, retentions, or disputed line items occur. * **Unallocated Advance Deposits:** If the received remittance exceeds total outstanding invoices, the residual amount is automatically booked as an **Unallocated Customer Advance** (`2150 — Customer Deposits`), available for one-click application against future invoices. --- ## 2. Supplier Batch Disbursements (Bulk Outbound EFTs) Treasury and accounts payable teams can consolidate vendor liabilities into scheduled payment batches: 1. **Vendor Bill Filtering:** Filter approved purchase entries by due date, payment terms (e.g., Net 30, Net 60), or specific vendor priority. 2. **Batch Total Calculation:** Select all qualifying bills to view the aggregated payout requirement, current bank account balance, and projected post-payment liquidity. 3. **Disbursement Execution:** Select the paying bank account, payment method (SARIE, Wire Transfer, Corporate Card, Post-Dated Cheque), and batch release date. 4. **Automated Sub-Ledger Posting:** BIZA generates a single consolidated bank credit entry while debiting each vendor's individual Accounts Payable sub-account, keeping AP aging reports 100% synchronized. --- ## 3. General Ledger Accounting Mechanics Batch payment workflows generate balanced, multi-line journal vouchers: ### Inbound Customer Batch Receipt Journal: $$\begin{aligned} \text{DR} \quad & \text{Al Rajhi Bank — Operating Account (1010)} & \text{SAR } 142,500.00 \\ \text{CR} \quad & \text{Accounts Receivable (1100) — Inv #INV-2026-081} & \text{SAR } 45,000.00 \\ \text{CR} \quad & \text{Accounts Receivable (1100) — Inv #INV-2026-088} & \text{SAR } 62,500.00 \\ \text{CR} \quad & \text{Accounts Receivable (1100) — Inv #INV-2026-094} & \text{SAR } 35,000.00 \end{aligned}$$ ### Outbound Supplier Batch Disbursement Journal: $$\begin{aligned} \text{DR} \quad & \text{Accounts Payable (2000) — Supplier Alpha} & \text{SAR } 28,000.00 \\ \text{DR} \quad & \text{Accounts Payable (2000) — Supplier Beta} & \text{SAR } 19,400.00 \\ \text{DR} \quad & \text{Accounts Payable (2000) — Supplier Gamma} & \text{SAR } 34,600.00 \\ \text{CR} \quad & \text{SNB Bank — Treasury Account (1020)} & \text{SAR } 82,000.00 \end{aligned}$$ --- ## 4. Bank Reconciliation Synergy By grouping individual invoice settlements into a single batch entry matching the exact transaction amount on the bank statement, BIZA's **Bank Reconciliation Workspace** matches the entire batch in a single click: * Eliminates the need to manually reconcile dozens of separate invoices against a single bank line. * Guarantees zero unreconciled penny rounding errors. * Produces instant batch remittance advice PDFs that can be emailed directly to counterparties. --- ## AR/AP Aging Analysis & Dynamic Customer Statements **Category:** finance-accounting | **Slug:** `/docs/ar-ap-aging-and-customer-statements` | **Canonical URL:** https://biza.app/docs/ar-ap-aging-and-customer-statements **Summary:** Manage credit risk, track overdue receivables and payables across aging brackets, and generate professional customer account statements with running ledger balances and direct payment links. # AR/AP Aging Analysis & Dynamic Customer Statements Proactive working capital management requires total visibility into open receivables and supplier payment commitments. BIZA's automated aging reports (`/accounting/ar-aging` and `/accounting/ap-aging`) and interactive **Customer Statement** generator (`/accounting/customer-statements`) provide finance controllers and collection agents with real-time tools to prevent bad debt and accelerate cash collection. --- ## 1. Accounts Receivable (AR) Aging Engine The AR Aging Report categorizes outstanding customer receivables into standardized overdue aging brackets based on contractual payment terms: * **Current (Not Yet Due):** Invoices within standard payment terms (e.g., Net 15, Net 30, Net 60). * **1 – 30 Days Overdue:** Follow-up window for standard invoice reminders. * **31 – 60 Days Overdue:** First escalation tier; automated collection notice triggers. * **61 – 90 Days Overdue:** High-risk bracket; credit hold recommendations on pending sales orders. * **90+ Days Overdue:** Critical delinquency bracket; automated bad-debt provisioning evaluations. ### Key Analytical Capabilities * **Interactive Drilldown:** Click any aging bucket to inspect underlying invoices, delivery notes, and outstanding balances. * **Customer Credit Limit Monitoring:** Real-time indicator displaying total credit exposure vs. authorized customer credit limit. * **Historical As-Of Date Aging:** Reconstruct historical aging reports as of any past balance sheet date for external financial audits. --- ## 2. Dynamic Customer Account Statements Finance teams can generate comprehensive, branded **Statements of Account** for any selected date range: ### Statement Contents & Architecture * **Opening Balance:** Brought-forward balance from all historical transactions prior to the start date. * **Chronological Transaction Ledger:** * **Sales Invoices (+ DR):** Invoiced amounts increasing customer balance. * **Payments & Receipts (- CR):** Bank transfers, cash receipts, and cheques reducing balance. * **Credit Notes (- CR):** Sales returns, rebate adjustments, and approved credit memos. * **Contra Settlements (- CR):** Set-off vouchers clearing AR against supplier bills. * **Running Balance Column:** Recalculated after every debit and credit line item. * **Closing Balance & Aging Summary:** Prominent statement footer displaying the total balance due along with the 30/60/90-day aging breakdown. ### Delivery & Sharing Options * **High-Definition PDF Generation:** Renders crisp, print-ready bilingual (English & Arabic) PDF statements featuring company letterhead and official stamps. * **One-Click Email Dispatch:** Send statements directly to customer accounts payable contacts with customizable email templates and attached PDF files. * **Online Payment Link Integration:** Embed direct payment portal links on the statement so customers can settle invoices immediately via Mada, Visa, Mastercard, or Apple Pay. --- ## 3. Accounts Payable (AP) Aging & Cash Outflow Planning The AP Aging Report provides treasury directors with complete control over vendor commitments: * **Early Payment Discounts:** Highlights invoices offering prompt-payment discounts (e.g., 2/10 Net 30). * **Cash Requirement Forecasting:** Aggregates upcoming vendor disbursements by week and month to prevent liquidity crunches. * **Supplier Dispute Tracking:** Flag disputed vendor bills to hold automated batch payment releases while retaining standard payment terms on undisputed items. --- ## Fiscal Year Closing, Period Locking & Balance Roll-Forward **Category:** finance-accounting | **Slug:** `/docs/fiscal-year-closing-and-period-locking` | **Canonical URL:** https://biza.app/docs/fiscal-year-closing-and-period-locking **Summary:** Manage monthly and annual accounting period closes, enforce immutable period locking against historical tampering, automate year-end Retained Earnings closing entries, and roll forward opening balances. # Fiscal Year Closing, Period Locking & Balance Roll-Forward Accurate financial reporting demands strict control over accounting periods. Allowing retroactive edits to transactions in periods that have already been audited, closed, or submitted in statutory VAT filings creates severe compliance liabilities and breaks general ledger integrity. BIZA's **Fiscal Years & Period Management** module (`/accounting/fiscal-years`) gives chief financial officers and financial controllers rigorous controls to lock closed periods, execute formal year-end closures, and roll forward opening balances into subsequent financial years. --- ## 1. Accounting Periods & Multi-Year Setup Organizations can configure their fiscal operating calendar to match their corporate bylaws and statutory jurisdiction: * **Standard Gregorian Calendar:** January 1 – December 31. * **Custom Fiscal Years:** Flexible start and end dates (e.g., April 1 – March 31 or July 1 – June 30). * **Multiple Open Years:** Maintain concurrent open fiscal years during year-end audit transitions, allowing day-to-day operations to proceed in the new year while external auditors finalize prior-year adjustments. --- ## 2. Immutable Accounting Period Locking To protect financial records from accidental or unauthorized modifications: * **Monthly & Quarterly Period Locks:** Once a monthly management close or quarterly VAT return is finalized, the controller applies a **Period Lock** up to a specified lock date (e.g., `2026-06-30`). * **Enforced Restrictions:** * No new invoices, bills, expenses, or manual journal entries can be backdated into a locked period. * Approved vouchers in locked periods cannot be edited, voided, or reversed without explicit dual-authorization unlocking workflows. * Preserves statutory compliance for ZATCA, FTA, and external auditor certifications. --- ## 3. Automated Year-End Closing Journal Entry At the conclusion of an annual audit, closing out the fiscal year requires transferring net operational performance from temporary Profit & Loss accounts into balance sheet equity: ### The Closing Mechanism 1. BIZA aggregates all balances across **Income Accounts (4000 series)** and **Expense Accounts (5000–6000 series)** for the entire fiscal year. 2. An automated, balanced **Year-End Closing Journal Entry** is posted on the final day of the fiscal year: * Debits all revenue accounts to bring their balances to zero. * Credits all expense accounts to bring their balances to zero. * Transfers the net difference (Net Profit or Net Loss) directly to the **Retained Earnings Equity Account (3100)**. $$\begin{aligned} \text{DR} \quad & \text{Sales & Service Revenue Accounts (4000)} & \text{SAR } 1,450,000.00 \\ \text{CR} \quad & \text{Cost of Goods Sold & Expenses (5000–6000)} & \text{SAR } 1,020,000.00 \\ \text{CR} \quad & \text{Retained Earnings — Equity (3100)} & \text{SAR } 430,000.00 \end{aligned}$$ --- ## 4. Opening Balance Roll-Forward Once the closing entry is posted, BIZA rolls forward the balance sheet: * **Zero P&L Starting Balance:** Day 1 of the new fiscal year begins with exact SAR 0.00 balances across all revenue and expense accounts. * **Balance Sheet Continuity:** Asset, Liability, and Equity account balances automatically roll forward as the opening ledger balances of the new fiscal year. * **Audit Trail & Permanent Record:** The fiscal year status transitions to **Closed (Audited)**, archiving all financial statements (Trial Balance, P&L, Balance Sheet, General Ledger) as permanent immutable historical records. --- ## Financial Budgeting & Budget vs. Actual Variance Reporting **Category:** finance-accounting | **Slug:** `/docs/budgeting-and-variance-analysis` | **Canonical URL:** https://biza.app/docs/budgeting-and-variance-analysis **Summary:** Establish departmental and project budgets across General Ledger accounts, monitor actual expenses in real time, and analyze budget vs. actual variances to prevent cost overruns. # Financial Budgeting & Budget vs. Actual Variance Reporting Sustaining corporate profitability requires comparing strategic financial targets against operational reality. BIZA's **Budgeting & Variance Analysis** engine (`/accounting/budgets` and `/accounting/budget-vs-actual`) allows management teams to set cost center and account budgets, monitor burn rates in real time, and enforce preventative spending controls before budget limits are breached. --- ## 1. Budget Creation & Cost Center Granularity BIZA supports flexible, multi-dimensional budgeting structures: * **Fiscal Year & Period Scope:** Define annual corporate operating budgets or granular quarterly and monthly spending limits. * **Account-Level Allocation:** Allocate spending targets across specific General Ledger accounts (e.g., Marketing Travel, IT Software Subscriptions, Office Lease, Subcontractor Labor). * **Cost Center & Branch Dimensions:** Segment budgets by department (Sales, Operations, Engineering, HR) or geographic branch (Riyadh HQ, Jeddah Branch, Dubai Office), ensuring department heads have clear accountability for their cost centers. --- ## 2. Real-Time Budget Tracking & Expenditure Accumulation Rather than waiting for month-end accounting cycles, BIZA continuously calculates budget consumption as operational transactions occur: * **Approved Actual Expenses:** Posted purchase bills, payroll runs, travel expenses, and vendor payments immediately debit against the designated cost center's budget. * **Committed Expenditures:** Purchase orders that have been approved but not yet billed can be tracked as **Committed Spend**, preventing duplicate order commitments that would exceed remaining budget headroom. --- ## 3. Interactive Budget vs. Actual Reporting The **Budget vs. Actual Report** (`/accounting/budget-vs-actual`) provides executive management with immediate visual and numerical variance metrics: | General Ledger Account | Annual Budget | Actual Spend | Variance (SAR) | % Utilized | Status | | :--- | :--- | :--- | :--- | :--- | :--- | | **6100 — Software Licenses** | SAR 120,000 | SAR 98,400 | + SAR 21,600 | 82.0% | Normal (Favorable) | | **6200 — Travel & Lodging** | SAR 80,000 | SAR 86,500 | - SAR 6,500 | 108.1% | Over Budget (Unfavorable) | | **6300 — Digital Advertising** | SAR 250,000 | SAR 190,000 | + SAR 60,000 | 76.0% | Normal (Favorable) | | **6400 — Office Utilities** | SAR 45,000 | SAR 44,200 | + SAR 800 | 98.2% | Caution (Threshold Alert) | ### Key Variance Metrics * **Favorable Variance (+):** Actual spending is less than budgeted, or revenue exceeds targets. * **Unfavorable Variance (-):** Costs have exceeded allocated thresholds, immediately highlighted with red status badges for rapid executive intervention. * **Drilldown Capability:** Click any variance number to view the exact line-item invoices, payment vouchers, and journal entries comprising that account's actual spend. --- ## 4. Preventative Spending Approvals BIZA connects budget thresholds directly to procurement workflows: * **Warning Alerts on Purchase Orders:** When an employee or purchasing officer drafts a purchase order that would cause an account or cost center to exceed its monthly budget, BIZA displays a non-blocking warning banner indicating the impending overage. * **Hard Approval Gates:** Organizations can configure approval workflows requiring CFO or managing director approval whenever an order exceeds 100% of the allocated budget limit. --- ## ZATCA Phase 2 E-Invoicing (Fatoora) Compliance & Clearance **Category:** compliance-tax | **Slug:** `/docs/zatca-phase-2-e-invoicing` | **Canonical URL:** https://biza.app/docs/zatca-phase-2-e-invoicing **Summary:** Technical guide to Saudi Arabia ZATCA Phase 2 e-invoicing: cryptographic stamp generation, UBL 2.1 XML structure, clearance API, and reporting workflows. # ZATCA Phase 2 E-Invoicing (Fatoora) Compliance & Clearance Under Saudi Arabia's Zakat, Tax and Customs Authority (ZATCA) regulations, businesses must integrate their ERP and billing systems with the Fatoora platform for Phase 2 (Integration Phase) compliance. BIZA provides an end-to-end native implementation supporting both B2B Clearance and B2C Reporting flows. --- ## 1. Clearance vs. Reporting Workflows ZATCA defines two distinct document types with separate legal requirements: | Parameter | Standard Tax Invoice (B2B / B2G) | Simplified Tax Invoice (B2C) | |---|---|---| | **Primary Audience** | Companies and government entities | Consumers and retail customers | | **Workflow** | **Clearance:** Must be sent to ZATCA API and approved *before* delivery to customer | **Reporting:** Issued immediately to customer; reported to ZATCA within 24 hours | | **Buyer Details** | Mandatory Legal Name, National Address, and VAT/CR Number | Optional for amounts under SAR 1,000 | | **Visual Stamp** | Cryptographic Stamp + ZATCA Clearance Status | Standard TLV QR Code | | **Output Document** | XML UBL 2.1 + PDF/A-3 embedded | Printed Thermal/A4 Receipt or digital PDF | --- ## 2. Technical Architecture & Cryptographic Stamping For every generated invoice, BIZA automatically executes the mandatory cryptographic pipeline: 1. **UBL 2.1 XML Construction:** Invoices are structured in strict compliance with ZATCA XML schemas, including tax categories (S, Z, E, O), supplier/buyer identification schemes, payment means, and line item calculations. 2. **Invoice Hash (SHA-256):** The canonical XML representation is hashed using SHA-256. 3. **Cryptographic Stamp (ECDSA secp256k1):** The hash is signed with the enterprise's private key linked to the active Compliance or Production CSID (Cryptographic Stamp Identifier). 4. **Previous Invoice Hash (PIH) Chaining:** Invoices are cryptographically chained. Each new invoice includes the hash of the preceding invoice, preventing retroactive insertion or tampering with historical records. 5. **Invoice Counter (ICV):** A sequential, unalterable integer counter incremented with every document. 6. **QR Code Generation:** Encodes mandatory Tag-Length-Value (TLV) byte structures: * Tag 1: Seller's name * Tag 2: Seller's VAT registration number * Tag 3: Invoice timestamp (ISO 8601) * Tag 4: Invoice total (with VAT) * Tag 5: VAT total * Tag 6: SHA-256 Invoice Hash * Tag 7: Cryptographic Signature * Tag 8: ECDSA Public Key (for simplified invoices) --- ## 3. Onboarding & CSID Lifecycle Management Connecting BIZA to your ZATCA portal requires completing the official device onboarding workflow: 1. **OTP Generation:** Obtain a one-time onboarding password from the ZATCA Fatoora portal. 2. **CSR Generation:** BIZA automatically generates an X.509 Certificate Signing Request (CSR) embedding your Commercial Registration (CR), VAT number, and device identity. 3. **Compliance CSID:** BIZA submits the CSR to ZATCA's compliance endpoint, executes the mandatory test scenarios (Standard Invoice, Simplified Invoice, Debit Note, Credit Note), and verifies clearance. 4. **Production CSID:** Upon passing all compliance checks, BIZA requests the final Production CSID and securely stores the production certificate and private keys. --- ## 4. Bilingual PDF/A-3 Layouts & Archival * **Bilingual Documents:** Invoices render in full Arabic and English, meeting all statutory language requirements. * **Embedded XML (PDF/A-3):** Conforms to PDF/A-3 standards, embedding the signed, cleared XML file directly inside the human-readable PDF. * **10-Year Archival:** All cryptographic artifacts (raw XML, signed XML, ZATCA API response headers, and verification tokens) are preserved in tamper-evident storage for the statutory retention period. ### النسخة العربية (Arabic Edition): الفوترة الإلكترونية للمرحلة الثانية من زاتكا (فاتورة): التكامل والاعتماد --- title: "الفوترة الإلكترونية للمرحلة الثانية من زاتكا (فاتورة): التكامل والاعتماد" slug: zatca-phase-2-e-invoicing category: compliance-tax order: 1 updatedAt: "2026-09-20" summary: "الدليل الفني الشامل للامتثال للمرحلة الثانية من الفوترة الإلكترونية (مرحلة الربط والتكامل) في المملكة العربية السعودية: توليد الختم التشفيري، تنسيق UBL 2.1 XML، وتكامل واجهات الربط (API)." tags: ["زاتكا", "فاتورة", "الفوترة الإلكترونية", "الضرائب", "المملكة العربية السعودية", "الامتثال"] --- # الفوترة الإلكترونية للمرحلة الثانية من زاتكا (فاتورة): التكامل والاعتماد تفرض هيئة الزكاة والضريبة والجمارك (ZATCA) في المملكة العربية السعودية متطلبات فنية وتشغيلية صارمة على المنشآت ضمن **المرحلة الثانية (مرحلة الربط والتكامل)** من مشروع الفوترة الإلكترونية «فاتورة». يوفر نظام بيزا (BIZA) محرك فوترة إلكترونية متكامل ومعتمد، يقوم بإنشاء ومعالجة الفواتير الضريبية وتوقيعها رقمياً وإرسالها إلى منصة زاتكا في الوقت الفعلي عبر مسارات الاعتماد المباشر وإشعار التقارير. --- ## 1. الفواتير الضريبية (B2B) مقابل الفواتير المبسطة (B2C) يميز نظام زاتكا بين نوعين رئيسيين من الفواتير لكل منهما متطلباته الخاصة: ### 1. الفواتير الضريبية القياسية (بين المنشآت B2B) * **مسار الاعتماد المسبق (Clearance API):** يجب إرسال الفاتورة بصيغة XML الموقعة رقمياً إلى منصة زاتكا والحصول على الموافقة والختم المشفر الرسمي قبل تسليمها للعميل. * **البيانات الإلزامية:** الرقم الضريبي للعميل، العنوان الوطني التفصيلي، والرمز البريدي. ### 2. الفواتير الضريبية المبسطة (بين المنشأة والمستهلك B2C) * **مسار إشعار التقارير (Reporting API):** يتم إصدار الفاتورة فوراً للمستهلك عند نقطة البيع أو إتمام الخدمة، مع التزام النظام برفعها إلى منصة زاتكا خلال 24 ساعة كحد أقصى. * **رمز الاستجابة السريعة (QR Code):** يجب أن تحتوي النسخة المطبوعة أو الإلكترونية على رمز QR مشفر بتنسيق (TLV - Tag Length Value) يتضمن التوقيع الرقمي والمفتاح العام. --- ## 2. المكونات التشفيرية الإلزامية في بيزا يقوم محرك بيزا بتوليد كافة المتطلبات التشفيرية لكل فاتورة دون أي تدخل يدوي: 1. **هيكل الفاتورة UBL 2.1 XML:** بناء ملف الفاتورة القياسي المتوافق تماماً مع مخطط الفاتورة المعتمد من زاتكا. 2. **تجزئة الفاتورة (Invoice Hash):** توليد قيمة التجزئة المشفرة باستخدام خوارزمية SHA-256 لحماية الفاتورة من أي تعديل لاحق. 3. **التسلسل والترابط التشفيري (PIH - Previous Invoice Hash):** ربط كل فاتورة تجزئة بالفاتورة السابقة لها في سلسلة غير قابلة للتلاعب، مما يمنع التلاعب بالتواريخ أو حذف الفواتير. 4. **الختم التشفيري (ECDSA Digital Signature):** توقيع الفاتورة باستخدام المفتاح الخاص لجهاز المنشأة وشهادة CSID الصادرة من هيئة الزكاة. 5. **تشفير رمز QR (TLV Encoding):** تشفير اسم المورد، الرقم الضريبي، تاريخ ووقت الإصدار، إجمالي الفاتورة، مبلغ الضريبة، وقيمة التجزئة والختم في رمز الاستجابة السريعة. --- ## 3. دورة حياة شهادة التشفير (CSID) * **التهيئة والربط (Onboarding):** توليد مفاتيح التشفير (Public/Private Keys) وطلب توقيع الشهادة (CSR) وإدخال رمز OTP من بوابة زاتكا في خطوة واحدة. * **شهادة الإنتاج (Production CSID):** الانتقال التلقائي من بيئة المحاكاة والاختبار إلى بيئة الإنتاج الحية. * **التجديد الدوري:** تنبيهات تلقائية قبل انتهاء صلاحية الشهادة وتجديدها بسلاسة لضمان استمرارية إصدار الفواتير دون انقطاع. --- ## 4. الفروقات بين المسودات والفواتير المعتمدة * **مسودة الفاتورة (Draft):** قابلة للتعديل والتحقق من الأسعار والكميات وحسابات الضريبة دون التأثير على القيود المحاسبية أو منصة زاتكا. * **الفاتورة المعتمدة (Approved):** عند الاعتماد، يقوم بيزا بقفل الفاتورة نهائياً، حجز الرقم التسلسلي، توليد الختم التشفيري، إنشاء القيود المحاسبية الآلية، ورفع الفاتورة إلى هيئة الزكاة. --- ## VAT Returns, Tax Period Closing & Statutory Filing Reports **Category:** compliance-tax | **Slug:** `/docs/vat-returns-tax-periods-reporting` | **Canonical URL:** https://biza.app/docs/vat-returns-tax-periods-reporting **Summary:** Reconcile output tax against input tax: automated Saudi ZATCA VAT Return (Box 1-16) generation, UAE FTA VAT 201 reports, and fiscal tax period locking. # VAT Returns, Tax Period Closing & Statutory Filing Reports Value Added Tax (VAT) compliance in Saudi Arabia (15%) and the United Arab Emirates (5%) requires accurate segregation of standard-rated supplies, zero-rated exports, exempt sales, and deductible input tax on local purchases and import customs. BIZA compiles official tax return figures automatically from daily operational documents. --- ## 1. Output Tax vs. Input Tax Reconciliation Tax calculation happens at the point of document creation rather than month-end estimation: * **Output VAT (Sales):** Recorded automatically when tax invoices and credit notes are issued to customers. * **Input VAT (Purchases & Expenses):** Recorded when supplier bills, import declarations, and expenses are approved with valid tax invoices. * **Net Tax Liability:** $$\text{Net VAT Payable / (Refund)} = \text{Total Output VAT} - \text{Total Recoverable Input VAT}$$ --- ## 2. ZATCA Official Return Form Layout (Saudi Arabia) BIZA structures tax summaries to match the exact statutory boxes of the ZATCA VAT Return: ### Section A: VAT on Sales (Output Tax) * **Box 1:** Standard-rated 15% sales to local customers. * **Box 2:** Sales to registered taxpayers in other GCC states. * **Box 3:** Zero-rated local supplies (qualifying medical supplies, transport). * **Box 4:** Export supplies outside GCC territory. * **Box 5:** Exempt supplies (qualifying financial services, residential leases). ### Section B: VAT on Purchases (Input Tax) * **Box 7:** Standard-rated 15% local purchases. * **Box 8:** Imports subject to VAT paid at customs. * **Box 9:** Imports subject to VAT under the Reverse Charge Mechanism (RCM). * **Box 10:** Zero-rated purchases. * **Box 11:** Exempt purchases. --- ## 3. Reverse Charge Mechanism (RCM) for Foreign Services When purchasing software, consulting, or engineering services from non-resident suppliers outside Saudi Arabia or UAE: * **Automatic Dual Booking:** BIZA accounts for VAT under the Reverse Charge Mechanism without supplier tax registration. * **Simultaneous Debit & Credit:** Recognizes both Output VAT Liability and Recoverable Input VAT on the same voucher, ensuring full compliance without manual journal workarounds. --- ## 4. Tax Period Locking & Audit File Export To prevent audit discrepancies after submitting a statutory tax return: * **Lock Tax Period:** Close the month or quarter in BIZA. This freezes the tax period and prevents retroactive editing or addition of invoices dated in that period. * **ZATCA Audit File:** Export the complete line-by-line transaction register (including invoice hashes, buyer tax IDs, and clearance codes) ready for submission during official tax audits. ### النسخة العربية (Arabic Edition): إقرارات ضريبة القيمة المضافة، إقفال الفترات الضريبية، والتقارير النظامية --- title: "إقرارات ضريبة القيمة المضافة، إقفال الفترات الضريبية، والتقارير النظامية" slug: vat-returns-tax-periods-reporting category: compliance-tax order: 2 updatedAt: "2026-09-20" summary: "مطابقة ضريبة المخرجات وضريبة المدخلات: توليد إقرار ضريبة القيمة المضافة لهيئة الزكاة السعودية (الخانات 1-16)، تقارير الهيئة الاتحادية للضرائب في الإمارات، وإقفال الفترات الضريبية المحكم." tags: ["ضريبة القيمة المضافة", "زاتكا", "الإقرار الضريبي", "الضرائب", "السعودية", "الإمارات", "الامتثال"] --- # إقرارات ضريبة القيمة المضافة، إقفال الفترات الضريبية، والتقارير النظامية تتطلب قوانين ضريبة القيمة المضافة في المملكة العربية السعودية (بنسبة 15%) ودولة الإمارات العربية المتحدة (بنسبة 5%) مطابقة دقيقة بين ضريبة المخرجات المحصلة من المبيعات وضريبة المدخلات المدفوعة على المشتريات والمصروفات المؤهلة. يوفر بيزا (BIZA) لوحة تحكم متطورة لضريبة القيمة المضافة (`/vat`) تتيح تتبع الالتزامات الضريبية لحظة بلحظة، إعداد نموذج الإقرار الضريبي الرسمي، إقفال الفترات الضريبية لحمايتها من التعديل بأثر رجعي، ومطابقة الرصيد الصافي المستحق للسداد أو الاسترداد. --- ## 1. نموذج إقرار ضريبة القيمة المضافة السعودي (الخانات 1 إلى 16) يُنشئ بيزا تقرير الإقرار الضريبي مطابقاً تماماً لترتيب وخانات بوابة هيئة الزكاة والضريبة والجمارك: ### ضريبة القيمة المضافة على المبيعات (ضريبة المخرجات): * **الخانة 1:** المبيعات الخاضعة للنسبة الأساسية (15%). * **الخانة 2:** المبيعات للمواطنين (الخدمات الصحية الخاصة والتعليم الأهلي). * **الخانة 3:** المبيعات الخاضعة للنسبة الصفرية (الصادرات والخدمات المؤهلة). * **الخانة 4:** المبيعات المعفاة من الضريبة. * **الخانة 5:** إجمالي المبيعات وضريبة المخرجات المحسوبة. ### ضريبة القيمة المضافة على المشتريات (ضريبة المدخلات): * **الخانة 7:** المشتريات الخاضعة للنسبة الأساسية (15%) المستردة بالكامل. * **الخانة 8:** الاستيرادات الخاضعة للضريبة والمدفوعة في الجمارك أو عبر آلية الاحتساب العكسي (RCM). * **الخانة 9:** المشتريات الخاضعة للنسبة الصفرية. * **الخانة 10:** المشتريات المعفاة. * **الخانة 11:** إجمالي المشتريات وضريبة المدخلات القابلة للاسترداد. ### صافي الضريبة المستحقة (الخانة 14): * حساب الفارق الرياضي بدقة: **ضريبة المخرجات - ضريبة المدخلات**. * في حال كانت النتيجة موجبة، يحدد النظام المبلغ الواجب سداده للهيئة؛ وفي حال كانت سالبة، يحدد الرصيد الدائن المؤهل للاسترداد أو الترحيل للفترة القادمة. --- ## 2. آلية الاحتساب العكسي (Reverse Charge Mechanism - RCM) عند استيراد خدمات برمجية أو استشارية أو سلع من خارج المملكة: * يقوم بيزا باحتساب ضريبة المخرجات وضريبة المدخلات ذاتياً في نفس القيد دون حركة نقدية للجمارك. * يدرج المبلغ في الخانة 8 (الاستيرادات الخاضعة لآلية الاحتساب العكسي) لحماية المنشأة من الغرامات الزكوية. --- ## 3. إقفال الفترة الضريبية وتجميد السجلات بعد تقديم الإقرار الضريبي وسداده عبر منصة «سداد»: 1. يقوم المدير المالي بإجراء **إقفال الفترة الضريبية** (Quarterly / Monthly Lock). 2. يقفل بيزا كافة فواتير المبيعات وفواتير الشراء والإشعارات الدائنة والمدينة الواقعة ضمن الفترة. 3. يمنع النظام تماماً أي تعديل أو إلغاء أو إضافة بأثر رجعي على تلك الفترة، مما يضمن تطابقاً مطلقاً بين دفاتر الحسابات والإقرارات الرسمية المرفوعة. --- ## Projects, Milestone Billing & Field Expense Capture **Category:** projects-operations | **Slug:** `/docs/projects-milestone-billing-field-expenses` | **Canonical URL:** https://biza.app/docs/projects-milestone-billing-field-expenses **Summary:** Manage client projects, contracts, milestone billing schedules, labor timesheets, and mobile/email site expense capture mapped directly to project cost centers. # Projects, Milestone Billing & Field Expense Capture Small-to-medium businesses in contracting, consulting, engineering, and field services require project accounting that bridges site operations with the financial ledger. BIZA connects project execution directly to accounting: track project phases, bill against contractual milestones, log field labor hours, and capture site expenses on the go. --- ## 1. Project Setup & Cost Center Allocation Every project in BIZA acts as an analytical cost center. When a project is initialized: * **Contract Value & Currency:** Set the total contract sum in SAR, AED, USD, or other supported currencies. * **Cost Center Linkage:** The project is assigned a dedicated analytical cost center. Every invoice, purchase entry, expense, or timesheet tagged with the project updates its actual cost and margin in real time. * **Customer Linkage:** Directly tied to the client's master record for consolidated receivables and Statements of Account (SOA). --- ## 2. Milestone Billing Schedules Unlike simple recurring monthly retainers, contracting and engineering projects are billed when contractual deliverables or percentage-of-completion thresholds are verified. ### How Milestone Billing Works 1. **Define Milestones:** Set up contractual stages with target dates, completion percentages, or fixed currency amounts (e.g., *Phase 1: Mobilization & Design (20%)*, *Phase 2: Structural Framing (40%)*, *Phase 3: Final Handover (40%)*). 2. **Progress Verification:** Mark a milestone as achieved. Attach site inspection certificates, sign-off memos, or client approval documents. 3. **One-Click Invoice Generation:** Click **Bill Milestone**. BIZA automatically generates a draft Tax Invoice pre-populated with: * Client details and VAT registration numbers (ZATCA/FTA compliant). * Exact contractual milestone description and line item amount. * Applicable VAT rates (15% Saudi Arabia, 5% UAE). * Retention money deductions (if applicable, held in a dedicated balance sheet retention account). 4. **Approval & Posting:** Once reviewed, approving the invoice posts to Accounts Receivable and generates the compliant e-invoice XML and QR code. --- ## 3. Field Expenses & Site Receipt Capture Site supervisors, project managers, and field technicians frequently incur local expenses: emergency hardware, fuel, materials, transport, and equipment rentals. ### Multi-Channel Ingestion BIZA eliminates lost paper receipts and manual spreadsheet logs through dual-channel capture: * **Mobile / Web Photo Upload:** Take a photo of the cash receipt or supplier voucher directly from a mobile device or desktop. * **Email Ingestion:** Forward receipts, invoices, or delivery slips directly to your workspace email (e.g., `invoices@company.biza.email`). ### AI Extraction & Cost Tagging 1. **Automated Parsing:** AI-powered OCR extracts supplier name, date, currency, line items, VAT breakdown, and total. 2. **Project Tagging:** Select the project cost center and expense category (e.g., *Site Materials*, *Equipment Rental*, *Subcontractor Labor*). 3. **Draft Review:** BIZA creates an **Expense Draft**. The draft displays the original scanned receipt alongside extracted fields and confidence indicators. 4. **Approval Gate:** The finance team or project director reviews and approves the expense. Upon approval: * Debits the Project Cost account in the General Ledger. * Credits Cash, Petty Cash, or Accounts Payable. * Updates the project's actual vs. budgeted cost analysis. --- ## 4. Labor Hours & Timesheet Tracking Accurate project margin calculation requires factoring in employee and contractor time. * **Weekly / Daily Timesheets:** Employees or supervisors record hours worked by project and task. * **Internal Cost Rates:** Each employee profile can carry a private internal labor cost rate (standard hourly rate + overhead). * **Cost vs. Billable Hours:** Track non-billable project overhead alongside billable hours for time-and-materials contracts. * **Direct Payroll Linkage:** Approved project hours feed into the monthly WPS payroll run. --- ## 5. Real-Time Project P&L & Margins Because all project transactions (milestone invoices, material purchases, field expenses, and labor costs) share the same underlying General Ledger: * **Earned Value & Profitability:** Instantly view revenue recognized vs. total actual costs incurred. * **Budget vs. Actual Variance:** Track material cost overruns or labor slippage before project completion. * **Work in Progress (WIP):** Accurately account for unbilled deliverables at period close. ### النسخة العربية (Arabic Edition): إدارة المشاريع، الفوترة بالأشواط (Milestones)، وتتبع مصاريف الموقع --- title: "إدارة المشاريع، الفوترة بالأشواط (Milestones)، وتتبع مصاريف الموقع" slug: projects-milestone-billing-field-expenses category: projects-operations order: 1 updatedAt: "2026-09-20" summary: "إدارة عقود المشاريع الإنشائية والاستشارية، جداول الفوترة بالأشواط والمستخلصات، تسجيل ساعات العمل، وتوثيق مصاريف الموقع عبر البريد والجوال وربطها بمراكز تكلفة المشاريع." tags: ["المشاريع", "المقاولات", "المستخلصات", "المصروفات", "مراكز التكلفة", "ساعات العمل"] --- # إدارة المشاريع، الفوترة بالأشواط (Milestones)، وتتبع مصاريف الموقع تواجه شركات المقاولات، والخدمات الهندسية، والاستشارات المهنية صعوبة مستمرة في ضبط تكاليف المشاريع الميدانية ومطابقتها مع جداول الدفعات والمستخلصات المعتمدة من العملاء. يوفر نظام بيزا (BIZA) وحدة متكاملة لإدارة المشاريع (`/projects`) تجمع بين تتبع مراحل الإنجاز، وإصدار فواتير المستخلصات بنقرة واحدة، وتسجيل ساعات العمل، والتقاط مصاريف الموقع الميدانية لحظياً عبر البريد الإلكتروني أو كاميرا الجوال دون أي تأخير. --- ## 1. هيكلة عقود المشاريع والأشواط (Milestones) * **بيانات العقد وقيمته الإجمالية:** تحديد العميل، نطاق العمل، تاريخ البدء والتسليم، وقيمة العقد المعتمدة شاملة أو غير شاملة لضريبة القيمة المضافة. * **جدول الأشواط والدفعات:** تقسيم قيمة المشروع إلى أشواط قابلة للقياس (مثال: الدفعة المقدمة 10%، إتمام الأعمال الترابية 25%، الهيكل الإنشائي 35%، التسليم النهائي 30%). * **ربط المهام بمراكز التكلفة:** كل مرحلة ترتبط بمركز تكلفة تحليلي مستقل داخل شجرة الحسابات العامة، مما يتيح استخراج قائمة أرباح وخسائر مستقلة لكل مشروع على حدة. --- ## 2. التقاط مصاريف الموقع الميدانية عبر البريد والهاتف بدلاً من ضياع الفواتير الورقية في مواقع العمل: 1. **الالتقاط بالهاتف الذكي:** يفتح مهندس الموقع واجهة بيزا من الجوال ويلتقط صورة لفاتورة الوقود أو شراء المواد الطارئة. 2. **إعادة التوجيه عبر البريد:** إعادة توجيه الفواتير الرقمية وعقود تأجير المعدات إلى بريد المنشأة المخصص (`inbox@company.biza.email`). 3. **الاستخراج الآلي للمسودة:** يقرأ محرك الذكاء الاصطناعي اسم المورد، التاريخ، والتفاصيل والضريبة (15%)، وينشئ مسودة سند صرف مقيدة بالمشروع والمهمة المعنية. --- ## 3. إصدار فواتير المستخلصات المعتمدة بضغطة زر عند إنجاز أي شوط تعاقدي واعتماده من استشاري العميل: * يفتح مدير المشروع شاشة العقد وينقر **إصدار فاتورة الشوط**. * يقوم بيزا باحتساب المبلغ المستحق آلياً، واحتساب ضريبة القيمة المضافة (15%)، وإصدار فاتورة ضريبية نظامية معتمدة من هيئة الزكاة (زاتكا) مشفرة برمز الاستجابة السريعة (QR). * إرفاق تقارير الإنجاز وسجلات المصاريف المعتمدة كملفات داعمة للفاتورة بضغطة واحدة. --- ## Project Change Orders & Subcontractor Cost Management **Category:** projects-operations | **Slug:** `/docs/project-change-orders-subcontractors` | **Canonical URL:** https://biza.app/docs/project-change-orders-subcontractors **Summary:** Manage project contract variations, formal change order approvals, subcontractor work orders, milestone progress certifications, retention money deductions, and back-to-back client billing. # Project Change Orders & Subcontractor Cost Management In contracting, construction, engineering, and enterprise consulting, initial project contracts rarely remain static. Unforeseen site conditions, client scope additions, and engineering revisions require formal contractual variations. Simultaneously, managing specialized subcontractors requires strict verification of milestone deliverables, retention money withholdings, and back-to-back cost recovery. BIZA provides comprehensive **Change Order Management** (`/projects/:id/change-orders`) and **Subcontractor Administration** (`/subcontractors`) tools designed to protect project gross margins and eliminate unapproved scope creep. --- ## 1. Project Change Orders (Variation Orders) When a client or site supervisor requests an adjustment to original deliverables, BIZA formalizes the change through a structured variation workflow: ### Key Change Order Attributes * **Scope Definition & Technical Justification:** Detailed narrative describing the architectural, mechanical, or functional revisions requested. * **Cost & Price Impact:** * **Direct Cost Impact:** Additional labor hours, specialized equipment rentals, raw material requisitions, and subcontractor fees. * **Client Billing Adjustment:** Revised contract price, profit markup, and revised billing milestone schedules. * **Schedule Impact:** Additional working days or adjusted project completion deadlines. ### Formal Approval Gate * Change orders remain in **Draft / Submitted** status until approved by authorized stakeholders (Project Director, Client Representative). * Upon approval, BIZA automatically updates the project's **Revised Contract Value**, **Baseline Budget**, and downstream milestone billing schedules. Unapproved variation orders cannot generate customer invoices. --- ## 2. Subcontractor Work Orders & Milestone Certifications Managing third-party trade subcontractors (e.g., electrical, plumbing, civil foundations, software engineering) requires strict verification before disbursement: 1. **Subcontractor Agreements:** Define subcontractor trade specializations, agreed unit rates, milestone deliverables, and payment terms. 2. **Work Completion Certifications:** Site supervisors inspect and record actual physical progress (e.g., 40% civil works completed) before the subcontractor submits a payment claim. 3. **Automated 3-Way Match:** Subcontractor progress invoices are matched against the approved work order and supervisor site certification, preventing over-billing. --- ## 3. Retention Money Withholding & Release In contracting and construction, withholding a statutory or contractual retention percentage (typically 5% to 10%) protects against latent defects: * **Automated Retention Deduction:** When a subcontractor invoice is processed, BIZA automatically deducts the configured retention percentage, booking the net amount to Accounts Payable and the withheld balance to a dedicated **Retention Payable Liability Account (2050)**. * **Defect Liability Period (DLP) Tracking:** Records the warranty and maintenance period (e.g., 12 months post-handover). * **Final Retention Release Voucher:** Upon successful issuance of the Final Completion Certificate, BIZA generates a retention release payment voucher, releasing the retained funds back to the subcontractor. --- ## 4. Back-to-Back Client Billing & Cost Recovery Subcontractor costs and approved variation orders link directly to customer accounts: * **Cost Code Linkage:** Every subcontractor timesheet, material purchase, and equipment rental is tagged with the specific project task and cost center. * **One-Click Milestone Invoicing:** Approved change orders and certified subcontractor progress claims feed directly into BIZA's customer invoicing engine, enabling timely, transparent milestone billing with attached supporting documentation. --- ## Multi-Warehouse Inventory & Landed Cost Valuation **Category:** inventory-procurement | **Slug:** `/docs/multi-warehouse-inventory-valuation` | **Canonical URL:** https://biza.app/docs/multi-warehouse-inventory-valuation **Summary:** Track stock across multiple warehouses, manage transfers, automate reorder points, allocate landed costs, and maintain accurate inventory valuations. # Multi-Warehouse Inventory & Landed Cost Valuation For retail, distribution, and manufacturing businesses, inventory is both an operational necessity and a major balance sheet asset. BIZA links physical stock movements directly to accounting valuation, providing real-time visibility across multiple branches, warehouses, and storage locations. --- ## 1. Multi-Warehouse Architecture Track items across any number of physical or virtual locations: * **Central Warehouses & Distribution Centers:** High-volume storage and supplier receiving points. * **Retail Branches & Showrooms:** Location-specific inventory levels for point-of-sale and showroom sales. * **Vehicles / Field Vans:** Mobile stock locations for technicians or van-sale operations. * **Consignment & Transit Locations:** Track goods currently in transit between warehouses or on consignment with partners. --- ## 2. Stock Movements & Traceability Every inventory movement generates an auditable stock ledger entry: * **Stock Transfers:** Two-step transfer workflows (Dispatch from Warehouse A -> In Transit -> Receipt at Warehouse B) to prevent missing goods. * **Batch & Serial Number Tracking:** Track perishable batches with expiry dates or high-value serialized equipment for warranty management. * **Stock Adjustments:** Physical inventory cycle counts and write-offs with mandatory reason codes and approval gates. * **Reorder Points & Safety Stock:** Configure minimum threshold alerts by warehouse; automatically draft purchase orders when available stock falls below safety levels. --- ## 3. Landed Cost Allocation A product's true cost is rarely just the purchase price on the supplier's invoice. Freight, customs duties, port handling, and insurance must be capitalized into inventory value to maintain true gross margins. ### The Landed Cost Voucher 1. **Link Purchase Entries:** Select the goods receipt or purchase entries associated with an import shipment. 2. **Add Additional Costs:** Enter freight charges, customs fees, transport, and insurance vouchers. 3. **Allocation Methods:** Allocate costs proportionally across line items based on: * **Item Value:** Proportional to item purchase cost. * **Item Quantity:** Proportional to unit count. * **Weight / Volume:** Proportional to gross weight or cubic volume (CBM). 4. **General Ledger Update:** * Debits the Inventory Asset account by the allocated additional charges. * Credits the Landed Cost Clearing / Accrual account. * Updates the moving average cost of each SKU in the stock ledger. --- ## 4. Inventory Valuation Methods BIZA supports standard inventory accounting principles: * **Moving Weighted Average Cost:** Re-evaluates unit cost dynamically upon each purchase entry and landed cost allocation. * **Periodic Stock Valuation Report:** Real-time balance breakdown by category, warehouse, and SKU for monthly financial reconciliation. ### النسخة العربية (Arabic Edition): إدارة المستودعات المتعددة، التحويلات المخزنية، وتقييم المخزون --- title: "إدارة المستودعات المتعددة، التحويلات المخزنية، وتقييم المخزون" slug: multi-warehouse-inventory-valuation category: inventory-procurement order: 1 updatedAt: "2026-09-20" summary: "تتبع المخزون عبر فروع ومستودعات متعددة، إدارة التحويلات وحالات البضاعة في الطريق، ضبط نقاط إعادة الطلب الآلية، وتوزيع التكاليف المضافة وفق المعايير المحاسبية الدولية." tags: ["المستودعات", "المخزون", "التحويلات", "تقييم المخزون", "التكلفة المرجحة", "سلاسل الإمداد"] --- # إدارة المستودعات المتعددة، التحويلات المخزنية، وتقييم المخزون تتطلب الشركات التجارية وشركات التوزيع والمصانع رقابة صارمة على حركة الأصناف عبر مختلف الفروع والمستودعات الإقليمية لضمان عدم نفاد المخزون وحساب تكلفة البضاعة المباعة (COGS) بدقة. يوفر نظام بيزا (BIZA) محركاً متقدماً لإدارة المخزون (`/inventory`) يدعم المستودعات اللامحدودة، وتتبع البضائع في الطريق، وتحديد مستويات الأمان وإعادة الطلب، والتقييم المحاسبي المستمر وفق المتوسط المرجح. --- ## 1. شجرة المستودعات وتوزيع الأصناف * **مستودعات رئيسية وفروع:** تهيئة مواقع تخزين متعددة (مستودع الرياض المركزي، مستودع جدة، مستودع الدمام، معارض البيع بالتجزئة). * **أرصدة لحظية لكل موقع:** استعراض الكميات الفعلية المتاحة للبيع، الكميات المحجوزة لأوامر البيع المعتمدة، والكميات المطلوبة من الموردين. * **تتبع الأرقام التسلسلية ورقم التشغيلة (Batch/Lot Tracking):** متابعة تواريخ انتهاء الصلاحية للمنتجات الغذائية والدوائية ورصد الأرقام التسلسلية للمعدات والإلكترونيات. --- ## 2. التحويلات المخزنية وتتبع البضائع في الطريق (In-Transit) لمنع الفقد أو العجز المخزني أثناء النقل بين المدن: 1. **أمر التحويل:** ينشئ المستودع المرسل طلب تحويل محدد الأصناف والكميات. 2. **سند الصرف وحالة البضاعة في الطريق:** عند خروج الشاحنة، يُنقل المخزون محاسبياً إلى حساب وسيط (`1250 — بضاعة في الطريق`) ويخرج من الرصيد المتاح للمستودع المرسل. 3. **سند الاستلام:** عند وصول الشحنة، يفحص المستودع المستلم البضاعة ويثبت استلامها الفعلي، ليتحول الرصيد إلى المستودع الجديد ويغلق الحساب الوسيط آلياً. --- ## 3. تقييم المخزون والتكلفة اللحظية * **طريقة المتوسط المتحرك المرجح (Moving Average):** يعيد النظام احتساب تكلفة الوحدة تلقائياً مع كل سند إدخال مشتريات أو تعديل تكلفة إضافية. * **القيود المحاسبية الآلية:** مع كل سند تسليم مبيعات، يولد بيزا تلقائياً قيد تكلفة المبيعات: $$\text{مدين: تكلفة البضاعة المباعة (5000)} \quad / \quad \text{دائن: أصل المخزون (1200)}$$ --- ## Procurement Lifecycle: From RFQ to 3-Way Matching & Payment **Category:** inventory-procurement | **Slug:** `/docs/procurement-rfq-to-payment` | **Canonical URL:** https://biza.app/docs/procurement-rfq-to-payment **Summary:** End-to-end procurement workflows: Request for Quotation (RFQ), supplier quote comparisons, Purchase Orders, Goods Receipts, and 3-way invoice matching. # Procurement Lifecycle: From RFQ to 3-Way Matching & Payment Effective procurement prevents uncontrolled spending, secures favorable supplier pricing, and ensures that businesses only pay for goods they actually received. BIZA provides a structured procurement pipeline connecting requests, purchase orders, warehouse receiving, and accounts payable. --- ## 1. Request for Quotation (RFQ) & Supplier Bidding When sourcing materials or services: * **Create RFQ:** Define required SKUs, quantities, specifications, delivery location, and submission deadlines. * **Multi-Supplier Dispatch:** Send the RFQ simultaneously to multiple approved vendors via email directly from BIZA. * **Supplier Quotation Comparison:** Enter vendor bids to view side-by-side comparison tables evaluating price per unit, delivery lead times, payment terms, and minimum order quantities. --- ## 2. Purchase Orders (PO) & Approval Gates Once the preferred supplier quotation is selected: * **PO Generation:** Convert the accepted quotation into a Purchase Order with one click. * **Threshold Approval Rules:** Configure automated approval routing based on company financial controls (e.g., POs under SAR 10,000 approved by department manager; POs over SAR 50,000 require CFO / General Manager sign-off). * **Vendor Confirmation:** Transmit the finalized bilingual PO (PDF/Email) to the supplier. --- ## 3. Goods Receipt / Purchase Entry When goods physically arrive at the destination warehouse: * **Warehouse Receiving:** Staff create a **Purchase Entry / Goods Receipt** against the open PO. * **Quantity Verification:** Record received quantities vs. ordered quantities. Handle partial deliveries, damaged items, and backorders cleanly. * **Stock Ledger Update:** Increases on-hand stock quantities at the designated warehouse location and debits Inventory Stock In Hand. --- ## 4. 3-Way Matching & Supplier Bill Verification Before finance releases payment, BIZA facilitates rigorous **3-Way Matching**: 1. **Purchase Order:** Validates agreed unit price and approved order quantities. 2. **Purchase Entry / Goods Receipt:** Validates actual physical items received into the warehouse. 3. **Supplier Invoice:** Validates supplier billing totals, VAT calculation, and payment terms. ### Discrepancy Safeguards If the supplier invoice charges a higher price than the PO or bills for more items than the warehouse received: * BIZA flags the line item with a **Variance Alert**. * The voucher requires explicit management approval before it can be scheduled for payment. --- ## 5. Settlement & Supplier Statement of Account (SOA) * **Payment Voucher:** Generate payment entries against single or multiple bills (cash, cheque, bank transfer). * **AP Aging:** Real-time visibility into supplier obligations across aging buckets (Current, 1-30 days, 31-60 days, 60+ days). * **Supplier SOA:** Generate complete statements of account in Arabic and English for periodic vendor reconciliations. ### النسخة العربية (Arabic Edition): دورة المشتريات: من طلب عروض الأسعار (RFQ) إلى المطابقة الثلاثية والسداد --- title: "دورة المشتريات: من طلب عروض الأسعار (RFQ) إلى المطابقة الثلاثية والسداد" slug: procurement-rfq-to-payment category: inventory-procurement order: 2 updatedAt: "2026-09-20" summary: "إدارة دورة المشتريات المؤسسية: مقارنة عروض أسعار الموردين، أوامر الشراء المعتمدة، سندات استلام البضائع، والمطابقة الثلاثية لمنع الدفع الزائد." tags: ["المشتريات", "أوامر الشراء", "الموردين", "المطابقة الثلاثية", "استلام البضائع", "الرقابة المالية"] --- # دورة المشتريات: من طلب عروض الأسعار (RFQ) إلى المطابقة الثلاثية والسداد تتطلب الرقابة على سلاسل الإمداد ومصروفات المشتريات في المنشآت المتوسطة والكبيرة مساراً تدقيقياً محكماً يضمن الحصول على أفضل الأسعار ومنع سداد فواتير لم يتم استلام بضائعها بالفعل. يوفر نظام بيزا (BIZA) دورة مشتريات إلكترونية مغلقة (`/procurement`) تبدأ من طلب الأسعار وتنتهي بسداد فواتير الموردين مع مطابقة ثلاثية صارمة. --- ## 1. طلبات عروض الأسعار ومقارنة الموردين (RFQ) * **إنشاء طلب تسعير:** تحديد مواصفات وكميات الأصناف المطلوبة وإرسالها لمجموعة من الموردين المعتمدين بضغطة زر. * **جدول مقارنة الأسعار:** تفريغ عروض الأسعار الواردة في جدول مقارنة موحد يوضح السعر الإفرادي، فترات التسليم، شروط السداد، وموثوقية المورد. * **الترقية لأمر شراء:** اختيار العرض الفائز وترقيته بضغطة واحدة إلى أمر شراء رسمي دون إعادة كتابة البيانات. --- ## 2. أوامر الشراء ومستويات الصلاحيات * **أمر الشراء المعتمد (PO):** وثيقة ملزمة قانونياً تُرسل للمورد متضمنة الأسعار المتفق عليها وضريبة القيمة المضافة وموعد التسليم. * **مصفوفة الاعتمادات المالية:** إمكانية وضع حدود صلاحيات مالية (مثلاً: أوامر الشراء التي تتجاوز 100,000 ريال تتطلب اعتماد المدير المالي). --- ## 3. المطابقة الثلاثية الصارمة (3-Way Matching) يقوم محرك بيزا بمقارنة ثلاثة مستندات قبل السماح بصرف أي دفعة للمورد: 1. **أمر الشراء (PO):** ما تم الاتفاق على شرائه وسعره. 2. **سند استلام البضاعة (GRN):** ما تم فحصه واستلامه فعلياً في المستودع. 3. **فاتورة المورد (Supplier Bill):** ما يطالب المورد بسداده مالياً. إذا وُجد أي فارق في الكميات أو زيادة غير مبررة في الأسعار، يقوم بيزا بتعليق الفاتورة وتنبيه قسم الحسابات فوراً لمنع التكرار أو السداد الخاطئ. --- ## Landed Cost Adjustments & Inventory Capitalization **Category:** inventory-procurement | **Slug:** `/docs/landed-cost-adjustments-valuation` | **Canonical URL:** https://biza.app/docs/landed-cost-adjustments-valuation **Summary:** Capitalize international freight, customs clearance, tariffs, and shipping insurance into inventory asset values and Cost of Goods Sold (COGS) with multi-criteria apportionment. # Landed Cost Adjustments & Inventory Capitalization When importing merchandise or acquiring industrial raw materials, the purchase price paid to the overseas vendor is only one component of true inventory acquisition cost. Companies routinely incur significant third-party expenditures, including ocean/air freight, customs tariffs, port demurrage, clearance agent fees, transport insurance, and local inland haulage. Under standard accounting frameworks (IFRS and SOCPA), these ancillary acquisition costs cannot simply be expensed into administrative overhead—they must be **capitalized** into inventory asset values and cost of goods sold (COGS). BIZA's **Landed Cost Adjustments** module (`/procurement/landed-cost-adjustments`) automates this complex accounting process. --- ## 1. The Landed Cost Problem: Delayed Ancillary Bills In international trade, goods frequently arrive at the warehouse weeks before final clearance and freight invoices are delivered by logistics carriers: * **The Valuation Risk:** If inventory is received and sold before freight is capitalized, product profit margins appear artificially inflated, followed by an unexpected margin collapse when carrier bills arrive. * **BIZA's Solution:** BIZA allows warehouses to receive inventory immediately at estimated or purchase bill values, and subsequently apply **Landed Cost Adjustment Vouchers** that retrospectively adjust item moving average costs and update Cost of Goods Sold for items already sold. --- ## 2. Multi-Criteria Apportionment Engine When applying a consolidated freight bill (e.g., USD 4,200.00 ocean container freight) across a shipment containing diverse products, costs must be distributed proportionally. BIZA provides three mathematical apportionment methods: 1. **By Item Value (Pro-Rata):** * Allocates cost based on the relative monetary value of each line item. * Ideal for customs tariffs and ad-valorem import duties that are assessed as a percentage of CIF value. 2. **By Item Weight (Gross/Net Weight):** * Allocates cost based on total weight (kg / metric tons). * Essential for air freight, container shipping, and heavy industrial metals where logistics pricing scales by weight. 3. **By Item Volume (CBM):** * Allocates cost based on cubic meters (CBM) consumed in the container or transport truck. * Ideal for lightweight, bulky merchandise such as packaging, furniture, and plastic wares. 4. **Manual Allocation:** Custom overrides for specific handling fees or specialized inspection surcharges tied to a single item. --- ## 3. General Ledger Accounting Workflow When a Landed Cost Adjustment is posted, BIZA executes precise accounting adjustments: ### Scenario: * An electronics shipment arrives with purchase cost of SAR 100,000.00. * A freight and customs bill of SAR 15,000.00 arrives from a logistics provider. ### Accounting Journal Entry: $$\begin{aligned} \text{DR} \quad & \text{Merchandise Inventory Asset (1200)} & \text{SAR } 15,000.00 \\ \text{CR} \quad & \text{Accounts Payable — Logistics Carrier (2000)} & \text{SAR } 15,000.00 \end{aligned}$$ ### What Happens if Goods Were Already Sold? If 40% of the shipment was already delivered and sold to customers under delivery notes prior to the landed cost voucher: * BIZA capitalizes 60% (SAR 9,000.00) into remaining on-hand **Inventory Asset**. * BIZA automatically debits the remaining 40% (SAR 6,000.00) directly to **Cost of Goods Sold (COGS — 5000)**, ensuring financial statements accurately reflect true gross profit without distorting current stock valuation. --- ## 4. Landed Cost Traceability & Profitability Analysis * **Item Master Valuation:** Automatically updates the item's **Moving Average Unit Cost** (`weighted_average_cost`), ensuring downstream sales quotations and margin calculations use true acquisition costs. * **Audit Trail & Document Chain:** Links the Landed Cost Adjustment voucher directly to the original Purchase Orders, Goods Receipt Vouchers (GRN), and Logistics Supplier Bills. * **Product Profitability Reports:** Enables accurate net margin reporting by product line, accounting for shipping, tariffs, and handling overhead. --- ## Sales Lifecycle: Quotations, Sales Orders, Delivery Notes & Invoices **Category:** sales-crm | **Slug:** `/docs/sales-quotes-to-invoices` | **Canonical URL:** https://biza.app/docs/sales-quotes-to-invoices **Summary:** Manage the commercial sales cycle: customer quotations, sales order commitments, delivery notes with stock decrement, and tax invoice generation. # Sales Lifecycle: Quotations, Sales Orders, Delivery Notes & Invoices From the initial commercial inquiry to receiving payment, BIZA maintains a seamless, auditable sales pipeline that keeps sales representatives, warehouse fulfillment, and finance in complete coordination. --- ## 1. Commercial Quotations & Proposals Sales teams can quickly prepare branded, bilingual quotations: * **Customer Lookup:** Auto-populate customer legal details, payment terms, and price list tiers. * **Line Item Pricing:** Dynamic calculation of unit prices, percentage/amount discounts, and applicable VAT. * **Validity & Terms:** Specify quotation validity periods, delivery lead times, and terms of payment. * **One-Click Share:** Send quotes directly via email or export as professional bilingual PDFs (Arabic/English). --- ## 2. Sales Orders (SO) & Stock Reservation When a customer accepts a proposal: * **Convert Quote to Order:** One click converts the quotation into an active Sales Order. * **Stock Allocation & Availability:** Instantly verify whether ordered quantities exist in warehouse stock. BIZA can reserve inventory against the order to prevent double-selling. * **Credit Limit Enforcement:** If the customer's outstanding balance plus the new order value exceeds their approved credit limit, the system alerts the sales rep and requests credit manager approval. --- ## 3. Delivery Notes & Fulfillment For businesses that deliver physical goods before issuing the financial tax invoice: * **Fulfillment Dispatch:** Warehouse teams generate a **Delivery Note / Dispatch Slip** against the Sales Order. * **Inventory Decrement:** Confirming delivery decrements stock from the specified warehouse and debits Cost of Goods Sold (COGS). * **Proof of Delivery:** Upload signed customer delivery acknowledgments and gate passes directly to the record. --- ## 4. Tax Invoicing & Accounts Receivable * **Invoice Generation:** Convert the Sales Order or Delivery Note into a final Tax Invoice. * **ZATCA Compliance:** In Saudi Arabia, the invoice is processed through the ZATCA Phase 2 clearance engine (B2B) or reporting engine (B2C), embedding the required QR code and cryptographic stamp. * **Automatic Revenue Posting:** * Credits Sales / Revenue accounts. * Credits Output VAT Payable (15% in KSA, 5% in UAE). * Debits Accounts Receivable (Customer Ledger). --- ## 5. Payments, Credit Notes & Customer Statements * **Payment Receipts:** Record customer settlement via bank transfer, credit card, or cash. Support partial payments and advance deposits. * **Credit Notes:** Issue compliant credit notes for returns or billing corrections, cryptographically referencing the original invoice as required by tax authorities. * **AR Aging & Automated Statements:** Track overdue receivables and send customer Statements of Account (SOA) with complete transaction histories. ### النسخة العربية (Arabic Edition): دورة المبيعات: من عروض الأسعار إلى أوامر البيع وسندات التسليم والفواتير --- title: "دورة المبيعات: من عروض الأسعار إلى أوامر البيع وسندات التسليم والفواتير" slug: sales-quotes-to-invoices category: sales-crm order: 1 updatedAt: "2026-09-20" summary: "إدارة دورة المبيعات التجارية: عروض أسعار احترافية ثنائية اللغة، حجز المخزون الفوري، سندات تسليم البضائع مع إنقاص المخزون، وإصدار الفواتير الضريبية المعتمدة." tags: ["المبيعات", "عروض الأسعار", "أوامر البيع", "سندات التسليم", "الفاتورة الضريبية", "إدارة العملاء"] --- # دورة المبيعات: من عروض الأسعار إلى أوامر البيع وسندات التسليم والفواتير يضمن التسلسل السليم لدورة المبيعات التجارية حماية حقوق المنشأة ومنع التضارب بين فرق المبيعات ومسؤولي المستودعات وقسم المحاسبة والتحصيل. يوفر بيزا (BIZA) مسار مبيعات سلس ومترابط (`/sales`) يربط كل خطوة بالخطوة التالية تلقائياً: --- ## 1. عروض الأسعار الاحترافية (Quotations) * **تصاميم رسمية ثنائية اللغة:** إصدار عروض أسعار احترافية بالعربية والإنجليزية متضمنة شعار المنشأة، الشروط والأحكام، وصلاحية العرض. * **تحديد الأسعار والخصومات:** تطبيق فئات أسعار مخصصة لكل عميل وحساب نسبة الخصم ومبلغ ضريبة القيمة المضافة 15%. * **المشاركة السريعة:** إرسال عروض الأسعار عبر البريد الإلكتروني أو مباشرة عبر تطبيق واتساب بضغطة زر واحدة. --- ## 2. أمر البيع وحجز المخزون (Sales Order) بمجرد موافقة العميل على العرض: * ترقية العرض بنقرة واحدة إلى **أمر بيع معتمد**. * **حجز الكميات في المستودع:** يقوم بيزا بحجز الأصناف فوراً لصالح العميل لمنع بيعها لعميل آخر، مع إبقاء المخزون الفعلي في المستودع لحين صدور سند التسليم. --- ## 3. سند التسليم وخروج البضاعة (Delivery Note) عند قيام موظف المستودع بتجهيز البضاعة وتسليمها لسائق التوصيل أو مندوب العميل: * إصدار **سند تسليم رسمي (Delivery Note)**. * يقوم النظام تلقائياً بإنقاص رصيد المخزون الفعلي من المستودع المحدد. * إنشاء قيد تكلفة البضاعة المباعة (COGS) لحظياً في دفتر الأستاذ العام. --- ## 4. إصدار الفاتورة الضريبية المعتمدة والتحصيل * **الربط مع سندات التسليم:** إنشاء الفاتورة استناداً إلى سندات التسليم المنفذة فعلياً، مما يمنع النزاعات مع العميل حول الكميات المستلمة. * **الامتثال لمتطلبات زاتكا:** توليد الفاتورة الضريبية المعتمدة من المرحلة الثانية مع الختم التشفيري ورمز الاستجابة السريعة (QR). * **تتبع التحصيل:** مراقبة حالة السداد (غير مسدد، مسدد جزئياً، مسدد بالكامل) وتوليد روابط سداد إلكترونية مباشرة للعميل. --- ## WhatsApp Business Integration & Customer CRM **Category:** sales-crm | **Slug:** `/docs/whatsapp-crm-customer-communication` | **Canonical URL:** https://biza.app/docs/whatsapp-crm-customer-communication **Summary:** Unify customer communication with ERP records: send tax invoices and payment reminders via WhatsApp, manage customer leads, and convert chats into sales quotes. # WhatsApp Business Integration & Customer CRM In the Gulf region and international emerging markets, WhatsApp is the dominant communication channel for B2B and retail transactions. BIZA integrates WhatsApp Business directly into your ERP workflow, turning informal chat conversations into auditable customer relationships, quotations, and instant payment links. --- ## 1. Unified Customer 360° Profile Every customer record in BIZA connects contact information, operational history, and financial standing: * **Commercial Identifiers:** Legal business name, commercial registration (CR), VAT registration number, and billing/shipping addresses. * **Credit Terms & Limits:** Maximum allowable credit exposure, payment terms (e.g. Net 30, Net 60), and customer price list assignments. * **Unified Timeline:** A chronological activity feed displaying all issued quotations, approved sales orders, delivery notes, cleared tax invoices, and received payments. --- ## 2. WhatsApp Document Delivery & Direct Links Eliminate email delivery failures and spam filters by communicating with customers where they are already active: * **One-Click Invoice Delivery:** Send issued ZATCA/FTA tax invoices directly to the customer's verified WhatsApp number as a high-resolution PDF with embedded QR code. * **Digital Payment Links:** Include direct payment checkout links so customers can settle invoices via mada, Visa, Mastercard, or Apple Pay instantly. * **Automated Delivery Status:** Track message delivery and read receipts directly within the ERP invoice view. --- ## 3. Automated Payment Reminders & Dunning Cash flow management depends on timely collections. BIZA automates accounts receivable follow-ups: * **Pre-Due Alerts:** Send friendly courtesy notifications 3 days before an invoice reaches its contractual due date. * **Overdue Dunning:** Configurable automated escalation workflows (e.g., 7 days overdue, 15 days overdue, 30 days overdue) with attached updated Statements of Account (SOA). * **Payment Acknowledgment:** When a customer payment is posted in the ledger, BIZA automatically transmits an official digital payment receipt voucher via WhatsApp. --- ## 4. Chat-to-Quote Workflow Sales representatives interacting with prospects can generate commercial documents without context switching: * **Quick Item Lookup:** Search inventory on-hand availability, warehouse locations, and pricing while chatting with the client. * **Draft Quotation Creation:** Build a multi-item proposal, apply authorized discounts, and dispatch a bilingual PDF quote directly into the WhatsApp conversation thread. * **Acceptance & Conversion:** When the customer confirms via chat, convert the quote to an active Sales Order with one click. --- ## Point of Sale (POS): a billing counter that posts to your own books **Category:** sales-crm | **Slug:** `/docs/pos-retail-storefront-checkout` | **Canonical URL:** https://biza.app/docs/pos-retail-storefront-checkout **Summary:** BIZA POS for shops, showrooms and counters: barcode and camera scanning, split tenders, promotions, loyalty and gift cards, offline selling, cashier PINs, receipt printing with a cash drawer, and every sale posted as an invoice, a journal entry and a stock movement in one step. # Point of Sale (POS): a billing counter that posts to your own books Most point-of-sale products are a separate app that *exports* to accounting at the end of the day. BIZA POS is different: the billing counter lives inside the ERP, so a sale completed at the counter **is** the accounting. One step creates the numbered tax invoice, the balanced journal entry, the stock movement and the payment records — there is no sync, no import file and no second system to reconcile. This guide covers the retail counter. Companion guides: [receipt printers, cash drawers and self-checkout](/docs/pos-hardware-receipt-printers-cash-drawer-kiosk/), [promotions, price lists, loyalty and gift cards](/docs/pos-promotions-price-lists-loyalty-gift-cards/), [offline selling, shifts and cash control](/docs/pos-offline-shifts-cash-control/), and [restaurant and café mode](/docs/pos-restaurant-cafe-tables-kitchen-qr-ordering/). --- ## 1. What a sale produces When the cashier takes payment, BIZA records — in a single transaction that either fully succeeds or does not happen at all: | Record | Detail | |---|---| | **Tax invoice** | The next number in your gapless invoice sequence, flagged as a POS invoice, with the cashier, terminal and shift on it. Every line carries its tax rate, discount, serial or batch, and (India) HSN/SAC. | | **Journal entry** | Debit cash / bank per tender, credit revenue and output tax; discounts to *Sales discounts given*; tips to *Tips payable*; gift cards sold to a liability, never revenue. | | **Stock movements** | Quantity leaves the terminal's stock location; serial numbers and batches move in the lot ledger. | | **Payments** | One payment record per tender (cash, card, transfer, gift card, points, mada, UPI), each to the bank or cash account you chose. | | **Fiscal data** | Saudi Arabia: the ZATCA TLV QR on the slip (Phase 1) or clearance through the platform (Phase 2). India: GSTIN, HSN/SAC and the composition-scheme line where it applies. | Because nothing is summarised at day end, the Z report, the payment records and the journal always agree — and the POS dashboard shows the three side by side. --- ## 2. The cashier's screen - **Product grid** with search by name, SKU or barcode; category chips; sort by best-selling or recently sold; *in stock only*; large cards, small cards or a list; images on or off. Products with options open a variant picker. Stock, low stock and *not stocked here* are shown per terminal location. - **Scanning** — any USB or Bluetooth barcode scanner works with no setup; the mobile app scans with the camera; in-store scale labels (weight- or price-embedded EAN-13) decode straight into the right quantity. - **Cart** — quantity steppers, unit price override, line discount, note, unit (kg, m, each); cart discount; coupon code; automatic promotions shown with the amount each took; **park** a cart for a customer and resume it from any counter. - **Customer** — walk-in by default; pick a customer to earn or redeem points, get their price list, or credit a return to their account. - **Keyboard** — `F2` search · `F4` pay · `F6` park · `F8` returns · `F9` exact cash · `Esc` back. - **Phones and tablets** — a dedicated one-hand phone layout, a tablet layout that keeps the cart reachable in portrait, 44 px touch targets, swipe to delete, haptics, and a full-screen register mode. --- ## 3. Taking payment Tenders can be **split** across cash, card, bank transfer, gift card or store credit, loyalty points, **on account** (the balance stays on the customer's receivable), and the country pack's tenders — **mada** in Saudi Arabia, **UPI** in India with a scan-to-pay QR built from your UPI ID. Quick-tender chips (50 / 100 / 200 …), a numeric keypad on touch screens, *exact cash* and **change due** keep cash fast. Each tender names the ledger account it is banked to; a missing account blocks the sale instead of posting to nowhere. **Selling on account** — a regular, a contractor or a fleet can take the goods and be charged to their account. The counter shows what they already owe and what their credit limit leaves; it refuses a walk-in and refuses a sale that would pass the limit. The invoice stays unpaid and is collected through Customer Receipts with the usual terms, statements and ageing. In India this is the *khata* the shop already keeps, kept in the ledger instead of a notebook. Tips (to *Tips payable*, never revenue) and a configurable service charge (taxed or not, dine-in only if you want) are available at checkout when switched on. --- ## 4. Receipts The receipt previews on screen and prints on 80 mm or 58 mm thermal paper: seller name and tax number, the country's document title (*Simplified Tax Invoice* in Saudi Arabia, *Tax Invoice* in the UAE and India, *Receipt* elsewhere), receipt reference and invoice number, cashier, lines with serial / batch / expiry / HSN, tax breakdown by rate, tenders, change, gift-card balance, points earned, the fiscal QR and your footer. With a printer configured the receipt prints automatically and the cash drawer opens on cash sales; a printer fault never blocks a sale — the job waits in a retry queue. Send the receipt by **email** (with the invoice's copy-of-record PDF attached, from the platform sender under your store's name) or by **WhatsApp** (share sheet on a phone, a link on desktop). A **customer display** on a second screen shows the lines, total, tendered and change as the sale happens. --- ## 5. Cashiers, shifts and control - **A cashier is a real user.** On a shared counter, cashiers switch with a **PIN** and are signed in as themselves, so every sale, void and drawer open names the person who did it. *Lock counter* hides the screen behind the PIN pad without closing the drawer. - **Shifts** — open the counter with a counted float, record cash in and out with reasons, take an X report any time, close with a blind count and get the Z report: float → sales → movements → expected → counted → variance. - **Events** — line voids (with value), cart voids, no-sale drawer opens (reason required), sign-ins — audited, on the reports, and scored by the dashboard's attention flags. - **Permissions** are enforced by the server, not just the screen: discounts, price overrides, refunds, counter actions, drawer opens and settings each have their own right. --- ## 6. Returns and refunds From Transactions, pick the sale and the quantity per line, give a reason, and refund by **cash from the counter** (leaves the drawer and the expected cash), **credit to the customer's account**, or **store credit** on a card in the customer's name. A credit note is issued against the original invoice and the items — including the exact serial or batch — return to stock. Returns work offline against the billing counter's copy of the sale. --- ## 7. Inventory at the counter Every terminal sells from a stock location. Products tracked by **serial number** or **batch** open a picker on add — scan the serial, or take the batch with the soonest expiry first (FEFO) with expiry warnings; expired batches are refused unless you allow them. Stock transfers open from the counter menu. Multi-location businesses see each outlet's stock and a combined dashboard. --- ## 8. Regional and tax compliance BIZA is global: the receipt, tax label, fiscal QR, document title and extra tenders follow the **country pack** of your company's country. | Country | Receipt title | Fiscal QR | Tax id on receipt | Extra tenders | |---|---|---|---|---| | Saudi Arabia | Simplified Tax Invoice | ZATCA TLV (Phase 1) · Phase 2 clearance | VAT No | mada | | UAE and GCC | Tax Invoice | — | TRN | — | | India | Tax Invoice with HSN/SAC | — | GSTIN | UPI (scan-to-pay QR), RuPay | | United Kingdom | Receipt | — | VAT No | — | | United States | Receipt (sales tax) | — | — | — | Tax is computed per line from the product's tax category or your standard rate; output tax lands in the return period like any other invoice. ### النسخة العربية (Arabic Edition): نقاط البيع (POS): كاشير يُرحّل مباشرةً إلى دفاترك --- title: "نقاط البيع (POS): كاشير يُرحّل مباشرةً إلى دفاترك" slug: pos-retail-storefront-checkout category: sales-crm order: 3 updatedAt: "2026-09-21" summary: "نقاط بيع BIZA للمحلات والمعارض والكاونترات: مسح الباركود والكاميرا، تقسيم الدفع على عدة وسائل، العروض الترويجية، نقاط الولاء وبطاقات الهدايا، البيع دون إنترنت، رقم PIN لكل كاشير، طباعة الإيصال مع فتح درج النقد — وكل عملية بيع تُقيَّد كفاتورة ضريبية وقيد يومية وحركة مخزون في خطوة واحدة." tags: ["نقاط البيع", "التجزئة", "الباركود", "درج النقد", "دون اتصال", "الكاشير", "زاتكا", "ضريبة القيمة المضافة"] --- # نقاط البيع (POS): كاشير يُرحّل مباشرةً إلى دفاترك معظم أنظمة نقاط البيع تطبيقٌ منفصل «يُصدِّر» بياناته إلى المحاسبة في نهاية اليوم. نقاط بيع BIZA مختلفة: الكاشير يعيش داخل نظام ERP نفسه، فعملية البيع على الكاونتر **هي** القيد المحاسبي. خطوة واحدة تُنشئ الفاتورة الضريبية المرقّمة، وقيد اليومية المتوازن، وحركة المخزون، وسجلات الدفع — دون مزامنة ولا ملف استيراد ولا نظام ثانٍ يحتاج إلى تسوية. يغطي هذا الدليل كاشير التجزئة. أدلة مرافقة: [طابعات الإيصالات ودرج النقد والدفع الذاتي](/ar/docs/pos-hardware-receipt-printers-cash-drawer-kiosk/)، [العروض الترويجية وقوائم الأسعار والولاء وبطاقات الهدايا](/ar/docs/pos-promotions-price-lists-loyalty-gift-cards/)، [البيع دون اتصال والورديات ورقابة النقد](/ar/docs/pos-offline-shifts-cash-control/)، و[وضع المطاعم والمقاهي](/ar/docs/pos-restaurant-cafe-tables-kitchen-qr-ordering/). --- ## 1. ماذا تُنتج عملية البيع عند قبض المبلغ يسجّل BIZA — في معاملة واحدة إمّا تنجح كاملةً أو لا تحدث أصلاً: | السجل | التفاصيل | |---|---| | **فاتورة ضريبية** | الرقم التالي في تسلسل فواتيرك دون فجوات، مُعلَّمة كفاتورة نقاط بيع، وعليها الكاشير والجهاز والوردية. كل سطر يحمل نسبة ضريبته وخصمه ورقمه التسلسلي أو دفعته، ورمز HSN/SAC في الهند. | | **قيد يومية** | مدين النقد/البنك لكل وسيلة دفع، ودائن الإيراد وضريبة المخرجات؛ الخصومات إلى *خصومات المبيعات الممنوحة*؛ الإكراميات إلى *إكراميات مستحقة الدفع*؛ بطاقات الهدايا المباعة إلى حساب التزام لا إيراد. | | **حركات المخزون** | تخرج الكمية من موقع مخزون الجهاز؛ وتتحرك الأرقام التسلسلية والدُفعات في سجل الدُفعات. | | **الدفعات** | سجل دفع لكل وسيلة (نقد، بطاقة، تحويل، بطاقة هدايا، نقاط، مدى، UPI) إلى الحساب البنكي أو النقدي الذي اخترته. | | **البيانات الضريبية** | السعودية: رمز QR الخاص بزاتكا (المرحلة الأولى) أو الاعتماد عبر المنصة (المرحلة الثانية). الهند: رقم GSTIN ورموز HSN/SAC وعبارة نظام التركيب حيث تنطبق. | ولأن شيئاً لا يُجمَّع في نهاية اليوم، فإن تقرير Z وسجلات الدفع وقيد اليومية تتطابق دائماً — ولوحة نقاط البيع تعرض الثلاثة جنباً إلى جنب. --- ## 2. شاشة الكاشير - **شبكة المنتجات** مع بحث بالاسم أو SKU أو الباركود؛ شرائح التصنيفات؛ ترتيب بالأكثر مبيعاً أو الأحدث بيعاً؛ *المتوفر فقط*؛ بطاقات كبيرة أو صغيرة أو قائمة؛ الصور تشغيل/إيقاف. المنتجات ذات الخيارات تفتح منتقي المتغيرات. المخزون والمخزون المنخفض و*غير مخزَّن هنا* تظهر حسب موقع الجهاز. - **المسح** — أي ماسح باركود USB أو بلوتوث يعمل دون إعداد؛ تطبيق الجوال يمسح بالكاميرا؛ ملصقات الموازين (EAN-13 بوزن أو سعر مضمَّن) تُفكّ مباشرةً إلى الكمية الصحيحة. - **السلة** — أزرار الكمية، تعديل سعر الوحدة، خصم السطر، ملاحظة، الوحدة (كجم، متر، قطعة)؛ خصم على السلة؛ رمز كوبون؛ العروض التلقائية تظهر مع مبلغ كل منها؛ **تعليق** سلة لعميل واستئنافها من أي كاشير. - **العميل** — عميل نقدي افتراضياً؛ اختر عميلاً لكسب النقاط أو استبدالها، أو الحصول على قائمة أسعاره، أو قيد مرتجع لحسابه. - **لوحة المفاتيح** — `F2` بحث · `F4` دفع · `F6` تعليق · `F8` مرتجعات · `F9` نقد مضبوط · `Esc` رجوع. - **الجوال والأجهزة اللوحية** — تخطيط مخصص لليد الواحدة على الجوال، وتخطيط للجهاز اللوحي يُبقي السلة في متناول اليد في الوضع الرأسي، وأهداف لمس 44 بكسل، سحب للحذف، اهتزاز، ووضع كاشير بملء الشاشة. --- ## 3. قبض المبلغ يمكن **تقسيم** الدفع بين النقد والبطاقة والتحويل البنكي وبطاقة الهدايا أو رصيد المتجر ونقاط الولاء و**على الحساب** (يبقى المبلغ في ذمة العميل) ووسائل حزمة الدولة — **مدى** في السعودية، و**UPI** في الهند مع رمز QR للدفع مبنيّ من معرّف UPI الخاص بك. شرائح المبالغ السريعة (50 / 100 / 200 …)، لوحة أرقام على الشاشات اللمسية، *نقد مضبوط*، و**الباقي المستحق** تُبقي النقد سريعاً. كل وسيلة دفع تحدد حساب الأستاذ الذي تُودَع فيه؛ وغياب الحساب يوقف البيع بدل الترحيل إلى لا مكان. **البيع على الحساب** — يمكن للعميل المنتظم أو المقاول أو الأسطول أخذ البضاعة وقيدها على حسابه. يعرض الكاونتر ما هو مستحق عليه وما تبقى من حد ائتمانه، ويرفض العميل النقدي غير المحدد كما يرفض أي بيع يتجاوز الحد. تبقى الفاتورة غير مسددة وتُحصّل عبر سندات القبض بشروطها وكشوفها وأعمارها المعتادة. الإكراميات (إلى *إكراميات مستحقة الدفع* لا إلى الإيراد) ورسوم الخدمة القابلة للإعداد (خاضعة للضريبة أو لا، وللجلوس داخل المطعم فقط إن شئت) متاحة عند الدفع عند تفعيلها. --- ## 4. الإيصالات يُعاين الإيصال على الشاشة ويُطبع على ورق حراري 80 مم أو 58 مم: اسم البائع ورقمه الضريبي، وعنوان المستند حسب الدولة (*فاتورة ضريبية مبسطة* في السعودية، *فاتورة ضريبية* في الإمارات والهند، *إيصال* في غيرها)، مرجع الإيصال ورقم الفاتورة، الكاشير، الأسطر مع الرقم التسلسلي / الدفعة / الانتهاء / HSN، تفصيل الضريبة حسب النسبة، وسائل الدفع، الباقي، رصيد بطاقة الهدايا، النقاط المكتسبة، رمز QR الضريبي وتذييلك. مع طابعة مُعدّة يُطبع الإيصال تلقائياً ويُفتح درج النقد في المبيعات النقدية؛ وعطل الطابعة لا يوقف البيع أبداً — تنتظر المهمة في طابور إعادة المحاولة. أرسل الإيصال **بالبريد الإلكتروني** (مع ملف PDF للنسخة المعتمدة من الفاتورة، من مُرسِل المنصة باسم متجرك) أو **بواتساب** (ورقة المشاركة على الجوال، ورابط على سطح المكتب). **شاشة العميل** على شاشة ثانية تعرض الأسطر والإجمالي والمدفوع والباقي أثناء البيع. --- ## 5. الكاشير والورديات والرقابة - **الكاشير مستخدم حقيقي.** على كاشير مشترك يتبادل الكاشيرون بـ**رقم PIN** ويُسجَّل دخول كل منهم باسمه، فكل بيع وإلغاء وفتح درج يحمل اسم من فعله. *قفل الكاشير* يخفي الشاشة خلف لوحة PIN دون إغلاق الدرج. - **الورديات** — افتح الكاشير برصيد افتتاحي معدود، سجّل النقد الداخل والخارج بأسبابه، اطلب تقرير X في أي وقت، وأغلق بعدٍّ أعمى لتحصل على تقرير Z: الرصيد الافتتاحي ← المبيعات ← الحركات ← المتوقع ← المعدود ← الفرق. - **الأحداث** — إلغاء الأسطر (بقيمتها)، إلغاء السلة، فتح الدرج دون بيع (السبب إلزامي)، تسجيلات الدخول — مدقَّقة وعلى التقارير ومحسوبة في تنبيهات اللوحة. - **الصلاحيات** يفرضها الخادم لا الشاشة فقط: الخصومات وتعديل الأسعار والمرتجعات وإجراءات الكاشير وفتح الدرج والإعدادات لكلٍّ منها حقّه المستقل. --- ## 6. المرتجعات والاسترداد من المعاملات اختر البيع والكمية لكل سطر، أعطِ سبباً، واسترد **نقداً من الكاشير** (يخرج من الدرج ومن النقد المتوقع)، أو **رصيداً في حساب العميل**، أو **رصيد متجر** على بطاقة باسم العميل. يُصدَر إشعار دائن مقابل الفاتورة الأصلية وتعود الأصناف — بالرقم التسلسلي أو الدفعة نفسها — إلى المخزون. المرتجعات تعمل دون اتصال على نسخة الكاشير من البيع. --- ## 7. المخزون عند الكاشير كل جهاز يبيع من موقع مخزون. المنتجات المتتبَّعة **بالرقم التسلسلي** أو **الدفعة** تفتح منتقياً عند الإضافة — امسح الرقم التسلسلي، أو خذ الدفعة الأقرب انتهاءً أولاً (FEFO) مع تحذيرات الانتهاء؛ وتُرفض الدُفعات المنتهية ما لم تسمح بها. تحويلات المخزون تُفتح من قائمة الكاشير. الأعمال متعددة المواقع ترى مخزون كل فرع ولوحة موحّدة. --- ## 8. الامتثال الإقليمي والضريبي BIZA عالمي: الإيصال وتسمية الضريبة ورمز QR الضريبي وعنوان المستند ووسائل الدفع الإضافية تتبع **حزمة الدولة** لدولة شركتك. | الدولة | عنوان الإيصال | رمز QR الضريبي | الرقم الضريبي على الإيصال | وسائل دفع إضافية | |---|---|---|---|---| | السعودية | فاتورة ضريبية مبسطة | زاتكا TLV (المرحلة 1) · اعتماد المرحلة 2 | الرقم الضريبي | مدى | | الإمارات ودول الخليج | فاتورة ضريبية | — | TRN | — | | الهند | فاتورة ضريبية مع HSN/SAC | — | GSTIN | UPI (رمز QR للدفع)، RuPay | | المملكة المتحدة | إيصال | — | VAT No | — | | الولايات المتحدة | إيصال (ضريبة مبيعات) | — | — | — | تُحسب الضريبة لكل سطر من فئة ضريبة المنتج أو نسبتك القياسية؛ وتصل ضريبة المخرجات إلى فترة الإقرار كأي فاتورة أخرى. --- ## WhatsApp Inbox Pipelines: Route Customer Messages Automatically **Category:** sales-crm | **Slug:** `/docs/whatsapp-inbox-pipelines` | **Canonical URL:** https://biza.app/docs/whatsapp-inbox-pipelines **Summary:** Decide what happens to every incoming WhatsApp message: recognise your own intents, open orders and tickets automatically, reply with the order number or ticket reference, and hand the rest to a person — from ready templates for shops, service businesses and software teams. # WhatsApp Inbox Pipelines A **pipeline** decides what BIZA does with each WhatsApp message a customer sends to one of your business numbers. It classifies the message into intents you define, runs an ordered list of routes, and leaves anything it is unsure about in the inbox for a person. Every number you connect can run its own pipeline: a sales number that takes orders, a support number that files issues. --- ## 1. Start from a template Open **CRM → WhatsApp Inbox → Pipelines** and pick a template. Each one is a complete pipeline — intents, routes and replies — copied into your workspace, where you edit it freely. | Template | Built for | What it does | |---|---|---| | **Shop & restaurant orders** | Retail, restaurants, food | Claude matches the ordered items to your products and opens an order on the billing counter; the customer gets the order number and total, and can ask where their order is. Ambiguous items go to a person instead of being guessed. | | **Service business** | Agencies, consultancies, government-services offices | Enquiries become leads, requests from known customers start a service case, documents attach to the open case, every message is acknowledged. | | **Issue tracker** | Software and product teams | Bug reports get a Claude triage (severity, what happened, next step), become a service case or a lead, notify support and acknowledge the sender. | | **Blank** | Anything else | Classifies with the default intents and keeps everything in the inbox until you add routes. | --- ## 2. Bind your numbers On the pipeline's **Numbers** tab you see every WhatsApp Cloud number connected to your account. Choose the pipeline each one uses; a number left unbound falls back to the workspace's default pipeline. New numbers on your WhatsApp Business account appear automatically after their first message. --- ## 3. Teach it your intents The **Intents** tab holds the classifier profile: one or two sentences about what your business does, and the list of intents the AI may choose from — each with a key, labels in English and Arabic, a description and examples. Add fields to extract (delivery address, requested time, affected product area) and routes can use them. Messages are read in English, Arabic, Malayalam, Hindi and mixed scripts; summaries are produced in English and Arabic. --- ## 4. Routes: when this, do that Routes run top to bottom for every classified message. Each route is a **when** (intent, whether the message is actionable, whether the sender is a known customer, minimum confidence) and a **then**: * **Create a record** — a lead, a service case, a note on an open case, a support ticket, a billing-counter order. * **Ask Claude** — a triage or extraction step with your own instructions. Claude can analyse only, propose actions for a person to approve, or act on its own within the actions you allow. * **Reply on WhatsApp** — a message template with placeholders such as the sender's name, the summary, or a ticket number created by an earlier route. Replies go out inside WhatsApp's 24-hour customer-service window from the number that received the message. * **Notify the team**, **assign to a person**, or **leave for a person** in the inbox. * **Call your endpoint** — post the classified message, signed, to an HTTPS endpoint of your own; it can answer with a reply to send or a record to link. Drag routes to reorder them, mark any route as needing approval, and stop the routes below it when it matches. --- ## 5. Replies: automatic or approved Per pipeline, replies send **automatically** (the default), **wait for approval** in the inbox, or are **off**. Approval-gated replies and Claude's proposals show up on the message in the inbox with Approve and Reject buttons. --- ## 6. Test before you go live The **Test** tab classifies a message exactly like a real one and lists the routes that would fire, with the reply rendered — nothing is saved or sent. --- ## 7. See what happened Every message in the inbox shows which pipeline and routes handled it, the records they created, Claude's analysis, and anything waiting for approval. The pipeline's **Runs** tab keeps the full history. --- ## 8. Your own integrations Register HTTPS endpoints under **Endpoints** with a signing secret (stored encrypted, never shown again). Each call carries `X-Biza-Timestamp` and `X-Biza-Signature: v1=HMAC-SHA256(secret, ".")`. Respond with JSON `{ "reply_text": "…", "link": { "entity_type": "…", "id": "…" } }` to send a WhatsApp reply or link a record of yours. --- ## Frequently asked questions **Does it need the WhatsApp Cloud API?** Receiving works with either the Cloud API or the browser bridge; automatic replies need a Cloud API number. **Will it create records from small talk?** No — "thanks" and "ok" are filtered before the AI runs, and templates only act on messages classified as actionable. Anything uncertain stays in the inbox. **Can I stop a route from acting without deleting it?** Yes — switch it off, or set it to require approval. ### النسخة العربية (Arabic Edition): مسارات صندوق واتساب: توجيه رسائل العملاء تلقائيًا --- title: "مسارات صندوق واتساب: توجيه رسائل العملاء تلقائيًا" slug: whatsapp-inbox-pipelines category: sales-crm order: 3 updatedAt: "2026-09-23" summary: "حدّد ما يحدث لكل رسالة واتساب واردة: تعرّف على نواياك الخاصة، وافتح الطلبات والتذاكر تلقائيًا، ورُدّ برقم الطلب أو مرجع التذكرة، وأحِل الباقي إلى شخص — من قوالب جاهزة للمتاجر وشركات الخدمات وفرق البرمجيات." tags: ["واتساب", "إدارة العملاء", "أتمتة", "ذكاء اصطناعي", "الطلبات", "الدعم"] --- # مسارات صندوق واتساب **المسار** يحدد ما تفعله BIZA بكل رسالة واتساب يرسلها عميل إلى أحد أرقام نشاطك. يصنّف الرسالة ضمن نوايا تحددها أنت، ويشغّل قائمة مرتبة من القواعد، ويترك ما لا يثق به في صندوق الوارد لشخص. كل رقم تربطه يمكنه تشغيل مساره الخاص: رقم مبيعات يستقبل الطلبات، ورقم دعم يسجّل المشكلات. --- ## 1. ابدأ من قالب افتح **إدارة العملاء ← صندوق واتساب ← المسارات** واختر قالبًا. كل قالب مسار كامل — نوايا وقواعد وردود — يُنسخ إلى مساحة عملك وتعدّله كما تشاء. | القالب | مناسب لـ | ماذا يفعل | |---|---|---| | **طلبات المتجر والمطعم** | التجزئة والمطاعم والأغذية | يطابق Claude الأصناف المطلوبة مع منتجاتك ويفتح طلبًا على شاشة البيع؛ يستلم العميل رقم الطلب والإجمالي ويمكنه السؤال عن حالة طلبه. الأصناف الغامضة تُحال إلى شخص بدل التخمين. | | **شركة خدمات** | الوكالات والاستشارات ومكاتب الخدمات الحكومية | تتحول الاستفسارات إلى عملاء محتملين، وتبدأ طلبات العملاء المعروفين حالة خدمة، وتُرفق المستندات بالحالة المفتوحة، ويُؤكَّد استلام كل رسالة. | | **متابعة المشكلات** | فرق البرمجيات والمنتجات | تحصل بلاغات الأخطاء على فرز من Claude (الخطورة، ما حدث، الخطوة التالية)، وتصبح حالة خدمة أو عميلًا محتملًا، مع إشعار الدعم وتأكيد للمرسل. | | **فارغ** | أي شيء آخر | يصنّف بالنوايا الافتراضية ويُبقي كل شيء في صندوق الوارد حتى تضيف قواعد. | --- ## 2. اربط أرقامك في تبويب **الأرقام** ترى كل رقم واتساب سحابي متصل بحسابك. اختر المسار الذي يستخدمه كل رقم؛ الرقم غير المرتبط يعود إلى المسار الافتراضي لمساحة العمل. تظهر الأرقام الجديدة على حساب واتساب للأعمال تلقائيًا بعد أول رسالة. --- ## 3. علّمه نواياك يحوي تبويب **النوايا** ملف المصنّف: جملة أو جملتان عن نشاطك، وقائمة النوايا التي يمكن للذكاء الاصطناعي اختيارها — لكل منها مفتاح وتسميات بالإنجليزية والعربية ووصف وأمثلة. أضف حقولًا للاستخراج (عنوان التوصيل، الوقت المطلوب، جزء المنتج المتأثر) لتستخدمها القواعد. تُقرأ الرسائل بالإنجليزية والعربية والمالايالامية والهندية والنصوص المختلطة؛ وتُنتج الملخصات بالإنجليزية والعربية. --- ## 4. القواعد: عندما يحدث هذا، افعل ذاك تعمل القواعد من الأعلى إلى الأسفل لكل رسالة مصنّفة. كل قاعدة هي **شرط** (النية، هل الرسالة قابلة للتنفيذ، هل المرسل عميل معروف، الحد الأدنى للثقة) و**إجراء**: * **إنشاء سجل** — عميل محتمل، حالة خدمة، ملاحظة على حالة مفتوحة، تذكرة دعم، طلب على شاشة البيع. * **اسأل Claude** — خطوة فرز أو استخراج بتعليماتك الخاصة. يمكن لـ Claude أن يحلل فقط، أو يقترح إجراءات يوافق عليها شخص، أو يتصرف بنفسه ضمن الإجراءات التي تسمح بها. * **الرد على واتساب** — قالب رسالة بمتغيرات مثل اسم المرسل أو الملخص أو رقم تذكرة أنشأتها قاعدة سابقة. تُرسل الردود ضمن نافذة خدمة العملاء (24 ساعة) من الرقم الذي استقبل الرسالة. * **إشعار الفريق** أو **الإسناد إلى شخص** أو **الترك لشخص** في صندوق الوارد. * **استدعاء نقطة الربط الخاصة بك** — إرسال الرسالة المصنّفة موقّعةً إلى عنوان HTTPS خاص بك؛ ويمكنه الرد برسالة تُرسل أو سجل يُربط. اسحب القواعد لإعادة ترتيبها، وحدّد أي قاعدة لتحتاج موافقة، وأوقف القواعد التي تليها عند مطابقتها. --- ## 5. الردود: تلقائية أو بموافقة لكل مسار، تُرسل الردود **تلقائيًا** (الافتراضي)، أو **تنتظر الموافقة** في صندوق الوارد، أو **تُعطَّل**. تظهر الردود المشروطة بالموافقة واقتراحات Claude على الرسالة في صندوق الوارد مع زرّي موافقة ورفض. --- ## 6. اختبر قبل التشغيل يصنّف تبويب **اختبار** رسالة تمامًا كرسالة حقيقية ويعرض القواعد التي ستُفعَّل مع الرد المُعد — دون حفظ أو إرسال أي شيء. --- ## 7. اعرف ما حدث تعرض كل رسالة في صندوق الوارد المسار والقواعد التي عالجتها، والسجلات التي أنشأتها، وتحليل Claude، وأي شيء بانتظار الموافقة. ويحتفظ تبويب **السجل** في المسار بالتاريخ الكامل. --- ## 8. تكاملاتك الخاصة سجّل عناوين HTTPS تحت **نقاط الربط** مع سر توقيع (يُخزَّن مشفرًا ولا يُعرض مجددًا). يحمل كل استدعاء `X-Biza-Timestamp` و`X-Biza-Signature: v1=HMAC-SHA256(secret, ".")`. أجب بـ JSON ‏`{ "reply_text": "…", "link": { "entity_type": "…", "id": "…" } }` لإرسال رد واتساب أو ربط سجل لديك. --- ## أسئلة شائعة **هل يحتاج إلى واجهة واتساب السحابية؟** الاستقبال يعمل عبر الواجهة السحابية أو جسر المتصفح؛ أما الردود التلقائية فتحتاج رقمًا على الواجهة السحابية. **هل سينشئ سجلات من الدردشة العابرة؟** لا — تُرشَّح رسائل مثل "شكرًا" و"تمام" قبل تشغيل الذكاء الاصطناعي، ولا تتصرف القوالب إلا مع الرسائل المصنّفة قابلة للتنفيذ. وكل ما هو غير مؤكد يبقى في صندوق الوارد. **هل يمكن إيقاف قاعدة عن التنفيذ دون حذفها؟** نعم — أطفئها أو اجعلها تتطلب موافقة. --- ## POS hardware: receipt printers, cash drawers, scanners, customer display and self-checkout kiosk **Category:** sales-crm | **Slug:** `/docs/pos-hardware-receipt-printers-cash-drawer-kiosk` | **Canonical URL:** https://biza.app/docs/pos-hardware-receipt-printers-cash-drawer-kiosk **Summary:** What works with BIZA POS out of the box: ESC/POS thermal printers over the network or USB (58 mm and 80 mm), cash drawers that kick on cash sales, keyboard-wedge and camera barcode scanning, scale labels, a second-screen customer display, kitchen printers, and a self-checkout kiosk approved by staff PIN. # POS hardware: receipt printers, cash drawers, scanners, customer display and self-checkout kiosk BIZA POS runs in a browser, as an installed web app, as a desktop app for Windows, macOS and Linux, and as a native Android / iOS app. The hardware you already own almost certainly works; this guide lists what is supported and how to set it up. --- ## 1. Receipt printers ### Network (Ethernet / Wi-Fi) thermal printers — recommended Any **ESC/POS** printer with a network port: Epson TM-T20 / T88 series and the many compatibles, or Star printers in Star mode. Setup per terminal under **POS → Settings → Terminals → Receipt printer**: 1. Connection: **Network (IP address)**, port 9100 (the default on almost every printer). 2. Printer type: **Epson-compatible** or **Star**. 3. Paper width: **80 mm** or **58 mm** — the receipt layout adapts (the narrow layout drops the item-code column). 4. Drawer connector: the pin your cash drawer is wired to (pin 2 on most printers). 5. *Check connection* → *Test print* → *Open drawer*. Turn on **Print the receipt automatically** and **Open the drawer on cash sales**. Receipts are printed as a **raster image built from the same layout as the on-screen preview**, so Arabic, Hindi and every other script print exactly as previewed, on any printer, with no font installed on the printer. Network printing needs the **desktop app** or the **tablet / phone app** — a browser tab cannot open a printer socket, so in a plain browser the billing counter falls back to the system print dialog. ### USB, serial and Bluetooth printers In the desktop app choose **This computer's printer** and pick the printer from the list. BIZA sends the raw ESC/POS job through the Windows print spooler (RAW) or CUPS on macOS / Linux, so a printer that appears in the operating system works without a driver of its own. ### Reliability A printer that is off, out of paper or unreachable **never blocks a sale** — the sale posts, the job waits in a retry queue shown in the billing counter strip, and *Reprint* from Transactions sends it again. Kitchen tickets use the same queue. --- ## 2. Cash drawers Plug the drawer into the printer's drawer port (RJ-11/RJ-12). It opens: - automatically on every cash sale (setting above); - from *Open drawer* in the billing counter strip — a **no-sale** that requires a reason, needs the *open drawer* permission and is recorded in the shift's events (a drawer that opens without a trace is a shrinkage vector, so BIZA always leaves one). Drawer cash is reconciled per shift: opening float, sales, cash in/out with reasons, expected cash, the blind count at close, and the variance on the Z report. --- ## 3. Barcode scanners and scales - **Any USB or Bluetooth scanner in keyboard-wedge mode** — no configuration; a scan is just fast typing into the search box. Variant barcodes add that variant; a scanned **serial number** adds that exact unit. - **Camera scanning** in the native Android / iOS app (Google MLKit), for delivery vans, market stalls and stock-room sales. - **Scale labels** — label-printing scales that emit weight- or price-embedded EAN-13 barcodes (prefix 2x by default). BIZA decodes the PLU and the weight, or the price divided by the shelf price into kilos, so the unit price on the receipt stays the shelf price. Prefixes, PLU digits and decimals are configurable. --- ## 4. Customer display Open **Counter menu → Customer display** on a second screen or a tablet facing the customer. It shows a welcome screen, then each line and the running total as the cashier adds items, then *Paid* with the amount tendered and the change. It works from the same device (a second window) or a separate one on the same network, and can be pinned to a terminal. --- ## 5. Self-checkout kiosk **Counter menu → Self-checkout kiosk** turns a tablet into an unattended lane: 1. *Scan to start* — the customer scans items (a wedge scanner or the tablet camera). 2. Basket with *Scan another item*, *Call staff* and **Pay**. 3. The customer taps their card on the terminal beside the kiosk; a member of staff confirms the payment with their **cashier PIN** (ten wrong PINs pause approvals on that kiosk for 15 minutes). 4. The sale posts as a card tender approved by that cashier, the receipt prints on the kiosk's printer, and the screen resets for the next customer. Items that need a serial number or batch, out-of-stock items and unknown codes ask for staff and are logged as assistance events. --- ## 6. Tablets, phones and the desktop app | Device | Notes | |---|---| | **Windows / macOS / Linux desktop app** | Network and USB printing, cash drawer, full-screen register mode. | | **iPad / Android tablet** | The native app prints to network printers; landscape splits grid and cart, portrait keeps the cart one tap away; register mode is the default. | | **Phone** | A one-hand layout — grid, cart, checkout — with a thumb-reach summary bar, swipe-to-delete and haptics. Waiters use it to take orders and send them to the kitchen. | | **Any browser** | Everything except direct printer sockets and camera scanning; installed as a web app it opens straight into the billing counter. | --- ## 7. Kitchen printers Restaurant stations can each have their own ticket printer (IP address per station). *Send to kitchen* prints a ticket per station with only the lines that station cooks, and the same ticket appears on the kitchen display. See [restaurant and café mode](/docs/pos-restaurant-cafe-tables-kitchen-qr-ordering/). --- ## 8. Card terminals Card payments are keyed into the billing counter after the terminal approves them (with a reference), and each tender is banked to the account you choose — so the reconciliation of the card settlement to the ledger is exact. Integrated terminal drivers are part of the country-pack layer and are added per market. ### النسخة العربية (Arabic Edition): أجهزة نقاط البيع: طابعات الإيصالات ودرج النقد والماسحات وشاشة العميل وكشك الدفع الذاتي --- title: "أجهزة نقاط البيع: طابعات الإيصالات ودرج النقد والماسحات وشاشة العميل وكشك الدفع الذاتي" slug: pos-hardware-receipt-printers-cash-drawer-kiosk category: sales-crm order: 4 updatedAt: "2026-09-21" summary: "ما يعمل مع نقاط بيع BIZA مباشرةً: طابعات حرارية ESC/POS عبر الشبكة أو USB (58 مم و80 مم)، أدراج نقد تُفتح مع المبيعات النقدية، مسح الباركود بالماسح أو الكاميرا، ملصقات الموازين، شاشة عميل على شاشة ثانية، طابعات المطبخ، وكشك دفع ذاتي يعتمده الموظف برقم PIN." tags: ["نقاط البيع", "طابعة الإيصالات", "ESC/POS", "درج النقد", "ماسح الباركود", "كشك", "شاشة العميل", "الأجهزة"] --- # أجهزة نقاط البيع: طابعات الإيصالات ودرج النقد والماسحات وشاشة العميل وكشك الدفع الذاتي تعمل نقاط بيع BIZA في المتصفح، وكتطبيق ويب مثبَّت، وكتطبيق سطح مكتب لويندوز وماك ولينكس، وكتطبيق أصلي لأندرويد و iOS. الأجهزة التي تملكها اليوم تعمل على الأرجح؛ يسرد هذا الدليل ما هو مدعوم وكيفية إعداده. --- ## 1. طابعات الإيصالات ### الطابعات الحرارية الشبكية (إيثرنت / واي فاي) — الموصى بها أي طابعة **ESC/POS** بمنفذ شبكة: سلسلة Epson TM-T20 / T88 والكثير من المتوافقات، أو طابعات Star في وضع Star. الإعداد لكل جهاز من **نقاط البيع ← الإعدادات ← الأجهزة ← طابعة الإيصالات**: 1. الاتصال: **شبكة (عنوان IP)**، المنفذ 9100 (الافتراضي في معظم الطابعات). 2. نوع الطابعة: **متوافقة مع Epson** أو **Star**. 3. عرض الورق: **80 مم** أو **58 مم** — يتكيّف تخطيط الإيصال (التخطيط الضيق يُسقط عمود رمز الصنف). 4. موصّل الدرج: الدبوس الموصول به درج النقد (الدبوس 2 في معظم الطابعات). 5. *فحص الاتصال* ← *طباعة تجريبية* ← *فتح الدرج*. فعّل **طباعة الإيصال تلقائياً** و**فتح الدرج في المبيعات النقدية**. تُطبع الإيصالات **كصورة نقطية مبنية من التخطيط نفسه الذي تراه على الشاشة**، فتُطبع العربية والهندية وكل الخطوط الأخرى تماماً كما في المعاينة، على أي طابعة، دون تثبيت خط على الطابعة. الطباعة الشبكية تحتاج **تطبيق سطح المكتب** أو **تطبيق الجهاز اللوحي / الجوال** — فتبويب المتصفح لا يمكنه فتح منفذ للطابعة، لذا يعود الكاشير في المتصفح العادي إلى نافذة الطباعة في النظام. ### طابعات USB والتسلسلية والبلوتوث في تطبيق سطح المكتب اختر **طابعة هذا الجهاز** واختر الطابعة من القائمة. يرسل BIZA مهمة ESC/POS الخام عبر طابور الطباعة في ويندوز (RAW) أو CUPS في ماك / لينكس، فأي طابعة تظهر في نظام التشغيل تعمل دون تعريف خاص. ### الموثوقية الطابعة المطفأة أو التي نفد ورقها أو غير القابلة للوصول **لا توقف البيع أبداً** — يُرحَّل البيع، وتنتظر المهمة في طابور إعادة المحاولة الظاهر في شريط الكاشير، و*إعادة الطباعة* من المعاملات ترسلها مجدداً. تذاكر المطبخ تستخدم الطابور نفسه. --- ## 2. أدراج النقد وصّل الدرج بمنفذ الدرج في الطابعة (RJ-11/RJ-12). يُفتح: - تلقائياً مع كل بيع نقدي (الإعداد أعلاه)؛ - من *فتح الدرج* في شريط الكاشير — **فتح دون بيع** يتطلب سبباً وصلاحية *فتح الدرج* ويُسجَّل في أحداث الوردية (الدرج الذي يُفتح دون أثر ثغرة للهدر، لذا يترك BIZA أثراً دائماً). يُسوّى نقد الدرج لكل وردية: الرصيد الافتتاحي، المبيعات، النقد الداخل/الخارج بأسبابه، النقد المتوقع، العدّ الأعمى عند الإغلاق، والفرق في تقرير Z. --- ## 3. ماسحات الباركود والموازين - **أي ماسح USB أو بلوتوث في وضع لوحة المفاتيح** — دون إعداد؛ المسح مجرد كتابة سريعة في مربع البحث. باركود المتغير يضيف ذلك المتغير؛ ومسح **رقم تسلسلي** يبيع تلك الوحدة بعينها. - **المسح بالكاميرا** في تطبيق أندرويد / iOS الأصلي (Google MLKit)، لسيارات التوصيل وأكشاك الأسواق ومبيعات المستودع. - **ملصقات الموازين** — الموازين التي تطبع باركود EAN-13 بوزن أو سعر مضمَّن (بادئة 2x افتراضياً). يفكّ BIZA رمز PLU والوزن، أو السعر مقسوماً على سعر الرف إلى كيلوغرامات، فيبقى سعر الوحدة على الإيصال هو سعر الرف. البادئات وعدد خانات PLU والكسور العشرية قابلة للإعداد. --- ## 4. شاشة العميل افتح **قائمة الكاشير ← شاشة العميل** على شاشة ثانية أو جهاز لوحي مواجه للعميل. تعرض شاشة ترحيب، ثم كل سطر والإجمالي الجاري أثناء إضافة الأصناف، ثم *مدفوع* مع المبلغ المقبوض والباقي. تعمل من الجهاز نفسه (نافذة ثانية) أو من جهاز منفصل على الشبكة نفسها، ويمكن تثبيتها على جهاز محدد. --- ## 5. كشك الدفع الذاتي **قائمة الكاشير ← كشك الدفع الذاتي** يحوّل الجهاز اللوحي إلى مسار غير مراقب: 1. *امسح للبدء* — يمسح العميل أصنافه (ماسح أو كاميرا الجهاز). 2. سلة مع *امسح صنفاً آخر* و*استدعاء الموظف* و**ادفع**. 3. يمرّر العميل بطاقته على الجهاز المجاور للكشك؛ ويؤكد الموظف الدفع برقم **PIN** الخاص به (عشر محاولات خاطئة توقف الاعتمادات على ذلك الكشك 15 دقيقة). 4. يُرحَّل البيع كدفع ببطاقة معتمد من ذلك الكاشير، ويُطبع الإيصال على طابعة الكشك، وتعود الشاشة للعميل التالي. الأصناف التي تحتاج رقماً تسلسلياً أو دفعة، والأصناف غير المتوفرة، والرموز غير المعروفة تطلب الموظف وتُسجَّل كأحداث مساعدة. --- ## 6. الأجهزة اللوحية والجوال وتطبيق سطح المكتب | الجهاز | ملاحظات | |---|---| | **تطبيق سطح المكتب لويندوز / ماك / لينكس** | طباعة شبكية و USB، درج النقد، وضع كاشير بملء الشاشة. | | **iPad / جهاز أندرويد لوحي** | التطبيق الأصلي يطبع على الطابعات الشبكية؛ الوضع الأفقي يقسم الشبكة والسلة، والرأسي يُبقي السلة على بُعد لمسة؛ وضع الكاشير هو الافتراضي. | | **الجوال** | تخطيط لليد الواحدة — شبكة، سلة، دفع — مع شريط ملخص في متناول الإبهام، سحب للحذف واهتزاز. يستخدمه النُدُل لأخذ الطلبات وإرسالها للمطبخ. | | **أي متصفح** | كل شيء عدا منافذ الطابعة المباشرة والمسح بالكاميرا؛ وعند تثبيته كتطبيق ويب يفتح مباشرةً على الكاشير. | --- ## 7. طابعات المطبخ يمكن لكل محطة في المطعم أن تملك طابعة تذاكر خاصة (عنوان IP لكل محطة). *إرسال إلى المطبخ* يطبع تذكرة لكل محطة بالأسطر التي تطبخها تلك المحطة فقط، وتظهر التذكرة نفسها على شاشة المطبخ. انظر [وضع المطاعم والمقاهي](/ar/docs/pos-restaurant-cafe-tables-kitchen-qr-ordering/). --- ## 8. أجهزة البطاقات تُدخَل مدفوعات البطاقات في الكاشير بعد موافقة الجهاز عليها (مع مرجع)، وتُودَع كل وسيلة دفع في الحساب الذي تختاره — فتكون تسوية تسويات البطاقات مع الأستاذ دقيقة. برامج تشغيل الأجهزة المتكاملة جزء من طبقة حزمة الدولة وتُضاف لكل سوق. --- ## Recurring Invoices & Subscription Billing Automation **Category:** sales-crm | **Slug:** `/docs/recurring-invoices-subscription-billing` | **Canonical URL:** https://biza.app/docs/recurring-invoices-subscription-billing **Summary:** Automate contract billing schedules: recurring monthly retainers, annual software licenses, rental billing intervals, and automated draft invoice generation. # Recurring Invoices & Subscription Billing Automation Businesses providing recurring services—such as property rentals, maintenance contracts, IT support retainers, software licenses, or security services—require automated billing schedules that eliminate manual invoice preparation at the beginning of each billing cycle. --- ## 1. Recurring Profile Configuration A recurring invoice profile defines the contractual billing template: * **Customer & Contract Association:** Linked to the customer master record with pre-agreed billing terms and currency. * **Frequency & Intervals:** Support for weekly, bi-weekly, monthly, quarterly, semi-annual, and annual billing intervals. * **Effective Date Range:** Configure contract start date and optional expiration date (or set to run indefinitely until cancelled). * **Line Items & Quantities:** Fixed service fees, recurring item quantities, discount percentages, and statutory VAT rates. --- ## 2. Automated Generation Engine On scheduled billing days: * **Background Worker Processing:** The automated scheduler scans active recurring profiles and identifies vouchers due for issuance. * **Draft Generation Mode (Default):** Generates draft tax invoices with the next sequential invoice number and current billing period dates (e.g., *"Monthly Maintenance Service — October 2026"*). * **Review & Verification:** Finance teams can review generated drafts before final posting, or configure auto-approval for trusted recurring accounts. --- ## 3. Prorated Cycles & Mid-Month Start Handle customers who subscribe midway through a billing month: * **Proration Calculator:** Calculate exact fractional amounts based on days active in the initial cycle. * **Harmonized Renewal:** Align future renewals to the 1st of the month for clean calendar accounting. --- ## 4. Automatic Delivery & Collection * **Automated Email & WhatsApp Dispatch:** Automatically transmit finalized tax invoices and payment links to the customer's billing email or mobile. * **Payment Allocation:** Customer payments clear the open recurring invoice, updating Accounts Receivable and customer statements. --- ## Credit Notes, Debit Notes & Tax Invoice Adjustments **Category:** sales-crm | **Slug:** `/docs/debit-notes-credit-notes-adjustments` | **Canonical URL:** https://biza.app/docs/debit-notes-credit-notes-adjustments **Summary:** Handle sales returns, billing adjustments, and supplier refunds with legally compliant credit notes and debit notes cryptographically linked to original invoices. # Credit Notes, Debit Notes & Tax Invoice Adjustments Once an official tax invoice has been issued or cleared through tax authorities (such as ZATCA or the UAE FTA), statutory regulations strictly prohibit direct alteration or deletion of the document. Any price correction, returned merchandise, or cancelled transaction must be executed through formal Credit Notes or Debit Notes. --- ## 1. Statutory Cryptographic Linkage Under ZATCA Phase 2 e-invoicing and GCC VAT rules: * **Original Invoice Reference:** Every Credit Note and Debit Note must explicitly record the UUID, sequence number, and issue date of the original tax invoice it adjusts. * **Cryptographic Chaining:** The adjustment voucher receives its own unique cryptographic stamp and is chained into the sequential hash sequence. * **Reason Codes:** Mandates statutory reason descriptions (e.g., *Goods Returned*, *Defective Merchandise*, *Post-Invoice Discount / Price Correction*, *Cancellation of Contract*). --- ## 2. Customer Credit Notes (Sales Adjustments) When a customer returns items or receives a post-sale billing reduction: * **One-Click Creation:** Open the issued invoice in BIZA and select **Issue Credit Note**. * **Flexible Adjustment Scope:** * **Full Reversal:** Reverses the entire invoice value and VAT. * **Partial Item Return:** Select specific line items and returned quantities; restores inventory back to the warehouse. * **Financial Price Adjustment:** Adjusts only the monetary value or discount without moving physical stock. * **Accounting Ledger Impact:** * Debits Sales Returns or Sales Revenue. * Debits Output VAT Payable (reduces VAT tax liability). * Credits Accounts Receivable (reduces customer balance or creates an unallocated customer credit balance). --- ## 3. Supplier Debit Notes (Purchasing Adjustments) When returning defective materials to a vendor or claiming an overcharge: * **Goods Return to Supplier:** Generate a Debit Note linked to the original Purchase Entry or Supplier Bill. * **Warehouse Stock Decrement:** Removes returned items from the designated warehouse inventory. * **Accounts Payable Adjustment:** Decreases outstanding debt owed to the supplier and adjusts Input VAT Receivable in the tax register. --- ## 4. Credit Application & Refund Vouchers Unallocated credit note balances can be resolved cleanly: * **Apply to Future Invoices:** Settle subsequent invoices against the open customer credit balance with one click. * **Cash / Bank Refund:** Issue a formal refund payment voucher transferring funds back to the customer's bank account. --- ## POS promotions, coupons, price lists, loyalty points, gift cards and store credit **Category:** sales-crm | **Slug:** `/docs/pos-promotions-price-lists-loyalty-gift-cards` | **Canonical URL:** https://biza.app/docs/pos-promotions-price-lists-loyalty-gift-cards **Summary:** Run deals the billing counter applies on its own — percentage and amount off, fixed price, buy-X-get-Y, bundles — with coupon codes, customer groups, schedules and limits; quantity-break price lists per group or terminal; a loyalty points programme; and gift cards and store credit that post to a liability account, never to revenue. # POS promotions, coupons, price lists, loyalty points, gift cards and store credit Everything in this guide is managed under **POS → Promotions** and applies at the counter instantly — no export, no re-sync. The discount the cashier sees is re-checked by the server when the sale posts, so a modified device cannot invent one. --- ## 1. Promotions | Kind | Example | |---|---| | Percentage off | 10 % off all drinks | | Amount off | 5 off any cart over 50 | | Fixed price | Any T-shirt at 29 | | Buy X get Y | Buy 2 get 1 free · buy 3 get 1 at 50 % off · mix-and-match within a set, or *buy this, get that* | | Bundle price | 3 for 10 | A promotion defines: - **How it applies** — automatically, or only when the cashier enters a **coupon code**. - **Applies to** — the whole cart, or chosen products and categories, with *never applies to* exclusions. - **Who** — everyone, one or more **customer groups**, or named customers. - **When** — start and end dates, days of the week, a daily time window (happy hour). - **Limits** — minimum cart value, minimum items, maximum discount, maximum times per sale, total uses, uses per customer. - **Priority** and an on/off switch. The list shows *On · Off · Expired · Used up*. At the billing counter the cart lists each promotion that applied with the amount it took; a coupon that does not apply says why (*not started yet*, *not for this customer*, *minimum order not reached*, *already used up* …). **Accounting:** the invoice keeps the gross revenue and posts the discount to *Sales discounts given*, so margin reports and promotion cost are visible instead of buried in a lower price. --- ## 2. Customer groups Named sets of customers — VIP, staff, trade, members. Promotions and price lists can be limited to a group; a customer picked at the counter gets their group's deals automatically. --- ## 3. Price lists A price list holds per-item prices with **quantity breaks** (from 1, from 6, from 12 …). Attach it to **customer groups** and / or **terminals** (a warehouse counter, an outlet with different pricing). At the billing counter the customer's group list wins, then the terminal's list, then the shelf price; the cart shows the list price under the line. Everything not on the list still sells at the shelf price. --- ## 4. Loyalty points Switch the programme on under POS settings with three numbers: **points per 1 spent**, **value of one point**, **minimum points to redeem** — the settings card shows a worked example. Points are earned on the goods total of a sale (never on tips, gift-card purchases or the points tender itself), printed on the receipt as *Points earned* and *Points balance*, and redeemed as a tender at checkout. Staff with the right permission can adjust a customer's points with a note; every movement is in the customer's history. **Accounting:** earning debits *Loyalty programme expense* and credits *Loyalty points liability*; redeeming debits the liability. The liability on your balance sheet is exactly the points outstanding. --- ## 5. Gift cards Sell a gift card from the cart (**Gift card** button: value, optional code, recipient, expiry). The sale line posts to the **Gift cards & store credit** liability, not to revenue — revenue is recognised when the card is spent. Cards can be **issued**, **reloaded** and **voided** from the Gift cards tab; the receipt prints the code and the remaining balance. At checkout, enter the code and the balance is checked live (*unknown*, *used up*, *voided*, *expired*). --- ## 6. Store credit A return can be refunded as **store credit**: a card in the customer's name for the amount, on the same liability account, printed with its code and spent like a gift card. --- ## 7. What is not included yet Punch cards and loyalty tiers are on the roadmap; today's programme is points only. Promotions are evaluated per line with one promotion per line (the best one wins), which is what most tax authorities expect on a receipt. ### النسخة العربية (Arabic Edition): العروض الترويجية والكوبونات وقوائم الأسعار ونقاط الولاء وبطاقات الهدايا ورصيد المتجر في نقاط البيع --- title: "العروض الترويجية والكوبونات وقوائم الأسعار ونقاط الولاء وبطاقات الهدايا ورصيد المتجر في نقاط البيع" slug: pos-promotions-price-lists-loyalty-gift-cards category: sales-crm order: 5 updatedAt: "2026-09-21" summary: "شغّل عروضاً يطبّقها الكاشير من تلقاء نفسه — نسبة أو مبلغ مخصوم، سعر ثابت، اشترِ X واحصل على Y، حِزم — مع رموز كوبونات ومجموعات عملاء وجداول وحدود؛ قوائم أسعار بشرائح كمية لكل مجموعة أو جهاز؛ برنامج نقاط ولاء؛ وبطاقات هدايا ورصيد متجر تُقيَّد في حساب التزام لا في الإيراد." tags: ["نقاط البيع", "العروض الترويجية", "الكوبونات", "قوائم الأسعار", "الولاء", "بطاقات الهدايا", "رصيد المتجر"] --- # العروض الترويجية والكوبونات وقوائم الأسعار ونقاط الولاء وبطاقات الهدايا ورصيد المتجر في نقاط البيع كل ما في هذا الدليل يُدار من **نقاط البيع ← العروض الترويجية** ويُطبَّق على الكاشير فوراً — دون تصدير ولا إعادة مزامنة. الخصم الذي يراه الكاشير يُعاد التحقق منه على الخادم عند ترحيل البيع، فلا يستطيع جهاز معدَّل اختلاق خصم. --- ## 1. العروض الترويجية | النوع | مثال | |---|---| | نسبة مخصومة | 10 % على كل المشروبات | | مبلغ مخصوم | 5 على أي سلة تتجاوز 50 | | سعر ثابت | أي قميص بـ 29 | | اشترِ X واحصل على Y | اشترِ 2 واحصل على 1 مجاناً · اشترِ 3 واحصل على 1 بخصم 50 % · مزج وتوفيق ضمن مجموعة، أو *اشترِ هذا واحصل على ذاك* | | سعر الحزمة | 3 بـ 10 | يحدد العرض: - **كيف يُطبَّق** — تلقائياً، أو فقط عندما يُدخل الكاشير **رمز كوبون**. - **على ماذا** — السلة كاملةً، أو منتجات وتصنيفات مختارة، مع استثناءات *لا يُطبَّق أبداً على*. - **لمن** — الجميع، أو **مجموعة عملاء** أو أكثر، أو عملاء بأسمائهم. - **متى** — تاريخا البدء والانتهاء، أيام الأسبوع، نافذة زمنية يومية (ساعة سعيدة). - **الحدود** — الحد الأدنى لقيمة السلة، الحد الأدنى للأصناف، الحد الأقصى للخصم، الحد الأقصى للمرات في البيع الواحد، إجمالي الاستخدامات، الاستخدامات لكل عميل. - **الأولوية** ومفتاح تشغيل/إيقاف. تعرض القائمة *مفعّل · موقوف · منتهٍ · مستنفَد*. على الكاشير تعرض السلة كل عرض طُبِّق مع المبلغ الذي أخذه؛ والكوبون الذي لا ينطبق يشرح السبب (*لم يبدأ بعد*، *ليس لهذا العميل*، *لم يُبلغ الحد الأدنى للطلب*، *مستنفَد* …). **المحاسبة:** تحتفظ الفاتورة بالإيراد الإجمالي وتُقيّد الخصم في *خصومات المبيعات الممنوحة*، فتظهر تقارير الهامش وتكلفة العروض بدل أن تُدفن في سعر أقل. --- ## 2. مجموعات العملاء مجموعات مسماة من العملاء — كبار العملاء، الموظفون، التجّار، الأعضاء. يمكن قصر العروض وقوائم الأسعار على مجموعة؛ والعميل المختار عند الكاشير يحصل على عروض مجموعته تلقائياً. --- ## 3. قوائم الأسعار تحوي قائمة الأسعار أسعاراً لكل صنف مع **شرائح كمية** (من 1، من 6، من 12 …). اربطها بـ**مجموعات عملاء** و/أو **أجهزة** (كاونتر مستودع، فرع بتسعير مختلف). عند الكاشير تفوز قائمة مجموعة العميل، ثم قائمة الجهاز، ثم سعر الرف؛ وتعرض السلة سعر القائمة تحت السطر. كل ما ليس في القائمة يظل يُباع بسعر الرف. --- ## 4. نقاط الولاء فعّل البرنامج من إعدادات نقاط البيع بثلاثة أرقام: **النقاط لكل 1 مُنفَق**، **قيمة النقطة الواحدة**، **الحد الأدنى من النقاط للاستبدال** — وتعرض بطاقة الإعدادات مثالاً محسوباً. تُكتسب النقاط على إجمالي البضائع في البيع (لا على الإكراميات ولا شراء بطاقات الهدايا ولا الدفع بالنقاط نفسه)، وتُطبع على الإيصال كـ*النقاط المكتسبة* و*رصيد النقاط*، وتُستبدل كوسيلة دفع عند الخروج. يستطيع الموظفون أصحاب الصلاحية تعديل نقاط العميل مع ملاحظة؛ وكل حركة في سجل العميل. **المحاسبة:** الاكتساب يجعل *مصروف برنامج الولاء* مديناً و*التزام نقاط الولاء* دائناً؛ والاستبدال يجعل الالتزام مديناً. الالتزام في ميزانيتك هو بالضبط النقاط القائمة. --- ## 5. بطاقات الهدايا بِع بطاقة هدايا من السلة (زر **بطاقة هدايا**: القيمة، رمز اختياري، المستفيد، الانتهاء). يُقيَّد سطر البيع في التزام **بطاقات الهدايا ورصيد المتجر** لا في الإيراد — يُعترف بالإيراد عند إنفاق البطاقة. يمكن **إصدار** البطاقات و**إعادة شحنها** و**إلغاؤها** من تبويب بطاقات الهدايا؛ ويطبع الإيصال الرمز والرصيد المتبقي. عند الدفع أدخل الرمز فيُفحص الرصيد مباشرةً (*غير معروف*، *مستنفَد*، *ملغى*، *منتهٍ*). --- ## 6. رصيد المتجر يمكن استرداد المرتجع كـ**رصيد متجر**: بطاقة باسم العميل بالمبلغ، على حساب الالتزام نفسه، تُطبع برمزها وتُنفق كبطاقة هدايا. --- ## 7. ما لم يُضمَّن بعد بطاقات الختم ومستويات الولاء على خارطة الطريق؛ برنامج اليوم نقاط فقط. تُقيَّم العروض لكل سطر بعرض واحد لكل سطر (يفوز الأفضل)، وهو ما تتوقعه معظم الهيئات الضريبية على الإيصال. --- ## POS offline selling, shifts, cash control and the outlet dashboard **Category:** sales-crm | **Slug:** `/docs/pos-offline-shifts-cash-control` | **Canonical URL:** https://biza.app/docs/pos-offline-shifts-cash-control **Summary:** How BIZA POS keeps selling when the internet drops and posts every sale exactly once when it returns; how shifts, blind counts, X and Z reports, cash movements and cashier PINs keep the drawer honest; and how the live dashboard flags the shifts a manager should look at. # POS offline selling, shifts, cash control and the outlet dashboard --- ## 1. Offline selling Every sale, return, counter open / close and cash movement is first saved on the device, then posted from a queue. If the connection drops mid-shift: - The billing counter keeps selling from its cached catalog, prices, promotions and lot list; the strip shows *Offline* and *N to send*. - Receipts print immediately with the billing counter's receipt reference; the invoice number is added when the sale reaches the server ("Invoice number follows once this sale is sent"). - When the connection returns the queue drains **in order** and **exactly once**: each sale carries an idempotency key, so a retry can never double-post, and a sale can never overtake the shift it belongs to. Two offline sales always produce exactly two invoices. - Anything the server refuses for a reason a retry cannot fix (a serial number sold elsewhere first, a coupon used up meanwhile) stays visible as *needs attention* with the reason until a cashier retries or discards it — nothing disappears silently. Settings: **Keep selling offline** (off = refuse to sell while offline) and **Allow selling below recorded stock** (whether an offline sale may exceed the cached stock figure). Returns work offline against the billing counter's copy of the sale; the server caps the refund when it syncs. --- ## 2. Shifts (shifts) | Step | What happens | |---|---| | **Open counter** | Pick the terminal, count the drawer as the opening float. | | **Cash in / out** | Anything that moves cash without a sale — float top-up from the safe, a safe drop, a courier fee — with a direction, reason, the drawer account and the counter account. Posts its own numbered journal entry. A mistake is **voided** with a reversing entry and a reason. | | **X report** | The shift so far, any time: sales by tender, discounts, refunds, movements, expected cash. | | **Close counter** | A **blind count** — the expected figure is hidden until the count is entered — then the **Z report**: float → sales → movements → expected → counted → variance, with notes. | **Require an open counter** (recommended for cash businesses): a sale cannot be completed without a session, so no cash ever belongs to nobody. Off, sales still post in full but carry no shift. --- ## 3. Cashiers A cashier is a real user with a POS role. On a shared counter, cashiers **switch with a PIN** — the next cashier is signed in as themself, so every sale, void and drawer open carries the right name. Five wrong PINs lock the PIN for 15 minutes. *Lock counter* hides the screen behind the PIN pad without closing the drawer; close the counter only at the end of the shift. Every permission — discounts, price overrides, refunds, opening and closing counters, cash movements, opening the drawer, settings — is checked by the server, not just hidden in the interface. --- ## 4. Events and the audit trail Line voids (with the value removed), cart voids, **no-sale** drawer opens (reason required), cashier sign-ins, kiosk assistance and guest QR orders are recorded as events, listed on the X / Z report and counted by the dashboard's attention flags. --- ## 5. The outlet dashboard **POS → Dashboard** refreshes every 15 seconds, for today, yesterday, 7 or 30 days: - **Outlets** — net sales (gross · refunded), sales and units, average basket, open shifts with voids and no-sales; every terminal side by side with its sales, basket, refunds, voids, expected drawer, last sale, online status and current cashier; sales by hour, tender mix and top items. - **Attention** — shifts that crossed a threshold you set: cash variance at close, void rate, refund rate, manual discount rate, drawers opened without a sale, price overrides. Each opens the shift. - **Reconciliation** — per tender, what the **counters** reported, what the receivable **ledger** recorded and what the **journal** debited, side by side with the status; unposted sales awaiting e-invoice clearance; and every drawer's float → expected → counted → variance. - **Tips** — tips by server and by tender, ready to pay out. You can also ask the BIZA assistant in plain language — "how did counter 2 do today", "which shift had the biggest variance this week". ### النسخة العربية (Arabic Edition): البيع دون اتصال والورديات ورقابة النقد ولوحة الفروع في نقاط البيع --- title: "البيع دون اتصال والورديات ورقابة النقد ولوحة الفروع في نقاط البيع" slug: pos-offline-shifts-cash-control category: sales-crm order: 6 updatedAt: "2026-09-21" summary: "كيف تواصل نقاط بيع BIZA البيع عند انقطاع الإنترنت وتُرحّل كل عملية مرةً واحدة بالضبط عند عودته؛ وكيف تحافظ جلسات الكاشير والعدّ الأعمى وتقارير X و Z وحركات النقد وأرقام PIN على أمانة الدرج؛ وكيف تُبرز اللوحة الحية الورديات التي ينبغي للمدير النظر فيها." tags: ["نقاط البيع", "دون اتصال", "الورديات", "تقرير Z", "رقابة النقد", "PIN الكاشير", "اللوحة", "التسوية"] --- # البيع دون اتصال والورديات ورقابة النقد ولوحة الفروع في نقاط البيع --- ## 1. البيع دون اتصال كل بيع ومرتجع وفتح/إغلاق كاشير وحركة نقد يُحفظ أولاً على الجهاز ثم يُرحَّل من طابور. إذا انقطع الاتصال في منتصف الوردية: - يواصل الكاشير البيع من الكتالوج والأسعار والعروض وقائمة الدُفعات المخزَّنة؛ ويعرض الشريط *دون اتصال* و*N بانتظار الإرسال*. - تُطبع الإيصالات فوراً بمرجع الإيصال الخاص بالكاشير؛ ويُضاف رقم الفاتورة عند وصول البيع إلى الخادم («رقم الفاتورة يلحق فور إرسال هذا البيع»). - عند عودة الاتصال يُفرَّغ الطابور **بالترتيب** و**مرةً واحدة بالضبط**: كل بيع يحمل مفتاح تفرّد، فلا تستطيع إعادة المحاولة ترحيله مرتين، ولا يستطيع بيع تجاوز جلسة الكاشير التي ينتمي إليها. عمليتا بيع دون اتصال تُنتجان دائماً فاتورتين بالضبط. - كل ما يرفضه الخادم لسبب لا تصلحه إعادة المحاولة (رقم تسلسلي بيع في مكان آخر أولاً، كوبون استُنفد في الأثناء) يبقى ظاهراً كـ*يحتاج انتباهاً* مع السبب حتى يعيد الكاشير المحاولة أو يتخلص منه — لا يختفي شيء بصمت. الإعدادات: **مواصلة البيع دون اتصال** (إيقافه = رفض البيع أثناء الانقطاع) و**السماح بالبيع تحت المخزون المسجَّل** (هل يجوز لبيع دون اتصال تجاوز رقم المخزون المخزَّن). المرتجعات تعمل دون اتصال على نسخة الكاشير من البيع؛ ويحدّ الخادم الاسترداد عند المزامنة. --- ## 2. الورديات (جلسات الكاشير) | الخطوة | ما يحدث | |---|---| | **فتح الكاشير** | اختر الجهاز، وعُدّ الدرج كرصيد افتتاحي. | | **نقد داخل / خارج** | كل ما يحرّك النقد دون بيع — تعزيز الرصيد من الخزنة، إيداع في الخزنة، رسوم مندوب — بالاتجاه والسبب وحساب الدرج والحساب المقابل. يُرحّل قيد يومية مرقّماً خاصاً به. الخطأ **يُلغى** بقيد عكسي وسبب. | | **تقرير X** | الوردية حتى الآن، في أي وقت: المبيعات حسب وسيلة الدفع، الخصومات، المرتجعات، الحركات، النقد المتوقع. | | **إغلاق الكاشير** | **عدّ أعمى** — يبقى الرقم المتوقع مخفياً حتى يُدخَل العدّ — ثم **تقرير Z**: الرصيد الافتتاحي ← المبيعات ← الحركات ← المتوقع ← المعدود ← الفرق، مع ملاحظات. | **اشتراط كاشير مفتوح** (موصى به للأعمال النقدية): لا يُباع شيء دون جلسة، فلا يعود نقدٌ ملكاً لأحد. وعند إيقافه تظل المبيعات تُرحَّل كاملةً لكن دون وردية. --- ## 3. الكاشيرون الكاشير مستخدم حقيقي بدور نقاط بيع. على كاشير مشترك يتبادل الكاشيرون **برقم PIN** — يُسجَّل دخول التالي باسمه، فكل بيع وإلغاء وفتح درج يحمل الاسم الصحيح. خمس محاولات خاطئة تقفل الرقم 15 دقيقة. *قفل الكاشير* يخفي الشاشة خلف لوحة PIN دون إغلاق الدرج؛ أغلق الكاشير فقط في نهاية الوردية. كل صلاحية — الخصومات، تعديل الأسعار، المرتجعات، فتح وإغلاق الكاشير، حركات النقد، فتح الدرج، الإعدادات — يتحقق منها الخادم لا مجرد إخفائها في الواجهة. --- ## 4. الأحداث وسجل التدقيق إلغاء الأسطر (بالقيمة المحذوفة)، إلغاء السلة، فتح الدرج **دون بيع** (السبب إلزامي)، تسجيلات دخول الكاشيرين، مساعدة الكشك وطلبات QR للضيوف تُسجَّل كأحداث، وتُعرض في تقرير X / Z، وتُحسب في تنبيهات اللوحة. --- ## 5. لوحة الفروع **نقاط البيع ← اللوحة** تتحدث كل 15 ثانية، لليوم أو الأمس أو 7 أو 30 يوماً: - **الفروع** — صافي المبيعات (الإجمالي · المسترد)، المبيعات والوحدات، متوسط السلة، الورديات المفتوحة مع الإلغاءات وفتحات الدرج دون بيع؛ كل جهاز جنباً إلى جنب بمبيعاته وسلته ومرتجعاته وإلغاءاته والدرج المتوقع وآخر بيع وحالة الاتصال والكاشير الحالي؛ المبيعات حسب الساعة ومزيج وسائل الدفع وأعلى الأصناف. - **انتباه** — الورديات التي تجاوزت حداً حددته أنت: فرق النقد عند الإغلاق، معدل الإلغاء، معدل المرتجعات، معدل الخصم اليدوي، فتحات الدرج دون بيع، تعديلات الأسعار. كل واحد يفتح الوردية. - **التسوية** — لكل وسيلة دفع، ما أبلغته **الكواشير**، وما سجّله **أستاذ** الذمم، وما قيّده **قيد اليومية** مديناً، جنباً إلى جنب مع الحالة؛ المبيعات غير المرحَّلة بانتظار اعتماد الفاتورة الإلكترونية؛ وكل درج: الرصيد الافتتاحي ← المتوقع ← المعدود ← الفرق. - **الإكراميات** — الإكراميات حسب النادل ووسيلة الدفع، جاهزة للصرف. يمكنك أيضاً سؤال مساعد BIZA بلغة عادية — «كيف كان أداء الكاشير 2 اليوم»، «أي وردية سجلت أكبر فرق هذا الأسبوع». --- ## Restaurant and café POS: tables, modifiers, kitchen display, split bills, tips and QR ordering **Category:** sales-crm | **Slug:** `/docs/pos-restaurant-cafe-tables-kitchen-qr-ordering` | **Canonical URL:** https://biza.app/docs/pos-restaurant-cafe-tables-kitchen-qr-ordering **Summary:** Run a restaurant, café or food court on the same POS engine as a shop: floor plans and tables, product modifiers, orders sent to the kitchen in rounds, a kitchen display with station routing and ticket printers, split bills by item or seat, tips and service charge, waiters taking orders on their phones, and guests ordering from a QR code at the table — with every bill posted as a tax invoice and a journal entry. # Restaurant and café POS: tables, modifiers, kitchen display, split bills, tips and QR ordering Restaurant mode is not a separate product. Set up floors and tables and the same counter that runs a shop becomes a table-service system — and every bill still posts as a numbered tax invoice, a balanced journal entry and a stock movement in one step. --- ## 1. Floors and tables Under **POS → Settings → Floors & tables** create floors (Ground, Terrace, Private room) and their tables with a name, number of seats and shape. Each table gets a **QR code** for guest ordering that you can show, download, print or rotate. --- ## 2. The floor **POS → Floor** shows every table coloured by state — free, occupied with the time since it opened and how many lines are *unsent* to the kitchen, and a *QR* badge when a guest has ordered — plus walk-up orders. Tap a table to take or continue its order. Orders belong to the business, not to a device, so any counter, tablet or phone can continue them. --- ## 3. Modifiers (options) Products carry **modifier groups** — size, milk, extras, cooking level — with minimum / maximum choices and price differences. Tapping such a product opens the options dialog; the price difference is applied on the device and again on the server, so a tampered device cannot under-price a large coffee. --- ## 4. Orders and the kitchen Lines accumulate on the order across rounds. **Send to kitchen** creates one **ticket per station** — the bar gets the drinks, the grill gets the mains — printed on the station's ticket printer and shown on the **kitchen display** (`POS → Kitchen`): filter by station, *Start*, *Done*, and *bring back* a ticket bumped by mistake. Tickets carry the ticket number, the table or *walk-up*, the course, the seat, the server and any notes. Stations are defined by the categories they cook; a default station catches everything else. A line the kitchen already has is marked *Sent* on the order and can only be removed with a reason, which becomes an audited void event. --- ## 5. Waiters on their phones On a phone the billing counter shows the menu, the order and a **Send** button in the thumb bar whenever there are unsent lines; after sending it returns to the floor. Menu → table → send → next table, one-handed, with camera scanning for packaged items. --- ## 6. Billing: split bills, tips, service charge - **Bill** takes the whole order to checkout. - **Split** lets the server pick lines — or a whole seat — to bill now; the rest stays open on the table as the next bill. - **Tips** — preset percentage chips, *no tip* or *other* at checkout; a tip posts to **Tips payable**, never to revenue and never taxed, and the dashboard's **Tips** report shows tips by server and by tender ready to pay out. - **Service charge** — a configurable percentage added at checkout, taxed or not, optionally **dine-in only** so walk-up counter sales get none; removable per bill by a cashier with the discount right. It posts to its own revenue account. Every bill is a normal POS sale: split tenders, gift cards, loyalty points, mada or UPI, receipt printing and the drawer all work as they do in a shop. --- ## 7. Guests order from the table (QR) Switch on **Order at the table** and add a welcome line. A guest scans the QR on the table and opens a public menu page — no app, no login — with photos, options, a note per item and a note for the staff, and **Send to the staff**. The order lands on the table **unsent**, so the waiter reviews it and sends it to the kitchen; the guest sees *your order so far* with what is in the kitchen and what is with the staff. Ordering is throttled per table, no payment is ever taken on the guest page, and a leaked code can be rotated in one tap. --- ## 8. Accounting impact of a restaurant bill | Item on the bill | Posting | |---|---| | Food and drink | Revenue per line's account · output VAT / GST | | Tip | Credit *Tips payable* (liability) | | Service charge | Credit *Service charge revenue* · VAT if taxed | | Discount or promotion | Debit *Sales discounts given* | | Tender | Debit cash / bank / gift-card liability / loyalty liability | Stock is consumed at the outlet's location as items are billed, so packaged goods, bottles and retail lines on a café menu are tracked like any other product. ### النسخة العربية (Arabic Edition): نقاط بيع المطاعم والمقاهي: الطاولات والإضافات وشاشة المطبخ وتقسيم الفاتورة والإكراميات والطلب عبر QR --- title: "نقاط بيع المطاعم والمقاهي: الطاولات والإضافات وشاشة المطبخ وتقسيم الفاتورة والإكراميات والطلب عبر QR" slug: pos-restaurant-cafe-tables-kitchen-qr-ordering category: sales-crm order: 7 updatedAt: "2026-09-21" summary: "شغّل مطعماً أو مقهى أو ساحة طعام على محرك نقاط البيع نفسه الذي يشغّل المتجر: مخططات الطوابق والطاولات، إضافات المنتجات، طلبات تُرسل إلى المطبخ على جولات، شاشة مطبخ بتوجيه للمحطات وطابعات تذاكر، تقسيم الفاتورة حسب الصنف أو المقعد، الإكراميات ورسوم الخدمة، النُدُل يأخذون الطلبات على جوالاتهم، والضيوف يطلبون من رمز QR على الطاولة — وكل فاتورة تُرحَّل كفاتورة ضريبية وقيد يومية." tags: ["نقاط البيع", "المطاعم", "المقاهي", "شاشة المطبخ", "KDS", "الطلب عبر QR", "الطاولات", "الإكراميات", "رسوم الخدمة"] --- # نقاط بيع المطاعم والمقاهي: الطاولات والإضافات وشاشة المطبخ وتقسيم الفاتورة والإكراميات والطلب عبر QR وضع المطاعم ليس منتجاً منفصلاً. أنشئ الطوابق والطاولات فيتحول الكاشير نفسه الذي يشغّل المتجر إلى نظام خدمة طاولات — وكل فاتورة تظل تُرحَّل كفاتورة ضريبية مرقّمة وقيد يومية متوازن وحركة مخزون في خطوة واحدة. --- ## 1. الطوابق والطاولات من **نقاط البيع ← الإعدادات ← الطوابق والطاولات** أنشئ الطوابق (الأرضي، التراس، الغرفة الخاصة) وطاولاتها باسم وعدد مقاعد وشكل. تحصل كل طاولة على **رمز QR** لطلبات الضيوف يمكنك عرضه أو تنزيله أو طباعته أو تدويره. --- ## 2. الصالة **نقاط البيع ← الصالة** تعرض كل طاولة ملوَّنة بحالتها — حرّة، مشغولة مع الوقت منذ فتحها وعدد الأسطر *غير المرسَلة* إلى المطبخ، وشارة *QR* عندما يطلب ضيف — إضافةً إلى الطلبات المباشرة. المس طاولة لأخذ طلبها أو متابعته. الطلبات ملك للمنشأة لا للجهاز، فأي كاشير أو جهاز لوحي أو جوال يستطيع متابعتها. --- ## 3. الإضافات (الخيارات) تحمل المنتجات **مجموعات إضافات** — الحجم، الحليب، الإضافات، درجة النضج — بحد أدنى وأقصى للاختيارات وفروق سعر. لمس مثل هذا المنتج يفتح نافذة الخيارات؛ ويُطبَّق فرق السعر على الجهاز ثم على الخادم مجدداً، فلا يستطيع جهاز معدَّل تسعير قهوة كبيرة بأقل من قيمتها. --- ## 4. الطلبات والمطبخ تتراكم الأسطر على الطلب عبر الجولات. **إرسال إلى المطبخ** ينشئ **تذكرة لكل محطة** — البار يحصل على المشروبات، والشواية على الأطباق الرئيسية — تُطبع على طابعة تذاكر المحطة وتظهر على **شاشة المطبخ** (`نقاط البيع ← المطبخ`): تصفية حسب المحطة، *بدء*، *تم*، و*إرجاع* تذكرة أُنهيت بالخطأ. تحمل التذاكر رقمها والطاولة أو *طلب مباشر* والجولة والمقعد والنادل وأي ملاحظات. تُعرَّف المحطات بالتصنيفات التي تطبخها؛ ومحطة افتراضية تلتقط ما تبقى. السطر الذي وصل المطبخ يُعلَّم *مُرسَل* على الطلب ولا يمكن حذفه إلا بسبب يصبح حدث إلغاء مدقَّقاً. --- ## 5. النُدُل على جوالاتهم على الجوال يعرض الكاشير القائمة والطلب وزر **إرسال** في شريط الإبهام كلما وُجدت أسطر غير مرسَلة؛ وبعد الإرسال يعود إلى الصالة. قائمة ← طاولة ← إرسال ← الطاولة التالية، بيد واحدة، مع مسح بالكاميرا للأصناف المعبأة. --- ## 6. الفوترة: تقسيم الفاتورة والإكراميات ورسوم الخدمة - **فاتورة** تأخذ الطلب كاملاً إلى الدفع. - **تقسيم** يتيح للنادل اختيار أسطر — أو مقعد كامل — لفوترتها الآن؛ ويبقى الباقي مفتوحاً على الطاولة كفاتورة تالية. - **الإكراميات** — شرائح نسب مسبقة أو *بلا إكرامية* أو *أخرى* عند الدفع؛ تُقيَّد الإكرامية في **إكراميات مستحقة الدفع**، لا في الإيراد ولا تخضع للضريبة، ويعرض تقرير **الإكراميات** في اللوحة الإكراميات حسب النادل ووسيلة الدفع جاهزة للصرف. - **رسوم الخدمة** — نسبة قابلة للإعداد تُضاف عند الدفع، خاضعة للضريبة أو لا، واختيارياً **للجلوس داخل المطعم فقط** فلا تُضاف لمبيعات الكاونتر؛ قابلة للإزالة لكل فاتورة من كاشير يملك صلاحية الخصم. تُقيَّد في حساب إيراد خاص بها. كل فاتورة بيع عادي في نقاط البيع: تقسيم الدفع، بطاقات الهدايا، نقاط الولاء، مدى أو UPI، طباعة الإيصال والدرج كلها تعمل كما في المتجر. --- ## 7. الضيوف يطلبون من الطاولة (QR) فعّل **الطلب من الطاولة** وأضف سطر ترحيب. يمسح الضيف رمز QR على الطاولة فتُفتح صفحة قائمة عامة — بلا تطبيق ولا تسجيل دخول — بالصور والخيارات وملاحظة لكل صنف وملاحظة للموظفين، و**إرسال إلى الموظفين**. يصل الطلب إلى الطاولة **غير مرسَل**، فيراجعه النادل ويرسله إلى المطبخ؛ ويرى الضيف *طلبك حتى الآن* بما هو في المطبخ وما هو لدى الموظفين. الطلب محدود المعدل لكل طاولة، ولا يُقبض أي مبلغ على صفحة الضيف، ويمكن تدوير الرمز المسرَّب بلمسة. --- ## 8. الأثر المحاسبي لفاتورة مطعم | البند في الفاتورة | القيد | |---|---| | طعام وشراب | إيراد حسب حساب كل سطر · ضريبة مخرجات | | إكرامية | دائن *إكراميات مستحقة الدفع* (التزام) | | رسوم خدمة | دائن *إيرادات رسوم الخدمة* · الضريبة إن كانت خاضعة | | خصم أو عرض | مدين *خصومات المبيعات الممنوحة* | | وسيلة الدفع | مدين النقد / البنك / التزام بطاقات الهدايا / التزام الولاء | يُستهلك المخزون في موقع الفرع عند فوترة الأصناف، فتُتبَّع البضائع المعبأة والزجاجات وأصناف التجزئة في قائمة المقهى كأي منتج آخر. --- ## HR Records, Document Expiry Tracking & WPS Payroll Compliance **Category:** hr-payroll | **Slug:** `/docs/hr-payroll-wps-compliance` | **Canonical URL:** https://biza.app/docs/hr-payroll-wps-compliance **Summary:** Manage employee profiles, track Iqama/passport/visa document expirations, process leave requests, and run WPS-compliant payroll linked to the general ledger. # HR Records, Document Expiry Tracking & WPS Payroll Compliance Managing human resources in the Gulf region involves strict statutory compliance, including document renewals (Iqamas, passports, labor cards), employee benefits, and government Wage Protection System (WPS) requirements. BIZA centralizes employee records and payroll directly alongside accounting. --- ## 1. Employee Profiles & Legal Document Management Every employee profile acts as the single source of truth for HR data: * **Identification & Contracts:** National ID / Iqama number, passport number, labor contract details, date of joining, and basic job title. * **Document Expiry Tracking:** Track renewal dates for critical legal documents: * Resident ID / Iqama * Passport * Commercial / Driving Licenses * Medical Insurance Policy & Occupational Cards * **Proactive Expiry Alerts:** Filter and view all documents expiring within 30, 60, or 90 days to avoid municipal penalties or operational halts. --- ## 2. Leave Management & Attendance * **Leave Types:** Configure annual leave, sick leave, maternity leave, and unpaid leave allowances in line with local labor laws. * **Request & Approval:** Employees or managers submit leave requests with start/end dates. * **Leave Balances:** Automatically updates employee leave balances and feeds into payroll deduction calculations. --- ## 3. Salary Structures & Allowances Define granular salary components for each employee: * **Basic Salary:** Base contractual wage. * **Housing Allowance (HRA):** Standard statutory allowance. * **Transport & Other Allowances:** Fixed monthly allowances. * **Social Insurance (GOSI / GPSSA):** Configure employer and employee social insurance contribution percentages. --- ## 4. Monthly Payroll Run & WPS File Generation Processing monthly salaries is a unified 3-step workflow: 1. **Initialize Payroll Run:** Select month and year. BIZA aggregates active employees, standard salary structures, approved leave deductions, timesheet overtime, and expense reimbursements. 2. **Review & Adjust:** Review draft payslips. Apply bonuses, advance loan deductions, or one-off adjustments. 3. **Generate WPS Bank File:** Export the official Wage Protection System SIF file format for electronic salary submission through corporate banking portals (Mudad, Al Rajhi, SNB, UAE WPS). --- ## 5. Automated Accounting Integration Approving the payroll run creates a balanced journal entry in the General Ledger: * **Debits:** Salaries & Wages Expense, Housing Allowance Expense, Transport Expense. * **Credits:** Salaries Payable, GOSI Contribution Payable, Employee Loan Clearing. * **Payment Settlement:** When the corporate bank wire is executed, a single payment voucher clears Salaries Payable against the bank account. ### النسخة العربية (Arabic Edition): سجلات الموارد البشرية، تتبع الوثائق، والامتثال لنظام حماية الأجور (WPS) --- title: "سجلات الموارد البشرية، تتبع الوثائق، والامتثال لنظام حماية الأجور (WPS)" slug: hr-payroll-wps-compliance category: hr-payroll order: 1 updatedAt: "2026-09-20" summary: "إدارة بيانات الموظفين، تنبيهات انتهاء الإقامات والجوازات، احتساب الرواتب والبدلات، وتوليد ملفات حماية الأجور (WPS SIF) المعتمدة وربطها بدفتر الأستاذ العام." tags: ["الموارد البشرية", "الرواتب", "حماية الأجور", "WPS", "مدد", "مقيم", "السعودية"] --- # سجلات الموارد البشرية، تتبع الوثائق، والامتثال لنظام حماية الأجور (WPS) تفرض وزارة الموارد البشرية والتنمية الاجتماعية في المملكة العربية السعودية والجهات التنظيمية في دول الخليج رقابة مشددة على صرف أجور العاملين من خلال **نظام حماية الأجور (WPS)** عبر منصة «مدد» والبنوك المعتمدة. يوفر بيزا (BIZA) نظاماً شاملاً لإدارة الموارد البشرية والرواتب، يدمج بين تتبع وثائق العاملين، إدارة عقود العمل، احتساب مستحقات نهاية الخدمة، وتوليد ملفات صرف الرواتب المتوافقة بدقة مع صيغة (SIF) لرفعها مباشرة للبنوك والمنصات الحكومية. --- ## 1. إدارة ملفات الموظفين والوثائق الثبوتية * **البيانات الشخصية والتعاقدية:** الاسم الثنائي بالعربية والإنجليزية، رقم الهوية الوطنية أو الإقامة، رقم الحدود، المسمى الوظيفي، وتاريخ الالتحاق. * **تتبع تواريخ انتهاء الوثائق:** رصد صلاحية الإقامات، جوازات السفر، رخص العمل، والتأمين الطبي مع تنبيهات استباقية (قبل 60 و 30 و 15 يوماً) لتفادي الغرامات الحكومية. * **إدارة الحسابات البنكية:** حفظ أرقام الآيبان (IBAN) المعتمدة للموظفين وربطها برمز البنك المحلي لضمان نجاح التحويلات. --- ## 2. هيكلة الرواتب والبدلات يتيح النظام تهيئة هياكل أجور مخصصة تشمل: * **الراتب الأساسي.** * **بدل السكن وبدل النقل والبدلات الإضافية.** * **استقطاعات التأمينات الاجتماعية (GOSI):** احتساب حصة الموظف وحصة المنشأة تلقائياً بناءً على النسب النظامية للمواطنين والمقيمين. * **خصومات الغياب والجزاءات:** تسجيل ساعات التأخير أو أيام الغياب غير المدفوعة وتطبيق الخصم آلياً قبل اعتماد المسير. --- ## 3. توليد ملف مسير الرواتب المعتمد (WPS SIF) عند إعداد مسير الرواتب الشهري: 1. يقوم مسؤول الموارد البشرية بمراجعة أيام العمل والإجازات والإضافي واعتماد المسير. 2. بضغطة زر واحدة، يُنشئ بيزا ملف صرف الرواتب القياسي المشفر (Salary Information File - SIF): * يتضمن رقم المنشأة في وزارة العمل (Establishment MOL ID). * رقم الحساب البنكي للمنشأة والرمز المصرفي. * تفصيل مبالغ الرواتب الأساسية والبدلات والاستقطاعات ورقم هوية وآيبان كل موظف. 3. يتم تنزيل الملف ورفعه فوراً إلى منصة مدد أو البنك التجاري دون الحاجة لأي تعديل على التنسيق. --- ## 4. القيود المحاسبية الآلية للرواتب عند اعتماد مسير الرواتب، يُنشئ بيزا تلقائياً قيود الاستحقاق والصرف في دفتر الأستاذ العام: * **مدين:** حساب مصروف الرواتب والأجور (الأساسي والبدلات). * **مدين:** حساب مساهمة المنشأة في التأمينات الاجتماعية (GOSI Expense). * **دائن:** حساب مخصص التأمينات الاجتماعية المستحقة (GOSI Payable). * **دائن:** حساب الرواتب المستحقة أو الحساب البنكي عند الصرف. --- ## Enterprise Security Architecture, RBAC & Immutable Audit Governance **Category:** security-platform | **Slug:** `/docs/enterprise-security-and-audit` | **Canonical URL:** https://biza.app/docs/enterprise-security-and-audit **Summary:** Enterprise security architecture: strict workspace segregation, granular role-based access control (RBAC), approval matrices, and tamper-evident field-level audit trails. # Enterprise Security Architecture, RBAC & Immutable Audit Governance Modern enterprise ERP systems safeguard sensitive financial ledgers, customer contracts, payroll details, and tax records. BIZA enforces zero-trust security principles, strict workspace segregation, fine-grained role-based access control (RBAC), and immutable audit trails across every business workflow. --- ## 1. Workspace Segregation & Session Security BIZA isolates tenant environments through a rigorous security boundary: * **Cryptographic Token Verification:** Every client request carries a cryptographically signed session token. Requests without verified credentials or valid organization context are rejected at the edge perimeter. * **Organizational Boundary Checks:** Access to financial vouchers, inventory movements, customer records, and tax filings is strictly bound to authorized organization members. Cross-tenant access is physically impossible. * **Session Lifecycle Control:** Configurable session timeouts, multi-factor authentication (MFA/2FA) enforcement, and instant credential revocation ensure lost or compromised devices cannot access enterprise ledgers. --- ## 2. Granular Role-Based Access Control (RBAC) Organizations can enforce the principle of least privilege using customizable roles and permissions: * **Standard Business Roles:** Administrator, Financial Controller, Chief Accountant, Sales Manager, Purchasing Officer, Warehouse Supervisor, Project Manager, and Auditor. * **Separation of Duties (SoD):** Separate permissions exist for drafting, reviewing, approving, and voiding documents. For example, a junior purchasing officer can prepare purchase orders (`po.create`), but only an authorized controller can release payment approvals (`payment.approve`). * **High-Risk Action Gates:** Critical operations—including fiscal year closing, journal entry reversals, bank account modifications, and VAT return finalization—require elevated administrative privileges with mandatory dual-authorization. --- ## 3. Tamper-Evident, Immutable Audit Logging (`audit_log`) Every create, update, approval, and void action across the entire ERP platform is permanently recorded in an immutable audit ledger: * **Audit Metadata Captured:** * Exact UTC timestamp with microsecond precision. * User identity (User ID, full name, registered email address). * Originating IP address and user agent. * Target entity name, document number, and primary identifier. * Operational event (`INSERT`, `UPDATE`, `DELETE`, `APPROVE`, `VOID`). * **Field-Level JSONB State Diffs:** The audit log stores complete `before` and `after` snapshots for every modified record, pinpointing exact line-item changes, price adjustments, credit limit overrides, and bank account updates. * **Immutable Storage:** Audit logs are write-once, append-only records that cannot be modified, edited, or truncated by standard application users or tenant administrators. This provides an indisputable chain of custody for external financial auditors, statutory tax reviews, and internal compliance investigations. --- ## 4. Comprehensive Encryption & Data Protection * **Data in Transit:** All traffic between clients, APIs, and microservices is strictly encrypted using TLS 1.3 with modern cipher suites. Insecure HTTP traffic is automatically upgraded. * **Data at Rest:** All operational databases, document repositories, and attachment stores (PDF invoices, scanned contracts, receipts) are encrypted at rest using industry-standard AES-256 encryption. * **Automated Disaster Recovery (PITR):** Continuous transaction write-ahead log (WAL) archiving enables Point-in-Time Recovery to any historical minute. Automated nightly offsite snapshots and scheduled weekly restore verification drills ensure business continuity.