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

تشمل حلولنا كامل عروض UPS العالمية: UPS Worldwide Express وUPS Express Saver للشحنات العاجلة، وUPS Ground للتوصيل المحلي الاقتصادي، وUPS SurePost للطرود الخفيفة، وUPS Freight وAir Freight للشحنات الكبيرة، وخدمات UPS International للشحنات عبر الحدود. كما ندعم خيارات متخصصة مثل الحلول ذات التحكم في درجة الحرارة، وإدارة المرتجعات، والتخليص الجمركي. يمكن تفعيل أو تعطيل كل خدمة حسب احتياجاتك الإقليمية وحجم الطرود.

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

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

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

توفر واجهة تتبع UPS Tracking API نقاط نهاية للاستعلام عن شحنة واحدة، وتتبع دفعات متعددة، وسجل أحداث مفصل. تتضمن كل استجابة طوابع زمنية، وبيانات الموقع الجغرافي، ورموز الحالة، مما يمكنك من بناء لوحات تحكم في الوقت الحقيقي، وإرسال إشعارات، أو التكامل مع أنظمة CRM. تمنحك هذه الرؤية الكاملة القدرة على معالجة أي استثناءات في التسليم استباقيًا.

نعم — باستخدام UPS Label Recovery & Print API، يمكنك طلب الملصقات بصيغ PDF أو ZPL أو EPL مباشرةً من نظامك. ما عليك سوى تضمين معرف الشحنة والصيغة المطلوبة في مكالمة API، وستعيد UPS الملصق كسلسلة base64 أو رابط تنزيل. يمكنك بعد ذلك إرساله برمجيًا إلى الطابعة أو تضمينه في رسائل البريد الإلكتروني للعملاء. كما ندعم تخصيص الملصقات بإضافة الشعار وتعليمات المعالجة الخاصة.

يوفر UPS Rate API عروض أسعار فورية بناءً على المصدر والوجهة وأبعاد الطرد والوزن وخيارات الخدمة. بدمج هذه الواجهة في صفحة الدفع، يمكنك عرض تكاليف دقيقة لمستويات الخدمة المختلفة — Ground أو Express أو Freight — دون استعلامات يدوية. تتضمن الاستجابة تفصيلًا للرسوم الأساسية والرسوم الإضافية وأي خصومات متفق عليها للحصول على شفافية كاملة.

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

يدعم UPS المصادقة عبر OAuth2 المعتمدة على الرموز وكذلك بيانات WS-Security القديمة (Access Key وUsername وPassword). لأجل OAuth2، تستبدل بيانات العميل برمز وصول وتضمّنه في رأس Authorization. للخدمات القديمة عبر SOAP/XML، ترسل بيانات UPS في رأس WS-Security. نساعدك في إعداد آليات تجديد الرموز وتخزين بيانات الاعتماد وفق أفضل الممارسات.

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

تتيح واجهة UPS Notifications API تلقي POST-callbacks تلقائية عند تغيير حالة الشحنة — مثل “In Transit” أو “Delivered” أو “Exception”. تقوم بتسجيل عنوان URL للاستقبال وتحديد أنواع الأحداث المطلوبة. تتضمن كل إشعار توقيع HMAC للتحقق من المصدر. يتيح هذا النظام المبني على الدفع تحديث لوحات التحكم وتنبيه العملاء وتحديث المخزون في الوقت الحقيقي مع تقليل عمليات الاستطلاع.

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