ختم التشفير (التوقيع الرقمي) في الفاتورة
توقيع ECDSA بصيغة XAdES على hash المستند وخصائص التوقيع، بمفتاح جهاز مسجل وشهادة من الهيئة.
ختم التشفير يثبت أمرين: أن المستند صدر من جهاز سجّله صاحبه لدى الهيئة، وأنه لم يتغير بعد ختمه. خوارزمية الـ hash SHA-256، وخوارزمية التوقيع ECDSA بمفتاح طوله 256 بت، والتوقيع XAdES مغلّف داخل الـ XML بمستوى B-B.
يحتوي التوقيع على مرجعين: الأول hash المستند بعد التحويلات، والثاني hash كتلة الخصائص الموقعة (SignedProperties) التي فيها وقت التوقيع وبصمة الشهادة واسم مُصدرها ورقمها التسلسلي. ثم يُوقَّع الجزء SignedInfo، ويُرفق التوقيع والشهادة.
في المبسطة يختم جهاز البائع قبل تسليم المستند. في الضريبية تختم منصة الهيئة عند الاعتماد، ويجوز للبائع أن يختم أيضاً فتضيف المنصة ختماً آخر. ويُستثنى من التوقيع رمز الاستجابة السريعة.
في نصوص الهيئة تفاوت بين ما يذكره جدول معيار الأمان (SigningCertificateV2 وسياسة التوقيع وسلسلة الشهادات كاملة، والمنحنى P-256 في الملف التوضيحي للشهادة) وبين ما تستخدمه الأمثلة والأدوات الرسمية (المنحنى secp256k1 في أوامر OpenSSL في الإرشادات الفنية).
في جوداكس
مبنييختم البرنامج بمفتاح secp256k1 (مكتبة k256) ويكتب كتلة الخصائص الموقعة بالشكل الذي تقبله أداة الهيئة حرفاً بحرف، ببصمة شهادة وhash خصائص بصيغة base64 للنص الست عشري. تختلف عن جدول معيار الأمان في: SigningCertificate بنسخته الأولى، وغياب سياسة التوقيع وخصائص الكائن الموقع، وإرفاق شهادة التوقيع وحدها، والقيمة Type للمرجع الثاني (xmldsig#SignatureProperties بدل 01903#SignedProperties). وتصف الخطوة 5 في الإرشادات الفنية hash الخصائص بأنه base64 للبايتات بعد حذف المسافات، بينما يحسبه البرنامج على كتلة مجمّدة المسافات ويرمّز النص الست عشري. قبلت أداة الهيئة هذا الشكل في مرحلة الإثبات.
crates/jdx-einvoice-sa/src/xml.rs
الخطوات
- احسب hash المستند (انظر صفحة hash الفاتورة).
- وقّع الـ hash بمفتاح الجهاز الخاص بخوارزمية ECDSA.
- احسب بصمة الشهادة، واملأ الخصائص الموقعة: وقت التوقيع والبصمة والمُصدر والرقم التسلسلي.
- احسب hash الخصائص الموقعة.
- املأ UBLExtensions بالتوقيع والشهادة والمرجعين، وأضف cac:Signature وكتلة رمز الاستجابة السريعة.
أسئلة وأجوبة
هل يوقّع ختم التشفير الملف كله؟
يغطي المستند كله ما عدا كتلة رمز الاستجابة السريعة وكتلة الختم نفسها.
صفحات ذات صلة
- KSA-15 ختم التشفير
- KSA-13 دالة تشفير (Hash) الفاتورة أو الإشعار السابق
- KSA-14 رمز الاستجابة السريعة (QR Code)
- BR-KSA-28 · معرّف معلومات التوقيع في ختم التشفير يجب أن يكون urn:oasis:names:specification:ubl:signature:1.
- BR-KSA-29 · معرّف التوقيع المرجعي يجب أن يكون urn:oasis:names:specification:ubl:signature:Invoice.
- BR-KSA-30 · طريقة التوقيع يجب أن تكون urn:oasis:names:specification:ubl:dsig:enveloped:xades.
- BR-KSA-60 · ختم التشفير إلزامي في المبسطة وإشعاراتها.
مفاهيم ذات صلة
- hash الفاتورة: كيف يُحسببصمة SHA-256 للمستند بعد حذف كتل الختم والرمز وتوحيد صيغته، تُكتب بـ base64، وعليها يقوم الختم والسلسلة.
- ربط جهاز الإصدار وشهادة CSIDالخطوات التي يحصل بها جهاز الإصدار على شهادة ختم من الهيئة: مفتاح وطلب شهادة ورمز OTP وفحص امتثال ثم شهادة الإنتاج.
- توحيد صيغة XML (C14N 1.1) قبل الـ hashتحويل نص XML إلى شكل وحيد قياسي قبل حساب الـ hash، حتى ينتج المستند نفسه البصمة نفسها في كل نظام.
الفوترة الإلكترونية في السعودية (فاتورة)
المصادر
- Security Features Implementation Standards to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
- E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
- الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
- Electronic Invoice XML Implementation Standard to the E-Invoicing resolution dated 2023-05-19 (v1.2) — ZATCA
تاريخ المراجعة: 4 نوفمبر 2026. ما يخص جوداكس مأخوذ من شيفرة البرامج نفسها.