دليل تكامل زد
اربط متجر زد الخاص بك بـ ZaLinkAI ومكّن وكلاء الذكاء الاصطناعي من إدارة المنتجات والطلبات والعملاء.
مصادقة OAuth 2.0
يستخدم زد تدفق OAuth 2.0 ثلاثي الأطراف للتفويض الآمن للمتجر.
إعادة التوجيه إلى زد
أرسل التاجر إلى عنوان تفويض زد مع client_id و redirect_uri ومعامل state فريد لحماية CSRF.
التاجر يمنح الإذن
يراجع التاجر النطاقات المطلوبة (المنتجات، الطلبات، العملاء، webhooks، السلة) ويوافق على الوصول لمتجره.
استلام الـ Callback
يعيد زد التوجيه إلى redirect_uri الخاص بك مع رمز التفويض ومعامل state للتحقق.
استبدال بالرموز
أرسل رمز التفويض عبر POST إلى نقطة نهاية رموز زد للحصول على access_token و refresh_token. يتم تشفير الرموز وتخزينها بأمان.
قدرات المنصة
نظرة شاملة على ما يمكن لوكلاء الذكاء الاصطناعي القيام به من خلال تكامل زد.
كتالوج المنتجات
- مزامنة جميع المنتجات بالعربية والإنجليزية
- قراءة مستويات المخزون في الوقت الفعلي
- الوصول لمتغيرات المنتج والصور والأسعار
- تطابق الفئات والمجموعات
إدارة الطلبات
- استرجاع سجل الطلبات والتفاصيل
- تحديث حالة الطلب (معلق، تم الشحن، تم التسليم)
- معالجة الاسترداد والإلغاء
- الوصول لملاحظات الطلب ومعلومات التتبع
بيانات العملاء
- الوصول لملفات العملاء والشرائح
- عرض سجل المشتريات لكل عميل
- عنوان العميل ومعلومات الاتصال
- بيانات تقسيم RFM
إشعارات Webhook
- أحداث order.created و order.updated
- أحداث product.created و product.deleted
- أحداث customer.created و customer.updated
- إشعار app.uninstalled
السلة والدفع
- إنشاء وتعديل سلات التسوق
- إنشاء روابط دفع آمنة
- تطبيق أكواد الخصم
- حساب الشحن وضريبة القيمة المضافة
التوطين
- دعم عملات SAR و AED
- بيانات ثنائية اللغة عربي وإنجليزي
- ضريبة القيمة المضافة السعودية (15%) مسبقة الإعداد
- معالجة ضريبية متوافقة مع ZATCA
العملات المدعومة
ريال سعودي
المملكة العربية السعودية
درهم إماراتي
الإمارات العربية المتحدة
استكشاف الأخطاء
المشكلات الشائعة وحلولها عند التكامل مع زد.
invalid_grant
رمز التفويض منتهي الصلاحية أو تم استخدامه بالفعل.
أعد تشغيل تدفق OAuth. الرموز تستخدم مرة واحدة وتنتهي بعد 10 دقائق.
token_refresh_failed
رمز التحديث غير صالح أو ألغى التاجر الوصول.
اطلب من التاجر إعادة التفويض. يقوم ZaLinkAI بتحديث الرموز تلقائياً قبل 30 دقيقة من انتهاء الصلاحية.
scope_not_granted
لم يوافق التاجر على جميع الأذونات المطلوبة.
تحقق من النطاقات الممنوحة. أعد طلب التفويض بالنطاقات المطلوبة فقط.
webhook_delivery_failed
أعادت نقطة النهاية رمز حالة غير 2xx.
تأكد من أن عنوان webhook الخاص بك متاح للعامة ويعيد 200. يتم إعادة محاولة webhooks الفاشلة بتراجع أسي.