إرسال الإيصالات والتحقق منها
تُرسل الإيصالات دفعات JSON إلى واجهة واحدة، فتعود فورًا بمعرّف الإرسالية، ويجري التحقق الكامل بعد ذلك.
الواجهة POST /api/v1/receiptsubmissions بمحتوى JSON فقط. والجسم قائمة receipts فيها إيصال واحد على الأقل، وقد تختلف أنواعها وإصداراتها، ومعها مصفوفة signatures: توقيع المُصدر (I) إلزامي وتوقيع مزوّد الخدمة (S) اختياري، كلاهما CAdES-BES بترميز Base64. لكن الصفحة تقول إن التحقق من التوقيع لم يُفعَّل بعد بانتظار قرار المصلحة.
الرد 202 يحمل submissionUUID، وقائمة المقبول (uuid والمعرّف الطويل longId للطباعة وreceiptNumber) وقائمة المرفوض بخطأ مفصل. والفحص المتزامن قليل (الهيكل والمُصدر والإصدار)، والتحقق الكامل غير متزامن يُتابع بمعرّف الإرسالية.
الحدود: 500 إيصال أو 1.5 ميغابايت للإرسالية، و300 سطر للإيصال، وكلها من نقطة بيع واحدة، والإرسالية المطابقة لإرسالية خلال 10 دقائق تُرفض بخطأ DuplicateSubmission. ولا يرسل إلا مموّل يحمل وسم B2C.
في جوداكس
مبني جزئيًايكتب جوداكس جسم الإرسالية {"receipts":[...],"signatures":[...]} ويرفضه ما لم يحمل توقيع المُصدر (I)، ومعه توقيع واحد على الأكثر لمزوّد الخدمة (S). ولا يصنع التوقيع: قيمة CAdES-BES تأتي من شهادة المكلّف نفسه، ولا يحملها إلا منشأة مسجلة في مصر، وتذكر صفحة الواجهة أن التحقق منه غير مفعّل بعد. ولا يرسل شيئًا.
crates/jdx-einvoice-eg/src/lib.rs
صفحات ذات صلة
مفاهيم ذات صلة
الإيصال والفاتورة الإلكترونية في مصر
المصادر
- eReceipt API: Submit Receipt Documents — Egyptian Tax Authority (ETA) – eInvoicing & eReceipt SDK
- Receipt Issuance FAQ — Egyptian Tax Authority (ETA) – eInvoicing & eReceipt SDK
- BatchReceipt.json (sample receipt batch linked from the Receipt Issuance FAQ; receipt v1.0) (vsample, typeVersion 1.0) — Egyptian Tax Authority (ETA) – eInvoicing & eReceipt SDK
تاريخ المراجعة: 4 نوفمبر 2026. ما يخص جوداكس مأخوذ من شيفرة البرامج نفسها.