الدرس 2 — حساب ASP، وماذا تعني حالة Verified
المفتاح وحده لا يُرسل شيئاً. والحساب الذي تنشئونه في هذا الدرس هو الهوية التي ستسافر مستنداتكم تحتها.
الالتزام. يجري الإرسال عبر Peppol والإبلاغ بالبيانات الضريبية إلى الهيئة الاتحادية للضرائب عند الركن 2، ويؤديه مزوّد اعتمدته وزارة المالية. أما كيفية الاعتماد وكيفية وضع قائمة مختصرة للمزوّدين وما تسألونهم عنه فهو موضوع الدورة 3.1. ويبدأ هذا الدرس من اللحظة التي يرسل فيها مزوّدكم المختار بيانات الاعتماد.
النموذج الذهني. حساب ASP سجل في قاعدة بياناتكم يحمل اتصالاً واحداً، بمزوّد واحد، في بيئة واحدة. ويأتي «Generic REST ASP» جاهزاً في الوحدة، فيكون أمامكم ما تختارونه يوم إنشاء أول حساب دون بناء أي شيء. وإضافة مزوّد مختلف لاحقاً هي نموذج مُحوِّل جديد مع إدخال واحد في قائمة اختيار، دون أي تعديل على الكود الأساسي — وهي مهمة مُكامِل تُؤدى مرة واحدة ولا تلتقونها مجدداً في هذه الدورة.
مسار النقر. المحاسبة (Accounting) ← الإعدادات ← UAE E-Invoicing ← ASP Accounts ← جديد. املأوا الحقول أدناه ثم اضغطوا Test Connection.
| الحقل | ما يوضع فيه |
|---|---|
| Provider | المُحوِّل المستخدَم — ويأتي «Generic REST ASP» جاهزاً في الوحدة |
| Environment | Sandbox أو Production، بما يطابق بيانات الاعتماد الصادرة لكم |
| API Base URL | نقطة النهاية التي زوّدكم بها المزوّد |
| Participant ID | هويتكم على شبكة Peppol |
| API Key وSecret وClient ID وWebhook Secret | بيانات الاعتماد — تظهر للمديرين فقط |
Verified حالة يضعها البرنامج، لا حالة تدّعونها. فنجاح Test Connection يحوّل الحساب إلى Verified. وقبل ذلك لديكم سجل فيه بعض النصوص ولا دليل على أن أحداً في الطرف الآخر يجيب. نفّذوا الاختبار يوم وصول بيانات الاعتماد لا في أسبوع التشغيل الفعلي، لأن أكثر أمرين يقعان خطأً — عنوان أساسي كُتب خطأً، وبيانات اعتماد صدرت للبيئة الأخرى — تصحيحان صغيران حين تجدونهما في سبتمبر، وحادثتان حين تجدونهما في يناير.
ثم وجّهوا الشركة إليه. ارجعوا إلى الإعدادات ← المحاسبة ← الإعدادات العامة ← قسم UAE E-Invoicing، واختاروا الحساب المُوثَّق بوصفه Default ASP Account. فالمستند قد يحمل حسابه الخاص، لكن الافتراضي على مستوى الشركة هو ما يستخدمه كل ما سواه، وتركه فارغاً هو السبب الأشيع لرفض قاعدة بيانات مضبوطة ضبطاً سليماً أن تُرسل.
المثال التطبيقي. تتسلّم Marina Ridge بيانات اعتماد Sandbox من مزوّدها. تنشئ موظفة الذمم المدينة الحساب، وتضبط Environment على Sandbox، وتلصق API Base URL وParticipant ID. وهي لا ترى حقول بيانات الاعتماد أصلاً، فيلصق مدير مفتاح API وسرّه. ثم يضغط المدير Test Connection، فيظهر الحساب بحالة Verified، ويُختار بوصفه Default ASP Account في الإعدادات. تستغرق المهمة كلها جلسة واحدة، وتنتهي قبل أربعة أشهر من الحاجة إليها.
وضع الفشل. يفشل الإرسال برسالة «No ASP account is configured for company …». وهي تعني ما تقوله حرفياً: لا المستند ولا الشركة يملك حساباً. أنشئوا حساباً، وشغّلوا Test Connection حتى يظهر Verified، ثم اختاروه بوصفه Default ASP Account في الإعدادات. أما جاره القريب فيبدو مختلفاً وسببه مختلف — شاشة لا تحمل قائمة ASP Accounts أصلاً، أو حقول بيانات اعتماد غير موجودة ببساطة. وتلك مشكلة مجموعة صلاحيات لا مشكلة إعداد، ويعالجها الدرس 7.
التعليقات معطلة في هذه الدورة.