تكامل FedEx هو اتصال سلس بين أنظمة عملك ومجموعة واجهات برمجة التطبيقات (API) الخاصة بـFedEx، مما يتيح لك أتمتة العمليات الأساسية مثل إنشاء الشحنات، والتتبع، والفوترة. من خلال تضمين خدمات FedEx مباشرة في تطبيقك، يمكنك التخلص من الإدخال اليدوي للبيانات وتقليل الأخطاء البشرية. يدعم هذا التكامل حساب الأسعار في الوقت الحقيقي، وإنشاء الملصقات المخصصة، والرؤية الشاملة لكل شحنة، مع لوحة تحكم موحدة تعرض التحديثات الحية للحالة.

تشمل حلولنا كامل عروض FedEx العالمية، مثل Express للشحنات العاجلة، وGround للمراسلات المحلية الاقتصادية، وFreight للبضائع الكبيرة أو المعبأة على لوح، وSmartPost للتسليم المشترك مع USPS، وInternational Priority للشحنات عبر الحدود بسرعة. كما ندعم خدمات متخصصة مثل Custom Critical للشحنات الحساسة للوقت أو الحرارة، وReturns لأتمتة عمليات الإرجاع. يمكن تفعيل أو تعطيل كل خدمة حسب متطلباتك.

تستغرق مشاريع تكامل FedEx النموذجية من 4 إلى 6 أسابيع، لكن الجدول الزمني الفعلي يعتمد على نطاق وتعقيد متطلباتك. نبدأ بمرحلة استكشاف لرسم خريطة سير العمل الحالي وتحديد نقاط واجهة برمجة التطبيقات المطلوبة، ثم نصمم ونطوّر طبقات التكامل بما في ذلك المصادقة وحساب الأسعار وإنشاء الملصقات. بعد اختبارات ضمان الجودة والمستخدم الدقيقة، ننشر أولاً على البيئة التجريبية ثم الإنتاج، مع تقديم التدريب والدعم طوال العملية.

للبدء بتكامل FedEx، ستحتاج إلى حساب مطور FedEx وبيانات الاعتماد اللازمة (Key، Password، رقم الحساب Account Number، ورقم العداد Meter Number). كما ينبغي توفير تفاصيل متطلبات الشحن—أبعاد الطرود، وحدات الوزن، ومستويات الخدمة الافتراضية. إذا كنت تخطط لأتمتة التصاريح الجمركية، سنحتاج إلى رموز النظام المنسق (HS) ومعلومات بلد المنشأ. وأخيراً، شارك متطلبات العلامة التجارية للملصقات أو الإشعارات لتكوينها أثناء التطوير.

يتيح لك Ship API إرسال بيانات الشحنة كاملة—عناوين المرسل والمستلم، أبعاد الطرد، الوزن، ونوع الخدمة—في طلب واحد. بعد التحقق، يعيد FedEx حمولة JSON تحتوي على معرف الشحنة، ورقم التتبع، ورابط أو سلسلة Base64 للملصق (PDF أو ZPL). يمكنك تضمين تعليمات خاصة أو متطلبات التوقيع. بعد ذلك، يمكنك توجيه البيانات إلى المستودع أو محطة الطباعة بسرعة.

يوفر Track API الخاص بـFedEx نقاط نهاية للتتبع الفردي والدفعي، بالإضافة إلى سجل الأحداث التفصيلي. تتضمن كل استجابة طوابع زمنية، وإحداثيات جغرافية، ورموز الحالة، مما يمكنك من إنشاء لوحات تحكم حية، وإرسال إشعارات للمستخدمين، والتكامل مع أنظمة CRM.

نعم—باستخدام Label Service endpoint، يمكنك طلب الملصقات بصيغ PDF أو ZPL أو EPL من نظامك مباشرة. أرسل معرف الشحنة والصيغة المطلوبة في الاستدعاء، ويعيد FedEx الملصق كسلسلة Base64 أو رابط تنزيل. يمكنك إرسالها إلى الطابعة أو تضمينها في رسائل البريد الإلكتروني للعملاء. نوفر أيضاً خيارات لتخصيص الملصق بالشعارات والرموز والإرشادات الخاصة.

يوفر FedEx Rate API عروض أسعار فورية بناءً على مصدر الشحنة، الوجهة، أبعاد الطرد، الوزن، وخيارات الخدمة. من خلال دمج هذه الواجهة في صفحة الدفع، يمكنك عرض تكاليف دقيقة لمستويات خدمة متعددة—اقتصادية، سريعة، أو شحن بضائع—مع تفاصيل عن الرسوم والخصومات المطبقة. يمكنك أيضاً تخزين مؤقت للطرق الشائعة لتحسين الأداء مع الحفاظ على حداثة البيانات.

تتيح لك نقطة نهاية Pickup Service طلب سائق FedEx لاستلام الشحنات من عنوان وزمن محددين. قدم تفاصيل الاستلام—التاريخ، الفترة الزمنية، عدد الطرود، والتعليمات الخاصة—في طلب JSON، ويؤكد FedEx برقم مرجعي. يمكنك الاستعلام عن الحالة أو تعديل الطلب إذا تغيرت الخطط، مما يضمن عدم تفويت أي جولة استلام وتقليل العبء الإداري.

يدعم FedEx المصادقة عبر OAuth2 القائمة على الرموز وطرق Key/Password التقليدية. لأجل OAuth2، تستبدل بيانات العميل برمز وصول تُضمّنه في رأس الطلب. للخدمات القديمة، تمرر مفتاح API وكلمة المرور في رأس HTTP. نساعدك في إعداد آليات تجديد الرمز الآمن وتخزين بيانات الاعتماد وفق أفضل الممارسات.

نعم—يوفر FedEx نهايات منفصلة للبيئات التجريبية والإنتاجية حتى تتمكن من اختبار التكامل دون التأثير على الشحنات الفعلية. في وضع الاختبار، يمكنك محاكاة إنشاء الشحنات، واستعلامات الأسعار، وأحداث التتبع دون إصدار ملصقات حقيقية. بعد التحقق، تنتقل إلى إعدادات الإنتاج بسلاسة بمساعدة فريقنا.

تسمح خدمة Webhook الخاصة بـFedEx بتلقي POST-callbacks آلية عند تغيير حالة الشحنة—مثل ‘In Transit’ أو ‘Delivered’ أو ‘Exception’. تسجل عنوان URL الخاص بك وتحدد أنواع الأحداث المرغوبة. تتضمن كل إشعار HMAC-signature في الرأس للتحقق من المصدر. هذا التصميم القائم على الدفع يمكّنك من تحديث لوحات التحكم وإرسال تنبيهات العملاء وتحديث المخزون في الوقت الفعلي.

تعتمد واجهات FedEx الحديثة على JSON كصيغة أساسية للإرسال والاستقبال، مما يسهل الدمج بأي لغة أو إطار عمل. يمكنك تحديد نوع المحتوى في رؤوس الطلب، ويقوم API بمعالجة البيانات تلقائياً. لدعم SOAP القديم، يتوفر XML أيضاً. طبقتنا للتكامل تُجرد هذه الاختلافات، لتتعامل دائماً مع واجهة JSON موحدة.