التثبيت والتحديث
- على هاتف أندرويد، افتح رابط التنزيل. إذا طلب الهاتف ذلك، اسمح للمتصفح بـ Install unknown apps (تثبيت التطبيقات غير المعروفة).
- افتح ملف
BM-AdminApp.apkالذي تم تنزيله واضغط Install (تثبيت). - عند نشر إصدار أحدث، تعرض الشاشة الرئيسية شريط يتوفر تحديث. اضغط تحديث، ثم نزّل الملف وثبّته فوق التطبيق الحالي.
تسجيل الدخول
- Company code (رمز الشركة) — الرمز المختصر لشركتك (3–20 حرفاً صغيراً أو رقماً، مثل
acme). وهو الجزء الأول من عنوان لوحة التحكم. يتذكره التطبيق. - البريد الإلكتروني أو الهاتف وكلمة المرور — بيانات دخولك إلى لوحة التحكم. الحسابات ذات دور admin (مسؤول) فقط يمكنها استخدام هذا التطبيق.
- اضغط تسجيل الدخول.
أول تسجيل دخول على هاتف جديد
هواتف المسؤولين تحتاج إلى موافقة أيضاً. عند تسجيل الدخول لأول مرة على هاتف، يعرض التطبيق بطاقة الموافقة على هذا الهاتف بدلاً من فتحه:
- وافق على الهاتف بنفسك من لوحة التحكم ← Devices (الأجهزة) أو من رابط "devices waiting for OTP" في الشريط العلوي، أو اطلب ذلك من مسؤول آخر. تعرض البطاقة في انتظار المسؤول… وتتحقق كل 5 ثوانٍ؛ وبعد الموافقة يسجّل التطبيق دخولك تلقائياً.
- أو أنشئ هناك الرمز المكوّن من 6 أرقام (صالح لمدة 10 دقائق)، ثم أدخله واضغط تحقق وسجّل الدخول.
تتوقف البطاقة عن التحقق بعد 5 دقائق — إذا تمت الموافقة على الهاتف لاحقاً، فاضغط تسجيل الدخول مرة أخرى. في الشركة التجريبية (demo) تتم الموافقة على الهواتف تلقائياً.
الموافقة على هواتف موظفيك. عندما يسجّل مندوب مبيعات أو عميل أو مراقب الدخول على هاتف جديد، تعرض الشاشة الرئيسية تنبيه "… هواتف بانتظار رمز". اضغط فتح (أو اذهب إلى More ← Devices)، ثم اختر الموافقة بدون رمز أو اضغط إنشاء رمز واقرأ الرمز المكوّن من 6 أرقام للمستخدم — يعمل لمدة 10 دقائق على ذلك الهاتف فقط.
بعد أول تسجيل دخول ناجح قد يعرض عليك التطبيق بصمة الإصبع / Face ID. يقفل التطبيق نفسه بعد 15 دقيقة من عدم الاستخدام.
العمل بدون اتصال
يعرض شريط أعلى كل شاشة الحالة: غير متصل — N تغييرات محفوظة محلياً، أو Connected but server is unreachable (متصل لكن تعذر الوصول إلى الخادم)، أو Syncing X of Y… (جارٍ مزامنة X من Y)، أو All changes synced (تمت مزامنة كل التغييرات) باللون الأخضر. اضغط مزامنة لفرض الرفع؛ واضغط على الشريط (أو صف N pending sync في الرئيسية وفي القائمة الجانبية) لفتح Sync issues (مشكلات المزامنة) ثم Retry (إعادة المحاولة) / Dismiss (تجاهل) / Retry all (إعادة محاولة الكل).
- يزامن التطبيق تلقائياً كل 45 ثانية أثناء فتحه، وكلما عدت إليه، ومباشرة بعد حفظ أي شيء بدون اتصال.
- يعمل بدون اتصال: إنشاء الطلبات وإلغاؤها، وإنشاء المصروفات وتعديلها، وقراءة آخر التقارير المنزّلة (مميّزة بـ cached).
- يحتاج إلى إنترنت: كل شيء آخر — يقول التطبيق This action requires an internet connection (يتطلب هذا الإجراء اتصالاً بالإنترنت).
الرئيسية والتنقل
التبويبات السفلية: Home (الرئيسية) · Sales (المبيعات) · Customers (العملاء) · Inventory (المخزون) · More (المزيد). أيقونة القائمة (أعلى الشاشة) تفتح قائمة جانبية تسرد كل الشاشات مجمّعة: Overview (نظرة عامة)، Catalog (الكتالوج)، Customers (العملاء)، Sales (المبيعات)، Shipping (الشحن)، Expenses (المصروفات)، Inventory (المخزون)، Reports (التقارير)، Admin (الإدارة).
تعرض الرئيسية Sales (this month) (مبيعات هذا الشهر)، وExpenses (YTD) (مصروفات السنة حتى تاريخه)، وPending manual orders (الطلبات اليدوية المعلقة)، وصف pending sync، وروابط سريعة: New Order (طلب جديد)، New Expense (مصروف جديد)، Products (المنتجات)، Warehouse (المستودع). أيقونة الشخص في أعلى الشاشة تعرض حسابك وSign out (تسجيل الخروج).
المبيعات
الطلبات
- كل طلبات الشركة. أيقونة الفلتر تفتح البحث، والحالة، وحالة الدفع، ونطاق التاريخ، ومندوب المبيعات، وفلتر المؤرشف؛ ويعرض العنوان عدد الفلاتر النشطة. أيقونة التحديث تعيد التحميل من الخادم.
- + ينشئ طلباً: عميل أو Walk-in quick order (طلب سريع بدون موعد)، وتاريخ الطلب ووقته، والبنود، وApply VAT (تطبيق ضريبة القيمة المضافة)، وملاحظة، ثم إما Save as draft (حفظ كمسودة) ("Draft orders skip inventory/credit checks until confirmed" — المسودات تتخطى فحوصات المخزون والائتمان حتى التأكيد) أو التأكيد.
- افتح طلباً: Confirm order (تأكيد الطلب) للمسودات، وCollect payment (تحصيل الدفع)، وتعديل البنود أو تسجيل المرتجعات، والطلبات اليدوية المرتبطة، وطباعة/مشاركة الفاتورة. تعرض التنبيهات Pending sync (في انتظار المزامنة) أو Pending approval (في انتظار الموافقة).
الطلبات اليدوية
صندوق وارد لطلبات العملاء (ملاحظة، صور، صوت، فيديو). افتح أحدها لتشغيل الوسائط، أو Assign (تعيين) إلى مندوب مبيعات، أو Convert (تحويل) إلى طلب بنفسك.
مندوبو المبيعات وتقويم الفريق
أنشئ مندوبي المبيعات وعدّلهم، واتصل بهم أو راسلهم عبر واتساب، وحدد نطاق الخصم المسموح لهم. يعرض Team calendar (تقويم الفريق) كل الزيارات المخططة عبر الفريق.
العملاء
- Shops, Vans, Importers (المتاجر، الشاحنات، المستوردون) — سجلات كاملة: جهات الاتصال، وGPS والخريطة، والصور، والاسم العربي، وأرقام ضريبة القيمة المضافة/السجل التجاري، وحد الائتمان وشروط الدفع، وحساب دخول العميل (أنشئه هنا ليتمكن من استخدام تطبيق الطلبات أو البوابة).
- Customer types (أنواع العملاء) وAreas (المناطق) — القوائم المرجعية التي يقوم عليها التسعير والمناطق الجغرافية.
- Assignments (التعيينات) — أي مندوب مبيعات يخدم أي عميل، بشكل دائم أو مؤقت (تغطية الإجازات). Territories (المناطق الجغرافية) تربط المناطق بمندوبي المبيعات؛ Assignment calendar (تقويم التعيينات) يعرض التغطيات المؤقتة عبر الزمن؛ Unassigned (غير معيّن) يسرد العملاء الذين لا يخدمهم أحد؛ Assignment audit (سجل التعيينات) هو سجل التغييرات.
- SP dashboard (لوحة مندوب المبيعات) — نظرة عامة لكل مندوب مبيعات.
- Shop map (خريطة المتاجر) — دبابيس المتاجر وقائمة المراقبة مع الفلاتر. Watch-list (قائمة المراقبة) — العملاء المحتملون الذين وجدهم مندوبو المبيعات: راجع، وأعد التعيين، وحوّل. Churn risk (خطر فقدان العملاء) — العملاء الذين توقفوا عن الطلب.
المخزون
- Warehouse stock (مخزون المستودع) — الأرصدة لكل منتج. Van stock (مخزون الشاحنة) — لكل شاحنة مندوب مبيعات.
- تحميل الشاحنة — انقل المنتجات من المستودع إلى شاحنة؛ يعرض كل بند متاح: N.
- Stock adjust (تعديل المخزون) — تصحيح يدوي مع ذكر السبب. Damage write-off (شطب التالف) — إزالة المخزون التالف (يُنشأ مصروف معتمد تلقائياً).
- Inspections (الجرد) — عدّ فعلي مقارنةً بالسجل؛ إكمال الجرد يرحّل تعديلات الفروقات.
التقارير
من More ← Reports: Sales report (تقرير المبيعات: الطلبات والإيرادات حسب الفترة)، وSales performance (أداء المبيعات: لكل مندوب مبيعات — المبيعات والكراتين والمستحقات والاتجاه وحسب البند)، وProfit report (تقرير الأرباح: الإيرادات والتكلفة والربح)، وExpense report (تقرير المصروفات: حسب الفئة) وExpense summary (ملخص المصروفات: السنة حتى تاريخه حسب الفترة). يبقى آخر تقرير منزّل قابلاً للقراءة بدون اتصال مع تنبيه cached.
المصروفات
More ← Expenses: القائمة، و+ لتسجيل مصروف (الفئة، والمبلغ، والتاريخ، والمركبة، وملاحظة، وصورة الإيصال)، والتعديل، وإدارة Expense categories (فئات المصروفات) وVehicles (المركبات). الإنشاء والتعديل يعملان بدون اتصال.
الكتالوج
More ← Catalog: Products (المنتجات: الاسم والاسم العربي، والصور، وحجم الكرتون، والتكلفة، وسعر لكل نوع عميل، والوسوم)، وCategories (الفئات)، وTags (الوسوم)، وBrands (العلامات التجارية)، وUnits (الوحدات)، وPromotions (العروض الترويجية).
الشحن والمشتريات
More ← Shipping: Countries (الدول)، وSuppliers (المورّدون: مع أرقام ضريبة القيمة المضافة والسجل التجاري)، وContainers (الحاويات: الاستيراد) وPurchases (المشتريات: الشراء المحلي). ترحيل عملية شراء يضيف البضائع إلى مخزون المستودع.
الموافقات
More ← Approvals يحتوي على تبويبين: Discounts (الخصومات) التي طلبها مندوبو المبيعات فوق النطاق المسموح لهم، وCancellations (الإلغاءات) للطلبات الأقدم من يوم إنشائها. لكل طلب زرا Approve (موافقة) وReject (رفض). يُخطَر مندوبو المبيعات في تطبيقهم.
الإعدادات والمستخدمون والطابعة
- Pricing & VAT settings (إعدادات التسعير وضريبة القيمة المضافة) — نسبة الضريبة وخيارات التسعير التي تستخدمها التطبيقات.
- Users (المستخدمون) — حسابات الموظفين والأدوار (مسؤول، مندوب مبيعات، مراقب).
- Printer settings (إعدادات الطابعة) — اقرن طابعة إيصالات بلوتوث (58 أو 80 مم) واطبع صفحة اختبار.
- Profile (الملف الشخصي) — حسابك، واللغة، وتسجيل الدخول بالبصمة، وتسجيل الخروج (يحذّرك التطبيق إذا وُجدت بيانات غير متزامنة).
حل المشكلات
| المشكلة | ما يجب فعله |
|---|---|
| العودة إلى شاشة تسجيل الدخول بعد تسجيل الدخول | الحساب ليس حساب مسؤول. يستخدم المراقبون تطبيق المراقبة، ومندوبو المبيعات تطبيق المبيعات. |
| "3–20 lowercase letters/digits" تحت رمز الشركة | اكتب الرمز تماماً، بدون مسافات أو أحرف كبيرة — وهو الجزء الأول من عنوان لوحة التحكم. |
| "This action requires an internet connection" | الطلبات والمصروفات والتقارير المخزنة فقط تعمل بدون اتصال. أعد الاتصال وحاول مرة أخرى. |
| شريط أحمر بمشكلات مزامنة | اضغط عليه واقرأ الخطأ (حد الائتمان، المخزون، تكرار)؛ أصلح السبب في لوحة التحكم، ثم Retry. |
| الموظفون لا يرون شريط "يتوفر تحديث" | ارفع ملفات APK الجديدة وحدد أحدث رقم بنية لكل تطبيق في الإعدادات المركزية. |
| الطابعة غير موجودة | اقرنها في إعدادات بلوتوث بالهاتف أولاً، ثم اخترها في Printer settings واطبع صفحة اختبار. |
| رابط التنزيل يعرض "403" أو "expired" | الروابط صالحة لمدة 60 دقيقة. افتح Download App في لوحة التحكم مرة أخرى. |