Webhook – إرسال تحديثات حالة الطلب
في لوجستك نستخدم الويب هوكس لإرسال تحديثات حالة الطلب في نفس الوقت إلى أنظمة العملاء.
العميل يقدر يحدد رابط الويب هوك في نظامنا، وبنرسل له التحديثات لكل حالات الطلب.
📩 مثال للتحديثات اللي نرسلها
{
"waybill": "MACMSASAF000003044",
"SellerOrganizationCode": "AE",
"OrderNo": "",
"ShipNode": "Mahmoud Mohamed",
"ShipmentNo": "1008975850_20250518120507",
"Status": "PICKED_UP",
"StatusCode": 126,
"time_stamp": "2025-05-19 09:50:30.278287+00:00",
"scan_time": "2025-05-19 09:50:29.738086+00:00",
"scan_location": "LOGFUJ",
"items": [
{
"sku": 166813137,
"mode": "Manual",
"price": 45.0,
"quantity": 1,
"description": "تيشيرت بولو مقلم مقاس كبير بأكمام قصيرة - أزرق -",
"isExtraItem": false,
"total_quantity": 1
}
],
"remarks": "تم استلام الطلب المرتجع",
"additional_remarks": "تم الاستلام",
"additional_info": {
"pod_url": "https://example.com/lorem-ipsum/MACMSASAF000003044",
"otp": "",
"driver_details": {
"name": "P_TEX_NDD_FUJ_Rajeep Tamang",
"phone_number": 971562885041
}
},
"Source": "Logistiq"
}
✅ الرد المتوقع من نظام العميل
{
"status": true
}
⚠️ تأكد إن رابط الويب هوك متاح للعامة ويدعم طلبات
POSTبمحتوى JSON.
حالات الطلب
القائمة التالية توضح جميع حالات الطلب اللي نرسلها. ولسهولة التتبع، قسمناهم إلى شحنات مرسلة (Forward) و شحنات مسترجعة (Return).
حالات الشحنات (المرسلة)
| رقم الحالة | اسم الحالة | الوصف | اتجاه الشحنة |
|---|---|---|---|
| 101 | BOOKED | تم إنشاء الطلب. | مرسلة |
| 104 | CANCELLED | تم إلغاء الطلب قبل الاستلام. | مرسلة |
| 105 | PICKED_UP | تم استلام الشحنة من المصدر. | مرسلة |
| 106 | IN_HUB | الشحنة داخل المركز بوضع غير مخطط. | مرسلة |
| 107 | MANIFESTED | الشحنة مدرجة للإرسال. | مرسلة |
| 110 | INTRANSIT | في الطريق بين المراكز. | مرسلة |
| 111 | OUT_FOR_DELIVERY | خرجت مع المندوب. | مرسلة |
| 112 | DELIVERED | تم التوصيل. | مرسلة |
| 113 | PARTIALLY_RETURNED | جزء من الطلب تم إرجاعه. | مرسلة |
| 114 | RETURNED | الطلب بالكامل تم إرجاعه. | مرسلة |
| 115 | ON_HOLD | الشحنة موقفة مؤقتًا. | مرسلة |
| 116 | LOST | الشحنة ضاعت. | مرسلة |
| 117 | DAMAGED | الشحنة تالفة. | مرسلة |
| 118 | SHIPMENT_DELAYED | تأخير في التوصيل. | مرسلة |
| 119 | SHIPMENT_HELD | الشحنة موقفة بسبب مستندات أو عنوان. | مرسلة |
| 121 | NOT_SERVICEABLE | المنطقة غير مدعومة. | مرسلة |
| 122 | FAILED_DELIVERY | فشل التوصيل. | مرسلة |
| 147 | RTO_REQUESTED | تم طلب الإرجاع إلى المصدر. | مرسلة |
| 148 | RTO_OUT_FOR_DELIVERY | الإرجاع في الطريق للمصدر. | مرسلة |
| 149 | RTO_DELIVERED | تم توصيل المرتجع للمصدر. | مرسلة |
| 150 | RTO_FAILED | فشل في توصيل المرتجع. | مرسلة |
| 153 | RTO_INTRANSIT | مرتجع بالطريق. | مرسلة |
| 154 | OUT_FOR_PICKUP | المندوب في الطريق للاستلام. | مرسلة |
| 168 | RTO | إرجاع إلى المصدر. | مرسلة |
| 169 | RTO_SHIPMENT_DELAY | تأخير في إرجاع الشحنة. | مرسلة |
| 182 | HANDED_OVER_AT_ORIGIN_PORT | تم التسليم في ميناء المنشأ. | مرسلة |
| 183 | DEPARTED_FROM_ORIGIN_PORT | غادرت من ميناء المنشأ. | مرسلة |
| 184 | ARRIVED_AT_DESTINATION_PORT | وصلت إلى ميناء الوجهة. | مرسلة |
| 185 | CLEARED_FROM_DESTINATION_PORT | تم التخليص من ميناء الوجهة. | مرسلة |
| 186 | HELD_BY_CUSTOMS | محتجزة لدى الجمارك. | مرسلة |
| 187 | CONFISCATED_BY_CUSTOMS | تمت مصادرتها من الجمارك. | مرسلة |
| 188 | PROHIBITED_BY_CUSTOMS | محظورة من قبل الجمارك. | مرسلة |
| 189 | RE-EXPORT_BACK_TO_ORIGIN | معادة إلى بلد المنشأ. | مرسلة |
| 190 | AIRLINE_DELAY | تأخير من شركة الطيران. | مرسلة |
| 191 | LOST_AT_GATEWAY | فُقدت في مركز العبور. | مرسلة |
| 192 | DAMAGED_AT_GATEWAY | تضررت في مركز العبور. | مرسلة |
حالات الشحنات (المسترجعة)
| رقم الحالة | اسم الحالة | الوصف | اتجاه الشحنة |
|---|---|---|---|
| 124 | CREATED | تم إنشاء طلب الإرجاع. | مسترجعة |
| 125 | OUT_FOR_PICKUP | المندوب طالع لاستلام المرتجع. | مسترجعة |
| 126 | PICKED_UP | تم استلام المرتجع. | مسترجعة |
| 127 | INTRANSIT | المرتجع في الطريق. | مسترجعة |
| 128 | IN_HUB | المرتجع داخل المركز. | مسترجعة |
| 129 | MANIFESTED | مدرج للشحن للإرجاع. | مسترجعة |
| 130 | UNASSIGNED | لم يتم تعيين المندوب. | مسترجعة |
| 131 | ASSIGNED | تم تعيين المندوب. | مسترجعة |
| 132 | DELIVERED | تم توصيل المرتجع. | مسترجعة |
| 133 | RETURN_CANCELLED | تم إلغاء الإرجاع. | مسترجعة |
| 134 | ON HOLD | الإرجاع متوقف مؤقتًا. | مسترجعة |
| 135 | LOST | المرتجع ضاع. | مسترجعة |
| 136 | DAMAGED | المرتجع تالف. | مسترجعة |
| 137 | SHIPMENT_DELAYED | المرتجع تأخر. | مسترجعة |
| 138 | SHIPMENT_HELD | المرتجع موقوف. | مسترجعة |
| 139 | PICKUP_FAILED | فشل في استلام المرتجع. | مسترجعة |
| 140 | OUT_FOR_DELIVERY | في الطريق للتوصيل. | مسترجعة |
| 142 | UNMAPPED_RETURN | حالة غير معرفة. | مسترجعة |
| 144 | PICKUP_PENDING | بانتظار جدولة الاستلام. | مسترجعة |
| 152 | CONTACT_CUSTOMER_CARE | يحتاج تدخل من خدمة العملاء. | مسترجعة |
| 156 | RTO_CONACT_CUSTOMER_CARE | تواصل مع خدمة العملاء. | مسترجعة |
| 158 | AWB_REGISTERED | تم إصدار بوليصة الإرجاع. | مسترجعة |
| 160 | EXPIRED | الطلب المرتجع انتهى. | مسترجعة |
| 162 | EXCHANGE_PICKUP | مجدول للاستلام التبادلي. | مسترجعة |
| 164 | EXCHANGE_INTRANSIT | التبديل في الطريق. | مسترجعة |
| 166 | EXCHANGE_DELIVERED | تم توصيل التبديل. | مسترجعة |
| 167 | FAILED_DELIVERY | فشل التوصيل. | مسترجعة |
| 170 | NOT_SERVICEABLE | المنطقة غير مدعومة للإرجاع. | مسترجعة |