🔗 نظرة عامة على التكامل
ربط متجرك مع إسناد يسوّي جسر سلس بين قنوات البيع عندك وشبكة الإنجاز حقّتنا. الطلبات تنساب تلقائي، المخزون يتزامن لايف، والعملاء يستلمون تحديثات التتبّع—كل شي من دون تدخّل يدوي.
🛍️ تكامل شوبيفاي
شوبيفاي هو أسهل تكامل نقدّمه. مع أكثر من ٦٠٪ من متاجر التجارة الإلكترونية السعودية تستخدم شوبيفاي، حنّا خلّينا هالعملية شبه أوتوماتيكية.
تثبيت تطبيق شوبيفاي
تثبيت بضغطة واحدة من متجر تطبيقات شوبيفاي
الخطوات بالتفصيل:
- ١. الدخول لمتجر التطبيقات: ادخل على متجر تطبيقات شوبيفاي ودوّر على "ISNAAD Fulfillment"
- ٢. تثبيت التطبيق: اضغط "Add app" ووافق على الصلاحيات المطلوبة
- ٣. ربط الحساب: حط بيانات حساب التاجر حقّك في إسناد
- ٤. إعدادات المزامنة: اضبط تفضيلات مزامنة الطلبات وقواعد الإنجاز
- ٥. طلبات تجريبية: سوِّ طلبات تجريبية عشان تتأكّد إن التكامل شغّال زين
🇸🇦 إعدادات خاصة بالسوق السعودي:
- • فعّل دعم اللغة العربية لإشعارات العملاء
- • اضبط عملة الريال وحسابات الضريبة المحلية
- • نشّط التوافق مع طريقة دفع مدى
- • عدّل تقديرات وقت التوصيل لمناطق السعودية
🛍️ تكامل سلة
سلة واحدة من أشهر منصات التجارة الإلكترونية في السعودية، وتشغّل آلاف الأعمال المحلية. تكاملنا الأصلي يوفّر اتصال سلس مع دعم كامل للعربية وتحسين للسوق المحلي.
تكامل تطبيق سلة
تكامل أصلي مع المنصة المفضّلة في السعودية
خطوات التكامل:
- ١. متجر شركاء سلة: ادخل على سوق تطبيقات سلة ودوّر على "إسناد"
- ٢. تثبيت التطبيق: اضغط "تثبيت" ووافق على الصلاحيات
- ٣. ربط الحساب: اربط حساب التاجر حقّك في إسناد
- ٤. إعداد الإنجاز: اضبط مناطق التوصيل وقواعد المعالجة
- ٥. التشغيل المباشر: فعّل الإنجاز لمنتجاتك
🇸🇦 مميزات سلة:
- • واجهة عربية كاملة وتجربة عميل متكاملة
- • تكامل أصلي مع بوابات الدفع السعودية
- • امتثال تلقائي للفوترة الإلكترونية في هيئة الزكاة
- • تكامل تقويم الإجازات والمناسبات المحلية
- • دعم أسماء وأوصاف المنتجات بالعربي
🇸🇦 تكامل زد
زد منصة سعودية رائدة ثانية، معروفة بواجهتها السهلة والميزات الشاملة. تكاملنا يوفّر اتصال كامل مع تحسين للسوق المحلي.
تكامل زد الأصلي
مصمّم للسوق السعودي مع دعم كامل للعربي
خطوات التكامل:
- ١. لوحة تحكم زد: ادخل على لوحة الإدارة حقّتك في زد
- ٢. قسم التطبيقات: روح لـ "التطبيقات"
- ٣. تطبيق إسناد: دوّر وثبّت تطبيق إنجاز إسناد
- ٤. المصادقة: اتصل باستخدام حساب التاجر حقّك في إسناد
- ٥. الإعدادات: اضبط تفضيلات الإنجاز ومناطق التوصيل
🌟 مميزات زد:
- • واجهة عربية أصلية واتصالات العملاء
- • تكامل مدمج مع مدى و STC Pay
- • حسابات ضريبة القيمة المضافة التلقائية للامتثال الضريبي السعودي
- • تقديرات وقت التوصيل المحلي وتقاويم الإجازات
- • دعم أوصاف المنتجات العربية ورموز SKU
🔧 تكامل API مخصّص
للشركات اللي عندها منصات مبنية خصيصي أو متطلبات معيّنة، نقدّم تكامل REST API شامل. فريق التطوير حقّنا يشتغل مع فريقك بشكل وثيق عشان نضمن اتصال سلس.
تكامل REST API
وصول كامل للـ API للتطبيقات المخصّصة
نظرة عامة على نقاط النهاية:
Orders API
إرسال طلبات للإنجاز وتتبّع الحالة
GET /api/v1/orders/{order_id}
PUT /api/v1/orders/{order_id}/cancel
Inventory API
إدارة مستويات المخزون ومعلومات المنتج
POST /api/v1/inventory/update
GET /api/v1/inventory/{sku}
Webhooks
إشعارات فورية لتغييرات حالة الطلب
order.shipped, order.delivered, inventory.updated
⚡ أفضل ممارسات التكامل
اتبع هالممارسات المثبتة عشان تضمن إن تكاملك قوي، قابل للتوسّع، ومحسّن للسوق السعودي:
١. معالجة الأخطاء ومنطق إعادة المحاولة
طبّق معالجة صحيحة للأخطاء عشان تدير مشاكل الشبكة وحدود معدّل API:
try {
const response = await fetch('/api/v1/orders', {
method: 'POST',
headers: { 'Authorization': 'Bearer ' + apiKey },
body: JSON.stringify(orderData)
});
return await response.json();
} catch (error) {
if (retries > 0) return submitOrder(orderData, retries - 1);
throw error;
}
}
٢. أمان الـ Webhook
أمّن نقاط نهاية الـ webhook حقّتك عشان تمنع الوصول غير المصرّح:
🔒 قائمة فحص الأمان:
- • تحقّق من توقيعات webhook باستخدام HMAC-SHA256
- • استخدم نقاط نهاية HTTPS فقط (مطلوب للإنتاج)
- • طبّق تكرار العمليات لمعالجة webhooks المكرّرة
- • سجّل كل أحداث webhook للتصحيح ومسارات التدقيق
- • اضبط تنبيهات مراقبة لفشل تسليم webhook
🔍 اختبار التكامل حقّك
الاختبار الشامل يمنع المشاكل لمّا تبدأ التشغيل الفعلي. هذي قائمة الفحص الشاملة حقّتنا:
📝 اختبار تدفّق الطلبات
- ✓ طلبات بمنتج واحد
- ✓ طلبات بمنتجات متعدّدة
- ✓ طرق دفع مختلفة
- ✓ عناوين توصيل متنوّعة
- ✓ إلغاء الطلبات
- ✓ إنجاز جزئي
📊 اختبار مزامنة البيانات
- ✓ تحديثات مستوى المخزون
- ✓ مزامنة معلومات المنتج
- ✓ تحديثات حالة الطلب
- ✓ تسليم رقم التتبّع
- ✓ إشعارات العملاء
- ✓ معالجة المرتجعات
🚨 حل المشاكل الشائعة
حتى مع الإعداد المثالي، المشاكل ممكن تصير. هذي أكثر المشاكل الشائعة وحلولها:
❌ الطلبات ما تتزامن
الأعراض: الطلبات اللي تحطّها في متجرك ما تظهر في بوابة إسناد
الأسباب الشائعة:
- • عنوان URL للـ Webhook مو مضبوط صح
- • بيانات اعتماد API منتهية أو غلط
- • الجدار الناري يسدّ الطلبات الصادرة
- • حالة الطلب ما تشغّل قواعد الإنجاز
الحل: تحقّق من سجلات webhook في منصّتك، وتأكّد من بيانات اعتماد API في بوابة إسناد، وتأكّد إن قواعد الإنجاز مضبوطة صح.
❌ المخزون ما يتحدّث
الأعراض: مستويات المخزون في متجرك ما تعكس مخزون إسناد
الأسباب الشائعة:
- • عدم تطابق SKU بين المتجر وإسناد
- • مزامنة المخزون معطّلة في الإعدادات
- • مواقع مخزون متعدّدة تسبّب تعارضات
- • حد معدّل API يمنع التحديثات
الحل: تحقّق من تعيين SKU، فعّل مزامنة المخزون، دمج مواقع المخزون، وتحقّق من حدود معدّل API.
📱 تكامل تطبيق الموبايل
للشركات اللي عندها تطبيقات موبايل، إسناد توفّر SDKs للموبايل لـ iOS و Android، عشان تضمن إن عملاءك يحصلون على نفس التجربة السلسة عبر كل المنصات.
📱 iOS SDK
حزمة Swift لتطبيقات iOS
let fulfillment = ISNAADClient(apiKey: "your_key")
fulfillment.submitOrder(order) { result in
// معالجة الاستجابة
}
🤖 Android SDK
مكتبة Kotlin لتطبيقات Android
val client = ISNAADClient(apiKey)
client.submitOrder(order) { response ->
// معالجة الاستجابة
}
🎯 الإعدادات المتقدّمة
لمّا يشتغل تكاملك الأساسي، هالميزات المتقدّمة ممكن تحسّن عمليات الإنجاز حقّك:
قواعد الإنجاز الشرطية
اضبط قواعد لتوجيه الطلبات تلقائي بناءً على معايير مختلفة:
أمثلة القواعد:
- • الطلبات السريعة: الطلبات أكثر من ٥٠٠ ريال تحصل على توصيل نفس اليوم
- • التوجيه الإقليمي: طلبات الرياض تروح لمستودع الرياض
- • حسب المنتج: الإلكترونيات تحتاج معاملة خاصة
- • حسب الوقت: الطلبات بعد ٢ ظهر تُعالج اليوم التالي
خيارات التغليف المخصّصة
اضبط تغليف بعلامتك التجارية لأنواع طلبات مختلفة:
- • التغليف العادي: صناديق بعلامة إسناد للطلبات العادية
- • التغليف المميّز: صناديق بعلامتك التجارية للطلبات عالية القيمة
- • تغليف الهدايا: تغليف خاص لطلبات الهدايا
- • التغليف البيئي: مواد مستدامة للعملاء المهتمين بالبيئة
📊 مراقبة صحة التكامل
خلّي تكاملك يشتغل بسلاسة مع ممارسات المراقبة هذي:
مقاييس يومية
معدّل مزامنة الطلبات، وقت المعالجة، عدد الأخطاء
فحوصات الصحة
اختبارات تلقائية كل ١٥ دقيقة
التنبيهات
إشعارات فورية للمشاكل الحرجة
"التكامل كان سهل بشكل مفاجئ. المطوّر عندنا خلاّه يشتغل في أقل من ساعة، وما صار عندنا أي توقّف في ٨ أشهر تشغيل." - خالد العتيبي، المدير التقني لـ Fashion Forward KSA
🚀 قائمة فحص قبل البدء المباشر
قبل ما تحوّل للإنجاز الفعلي، تأكّد إن كل شي مضبوط صح: