تتبّع الطرود

الغرض ونية المستخدم: يحل الأداة تتبّع طرود عبر عدة شركات شحن لسلاسل العمل وتدفقات الدعم. تقبل رقم تتبّع واحد أو أكثر مع معرّفات شركات الشحن الاختيارية لاسترداد الحالة الحالية، والمكان وETA. تُستخدم في تنفيذ التجارة الإلكترونية، مخططي اللوجستيات وموظفي الدعم لتقديم تحديثات دقيقة للعملاء أو تغذية لوحات معلومات في النظام، خصوصًا حين تكون هناك حاجة إلى رؤية موحدة عبر الشركات. المنطق الأساسي والسمات: القدرات الأساسية تشمل تطبيع المدخلات، ربط الشاحنات وتنسيق API لاسترداد الحالة في الوقت الفعلي من شركات الشحن أو مجمّعات البيانات. الوظائف الأساسية: بحث متعدد الأرقام، مخطط خروج موحد، التحقق من المدخلات ومراقبة حدّ البيانات. وظائف اختيارية/متقدمة: معالجة دفعات مع قيود سرعة، التخزين المؤقت، إشعارات webhook وتنسيقات تصدير (JSON/CSV) مع دعم التوطين.
المدخلات والمخرجات: مدخلات تشمل tracking_numbers (مصوفة نصوص، مطلوبة)، carriers (مصوفة اختيارية أو mapping)، include_eta (قيمة منطقية، افتراضي true)، locale (اختياري). مخرجات هي shipments (مصوفة كائنات) تحتوي على: tracking_number، carrier، status، location، timestamp، eta، history (مصوفة أحداث). قواعد التحقق: تأكيد tracking_numbers غير فارغة ومعرّفات carriers المعروفة إذا زُوِّدت. تواريخ ISO 8601 للمخرجات.
الخوارزميات والحسابات: يستخدم الأداة استدعاءات REST API إلى carriers أو aggregators مع مهلات وسياسات إعادة المحاولة. قواعد ETA: استخدام ETA المقدم من carrier عند التوفر؛ وإلا تقدير بناءً على أوقات عبور مسار محدد وآخر حدث. توحيد الحالات: تحويل حالات carrier إلى تصنيف موحّد (In Transit, Out for Delivery, Delivered, Exception, Pending).
الأخطاء والحالات الحدّيّة: مدخلات غير صحيحة، carriers غير معروفة أو مدخلات ناقصة تولّد أخطاء تحقق. النتائج الجزئية لها رموز خطأ لكل شحنة عند عدم إمكانية الوصول إلى carrier. مهلات الاستعلام، حدود المعدّل أو فشل API تؤدي إلى retry أو fallback إلى أحدث بيانات متاحة.
الصناعة/الإقليم والتوطين: المعايير ISO 8601، التوقيت العالمي UTC وتصنيف حالة موحد. تغطية عالمية؛ تنسيقات البيانات وفق ممارسات الصناعة. حماية البيانات متوافقة مع GDPR وممارسات إقليمية؛ العملة غير مطبقة. الافتراضات والاستثناءات: يفترض الوصول إلى APIs لدى carriers أو aggregators مخولين؛ لا يوجد واجهة مستخدم؛ البيانات عند عدم التوفر تُشار إليها؛ لا يوجد بث حيّ؛ يستبعد منطق التوجيه الداخلي أو بيانات المخزون.