| name | saudi-shipping |
| description | الشحن والتوصيل في السعودية — تتبع شحنات وإنشاء بوالص شحن عبر شركات مثل سمسا وأرامكس وناقل. استخدم عندما يسأل المستخدم عن شحن أو تتبع طرد في السعودية. |
| version | 1.0.0 |
| author | Mousa Abu Mazin |
| license | MIT |
| platforms | ["linux","macos"] |
| prerequisites | {"commands":["curl"],"env_vars":["SMSA_PASSKEY","ARAMEX_USERNAME","ARAMEX_PASSWORD","ARAMEX_ACCOUNT_NUMBER","ARAMEX_ACCOUNT_PIN","ARAMEX_ACCOUNT_ENTITY","JT_API_ACCOUNT","JT_PRIVATE_KEY","BARQ_API_KEY"]} |
| metadata | {"hermes":{"tags":["arabic","saudi-shipping"]}} |
الشحن والتوصيل في السعودية
دليل شامل لشركات الشحن والتوصيل المتاحة في المملكة العربية السعودية.
نظرة عامة
| الشركة | النوع | التغطية | التواصل |
|---|
| سمسا (SMSA) | شحن سريع | محلي + دولي | 920009999 |
| أرامكس (Aramex) | شحن سريع | محلي + دولي | 920027447 |
| ناقل (Naqel) | شحن سريع | محلي | 920020505 |
| جي آند تي (J&T) | شحن اقتصادي | محلي | 8001111088 |
| بارق فليت (BARQ) | توصيل آخر ميل | محلي | barqfleet.com |
| البريد السعودي (SPL) | بريد حكومي | محلي + دولي | 920005700 |
سمسا (SMSA Express)
الإعداد
- تواصل مع سمسا للحصول على passKey
- اضبط المتغير:
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)
الإعداد
- سجّل في: https://www.aramex.com/developers
- احصل على بيانات الحساب (AccountNumber, AccountPin, AccountEntity, AccountCountryCode)
- اضبط المتغيرات:
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)
الإعداد
- تواصل مع ناقل للحصول على بيانات SOAP API
- واجهة 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)
الإعداد
- سجّل كشريك في: https://www.jtexpress.sa
- احصل على apiAccount و privateKey
- اضبط المتغيرات:
export JT_API_ACCOUNT=your_account
export JT_PRIVATE_KEY=your_key
إنشاء شحنة
المصادقة تتم عبر MD5 digest signing:
DIGEST=$(echo -n '{"orderNo":"ORDER_123"}'"$JT_PRIVATE_KEY" | md5sum)
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" | md5sum)
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)
الإعداد
- سجّل في: https://barqfleet.com
- احصل على مفتاح API من لوحة التحكم
- اضبط المتغير:
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)
- بارق متخصص في التوصيل داخل المدن (آخر ميل)
- تأكد من استخدام العنوان الوطني لدقة التوصيل
المراجع
