الدرس 2 — الإجراءات المجدولة الثلاثة
يجعلكم الإلزام مُصدِرين ومستقبِلين معاً، ولا بد أن تعود حالة ما أصدرتموه من مكان ما. وتلك ثلاث حركات منفصلة، وقد أفردت الوحدة لكل واحدة منها إجراءً مجدولاً خاصاً بها.
وتأتي الثلاثة جميعاً معطّلة افتراضياً، ويفعّلها مدير بعد أن يصبح حساب المزوّد جاهزاً. وموضعها واحد: الإعدادات ← تقني ← الإجراءات المجدولة (Settings → Technical → Scheduled Actions).
| الإجراء المجدول | الاتجاه | ما ينقله | ما ترونه إن بقي معطّلاً |
|---|---|---|---|
| E-Invoice: dispatch outbox | صادر | المستندات المصطفّة إلى مزوّد الخدمة | تُنشأ المستندات ويُتحقَّق منها ثم لا تغادر أبداً |
| UAE E-Invoice: Poll ASP/FTA status | حالة واردة | نتيجة المزوّد والهيئة إلى مستندكم | تبقى المستندات في Sent، ولا يُقرأ شيء أبداً بوصفه مخلَّصاً |
| UAE E-Invoice: Fetch inbound documents | مستندات واردة | فواتير مورّديكم الإلكترونية إلى فواتير مسوّدة | لا تصل أي فواتير موردين واردة |
اقرأوا الصف الأوسط بتمعّن، فهو الذي يفاجئ الناس. فالإرسال والنتيجة وظيفتان مختلفتان يؤدّيهما إجراءان مختلفان. ووحدتكم هي الركن 1 من نموذج الأركان الخمسة: تسلّم المستند ثم تنتظر أن يُخبرها أحد. ولا شيء في نظامكم يعلم أن الهيئة خلّصت فاتورة إلى أن يسأل إجراء الاستطلاع ويُجاب.
وينتج عن ذلك وضع نصف مُعَدّ يمكن تشخيصه. فعّلوا المُرسِل وحده فيعمل كل شيء، إلى النقطة التي لا يعمل عندها: يغادر 400 مستند خلال أسبوعين، ويجلس كل واحد منها في Sent. ويُظهر تقرير الحالة عمود قيد الإرسال يتسلّق أسبوعاً بعد أسبوع وعمود مُبلَّغ ثابتاً عند صفر. ويبدو المشهد تماماً كمزوّد توقّف عن الإجابة. لكنه في الحقيقة مفتاح لم يفعّله أحد. والدرس 5 يعطيكم اختبار الدقيقتين الذي يفصل بين الحالتين، لكن معرفة وجود هذا الوضع هي نصف الطريق.
وللمستندات الواردة مسار ثانٍ. فالدليل يصفها بأنها تصل عندما يستقبل الكرون الوارد أو الـ webhook الاختياري مستنداً — وسرّ الـ webhook أحد حقول بيانات الاعتماد على حساب المزوّد، ولا يظهر إلا للمديرين. ولا يوثّق الدليل إعداد الـ webhook أبعد من ذلك الحقل، فإن كان مزوّدكم يتيح التسليم الفوري فاتفقوا معه على الإعداد، وعاملوا الإجراء المجدول بوصفه الترتيب الذي تستطيعون التحقق منه بأنفسكم.
وطريقة الفشل موثَّقة في قسم استكشاف الأخطاء في الدليل نفسه، بالصياغة التي يبلّغ بها العملاء تقريباً: تبقى المستندات في «Sent» ولا تصل فواتير الموردين الواردة أبداً. وللعَرَضين سبب واحد. فالإجراءان يأتيان معطّلين؛ وبعد أن يصبح حساب المزوّد جاهزاً، اطلبوا من مدير تفعيل UAE E-Invoice: Poll ASP/FTA status وUAE E-Invoice: Fetch inbound documents من الإعدادات ← تقني ← الإجراءات المجدولة (Settings → Technical → Scheduled Actions). فعّلوا الثلاثة في العصر نفسه، وتحقّقوا في صباح اليوم التالي من أن عمود «مُبلَّغ» بدأ يتحرّك.
الفكرة التي تحملونها معكم: ثلاثة مفاتيح، وثلاث بصمات فشل. لا شيء يُرسَل، لا شيء يُحدَّث، لا شيء يصل — كلٌّ منها يسمّي إجراءه المجدول.
التعليقات معطلة في هذه الدورة.