ربط API سلة يعني أن يتبادل متجرك على سلة البيانات تلقائيًا مع أنظمتك الأخرى، كالنظام المحاسبي أو نظام المخزون أو منصتك الخاصة، عبر تطبيق يُسجَّل في بوابة شركاء سلة، ويحصل على إذن التاجر بآلية OAuth، ويستقبل الأحداث مثل الطلبات الجديدة عبر إشعارات آلية (Webhooks). تحتاجه عندما يصبح نسخ الطلبات يدويًا وتعديل الكميات بين الأنظمة عبئًا يوميًا ومصدرًا للأخطاء. في هذا الدليل نشرح متى يستحق الربط الاستثمار، وكيف يعمل دون تعقيد، وما الذي تطلبه من المطور حتى يبقى الربط موثوقًا.
متى يحتاج متجر سلة إلى ربط برمجي؟
في البداية يكفي لوحة تحكم سلة وحدها. لكن مع نمو الطلبات تظهر علامات واضحة على أن العمل اليدوي صار مكلفًا:
- موظف يعيد إدخال كل طلب مدفوع في النظام المحاسبي، وأحيانًا يخطئ في الضريبة أو يكرر الطلب.
- كميات المخزون في سلة لا تطابق المستودع أو الفروع، فتبيع منتجًا نفد فعليًا.
- تبيع خدمة رقمية أو اشتراكًا، ثم يفعّله فريقك يدويًا بعد كل عملية شراء.
- طلبات تحتاج مسار تنفيذ خاصًا، كتوزيعها على فرع في الرياض وآخر في جدة بحسب المدينة.
- تقارير الإدارة تُجمع من عدة ملفات Excel كل أسبوع.
ابحث أولًا في متجر تطبيقات سلة
قبل أن تطلب ربطًا مخصصًا، تحقق من متجر تطبيقات سلة. كثير من الاحتياجات الشائعة، كالربط مع بعض الأنظمة المحاسبية وشركات الشحن، قد يكون لها تطبيق جاهز. الربط المخصص يصبح منطقيًا عندما يكون نظامك غير مدعوم، أو منطق عملك خاصًا، أو عندما تحتاج تحكمًا كاملًا في البيانات وتوقيت المزامنة. وإذا كنت ما زلت تقارن بين المنصات، فراجع مقالنا سلة أم زد أم متجر مخصص.
كيف يعمل ربط سلة مع نظام خارجي؟
لا تحتاج أن تكون مبرمجًا لتفهم الصورة. الربط يقوم على ثلاثة أجزاء:
1. تطبيق في بوابة شركاء سلة
يُنشئ المطور تطبيقًا في بوابة شركاء سلة (Salla Partners)، ويحدد الصلاحيات التي يحتاجها، مثل قراءة الطلبات أو تعديل المنتجات. قد يكون التطبيق خاصًا بمتجرك، أو مُعدًا للنشر في متجر تطبيقات سلة ليستخدمه تجار آخرون، ولكل خيار متطلبات مراجعة مختلفة تشرحها وثائق المطورين الرسمية.
2. إذن التاجر عبر OAuth
عندما يثبّت التاجر التطبيق، يوافق على الصلاحيات المطلوبة، فيحصل التطبيق على رمز وصول (Access Token) يتيح له التعامل مع بيانات هذا المتجر فقط. هذه الرموز لها مدة صلاحية وتحتاج إلى تجديد، ويجب تخزينها مشفرة على خادم آمن، لا داخل ملف أو جدول بيانات.
3. الإشعارات الآلية وواجهة API
عند وقوع حدث في المتجر، كطلب جديد أو تغير حالة طلب أو تعديل منتج، ترسل سلة إشعارًا آليًا إلى عنوان على خادمك. يستقبل نظامك الإشعار، ثم يستدعي واجهة API لجلب التفاصيل أو تحديث بيانات في المتجر. أسماء الأحداث والحقول وحدود الاستخدام تحددها وثائق سلة الرسمية، وقد تتغير مع الإصدارات، لذلك يجب أن يبني المطور على الوثائق الحالية لا على أمثلة قديمة.
أنماط ربط سلة الأكثر شيوعًا
معظم مشاريع الربط تندرج تحت واحد من الأنماط التالية أو مزيج منها:
| النمط | مثال عملي | آلية العمل | أهم خطر يجب ضبطه |
|---|---|---|---|
| الطلبات إلى المحاسبة أو ERP | كل طلب مدفوع يُنشئ قيد بيع وفاتورة | إشعار آلي ثم طابور معالجة | تكرار القيد أو خطأ في ربط الضريبة |
| مزامنة المخزون | المستودع هو المرجع والمتجر يتبعه | تحديث مجدول مع إشعارات عند البيع | بيع كمية غير موجودة |
| تفعيل خدمة رقمية | شراء باقة يفعّل رصيدًا في منصتك | إشعار عند الدفع ثم تفعيل الحساب | مطابقة هوية العميل والاسترداد |
| تنفيذ مخصص للطلبات | توجيه الطلب إلى فرع أو مورد | إشعار ثم تحديث الحالة في سلة | اختلاف مسميات الحالات |
| التقارير ولوحات الإدارة | ملخص يومي للمبيعات والهوامش | سحب مجدول للبيانات | حدود عدد الطلبات المسموح بها |
مثال من عملنا: البيع على سلة والتفعيل في منصة خارجية
في منصة الخطط التربوية الفردية التي بنيناها لمعلمي التربية الخاصة، تُباع الاشتراكات عبر متجر على سلة ثم تُفعّل داخل المنصة. هذا هو نمط "تفعيل خدمة رقمية": سلة تتولى صفحة البيع والدفع، والمنصة تتولى الخدمة نفسها. التحدي الحقيقي في هذا النمط ليس الاتصال التقني، بل مطابقة المشتري بحسابه في المنصة، والتعامل مع حالات الإلغاء والاسترداد بوضوح.
ربط سلة مع نظام محاسبي: قرارات يجب حسمها قبل البرمجة
ربط المحاسبة هو الطلب الأكثر شيوعًا، وهو أيضًا الأكثر حساسية لأن أي خطأ يظهر في الإقرارات لا في الشاشة.
من يصدر الفاتورة الضريبية؟
حدد نظامًا واحدًا يصدر الفاتورة الضريبية الرسمية لكل طلب، ولا تسمح لنظامين بإصدارها للعملية نفسها. هذا مهم أكثر مع المرحلة الثانية من الفوترة الإلكترونية التي تطبقها هيئة الزكاة والضريبة والجمارك على موجات، وتتطلب ربط برنامج الفوترة بمنصة فاتورة. فبحسب إعلان الهيئة كما نقلته EY، تشمل الموجة 25 المكلفين الذين تتجاوز إيراداتهم الخاضعة للضريبة 187,500 ريال في أي من الأعوام 2022 إلى 2025، وموعد الربط 1 فبراير 2027. تحقق من الإشعار الخاص بمنشأتك في موقع الهيئة.
كيف تُعامل الحالات غير السعيدة؟
اتفق مسبقًا على ما يحدث عند الإلغاء، والاسترداد الجزئي، وتعديل الطلب بعد الدفع، والشحن على دفعات، ورسوم الشحن والخصومات وأكواد الكوبونات. هذه الحالات هي التي تكشف جودة الربط، لا الطلب العادي.
كيف تجعل الربط موثوقًا لا هشًّا؟
الربط الذي يعمل في العرض التجريبي قد يتعطل في موسم التخفيضات. اطلب من المطور هذه الضمانات بالاسم:
- معالجة الحدث مرة واحدة: إذا وصل الإشعار نفسه مرتين، لا يُنشأ قيدان.
- طابور وإعادة محاولة: عند تعطل النظام المحاسبي مؤقتًا، تنتظر العمليات ثم تُعاد تلقائيًا.
- التحقق من مصدر الإشعار: يرفض الخادم أي إشعار لا يحمل علامة التحقق التي توثقها سلة.
- سجل لكل عملية: ماذا وصل، ومتى، وما النتيجة.
- تقرير مطابقة يومي: يقارن طلبات سلة بما سُجل في النظام الآخر، وينبه إلى أي فرق.
- تنبيه عند الفشل: رسالة لفريقك بدل أن يكتشف المحاسب المشكلة بعد شهر.
وتذكّر أن بيانات العملاء تنتقل بين الأنظمة. نظام حماية البيانات الشخصية في السعودية، الذي تشرف عليه سدايا وأصبح نافذًا منذ سبتمبر 2024، يفرض ضمانات أمنية وشروطًا على نقل البيانات خارج المملكة، فانتبه إلى مكان استضافة خادم الربط، واستشر مختصًا قانونيًا عند الحاجة.
قالب متطلبات ربط سلة: انسخه وأرسله للمطور
اسم المتجر ورابطه:
النظام المراد الربط معه (الاسم والإصدار، وهل لديه API موثقة؟):
اتجاه المزامنة لكل نوع بيانات (طلبات / منتجات / مخزون / عملاء):
النظام المرجعي لكل نوع بيانات:
الأحداث التي تبدأ المزامنة (طلب مدفوع، تغير حالة، تعديل منتج...):
التأخير المقبول (فوري / كل ساعة / يومي):
الحالات الخاصة (استرداد، إلغاء، شحن جزئي، كوبونات):
من يصدر الفاتورة الضريبية:
من يستلم تنبيهات الفشل:
متجر تجريبي للاختبار متوفر؟ نعم / لا
تكلفة ربط متجر سلة بنظام: ما الذي يحددها؟
تعتمد التكلفة على عدد الأنماط المطلوبة، وجودة الواجهة البرمجية للنظام الآخر، وعدد الحالات الخاصة، ومتطلبات التقارير والمراقبة. ربط باتجاه واحد لنوع بيانات واحد أبسط كثيرًا من مزامنة مخزون باتجاهين بين عدة مستودعات.
للتوضيح فقط: ربط الطلبات المدفوعة بنظام محاسبي يملك API موثقة، مع طابور ومطابقة يومية، قد يُقدّر بـ 80 ساعة × سعر افتراضي قدره 100 ريال للساعة = 8,000 ريال. هذا مثال لطريقة الحساب لا عرض سعر، والتقدير الحقيقي يأتي بعد مراجعة النظامين. أضف إليه تكلفة الاستضافة والمتابعة الشهرية، لأن الربط يحتاج صيانة كلما تغيرت واجهة أحد الطرفين.
في PIXELSAA نبني هذا النوع من الأعمال ضمن خدمة الأنظمة المخصصة والواجهات البرمجية باستخدام Laravel، ونربط المتجر بالأنظمة التي يختارها التاجر. وإذا كان المخزون هو نقطة الألم الأساسية لديك، فقد يفيدك مقال نظام إدارة المخازن، وإذا كانت الواجهة نفسها تحتاج تحسينًا فاقرأ دليل تصميم متجر إلكتروني على سلة.
الأسئلة الشائعة
هل تسمح سلة بربط المتجر بنظام خارجي؟
نعم، توفر سلة للمطورين بوابة شركاء لإنشاء التطبيقات، وآلية OAuth لأخذ إذن التاجر، وإشعارات آلية عند وقوع الأحداث، وواجهة API لقراءة البيانات وتحديثها. تفاصيل الصلاحيات والأحداث وحدود الاستخدام موجودة في وثائق المطورين الرسمية، ويجب أن يبني المطور عليها مباشرة لأنها قد تتغير بين الإصدارات.
هل أحتاج إلى نشر التطبيق في متجر تطبيقات سلة؟
ليس بالضرورة. إذا كان الربط لمتجرك فقط، فقد يكفي تطبيق خاص بك بحسب الخيارات التي تتيحها بوابة الشركاء. أما إذا أردت بيع الحل لتجار آخرين، فستحتاج إلى نشره في متجر التطبيقات واجتياز مراجعة سلة. راجع الوثائق الحالية لمعرفة متطلبات كل خيار قبل بدء التطوير.
كم يستغرق ربط سلة مع نظام محاسبي؟
يعتمد ذلك على جاهزية النظام المحاسبي ووجود API موثقة لديه، وعلى عدد الحالات الخاصة كالاسترداد والشحن الجزئي. المراحل المعتادة هي تحليل البيانات وربط الحقول، ثم البناء، ثم الاختبار على متجر تجريبي، ثم التشغيل مع مراقبة لأسابيع. اطلب من المطور جدولًا زمنيًا مكتوبًا لكل مرحلة بدل رقم إجمالي.
ماذا يحدث إذا تعطل الربط في موسم التخفيضات؟
الربط الجيد لا يفقد البيانات عند التعطل. يجب أن تُحفظ الإشعارات في طابور وتُعاد معالجتها تلقائيًا عند عودة النظام، مع منع التكرار وتنبيه فريقك فورًا. ويكشف تقرير المطابقة اليومي أي طلب لم يُسجّل. اختبر هذه السيناريوهات قبل المواسم الكبرى مثل رمضان واليوم الوطني.
ابدأ بربط واحد يوفر وقت فريقك
إذا كان فريقك يقضي ساعات في نقل بيانات متجر سلة يدويًا، أرسل لنا قالب المتطلبات بعد تعبئته، وسنراجع النظامين ونقترح نمط الربط المناسب ومراحل تنفيذه وتقديرًا مبنيًا على نطاقك الفعلي.
