ربط المتجر الإلكتروني وتطبيق المناديب مع برنامج الأمين وOdoo: كيف تعمل المزامنة فعلياً

الخلاصة قبل التفاصيل

الربط الناجح يبدأ بقرار واحد: أي نظام هو «مصدر الحقيقة» لكل نوع من البيانات. القاعدة التي نعتمدها: البرنامج المحاسبي (الأمين أو Odoo) يملك المخزون والأسعار وبطاقات الأصناف، والمتجر أو التطبيق يملك الطلب لحظة إنشائه.

إذا كان متجرك على ووكومرس، فإصدار الأمين 10 يوفر ربطاً جاهزاً للمتاجر الإلكترونية يغطي الأساسيات. أما تطبيقات المناديب، والمستودعات المتعددة، والبيع من السيارة، وقوائم أسعار عملاء الجملة، فتحتاج طبقة مزامنة مخصصة.

آخر تحديث: نوفمبر 2026.

لماذا يفشل أغلب الربط بين المتجر والمحاسبة؟

ليس بسبب الـ API. يفشل لأن النظامين يُتركان يعدّلان الرقم نفسه. المتجر يخصم الكمية، والمستودع يخصمها مرة أخرى عند الصرف، وموظف يعدّل السعر في مكان وينسى الآخر. بعد شهر لا أحد يثق بالمخزون المعروض.

ثلاثة أعراض تعرفها غالباً: طلبات على منتجات نفدت فعلياً، فواتير مكررة أو ناقصة في المحاسبة، وجرد آخر الشهر لا يطابق ما باعه المتجر.

مصدر الحقيقة: من يملك ماذا؟

نوع البياناتالمالكاتجاه المزامنةالتوقيت
بطاقات الأصناف والأسعارالبرنامج المحاسبيمحاسبة ← متجر وتطبيقعند التعديل أو دورياً
الكميات المتاحةالبرنامج المحاسبي (لكل مستودع)محاسبة ← متجر وتطبيقلحظياً أو كل بضع دقائق
الطلباتالمتجر أو التطبيقمتجر وتطبيق ← محاسبةلحظة الدفع أو التأكيد
العملاءالمتجر للأفراد، المحاسبة لعملاء الجملةباتجاهين بقواعد مكتوبةعند الإنشاء
الفاتورة الضريبيةجهة واحدة فقط—حسب مسار زاتكا المختار

السطر الأخير هو الأهم: لا يجوز أن يصدر المتجر فاتورة وتصدر المحاسبة فاتورة أخرى للطلب نفسه. (التفاصيل في دليل ربط زاتكا المرحلة الثانية)

ثلاثة مستويات للربط

1. الربط الجاهز بين الأمين وووكومرس

يتضمن إصدار الأمين 10 قسماً للمتاجر الإلكترونية يُربط بووكومرس عبر REST API باستخدام رابط المتجر ومفتاحي Consumer Key وConsumer Secret. يغطي تصدير الأصناف وخصم المبيعات من مستودع البيع الإلكتروني وجلب الطلبات كفواتير. يناسب متجراً واحداً بمستودع بيع واحد، ويحتاج متجراً على استضافة يمكن الوصول إليها وتنسيقاً مع وكيل الأمين في منطقتك.

2. Odoo وموصلاته

يوفر Odoo واجهات برمجية (XML-RPC وJSON-RPC) تسمح بقراءة المخزون وإنشاء أوامر البيع والفواتير، وتوجد موصلات جاهزة مع ووكومرس بجودة متفاوتة. الموصل الجاهز يعمل جيداً طالما أن سير عملك يشبه ما تخيله من بناه.

3. طبقة مزامنة مخصصة (Middleware)

تصبح ضرورية عندما يوجد: تطبيق مناديب، أو فروع ومستودعات متعددة، أو بيع من السيارة في مناطق ضعيفة التغطية، أو قوائم أسعار لكل عميل جملة، أو أكثر من قناة بيع تسحب من المخزون نفسه. هنا تجلس طبقة وسيطة بين الأنظمة تترجم وترتب وتعيد المحاولة وتسجّل كل عملية.

تطبيق المناديب مع الأمين: سيناريو من مشروع حقيقي

منشأة جملة لها مستودعات في ينبع وأملج والمدينة المنورة، ومناديب يبيعون من السيارة، ومحاسبة كاملة على الأمين. المطلوب: أي فاتورة يصدرها المندوب تنزل في الأمين كفاتورة مبيعات معتمدة، وجرد كل مستودع يظهر في التطبيق دون إدخال يدوي مكرر. هكذا يُبنى:

  1. كل سيارة تُعرّف في الأمين كمستودع، والمندوب يرى رصيد سيارته فقط.
  2. الطلب يُحفظ على الجوال أولاً بمعرّف فريد، فيعمل التطبيق حتى مع انقطاع الإنترنت.
  3. عند عودة الاتصال يُرسل الطلب مع مفتاح منع التكرار (Idempotency Key)، فلا تتكرر الفاتورة لو أعاد التطبيق الإرسال.
  4. طبقة المزامنة تنشئ فاتورة المبيعات في الأمين وتعيد رقمها للتطبيق.
  5. الأمين يحدّث الأرصدة، وتُدفع الكميات الجديدة لكل الأجهزة.
  6. أي فشل يدخل طابور إعادة المحاولة ويظهر في لوحة متابعة للمحاسب، بدل أن يضيع بصمت.

المبدأ الذي نكرره في كل مشروع ربط: الخطأ الذي يظهر في لوحة متابعة أرخص بكثير من الخطأ الذي يُكتشف في الجرد.

أسئلة اطرحها قبل توقيع أي مشروع ربط

  • ما إصدار البرنامج المحاسبي، وأين يعمل: سحابياً أم على جهاز في المكتب؟
  • من يتحمل تكلفة رخصة الموصل أو وحدة الـ API من وكيل البرنامج؟
  • ماذا يحدث عند تعارض رقمين؟ ومن يكسب؟
  • هل توجد بيئة اختبار منفصلة عن بياناتك الحقيقية؟
  • من يراقب أخطاء المزامنة بعد التسليم، ولمدة كم؟

إذا لم تجد إجابة مكتوبة عن السؤال الثالث في أي عرض يصلك، فالعرض لم يفهم المشروع بعد.

عندك الأمين أو Odoo وتبغى تربطه؟

أرسل لنا إصدار البرنامج، وعدد المستودعات، والقنوات التي تبيع منها (متجر، تطبيق، مناديب)، ونرسم لك مخطط الربط ومصدر الحقيقة لكل بيان قبل أي عرض سعر.

أسئلة شائعة

هل يمكن ربط برنامج الأمين مع ووكومرس مباشرة؟

نعم. إصدار الأمين 10 يتضمن ربطاً مع ووكومرس عبر REST API، وهو كافٍ غالباً لمتجر واحد بمستودع بيع واحد. الحالات الأعقد تحتاج طبقة مزامنة مخصصة.

هل يعمل تطبيق المناديب بدون إنترنت؟

نعم، إذا صُمم ليحفظ الطلبات على الجهاز أولاً ويرسلها عند عودة الاتصال مع مفتاح يمنع تكرار الفاتورة.

كم مرة تتحدث الكميات في المتجر؟

لحظياً حيث يدعم النظام الإشعارات، أو كل بضع دقائق بمزامنة دورية. نحدد التوقيت حسب سرعة دوران مخزونك.

هل الربط آمن على بياناتي المحاسبية؟

نعم عند بنائه بشكل صحيح: صلاحيات API محدودة بالعمليات المطلوبة فقط، اتصال مشفر، سجل لكل عملية، ولا وصول مباشر إلى قاعدة البيانات المحاسبية.

كم تكلفة ربط المتجر مع الأمين أو ERP؟

ضمن المتاجر المخصصة يقع الربط عادة في مسار 8,500 – 15,300 ر.س. أنظمة المناديب والمستودعات المتعددة تُسعّر بعد حصر النطاق كتابياً.

أدلة مرتبطة

استشارة معمارية وتسويقية مباشرة

هل تبحث عن شريك تقني موثوق لتنفيذ مشروعك القادم؟

ناقش فكرتك مباشرة مع فريق أفق الهندسي في جدة (مقر حي النعيم - مركز دارا) أو عبر اجتماع أونلاين، واستلم خطة التنفيذ والتسعير بالريال السعودي.

  • المقر الرئيسي: جدة، حي النعيم، مركز دارا الدور الأول مكتب 101
  • مقابلات واجتماعات ميدانية في المدينة المنورة أو عبر Google Meet
  • ضمان خطي لملكية السورس كود 100% لمدة سنة كاملة بعد التسليم

نموذج طلب الاستشارة وعرض السعر

أدخل اسمك ورقم الجوال ونبذة مختصرة عن المشروع وسيتواصل معك مستشارنا التقني مباشرة.