التكامل مع نظام IPS (IPS Integration)

مشغّل البريد لا يتابع البريد وحده. فكل مادة تعبر الحدود تعيش في IPS — نظام البريد الدولي الذي يتشاركه المشغّل مع مكاتب البريد التي يتبادل معها البريد. وتتحاور المستندات البريدية في وحدة الشحن مع ذلك النظام في الاتجاهين:

• القراءة. حين تكتب رقم كيس أو مادة بريدية في مستند بريدي، يسأل النظام IPS عمّا يعرفه — الوزن والنوع والمنشأ والمرسَل إليه — ويملأ السطر.
• التبليغ. حين تحفظ مستندًا بريديًا، يخبر النظام IPS بما حدث للتوّ لكل مادة فيه — "استُلمت في مكتب كذا"، "سُلِّمت للجمارك"، "سُلِّمت للعميل" — بإرسال حدث.

والتبليغ غير متزامن: حفظ المستند يضع الأحداث في طابور فقط، وعملية في الخلفية ترسلها. لذا قد يُحفَظ المستند سليمًا بينما تفشل أحداثه. تشرح هذه الصفحة كيف تضبط الاتصال، وما الذي يُرسَل، وأين تنظر حين لا يُظهر IPS ما تتوقعه.

الاتصال

افتح نظام إدارة الشحن ← الإعدادات ← إعدادات نظام إدارة الشحن، تبويب IPS Configurations:

الإعداد	ماذا يفعل
IPS Url	عنوان خدمة IPS. القراءة والأحداث كلاهما يذهب إليه.
IPS Token	رمز الوصول المرسَل مع كل استدعاء.
عدم إرسال الأحداث إلى نظام ال IPS	يوقف التبليغ كله. تُحفَظ المستندات عاديًا ولا يوضع أي حدث في الطابور. وتبقى القراءة عاملة. مفيد على نسخة تجريبية من قاعدة البيانات.
حقل كود المستخدم على IPS	معرّف حقل في سجل المستخدم (كحقل نصّي يحمل اسم دخول المستخدم على IPS). قيمته، للمستخدم الذي يحفظ المستند، تُرسَل مع كل حدث مادة بريدية على أنها المستخدم الفاعل.
حقل الجهاز على IPS	الشيء نفسه لمعرّف الجهاز.
Allowed Mail Item Prefix To Send To IPS	قائمة بادئات مفصولة بفواصل. إذا مُلئت لا يُبلَّغ إلا عن المواد التي يبدأ رقمها بإحداها، ويُتخطّى الباقي بصمت. والفراغ يعني كل المواد. أمّا الأكياس فيُبلَّغ عنها دائمًا.

القراءة من IPS

تحدث القراءة أثناء الكتابة:

• استلام الكيس — إدخال رقم الكيس في سطر يملأ وزن الكيس على IPS ورقم الختم وعدد المواد ونوع البريد.
• فرز الطرد توصيل / تخزين — إدخال رقم الكيس في الرأس يملأ عدد المواد بالكيس، الذي يقارنه الفرز بعد ذلك بالمواد التي تمسحها.
• كل مستند مواد بريدية — إدخال رقم المادة في سطر يملأ وزنها ونوع البريد والصنف والفئة وبلد المنشأ والقيمة والعملة وHS Code وRevised HS Code واسم المرسَل إليه وبيانات الاتصال به ووصف المحتوى.

وأمران جديران بالمعرفة. بلد المنشأ يُؤخذ من آخر حرفين في رقم المادة، فهكذا تُبنى أرقام البريد الدولي. وأي صنف أو نوع بريد أو فئة أو دولة أو عملة يعيدها IPS ولا توجد في نما بعد تُنشأ تلقائيًا بذلك الكود — فبعد الأسابيع الأولى من العمل تمتلئ تلك الملفات من تلقاء نفسها.

وفي فرز الطرد توصيل / تخزين يوقف تعليم عدم قراءة البيانات من ال IPS قراءة المواد، للعمل اليدوي حين يتعذّر الوصول إلى IPS.

التبليغ بالأحداث

ما الحدث

IPS Event (نظام إدارة الشحن ← الملفات ← IPS Event) ملف من كود واسم. كوده هو ما يفهمه IPS — كود حدث التتبّع البريدي المتّفق عليه مع IPS الخاص بك. أمّا اسمه فللبشر فقط.

يسمّي توجيه كل مستند بريدي الحدث الذي يبلّغ عنه، في حقله الإلزامي event — راجع توجيهات مستندات الشحن. عند أول حفظ للمستند يضع النظام مهمة في الطابور لكل سطر (وإعادة حفظه لاحقًا لا تبلّغ مرة أخرى — استخدم إعادة إرسال أحداث IPS لذلك):

• استلام الكيس ومستند إرسال الاكياس جدول الطريق يضعان مهمة تحديث حالة الكيس لكل كيس، تحمل كود الحدث رقمًا ومكتب مستلم في.
• مستندات المواد — مستند تجميع مواد ومنافيست للجمرك ومذكرة تحقيق بريد وسند تحويل بين المكاتب وسند تفريغ المخزن للجرد وإعادة التخزين وسند تسوية شحنة وفرز الطرد توصيل / تخزين — تضع مهمة تحديث حالة المادة لكل مادة، تحمل كود الحدث وبلد المنشأ والصنف، ومكتب مستلم في والمكتب التالي، وحقلَي المستخدم والجهاز المضبوطين أعلاه. ومذكرة التحقيق ترسل أيضًا سبب تحقيق المادة.

وكودا حدثين يحملان بيانات إضافية تُؤخذ من رأس المستند:

• 36 (عدم التسليم) — كودا سبب عدم التوصيل وإجراء عدم التوصيل.
• 37 (التسليم) — توقيع العميل واسم المستلم والرقم المدني.

ولذلك فإن فرز الطرد، الذي يحمل هذه الحقول، هو المستند الطبيعي لكليهما.

طابور المهام

كل حدث في الطابور يظهر في نظام إدارة الشحن ← الإعدادات ← IPS Integration Tasks. كل صف استدعاء واحد لـIPS:

العمود	المعنى
# المستند	المستند الذي وضع المهمة.
رقم الكيس أو المادة	المادة المعنيّة.
نوع المهمة	تحديث حالة المادة أو تحديث حالة الكيس.
الحالة	مبدئي أثناء الانتظار، وتم التنفيذ بعد أن يقبلها IPS، وفشل حين تُرفض أو يتعذّر إيصالها.
اخر حالة للمادة	نتيجة أحدث مهمة للمادة نفسها، مكرّرة على كل صفوف تلك المادة — مفيدة لتصفية المواد التي فشل آخر تبليغ عنها.
عدد محاولات	كم مرة جُرِّبت.
رسالة الخطأ / وصف الخطأ	سبب الفشل — خطأ IPS نفسه حين يردّ بخطأ.
Request JSON / Response JSON	ما أُرسل بالضبط وما عاد.
تاريخ الحدث وتاريخ التنفيذ ومحرر الطلب	متى وُضعت، ومتى نُفِّذت، ومن وضعها.

المهمة التي تفشل تُعلَّم فشل فورًا، ولا يُعاد تجريبها تلقائيًا — بل تنتظر من يعيد إرسالها.

إعادة الإرسال

من قائمة المهام، قائمة المزيد:

• إعادة إرسال السجلات المختارة — يعيد المهام الفاشلة المختارة إلى الطابور. ويُعاد بناء الطلب من المستند كما هو الآن، فالمستند المصحَّح يرسل بيانات مصحَّحة.
• حذف المهام المختارة — يحذف الصفوف المختارة.
• حذف المهام المنفذة — يمسح كل المهام المنفَّذة ليبقى الجدول قصيرًا. يعمل على دفعات وآمن مع القوائم الكبيرة.

ومن المستند نفسه — ومن شاشة قائمة كلٍّ من المستندات البريدية التسعة أعلاه — قائمة المزيد:

• إعادة إرسال مهام IPS التي فشل إرسالها فقط — يعيد إلى الطابور مهام المستند الفاشلة وحدها.
• إعادة إرسال أحداث IPS — يضع حدثًا جديدًا لـكل سطر في المستند أيًّا كان ما حدث قبل ذلك. استخدمه حين يفقد IPS الأحداث، أو بعد تغيير حدث التوجيه. واستخدمه بحذر: فـIPS يستلم الحدث مرة ثانية للمواد التي سبق التبليغ عنها.

قراءة الفشل

افتح الصف الفاشل واقرأ رسالة الخطأ أولًا؛ فهي في الغالب تسمّي المشكلة — كود حدث مجهول، مادة لا يعرفها IPS، كود مكتب يرفضه. أصلح الملف أو المستند، ثم إعادة إرسال السجلات المختارة. وإن فشلت كل المهام بخطأ اتصال، فراجع IPS Url وIPS Token.

التبليغ من أي مستند

الأحداث أعلاه مرتبطة بتوجيهات المستندات البريدية. وللتبليغ عن حدث من مستند آخر — مستند توصيل، أو نموذج مخصّص — استخدم الإجراء EAKWSendIPSEvents في مسار كيان. يقرأ جدول تفاصيل تسمّيه، ويأخذ رقم المادة من حقل تسمّيه، ويضع مهمة تحديث حالة المادة لكل سطر بكود الحدث وأكواد المكاتب التي تمرّرها مدخلاتٍ. ويخضع للإعدادات نفسها — عدم إرسال الأحداث إلى نظام ال IPS وتصفية البادئات — وتظهر مهامه في الجدول نفسه. مدخلاته موثّقة في EAKWSendIPSEvents.