واجهة REST API للبضائع الخطرة

ما تقوم به واجهة API

الإرساليات. تُنشئ واجهة REST API من DGAssistant بتنسيق JSON إرسالية البضائع الخطرة من نظام الإدارة أو النظام اللوجستي الخاص بكم، وتُعيد إقرار المرسِل وقائمة التحقق وعلامات الطرود بعد التحقق منها وفق اللائحة التنظيمية المنطبقة. ويحتفظ نظامكم بالبيانات التجارية، بينما يوفّر DGAssistant المعرفة التنظيمية والمستندات.

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

فتح مواصفات واجهة API للبضائع الخطرة

طريقتان للعمل: المعالجة بالدفعات والوضع التفاعلي

المعالجة بالدفعات. يحمل استدعاء واحد المواصفات الكاملة للإرسالية بجميع بضائعها. وهي الطريقة المخصصة لأنظمة الإدارة والأنظمة اللوجستية التي ترسل إرساليات كاملة مجمَّعة مسبقاً.

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

بيانات معرَّفة مسبقاً أو بيانات فورية

البيانات المعرَّفة مسبقاً. تُنشأ المنتجات والأطراف — المرسِلون والناقلون والمرسَل إليهم والقائمون بالتحميل والسائقون — مسبقاً، وتستخدم واجهة API رموزها. وهي أبسط طرق العمل والطريقة التي نوصي بها، لأن التصنيف التنظيمي يُحسم مرة واحدة ويُعاد استخدامه في كل إرسالية.

البيانات الفورية. تُعرَّف المنتجات والأطراف في الاستدعاء نفسه الذي يُنشئ الإرسالية. وتناسب هذه الطريقة الأنظمة التي لا تحتفظ بكتالوج خاص بها أو التي تشحن بضائع بصورة عرضية.

المستندات التي تُعيدها

تُعيد واجهة API المستندات نفسها التي يُصدرها التطبيق. وتُسترجَع مستندات الإرسالية وتجميع الإرساليات بصيغة PDF أو XLSX أو DOCX، ويمكن أيضاً إرسال مستندات الإرسالية بالبريد الإلكتروني من الخدمة نفسها؛ أما مستندات بوليصة النقل فبصيغة PDF.

• لكل إرسالية: مستند النقل الخاص باللائحة التنظيمية المنطبقة —مستند النقل وفق ADR، أو إقرار البضائع الخطرة الصادر عن المنظمة البحرية الدولية أو استمارة البضائع الخطرة المتعددة الوسائط (IMDG)، وإقرار المرسِل وفق IATA—، وقائمة التحقق، وعلامات الطرود بالحجم الكامل أو بحجم صغير مخصص، وفي النقل الجوي ورقة بيانات بوليصة الشحن الجوي.
• للإرسالية الرئيسية: بيان تجميع الإرساليات، وقائمة الحاويات، وقائمة التعبئة لكل وحدة، وكشف التحميل حسب المرسِل، وورقة بيانات المستند الرئيسي.
• لوحدة النقل: شهادة تعبئة الحاوية أو المركبة، واستمارة البضائع الخطرة المتعددة الوسائط، وتقرير الفصل الخاص بالوحدة، وقائمة التحقق قبل توقيع الشهادة، وملصق تجميع الإرساليات.
• للرحلة: بيان البضائع الخطرة، وتقرير الفصل بين الوحدات على متن وسيلة النقل، وتقرير حدّ الإعفاء وفق الفقرة 1.1.3.6 من ADR، وورقة قيود الرحلة، وكشف التحميل، وإخطار قائد الطائرة (NOTOC)، ومستند النقل المجمَّع للمركبة.
• لبوليصة النقل: المسودة، والنسخة الموقَّعة، ومستند النقل وفق ADR المرفق بها، وتقرير الإثبات.

ما تتحقق منه واجهة API

في الإرسالية. الفصل بين البضائع المنقولة معاً، وحدود الكمية في تعليمة التعبئة المنطبقة وفي نظامي الكميات المحدودة والمستثناة، وجواز نقل البضائع بواسطة النقل المعنية، وجواز استخدام العبوة، واكتمال الإقرار. وعندما لا يكون أمرٌ ما مطابقاً، تبيّن الاستجابة القاعدة غير المستوفاة والقيم المعنية، بحيث يمكن عرض الرسالة في تطبيقكم.

في تجميع الإرساليات. الفصل داخل وحدة النقل، والفصل بين الوحدات المحمَّلة في حركة النقل نفسها، وحساب حدّ 1.1.3.6 من ADR لحركة النقل مع تفصيله، وقيود الرحلة التي تُعاد في صورة بيانات، مثل رمز قيود الأنفاق أو وجود بضائع خطرة ذات عواقب وخيمة.

اللوائح التنظيمية وأنواع النقل المشمولة

ADR للنقل البري، وIMDG للنقل البحري، وIATA للنقل الجوي، و49 CFR. وتُدار اللوائح التنظيمية الرئيسية الثلاث معاً لا بوصفها وحدات منفصلة، بحيث لا يلزم إعداد الإرسالية من جديد إذا تغيّرت واسطة نقلها.

التعبئة المختلطة، والعبوات الجامعة، والصهاريج، والنقل السائب، والعبوات الفارغة غير المنظَّفة، والنفايات، ومتفجرات الرتبة 1 —مع كتلتها المتفجرة الصافية لكل طرد—، والمواد المشعة من الرتبة 7 مدعومة جميعها، بالبيانات التي يتطلبها كلٌّ منها. وتصدر نصوص المستندات بتسع عشرة لغة.

التوافر

تُتاح الخدمة في ثلاث مناطق — أوروبا والأمريكتان وآسيا والمحيط الهادئ — لكل منها عنوانها الخاص، بحيث يعمل التكامل مع المنطقة التي يوجد فيها الحساب. والبنية التحتية مزوّدة بأنظمة احتياطية وتخضع للمراقبة على مدار الساعة.

كيف تبدأون

اطلبوا تجربة مجانية لمدة أسبوعين، ومعها بيانات اعتماد الخدمة. وتعتمد المصادقة على OAuth 2.0 بأسلوب منح بيانات اعتماد العميل (client credentials): إذ يحصل نظامكم على رمز وصول ويرسله مع كل طلب.

المواصفات الكاملة منشورة بتنسيق OpenAPI، ويمكن قراءتها واستكشافها واستخدامها لتوليد عميل بلغة البرمجة التي تستخدمونها، قبل كتابة سطر واحد من شيفرة التكامل.