إنشاء وتوقيع وإرسال فاتورة إلكترونية في فاتورة

مسار المستند كاملاً: مسودة → جاهز للتوقيع → توقيع محلي → إرسال للمصلحة → تحديث الحالة → صالح/غير صالح، أرشيف PDF، والإلغاء على المصلحة.

حالات المستند في فاتورة: DRAFT → READY_TO_SIGN → SIGNED → SUBMITTED → VALID / INVALID (وCANCELLED عند الإلغاء على المصلحة).

المتطلبات

• إعدادات محفوظة مع Client ID/Secret وملف المُصدر
• نجاح اختبار دخول المصلحة
• تطبيق التوقيع يعمل بالمفتاح الصحيح
• عميل واحد على الأقل وأصناف/أكواد بنود

1. الإنشاء

الصادر → فاتورة جديدة. اختر العميل، أكّد الاسم والرقم الضريبي للمستلم، أضف البنود (الوصف، كود الصنف، EGS|GS1، الكمية، السعر). حفظ للمسودة أو جاهز للتوقيع عند اكتمال البيانات.

2. جاهز للتوقيع

يبني فاتورة JSON غير موقّع ويضبط الحالة READY_TO_SIGN مع التحقق من المُصدر والبنود والمستلم.

3. توقيع محلي

اضغط توقيع محلي. بعد النجاح تصبح الحالة SIGNED. بدون حمولة موقّعة يُرفض الإرسال.

4. إرسال للمصلحة

اضغط إرسال للمصلحة. عند القبول غالباً SUBMITTED مع معرّفات المصلحة. الرفض قد يظهر INVALID مع رسالة خطأ.

5. تحديث الحالة وPDF

تحديث الحالة (يحتاج `etaUuid`) قد ينقل إلى VALID أو INVALID. يمكن أرشفة طباعة PDF الرسمية، والتحميل، ورابط المصلحة، والنسخ، والإلغاء. القوائم تدعم التحديث والأرشفة الجماعية.

أعطال شائعة

• توقف جاهز للتوقيع → نقص بيانات المُصدر أو أكواد البنود
• لا يحدث توقيع → التطبيق متوقف أو مفتاح خاطئ أو مشكلة PIN/تعريف
• فشل الإرسال → بيئة/اعتماد خاطئ أو المستند غير SIGNED
• Invalid بعد الإرسال → صحّح رسالة التحقق ثم أعد الإصدار عند الحاجة