Saudi Shipping

الشحن والتوصيل في السعودية

دليل شامل لشركات الشحن والتوصيل المتاحة في المملكة العربية السعودية.

نظرة عامة

سمسا (SMSA Express)

الإعداد

1. تواصل مع سمسا للحصول على passKey
2. اضبط المتغير: export SMSA_PASSKEY=your_passkey

إنشاء شحنة

curl -s -X POST "http://track.smsaexpress.com/SECOM/SMSAwebService.asmx" \
  -H "Content-Type: text/xml; charset=utf-8" \
  -H "SOAPAction: http://track.smsaexpress.com/seabornesecom/addShipment" \
  -d '<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ser="http://track.smsaexpress.com/seabornesecom">
  <soap:Body>
    <ser:addShipment>
      <ser:passKey>'$SMSA_PASSKEY'</ser:passKey>
      <ser:refNo>ORDER_123</ser:refNo>
      <ser:sentDate>2026-03-26</ser:sentDate>
      <ser:idNo></ser:idNo>
      <ser:cName>محمد أحمد</ser:cName>
      <ser:cntry>SA</ser:cntry>
      <ser:cCity>الرياض</ser:cCity>
      <ser:cAddr1>حي النرجس، شارع الأمير تركي</ser:cAddr1>
      <ser:cMobile>0500000000</ser:cMobile>
      <ser:shipType>DLV</ser:shipType>
      <ser:PCs>1</ser:PCs>
      <ser:cEmail>test@example.com</ser:cEmail>
      <ser:codAmt>0</ser:codAmt>
      <ser:weight>1</ser:weight>
    </ser:addShipment>
  </soap:Body>
</soap:Envelope>'

تتبع شحنة

curl -s -X POST "http://track.smsaexpress.com/SECOM/SMSAwebService.asmx" \
  -H "Content-Type: text/xml; charset=utf-8" \
  -H "SOAPAction: http://track.smsaexpress.com/seabornesecom/getTracking" \
  -d '<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ser="http://track.smsaexpress.com/seabornesecom">
  <soap:Body>
    <ser:getTracking>
      <ser:passKey>'$SMSA_PASSKEY'</ser:passKey>
      <ser:awbNo>AWB_NUMBER</ser:awbNo>
    </ser:getTracking>
  </soap:Body>
</soap:Envelope>'

حالة الشحنة

curl -s -X POST "http://track.smsaexpress.com/SECOM/SMSAwebService.asmx" \
  -H "Content-Type: text/xml; charset=utf-8" \
  -H "SOAPAction: http://track.smsaexpress.com/seabornesecom/getStatus" \
  -d '<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ser="http://track.smsaexpress.com/seabornesecom">
  <soap:Body>
    <ser:getStatus>
      <ser:passKey>'$SMSA_PASSKEY'</ser:passKey>
      <ser:awbNo>AWB_NUMBER</ser:awbNo>
    </ser:getStatus>
  </soap:Body>
</soap:Envelope>'

أرامكس (Aramex)

الإعداد

1. سجّل في: https://www.aramex.com/developers
2. احصل على بيانات الحساب (AccountNumber, AccountPin, AccountEntity, AccountCountryCode)
3. اضبط المتغيرات:

export ARAMEX_USERNAME=your_email
export ARAMEX_PASSWORD=your_password
export ARAMEX_ACCOUNT_NUMBER=your_account
export ARAMEX_ACCOUNT_PIN=your_pin
export ARAMEX_ACCOUNT_ENTITY=your_entity

إنشاء شحنة

curl -s -X POST "https://ws.aramex.net/ShippingAPI.V2/Shipping/Service_1_0.svc/json/CreateShipments" \
  -H "Content-Type: application/json" \
  -d '{
    "ClientInfo": {
      "UserName": "'$ARAMEX_USERNAME'",
      "Password": "'$ARAMEX_PASSWORD'",
      "AccountNumber": "'$ARAMEX_ACCOUNT_NUMBER'",
      "AccountPin": "'$ARAMEX_ACCOUNT_PIN'",
      "AccountEntity": "'$ARAMEX_ACCOUNT_ENTITY'",
      "AccountCountryCode": "SA",
      "Version": "v1.0"
    },
    "Shipments": [{
      "Shipper": {
        "Reference1": "ORDER_123",
        "AccountNumber": "'$ARAMEX_ACCOUNT_NUMBER'",
        "PartyAddress": {
          "Line1": "شارع العليا",
          "City": "Riyadh",
          "CountryCode": "SA"
        },
        "Contact": {
          "PersonName": "المتجر",
          "PhoneNumber1": "0110000000",
          "CellPhone": "0500000000",
          "EmailAddress": "shop@example.com"
        }
      },
      "Consignee": {
        "PartyAddress": {
          "Line1": "حي النرجس",
          "City": "Riyadh",
          "CountryCode": "SA"
        },
        "Contact": {
          "PersonName": "محمد أحمد",
          "PhoneNumber1": "0500000000",
          "CellPhone": "0500000000",
          "EmailAddress": "customer@example.com"
        }
      },
      "Details": {
        "NumberOfPieces": 1,
        "ActualWeight": {"Value": 1, "Unit": "KG"},
        "ProductGroup": "DOM",
        "ProductType": "ONP",
        "PaymentType": "P"
      }
    }]
  }'

تتبع شحنة

curl -s -X POST "https://ws.aramex.net/ShippingAPI.V2/Tracking/Service_1_0.svc/json/TrackShipments" \
  -H "Content-Type: application/json" \
  -d '{
    "ClientInfo": {
      "UserName": "'$ARAMEX_USERNAME'",
      "Password": "'$ARAMEX_PASSWORD'",
      "AccountNumber": "'$ARAMEX_ACCOUNT_NUMBER'",
      "AccountPin": "'$ARAMEX_ACCOUNT_PIN'",
      "AccountEntity": "'$ARAMEX_ACCOUNT_ENTITY'",
      "AccountCountryCode": "SA",
      "Version": "v1.0"
    },
    "Shipments": ["AWB_NUMBER"]
  }'

حساب تكلفة الشحن

curl -s -X POST "https://ws.aramex.net/ShippingAPI.V2/RateCalculator/Service_1_0.svc/json/CalculateRate" \
  -H "Content-Type: application/json" \
  -d '{
    "ClientInfo": {
      "UserName": "'$ARAMEX_USERNAME'",
      "Password": "'$ARAMEX_PASSWORD'",
      "AccountNumber": "'$ARAMEX_ACCOUNT_NUMBER'",
      "AccountPin": "'$ARAMEX_ACCOUNT_PIN'",
      "AccountEntity": "'$ARAMEX_ACCOUNT_ENTITY'",
      "AccountCountryCode": "SA",
      "Version": "v1.0"
    },
    "OriginAddress": {"City": "Riyadh", "CountryCode": "SA"},
    "DestinationAddress": {"City": "Jeddah", "CountryCode": "SA"},
    "ShipmentDetails": {
      "NumberOfPieces": 1,
      "ActualWeight": {"Value": 1, "Unit": "KG"},
      "ProductGroup": "DOM",
      "ProductType": "ONP",
      "PaymentType": "P"
    }
  }'

ناقل إكسبريس (Naqel Express)

الإعداد

1. تواصل مع ناقل للحصول على بيانات SOAP API
2. واجهة SOAP — إنشاء بوليصة شحن (AWB) وتتبع

إنشاء بوليصة شحن (AWB)

curl -s -X POST "https://api.naqelexpress.com/NaqelAPIService/NaqelAPIService.svc" \
  -H "Content-Type: text/xml; charset=utf-8" \
  -H "SOAPAction: http://tempuri.org/INaqelAPIService/AddWaybill" \
  -d '<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:tem="http://tempuri.org/">
  <soap:Body>
    <tem:AddWaybill>
      <tem:clientId>YOUR_CLIENT_ID</tem:clientId>
      <tem:password>YOUR_PASSWORD</tem:password>
      <tem:consigneeName>محمد أحمد</tem:consigneeName>
      <tem:consigneeCity>الرياض</tem:consigneeCity>
      <tem:consigneeMobile>0500000000</tem:consigneeMobile>
      <tem:pieces>1</tem:pieces>
      <tem:weight>1</tem:weight>
      <tem:codAmount>0</tem:codAmount>
      <tem:refNo>ORDER_123</tem:refNo>
    </tem:AddWaybill>
  </soap:Body>
</soap:Envelope>'

تتبع شحنة

curl -s -X POST "https://api.naqelexpress.com/NaqelAPIService/NaqelAPIService.svc" \
  -H "Content-Type: text/xml; charset=utf-8" \
  -H "SOAPAction: http://tempuri.org/INaqelAPIService/TrackWaybill" \
  -d '<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:tem="http://tempuri.org/">
  <soap:Body>
    <tem:TrackWaybill>
      <tem:clientId>YOUR_CLIENT_ID</tem:clientId>
      <tem:password>YOUR_PASSWORD</tem:password>
      <tem:waybillNo>AWB_NUMBER</tem:waybillNo>
    </tem:TrackWaybill>
  </soap:Body>
</soap:Envelope>'

جي آند تي إكسبريس (J&T Express)

الإعداد

1. سجّل كشريك في: https://www.jtexpress.sa
2. احصل على apiAccount و privateKey
3. اضبط المتغيرات:

export JT_API_ACCOUNT=your_account
export JT_PRIVATE_KEY=your_key

إنشاء شحنة

المصادقة تتم عبر MD5 digest signing:

# حساب التوقيع
DIGEST=$(echo -n '{"orderNo":"ORDER_123"}'"$JT_PRIVATE_KEY" | md5)

curl -s -X POST "https://openapi.jet.co.id/jts-open-api/order/create" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "bizContent={\"orderNo\":\"ORDER_123\",\"senderName\":\"المتجر\",\"senderMobile\":\"0500000000\",\"senderAddress\":\"الرياض\",\"receiverName\":\"محمد أحمد\",\"receiverMobile\":\"0500000000\",\"receiverAddress\":\"جدة\",\"weight\":1,\"itemName\":\"طرد\"}" \
  -d "apiAccount=$JT_API_ACCOUNT" \
  -d "digest=$DIGEST" \
  -d "timestamp=$(date +%s)000"

تتبع شحنة

DIGEST=$(echo -n '{"billCodes":"AWB_NUMBER"}'"$JT_PRIVATE_KEY" | md5)

curl -s -X POST "https://openapi.jet.co.id/jts-open-api/trace/query" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "bizContent={\"billCodes\":\"AWB_NUMBER\"}" \
  -d "apiAccount=$JT_API_ACCOUNT" \
  -d "digest=$DIGEST" \
  -d "timestamp=$(date +%s)000"

بارق فليت (BARQ Fleet)

الإعداد

1. سجّل في: https://barqfleet.com
2. احصل على مفتاح API من لوحة التحكم
3. اضبط المتغير: export BARQ_API_KEY=your_key

إنشاء طلب توصيل

curl -s -X POST "https://api.barqfleet.com/v1/deliveries" \
  -H "Authorization: Bearer $BARQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup": {
      "address": "شارع العليا، الرياض",
      "latitude": 24.71,
      "longitude": 46.67,
      "contact_name": "المتجر",
      "contact_phone": "0500000000"
    },
    "dropoff": {
      "address": "حي النرجس، الرياض",
      "latitude": 24.80,
      "longitude": 46.63,
      "contact_name": "محمد أحمد",
      "contact_phone": "0500000000"
    },
    "description": "طرد صغير"
  }'

تتبع التوصيل

curl -s "https://api.barqfleet.com/v1/deliveries/DELIVERY_ID" \
  -H "Authorization: Bearer $BARQ_API_KEY"

البريد السعودي (SPL)

تتبع شحنة

التتبع متاح عبر الموقع الرسمي:

curl -s "https://api.splonline.com.sa/track/api/TrackingSearch?trackingNumber=AWB_NUMBER"

أو عبر الموقع: https://splonline.com.sa/ar/track-trace/

عرض النتيجة

🚚 تتبع الشحنة:

• شركة الشحن: [الشركة]
• رقم بوليصة الشحن: [AWB]
• الحالة: [تم الاستلام/قيد التوصيل/تم التسليم]
• المدينة الحالية: [المدينة]
• آخر تحديث: [التاريخ والوقت]
• المرسل: [الاسم]
• المستلم: [الاسم]

متى تستخدم

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

تنبيه

• أسعار الشحن تختلف حسب الوزن والمدينة ونوع الخدمة
• سمسا وأرامكس يدعمان الدفع عند الاستلام (COD)
• بارق متخصص في التوصيل داخل المدن (آخر ميل)
• تأكد من استخدام العنوان الوطني لدقة التوصيل

المراجع

• سمسا: https://www.smsaexpress.com
• أرامكس: https://www.aramex.com/developers
• ناقل: https://www.naqelexpress.com
• جي آند تي: https://www.jtexpress.sa
• بارق: https://barqfleet.com
• البريد السعودي: https://splonline.com.sa