إزاي تتأكد إن الإيصال الإلكتروني اتسجّل صح؟ (QR والرقم الموحد UUID)

كل إيصال إلكتروني ليه رقم موحد (UUID) وكود QR بيفتح تفاصيل الإيصال على بوابة مصلحة الضرائب. هنا بنشرح يعني إيه الاتنين، وإزاي تتأكد إن الإيصال وصل المنظومة واتقبل، سواء إنت صاحب مطعم أو زبون. الشرح مبني على توثيق الـ SDK الرسمي.

ابدأ تجربة 7 أيام مجانًا · شوف الأسعار

الـ UUID: بصمة الإيصال

حسب توثيق الـ SDK، الـ UUID مفتاح فريد على مستوى المنظومة كلها، بيتولّد من محتوى الإيصال نفسه بالطريقة دي. نظام الكاشير هو اللي بيحسبه، مش مطلوب منك تحسبه بإيدك:

1. تجمّع كل حقول الإيصال، بما فيها UUID الإيصال السابق من نفس الجهاز (previousUUID)، وفي المرتجع بتضيف referenceUUID بتاع إيصال البيع.
2. تسيب خانة الـ UUID فاضية وقت الحساب.
3. تعمل serialize وnormalize للإيصال في سطر نص واحد.
4. تحسب hash للنص بخوارزمية SHA256.
5. تحوّل الـ 32 byte الناتجة لنص hexadecimal من 64 حرف، وده هو الـ UUID.

كود QR: بيفتح إيه؟

الممول لازم يطبع على الإيصال كود QR بيمثّل رابط لتفاصيل الإيصال على بوابة الفاتورة والإيصال الإلكتروني. الشكل حسب الـ SDK:

• الرابط: {رابط البوابة}/receipts/search/{UUID}/share/{تاريخ ووقت إصدار الإيصال بالتوقيت العالمي UTC}
• بعد الرابط بييجي إجمالي الإيصال ورقم التسجيل الضريبي للبائع: #Total:{الإجمالي},IssuerRIN:{رقم التسجيل}
• مثال من الـ SDK: http://invoicing.eta.gov.eg/receipts/search/68e656b2…f368f320/share/2022-02-19T02:00Z#Total:1000.000,IssuerRIN:674859545 (الـ UUID هنا مختصر للعرض).
• النص ده بيتحوّل لصورة QR، والمطبوع هو الصورة بس، مش النص نفسه (الأسئلة الشائعة الرسمية).
• في QR لكل نوع إيصال، بيع أو مرتجع.

للزبون: إزاي تتأكد إن إيصالك اتسجّل

الإيصال المطبوع لازم يحتوي على UUID وQR عشان المستهلك النهائي يقدر يبحث أو يستعلم عنه على المنظومة (الأسئلة الشائعة الرسمية). الخطوات:

1. امسح كود QR من الإيصال بكاميرا الموبايل، أو افتح الرابط اللي بيمثّله.
2. هتفتح صفحة تفاصيل الإيصال على بوابة المصلحة.
3. قارن اللي في الصفحة بإيصالك الورقي: التاريخ، والإجمالي، وبيانات البائع.
4. لو الصفحة مفتحتش أو الإيصال مش ظاهر: ممكن لسه ما اتبعتش، لأن المنظومة بتسمح حاليًا بإرسال الإيصال لحد 24 ساعة. جرّب تاني بعد شوية. وحسب الـ SDK، المستلم بيقدر يسترجع الإيصالات اللي حالتها valid بس.
5. لو فضل مش ظاهر، اسأل المنشأة اللي أصدرت الإيصال، أو اتصل بخط المصلحة 16395.

لصاحب المطعم أو الكافيه: إزاي تتأكد إن الإيصال اتقبل

بعد إرسال الإيصال لمنظومة المصلحة:

• الـ API بيرجّع رقم الإرسالية (submissionUUID) بحالة HTTP 202، ومعاه قايمة بالإيصالات المقبولة (acceptedDocuments) والمرفوضة (rejectedDocuments) من الفحص الأولي. باقي الفحص بيكمل بعد كده بشكل غير متزامن (توثيق Submit Receipt).
• ادخل بوابة المصلحة على صفحة الإرساليات: هتلاقي كل الإيصالات وحالتها. حالة الإيصال valid معناها إنه اتقبل، وفي كمان حالات invalid وcancelled (توثيق Integration Toolkit).
• لو الإيصال مش ظاهر على البوابة: اتأكد إن رقم الإرسالية ظهر وقت الإرسال، لأن لو ما ظهرش فالإيصال ما اتبعتش. ولو بتستخدم نقطة بيع، شوف صفحة (حالة الإيصالات) على الجهاز، هتلاقي فيها الإيصالات اللي لسه ما اتبعتتش (الأسئلة الشائعة).
• المنظومة بتبعت إخطار بوصول الإيصال، عن طريق بريد إلكتروني أو رسائل قصيرة أو الـ ERP (منصة تسجيل نقاط البيع، الأسئلة الشائعة).
• لو إيصال طلع invalid: صحّح الخطأ وابعته بـ UUID جديد، وحط UUID القديم في حقل referenceOldUUID، وخلّي previousUUID زي ما كان (الأسئلة الشائعة).

علامات إن في حاجة محتاجة مراجعة

المفروض الإيصال الإلكتروني المطبوع يكون فيه الحاجات دي. راجع لو لقيت غير كده:

• إيصال مطبوع من غير UUID أو من غير كود QR.
• كود QR مش بيفتح صفحة تفاصيل الإيصال بعد مرور المدة المسموحة للإرسال.
• الإجمالي أو بيانات البائع في الصفحة مختلفة عن المطبوع.
• لو أنت صاحب المنشأة وفي إيصالات متأخرة أو مرفوضة بشكل متكرر: راجع الإعدادات وبيانات الفروع، واتصل بدعم المصلحة 16395 أو [email protected].

أسئلة شائعة

إيه الفرق بين الـ UUID والرقم الداخلي للإيصال؟

الـ UUID بيتولّد تلقائيًا من محتوى الإيصال (64 حرف hexadecimal ناتجة من SHA256)، وهو اللي بيعرّف الإيصال على المنظومة. أما الرقم الداخلي (internal id) فهو رقم بتحدده منشأتك في نظامها، وهو حقل مطلوب في الإيصال.

الزبون مسح الـ QR والصفحة مفتحتش. يعني الإيصال مش مسجّل؟

مش بالضرورة. ممكن الإيصال لسه ما اتبعتش، لأن المنظومة بتسمح حاليًا بالإرسال لحد 24 ساعة، أو ممكن حالته مش valid. شوف صفحة الإرساليات على البوابة، ولو بتستخدم نقطة بيع شوف صفحة (حالة الإيصالات) عليها.

الإيصال طلع invalid. أعمل إيه؟

صحّح الخطأ وابعت الإيصال تاني بـ UUID جديد، مع وضع UUID الإيصال القديم في حقل referenceOldUUID، وخلّي previousUUID هو نفسه بتاع الإيصال القديم. وده حسب الأسئلة الشائعة الرسمية.

الإيصال المرتجع ليه QR؟

أيوه، الأسئلة الشائعة بتقول إن بيتصدر QR لكل نوع إيصال، بيع أو مرتجع. والمرتجع لازم يشير لإيصال البيع الأصلي عن طريق referenceUUID.

الفحار للتطوير بيطبع الـ UUID والـ QR؟

أيوه. بعد ما جهاز الفرع يتسجّل على بوابة المصلحة، الإيصال بيتبعت تلقائيًا، والـ UUID بيتخزّن وكود QR بيتطبع على الإيصال. جرّب على فرعك مجانًا 7 أيام من غير كارت بنكي.

المصادر

الشرح ده تبسيط للتوثيق اللي نشرته الجهات الرسمية، وكل معلومة فيه مأخوذة من المصادر دي. الإجراءات والتفاصيل ممكن تتحدّث، فراجع المصدر الرسمي أو اتصل بالخط الساخن لمصلحة الضرائب 16395 قبل ما تنفّذ. راجعنا المصادر في أكتوبر 2026. ده مش استشارة قانونية أو ضريبية.

• SDK الإيصال الإلكتروني: Receipt Issuance FAQ (UUID وQR code)
• SDK الإيصال الإلكتروني: Submit Receipt Documents API
• SDK الإيصال الإلكتروني: Get Receipt Details API
• SDK الإيصال الإلكتروني: Integration Toolkit (حالات الإيصال)
• مصلحة الضرائب المصرية: دليل الأسئلة الشائعة عن منظومة الإيصال الإلكتروني، الإصدار 24 بتاريخ 31 يناير 2024 (PDF)
• منصة تسجيل نقاط البيع (pos.eta.gov.eg): الأسئلة الشائعة

الفحار للتطوير بيبعت الإيصال الإلكتروني تلقائيًا

بعد ما تسجّل جهاز الفرع على بوابة مصلحة الضرائب، الفحار للتطوير بيبعت الإيصال الإلكتروني (B2C) لمنظومة الضرائب تلقائيًا مع كل عملية بيع. جرّب على فرعك مجانًا 7 أيام، من غير كارت بنكي.

اقرأ كمان

• منظومة الإيصال الإلكتروني للمطاعم
• ربط الكاشير بمصلحة الضرائب
• برنامج كاشير مطاعم
• خطوات تسجيل نقطة البيع على منظومة الإيصال الإلكتروني
• الفرق بين الفاتورة الإلكترونية والإيصال الإلكتروني