ربط المتجر الإلكتروني وتطبيق المناديب مع برنامج الأمين وOdoo: كيف تعمل المزامنة فعلياً
الخلاصة قبل التفاصيل
الربط الناجح يبدأ بقرار واحد: أي نظام هو «مصدر الحقيقة» لكل نوع من البيانات. القاعدة التي نعتمدها: البرنامج المحاسبي (الأمين أو Odoo) يملك المخزون والأسعار وبطاقات الأصناف، والمتجر أو التطبيق يملك الطلب لحظة إنشائه.
إذا كان متجرك على ووكومرس، فإصدار الأمين 10 يوفر ربطاً جاهزاً للمتاجر الإلكترونية يغطي الأساسيات. أما تطبيقات المناديب، والمستودعات المتعددة، والبيع من السيارة، وقوائم أسعار عملاء الجملة، فتحتاج طبقة مزامنة مخصصة.
آخر تحديث: نوفمبر 2026.
لماذا يفشل أغلب الربط بين المتجر والمحاسبة؟
ليس بسبب الـ API. يفشل لأن النظامين يُتركان يعدّلان الرقم نفسه. المتجر يخصم الكمية، والمستودع يخصمها مرة أخرى عند الصرف، وموظف يعدّل السعر في مكان وينسى الآخر. بعد شهر لا أحد يثق بالمخزون المعروض.
ثلاثة أعراض تعرفها غالباً: طلبات على منتجات نفدت فعلياً، فواتير مكررة أو ناقصة في المحاسبة، وجرد آخر الشهر لا يطابق ما باعه المتجر.
مصدر الحقيقة: من يملك ماذا؟
| نوع البيانات | المالك | اتجاه المزامنة | التوقيت |
|---|---|---|---|
| بطاقات الأصناف والأسعار | البرنامج المحاسبي | محاسبة ← متجر وتطبيق | عند التعديل أو دورياً |
| الكميات المتاحة | البرنامج المحاسبي (لكل مستودع) | محاسبة ← متجر وتطبيق | لحظياً أو كل بضع دقائق |
| الطلبات | المتجر أو التطبيق | متجر وتطبيق ← محاسبة | لحظة الدفع أو التأكيد |
| العملاء | المتجر للأفراد، المحاسبة لعملاء الجملة | باتجاهين بقواعد مكتوبة | عند الإنشاء |
| الفاتورة الضريبية | جهة واحدة فقط | — | حسب مسار زاتكا المختار |
السطر الأخير هو الأهم: لا يجوز أن يصدر المتجر فاتورة وتصدر المحاسبة فاتورة أخرى للطلب نفسه. (التفاصيل في دليل ربط زاتكا المرحلة الثانية)
ثلاثة مستويات للربط
1. الربط الجاهز بين الأمين وووكومرس
يتضمن إصدار الأمين 10 قسماً للمتاجر الإلكترونية يُربط بووكومرس عبر REST API باستخدام رابط المتجر ومفتاحي Consumer Key وConsumer Secret. يغطي تصدير الأصناف وخصم المبيعات من مستودع البيع الإلكتروني وجلب الطلبات كفواتير. يناسب متجراً واحداً بمستودع بيع واحد، ويحتاج متجراً على استضافة يمكن الوصول إليها وتنسيقاً مع وكيل الأمين في منطقتك.
2. Odoo وموصلاته
يوفر Odoo واجهات برمجية (XML-RPC وJSON-RPC) تسمح بقراءة المخزون وإنشاء أوامر البيع والفواتير، وتوجد موصلات جاهزة مع ووكومرس بجودة متفاوتة. الموصل الجاهز يعمل جيداً طالما أن سير عملك يشبه ما تخيله من بناه.
3. طبقة مزامنة مخصصة (Middleware)
تصبح ضرورية عندما يوجد: تطبيق مناديب، أو فروع ومستودعات متعددة، أو بيع من السيارة في مناطق ضعيفة التغطية، أو قوائم أسعار لكل عميل جملة، أو أكثر من قناة بيع تسحب من المخزون نفسه. هنا تجلس طبقة وسيطة بين الأنظمة تترجم وترتب وتعيد المحاولة وتسجّل كل عملية.
تطبيق المناديب مع الأمين: سيناريو من مشروع حقيقي
منشأة جملة لها مستودعات في ينبع وأملج والمدينة المنورة، ومناديب يبيعون من السيارة، ومحاسبة كاملة على الأمين. المطلوب: أي فاتورة يصدرها المندوب تنزل في الأمين كفاتورة مبيعات معتمدة، وجرد كل مستودع يظهر في التطبيق دون إدخال يدوي مكرر. هكذا يُبنى:
- كل سيارة تُعرّف في الأمين كمستودع، والمندوب يرى رصيد سيارته فقط.
- الطلب يُحفظ على الجوال أولاً بمعرّف فريد، فيعمل التطبيق حتى مع انقطاع الإنترنت.
- عند عودة الاتصال يُرسل الطلب مع مفتاح منع التكرار (Idempotency Key)، فلا تتكرر الفاتورة لو أعاد التطبيق الإرسال.
- طبقة المزامنة تنشئ فاتورة المبيعات في الأمين وتعيد رقمها للتطبيق.
- الأمين يحدّث الأرصدة، وتُدفع الكميات الجديدة لكل الأجهزة.
- أي فشل يدخل طابور إعادة المحاولة ويظهر في لوحة متابعة للمحاسب، بدل أن يضيع بصمت.
المبدأ الذي نكرره في كل مشروع ربط: الخطأ الذي يظهر في لوحة متابعة أرخص بكثير من الخطأ الذي يُكتشف في الجرد.
أسئلة اطرحها قبل توقيع أي مشروع ربط
- ما إصدار البرنامج المحاسبي، وأين يعمل: سحابياً أم على جهاز في المكتب؟
- من يتحمل تكلفة رخصة الموصل أو وحدة الـ API من وكيل البرنامج؟
- ماذا يحدث عند تعارض رقمين؟ ومن يكسب؟
- هل توجد بيئة اختبار منفصلة عن بياناتك الحقيقية؟
- من يراقب أخطاء المزامنة بعد التسليم، ولمدة كم؟
إذا لم تجد إجابة مكتوبة عن السؤال الثالث في أي عرض يصلك، فالعرض لم يفهم المشروع بعد.
أسئلة شائعة
هل يمكن ربط برنامج الأمين مع ووكومرس مباشرة؟
نعم. إصدار الأمين 10 يتضمن ربطاً مع ووكومرس عبر REST API، وهو كافٍ غالباً لمتجر واحد بمستودع بيع واحد. الحالات الأعقد تحتاج طبقة مزامنة مخصصة.
هل يعمل تطبيق المناديب بدون إنترنت؟
نعم، إذا صُمم ليحفظ الطلبات على الجهاز أولاً ويرسلها عند عودة الاتصال مع مفتاح يمنع تكرار الفاتورة.
كم مرة تتحدث الكميات في المتجر؟
لحظياً حيث يدعم النظام الإشعارات، أو كل بضع دقائق بمزامنة دورية. نحدد التوقيت حسب سرعة دوران مخزونك.
هل الربط آمن على بياناتي المحاسبية؟
نعم عند بنائه بشكل صحيح: صلاحيات API محدودة بالعمليات المطلوبة فقط، اتصال مشفر، سجل لكل عملية، ولا وصول مباشر إلى قاعدة البيانات المحاسبية.
كم تكلفة ربط المتجر مع الأمين أو ERP؟
ضمن المتاجر المخصصة يقع الربط عادة في مسار 8,500 – 15,300 ر.س. أنظمة المناديب والمستودعات المتعددة تُسعّر بعد حصر النطاق كتابياً.





