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

الإرساليات. تُنشئ واجهة REST API من DGAssistant بتنسيق JSON إرسالية البضائع الخطرة من نظام الإدارة أو النظام اللوجستي الخاص بكم، وتُعيد إقرار المرسِل وقائمة التحقق وعلامات الطرود بعد التحقق منها وفق اللائحة التنظيمية المنطبقة. ويحتفظ نظامكم بالبيانات التجارية، بينما يوفّر DGAssistant المعرفة التنظيمية والمستندات.
تجميع الإرساليات. تغطي واجهة API أيضاً تجميع إرساليات عدة مرسِلين، على محوريه. المحور التعاقدي هو الإرسالية الرئيسية — حجزٌ، أو تجميع بحري أو جوي للإرساليات، أو شحنة مجمَّعة برية — بأطرافها ومراجعها والإرساليات الملحقة بها وانتقالات حالتها وسجلها. أما المحور المادي فهو معدات النقل (حاوية أو مركبة أو مقطورة أو وحدة تحميل ULD) وحركة النقل (رحلة بحرية أو رحلة جوية أو رحلة برية) بمحطات توقفها، إلى جانب السفن والمركبات والمواقع المسجلة في الحساب. ويُخصَّص أكثر من نصف الخدمة لهذا الجزء.
طريقتان للعمل: المعالجة بالدفعات والوضع التفاعلي
المعالجة بالدفعات. يحمل استدعاء واحد المواصفات الكاملة للإرسالية بجميع بضائعها. وهي الطريقة المخصصة لأنظمة الإدارة والأنظمة اللوجستية التي ترسل إرساليات كاملة مجمَّعة مسبقاً.
الوضع التفاعلي. تُفتح الإرسالية أولاً ثم تُضاف البضائع واحدة تلو الأخرى. وتحمل كل استجابة رسائل التحقق الخاصة بما أُضيف للتو، كي يتمكن تطبيقكم من عرضها على المستخدم في أثناء إعداد الإرسالية.
بيانات معرَّفة مسبقاً أو بيانات فورية
البيانات المعرَّفة مسبقاً. تُنشأ المنتجات والأطراف — المرسِلون والناقلون والمرسَل إليهم والقائمون بالتحميل والسائقون — مسبقاً، وتستخدم واجهة 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 مدعومة جميعها، بالبيانات التي يتطلبها كلٌّ منها. وتصدر نصوص المستندات بتسع عشرة لغة.
توافر واجهة API
تُتاح الخدمة في ثلاث مناطق — أوروبا والأمريكتان وآسيا والمحيط الهادئ — لكل منها عنوانها الخاص، بحيث يعمل التكامل مع المنطقة التي يوجد فيها الحساب. والبنية التحتية مزوّدة بأنظمة احتياطية وتخضع للمراقبة على مدار الساعة.
كيفية البدء في استخدام واجهة API
اطلبوا تجربة مجانية لمدة أسبوعين، ومعها بيانات اعتماد الخدمة. وتعتمد المصادقة على OAuth 2.0 بأسلوب منح بيانات اعتماد العميل (client credentials): إذ يحصل نظامكم على رمز وصول ويرسله مع كل طلب.
المواصفات الكاملة منشورة بتنسيق OpenAPI، ويمكن قراءتها واستكشافها واستخدامها لتوليد عميل بلغة البرمجة التي تستخدمونها، قبل كتابة سطر واحد من شيفرة التكامل.
أقسام مواصفات واجهة API
| القسم | |
|---|---|
| نظرة عامةتعريف بواجهة API وحدود استخدامها، مع ملفات المواصفات بصيغتي OpenAPI 3.0 و2.0 وفهرس جميع الأقسام. | فتح |
| المصادقةرموز وصول OAuth2 تُصدَر بأسلوب منح بيانات اعتماد العميل (client credentials)، بديلاً عن مصادقة HTTP Basic في كل العمليات التي تتطلب المصادقة. | فتح |
| فحوص الاتصالالتحقق من توافر واجهة API، ومن بيانات اعتماد مستخدم الواجهة، ومن الطلبات المرسلة مع المصادقة ومن دونها. | فتح |
| البيانات المرجعيةالبضائع الخطرة والنويدات المشعة، والعبوات وتعليمات التعبئة، والرموز والبلدان والمواقع التي تشير إليها الإرساليات والمنتجات وتجميع الإرساليات. | فتح |
| المنتجاتالمنتجات البسيطة ومنتجات التعبئة المختلطة في الفهرس، بما في ذلك الإنشاء التفاعلي لمنتج بتعبئة مختلطة لإرسالية ما. | فتح |
| الأطرافالأطراف المعرَّفة مسبقاً: المرسِلون والمرسَل إليهم والقائمون بالتحميل والناقلون والموردون والسائقون. | فتح |
| المركبات والمقطورات والسفنمركبات الحسابات ومقطوراتها وسفنها، مع رقم التسجيل وتصنيف المركبة وفق ADR ووثيقة الامتثال. | فتح |
| المواقع والقيودموانئ الحسابات ومطاراتها ومحطاتها، والقيود التي تسري عند التخطيط لمعدات نقل فيها أو تحميلها فيها. | فتح |
| الإرسالياتإنشاء إرسالية بكامل محتوياتها (المعالجة بالدفعات) أو بأول محتوى لها (الوضع التفاعلي)، واسترجاع الإرساليات وحذفها. | فتح |
| محتويات الإرساليةالمنتجات والتعبئات المختلطة والعبوات الجامعة التي تُضاف إلى إرسالية تُعالَج تفاعلياً أو تُزال منها. | فتح |
| مستندات الإرساليةمستندات الإرسالية (مستند النقل وقائمة التحقق وعلامات الطرود وغيرها)، وإرسالها بالبريد الإلكتروني، والمستندات المجمَّدة. | فتح |
| بوالص النقلبوالص النقل CMR والإلكترونية (e-CMR) والوطنية، من التحقق من شمول بروتوكول e-CMR للمسار إلى الإصدار والتسليم والإلغاء. | فتح |
| طلبات التجميعطلبات التجميع المقدَّمة من حسابات العملاء أو من مستشار السلامة لديهم نيابةً عنهم، وقرارات المجمِّع. | فتح |
| الإرساليات الرئيسيةالإرساليات الرئيسية مع إرسالياتها ومسار اعتمادها. | فتح |
| معدات النقلمعدات النقل ومحتوياتها وفحوص الفصل الخاصة بها وسجل تحركاتها. | فتح |
| عمليات النقل ومحطات التوقفالرحلات البحرية والجوية والبرية بمحطات توقفها ومعدات النقل فيها، وفحوص الفصل، وحساب حد الحمولة (ADR 1.1.3.6)، والقيود. | فتح |
| مستندات تجميع الإرسالياتمستندات الإرساليات الرئيسية ومعدات النقل وعمليات النقل. | فتح |
| Webhooksاشتراكات webhooks في الحساب، واختبارها، وعمليات التسليم الأخيرة. | فتح |