سلسلة UUID: كيف يرتبط كل إيصال بما قبله
UUID كل إيصال بصمة SHA-256 لمحتواه، ومحتواه يضم UUID الإيصال السابق من نقطة البيع نفسها، فتصير الإيصالات سلسلة لا يُحذف منها حلقة دون أن يظهر.
خطوات المصلحة: أدخل كل الحقول ومنها UUID الإيصال السابق من نقطة البيع نفسها (ولإيصال المرتجع مرجع الإيصال الأصلي)، واترك UUID الإيصال نفسه فارغًا، وسلسِل الإيصال في سطر واحد، واحسب SHA-256، وحوّل البايتات الـ32 إلى 64 حرفًا ستّ عشريًا، ثم ضعها في الحقل.
أول إيصال من نقطة البيع يحمل previousUUID فارغًا، وكل إيصال بعده يحمل UUID سابقه. فلو تغيّر حرف في إيصال قديم تغيّرت بصمته ولم تعد تطابق ما سجله الإيصال الذي يليه.
وحين يُرفض إيصال لا تنكسر السلسلة: في مثال المصلحة يُرفض R2 بين R1 وR3، فيُصحح إلى R2* بـ UUID جديد، ويبقى سابقه R1، ويُضاف إليه referenceOldUUID يشير إلى R2، ولا يتغير R3.
في جوداكس
مبنييحسب جوداكس البصمة بهذه الخطوات ويضعها في الإيصال، وثلاثة اختبارات تغطي البصمة والسلسلة. والوحدة لا تخزّن آخر UUID لكل نقطة بيع ولا تبني referenceOldUUID ولا مرجع المرتجع. وتعليق الكود يصف تفريغ الحقل بأنه غير مؤكد، بينما تنص خطوات المصلحة عليه.
crates/jdx-einvoice-eg/src/lib.rs; crates/jdx-einvoice-eg/src/tests.rs
الخطوات
- ضع UUID الإيصال السابق من نقطة البيع نفسها في previousUUID (فارغًا لأول إيصال).
- اترك حقل uuid فارغًا.
- سلسِل الإيصال بقواعد المصلحة في سطر واحد.
- احسب SHA-256 للنص وحوّله إلى 64 حرفًا ستّ عشريًا.
- ضع الناتج في uuid، واحفظه ليكون previousUUID للإيصال التالي.
أسئلة وأجوبة
ماذا لو رُفض إيصال في منتصف السلسلة؟
يُصحح ويأخذ UUID جديدًا مع الإبقاء على سابقه وإضافة referenceOldUUID للإيصال المرفوض؛ والتصحيح بمرجع لإيصال مُبطل مقبول خلال 96 ساعة، ودون مرجع خلال 72 ساعة، ما لم يوجد طلب إرسال متأخر.
صفحات ذات صلة
مفاهيم ذات صلة
- التسلسل القانوني للمستند عند مصلحة الضرائب المصريةقبل حساب البصمة يُحوَّل المستند إلى سطر نصي واحد بقواعد ثابتة: أسماء الحقول بحروف كبيرة بين علامتي تنصيص، والقيم كما هي، واسم المصفوفة قبل كل عنصر.
- الإصدار دون اتصال ومهلة الـ24 ساعةيُصدر الإيصال ويُفحص محليًا ثم يُرسل خلال 24 ساعة؛ وما تأخر يحتاج طلب إرسال متأخر.
الإيصال والفاتورة الإلكترونية في مصر
المصادر
- Receipt Issuance FAQ — Egyptian Tax Authority (ETA) – eInvoicing & eReceipt SDK
- Receipt v1.2 (v1.2) — Egyptian Tax Authority (ETA) – eInvoicing & eReceipt SDK
- Document Serialization Approach — Egyptian Tax Authority (ETA) – eInvoicing & eReceipt SDK
تاريخ المراجعة: 4 نوفمبر 2026. ما يخص جوداكس مأخوذ من شيفرة البرامج نفسها.