saudi-ecommerce

name	saudi-ecommerce
description	منصات التجارة الإلكترونية السعودية -- ربط مع سلة وزد ونون عبر API
version	1.0.0
author	Mousa Abu Mazin
license	MIT
platforms	["linux","macos"]
prerequisites	{"commands":["curl"],"env_vars":["SALLA_TOKEN","ZID_TOKEN","ZID_STORE_ID","NOON_TOKEN"]}
metadata	{"hermes":{"tags":["saudi","ecommerce","salla","zid","noon","store","orders","products"]}}

منصات التجارة الإلكترونية السعودية

دليل ربط واجهات API لأبرز منصات التجارة الإلكترونية في المملكة العربية السعودية.

نظرة عامة

المنصة	عدد التجار	المصادقة	التوثيق
سلة (Salla)	+68,000 تاجر	OAuth 2.0	docs.salla.dev
زد (Zid)	+8,000 تاجر	OAuth 2.0	docs.zid.sa
نون (Noon)	ماركت بليس	JWT	noon-docs.noonpartners.dev

سلة (Salla)

أكبر منصة تجارة إلكترونية سعودية -- أكثر من 68,000 تاجر.

الإعداد

1. سجّل كمطور شريك: https://salla.partners
2. أنشئ تطبيق OAuth في لوحة الشركاء
3. احصل على Access Token عبر OAuth 2.0
4. اضبط المتغير: export SALLA_TOKEN=your_access_token

Base URL: https://api.salla.dev/admin/v2

جلب المنتجات

curl -s "https://api.salla.dev/admin/v2/products" \
  -H "Authorization: Bearer $SALLA_TOKEN" \
  -H "Content-Type: application/json"

جلب منتج محدد

curl -s "https://api.salla.dev/admin/v2/products/PRODUCT_ID" \
  -H "Authorization: Bearer $SALLA_TOKEN" \
  -H "Content-Type: application/json"

جلب الطلبات

curl -s "https://api.salla.dev/admin/v2/orders" \
  -H "Authorization: Bearer $SALLA_TOKEN" \
  -H "Content-Type: application/json"

جلب طلب محدد

curl -s "https://api.salla.dev/admin/v2/orders/ORDER_ID" \
  -H "Authorization: Bearer $SALLA_TOKEN" \
  -H "Content-Type: application/json"

جلب العملاء

curl -s "https://api.salla.dev/admin/v2/customers" \
  -H "Authorization: Bearer $SALLA_TOKEN" \
  -H "Content-Type: application/json"

إنشاء Webhook

curl -s -X POST "https://api.salla.dev/admin/v2/webhooks" \
  -H "Authorization: Bearer $SALLA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "طلب جديد",
    "event": "order.created",
    "url": "https://example.com/webhooks/salla",
    "headers": {}
  }'

أحداث Webhook الشائعة

الحدث	الوصف
order.created	طلب جديد
order.updated	تحديث طلب
order.status.updated	تغيير حالة طلب
product.created	منتج جديد
product.updated	تحديث منتج
customer.created	عميل جديد
app.installed	تثبيت التطبيق

زد (Zid)

الإعداد

1. سجّل كشريك: https://partner.zid.sa
2. أنشئ تطبيق OAuth في بوابة الشركاء
3. احصل على Access Token عبر OAuth 2.0
4. اضبط المتغيرات:

export ZID_TOKEN=your_access_token
export ZID_STORE_ID=your_store_id

جلب المنتجات

curl -s "https://api.zid.sa/v1/products/" \
  -H "Authorization: Bearer $ZID_TOKEN" \
  -H "X-Manager-Token: $ZID_TOKEN" \
  -H "Store-Id: $ZID_STORE_ID" \
  -H "Content-Type: application/json" \
  -H "Accept-Language: ar"

جلب الطلبات

curl -s "https://api.zid.sa/v1/orders/" \
  -H "Authorization: Bearer $ZID_TOKEN" \
  -H "X-Manager-Token: $ZID_TOKEN" \
  -H "Store-Id: $ZID_STORE_ID" \
  -H "Content-Type: application/json" \
  -H "Accept-Language: ar"

جلب المخزون

curl -s "https://api.zid.sa/v1/inventory/" \
  -H "Authorization: Bearer $ZID_TOKEN" \
  -H "X-Manager-Token: $ZID_TOKEN" \
  -H "Store-Id: $ZID_STORE_ID" \
  -H "Content-Type: application/json"

تحديث مخزون منتج

curl -s -X PUT "https://api.zid.sa/v1/products/PRODUCT_ID/inventory/" \
  -H "Authorization: Bearer $ZID_TOKEN" \
  -H "X-Manager-Token: $ZID_TOKEN" \
  -H "Store-Id: $ZID_STORE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "quantity": 50
  }'

نون (Noon)

الإعداد

1. سجّل كبائع: https://seller.noon.com
2. احصل على JWT token من بوابة البائعين
3. اضبط المتغير: export NOON_TOKEN=your_jwt_token

جلب الطلبات

curl -s "https://api.noon.partners/seller/orders" \
  -H "Authorization: Bearer $NOON_TOKEN" \
  -H "Content-Type: application/json"

جلب طلب محدد

curl -s "https://api.noon.partners/seller/orders/ORDER_ID" \
  -H "Authorization: Bearer $NOON_TOKEN" \
  -H "Content-Type: application/json"

جلب المنتجات

curl -s "https://api.noon.partners/seller/products" \
  -H "Authorization: Bearer $NOON_TOKEN" \
  -H "Content-Type: application/json"

تحديث حالة التنفيذ (Fulfillment)

curl -s -X PUT "https://api.noon.partners/seller/orders/ORDER_ID/fulfill" \
  -H "Authorization: Bearer $NOON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "tracking_number": "AWB_NUMBER",
    "carrier": "aramex"
  }'

رفع منتج جديد

curl -s -X POST "https://api.noon.partners/seller/products" \
  -H "Authorization: Bearer $NOON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "product_name": "اسم المنتج",
    "brand": "العلامة التجارية",
    "category": "electronics",
    "price": 100.00,
    "quantity": 50,
    "description": "وصف المنتج"
  }'

عرض النتيجة

بيانات المتجر:

• المنصة: [سلة/زد/نون]
• عدد المنتجات: [العدد]
• عدد الطلبات: [العدد]
• إجمالي المبيعات: [المبلغ] ريال

تفاصيل الطلب:

• رقم الطلب: [الرقم]
• العميل: [الاسم]
• المبلغ: [المبلغ] ريال
• الحالة: [جديد/قيد المعالجة/تم الشحن/تم التسليم]
• المنتجات: [قائمة المنتجات]

متى تستخدم

• المستخدم يسأل عن التجارة الإلكترونية في السعودية
• يريد ربط متجره على سلة أو زد مع نظام خارجي
• يسأل عن API سلة أو زد أو نون
• يريد أتمتة إدارة الطلبات أو المنتجات
• يسأل "كيف أفتح متجر إلكتروني؟" أو "كيف أربط سلة مع نظامي؟"

مقارنة المنصات

الميزة	سلة	زد	نون
النوع	متجر مستقل	متجر مستقل	ماركت بليس
الباقة المجانية	نعم (محدودة)	نعم (محدودة)	لا (عمولة على البيع)
التخصيص	عالي	عالي	محدود
بوابات الدفع	مويسر، تاب، وغيرها	مويسر، تاب، وغيرها	نون Pay
الشحن	تكامل مع سمسا، أرامكس	تكامل مع سمسا، أرامكس	نون Express
العمولة	لا	لا	5-27% حسب الفئة
API	شامل	شامل	بائعين فقط

تنبيه

• سلة وزد يتطلبان تسجيل كشريك مطور للوصول إلى API
• نون يتطلب حساب بائع معتمد
• OAuth tokens تنتهي صلاحيتها -- تأكد من تجديدها
• احترم حدود الاستخدام (Rate Limits) لكل منصة

المراجع

• سلة: https://docs.salla.dev
• زد: https://docs.zid.sa
• نون: https://noon-docs.noonpartners.dev
• شركاء سلة: https://salla.partners
• شركاء زد: https://partner.zid.sa