تجنب تكرار الفواتير الإلكترونية: شرح مفتاح عدم التكرار

ترسل نقطة البيع فاتورة ثم ينقطع الاتصال قبل وصول الرد. هل نجح الإرسال؟ ردّ الفعل الآمن أن ترسلها ثانية، لكن دون حماية قد يخلق ذلك فاتورتين لبيعة واحدة. يجعل مفتاح عدم التكرار إعادة المحاولة آمنة.

المشكلة

يصعب التراجع عن الوثائق الضريبية المكررة: فالفاتورة المبلَّغ عنها للهيئة لا تُحذف ببساطة. وثمن التكرار إشعار دائن وتوضيح.

كيف يعمل المفتاح

ينشئ العميل مفتاحا فريدا لكل بيعة، مثل رقم معاملة نقطة البيع، ويرسله في ترويسة Idempotency-Key.
يحفظ الخادم المفتاح مع بصمة للمحتوى.
تعيد المحاولة بالمفتاح نفسه والمحتوى نفسه النتيجة الأصلية ولا تنشئ شيئا.
يُرفض المفتاح نفسه مع محتوى مختلف، لأنه يدل على خلل.

ما الذي يجعل المفتاح جيدا

ثابت: تنتج البيعة نفسها المفتاح نفسه دائما.
فريد لكل بيعة ولا يُعاد استخدامه لأخرى.
قصير بما يكفي للتخزين (حتى 190 حرفا هنا).

وماذا عن النتيجة غير المعروفة

أحيانا يصل الطلب إلى الهيئة لكن الرد يضيع. وإعادة إرساله بشكل أعمى قد تكرر الإبلاغ. اعتبر النتيجة غير المؤكدة حالة قائمة بذاتها: احجزها وتحقق منها بالدليل ثم قرر.

اختبره

أرسل المحتوى نفسه مرتين بالمفتاح نفسه وتحقق أنك تستلم الفاتورة نفسها. ثم أرسل محتوى معدّلا بالمفتاح نفسه وتحقق أنه يُرفض. وتتيح لك نقطة التجربة الجافة التدرب دون إنشاء شيء.