الاعتماد (Clearance) للفاتورة الضريبية
إرسال الفاتورة الضريبية وإشعاراتها إلى منصة فاتورة قبل تسليمها للمشتري، فتعيدها مختومة برمز استجابة سريعة.
تعرّف الضوابط الاعتماد بأنه تحقق الهيئة من الفاتورة الضريبية والإشعارات المرتبطة بها وختم المطابق منها وإشعار المُصدر قبل وصولها إلى العميل. فالفاتورة الضريبية لا تُعد صحيحة في المرحلة الثانية إلا إذا حملت ختم الهيئة.
يرسل البائع المستند بصيغة XML (لا PDF/A-3) إلى واجهة الاعتماد مع الـ hash والـ UUID. إذا كان صحيحاً أو مقبولاً بتحذيرات تعيده المنصة مختوماً مع رمز استجابة سريعة، وإذا رُفض تعيد الأخطاء فيُصحح ويُرسل مستنداً جديداً بقيمة عداد وUUID جديدين.
في الفوترة الذاتية المعتمدة يرسل المشتري المستند. وإذا أوقفت الهيئة الاعتماد تعيد الواجهة الرمز 303، فيُرسل المستند الضريبي عبر واجهة الإبلاغ ويُتحقق منه دون ختم. وعند تعطل الأنظمة يُبلَّغ عن العطل عبر خدمة الإشعار بالأعطال، ثم تُرسل المستندات بعد زواله.
في جوداكس
غير مبنيغير مبني. المستند لا يحمل الرقم الضريبي للمشتري ولا عنوانه، وهما مما يلزم للفاتورة الضريبية؛ ولا توجد في البرنامج دالة تستدعي واجهة الاعتماد.
crates/jdx-einvoice-sa/src/api.rs
الخطوات
- أصدر المستند الضريبي ووقّعه اختيارياً.
- أرسله إلى /invoices/clearance/single مع الـ hash والـ UUID.
- عند 200 أو 202 خذ المستند المختوم (clearedInvoice) وسلّمه للمشتري.
- عند 400 صحّح وأصدر مستنداً جديداً.
أسئلة وأجوبة
هل يتغير hash الفاتورة بعد ختم الهيئة؟
لا، الختم ورمز الاستجابة السريعة في كتل مستثناة من الـ hash.
صفحات ذات صلة
- KSA-2 خيارات إصدار الفواتير وأنواع المعاملات الخاصة
- KSA-15 ختم التشفير
- KSA-14 رمز الاستجابة السريعة (QR Code)
- BR-KSA-06 · يجب أن توجد الخاصية name على نوع الفاتورة بالبنية NNPNESB.
مفاهيم ذات صلة
- الإبلاغ (Reporting) عن الفاتورة المبسطة خلال 24 ساعةإرسال الفاتورة المبسطة وإشعاراتها، بعد ختمها وتسليمها للمشتري، إلى منصة فاتورة خلال 24 ساعة من إصدارها.
- الفاتورة الضريبية والفاتورة المبسطة: الفرقالضريبية للمنشآت وتُعتمد قبل تسليمها، والمبسطة للمستهلك غالباً وتُختم محلياً وتُبلَّغ خلال 24 ساعة.
- ختم التشفير (التوقيع الرقمي) في الفاتورةتوقيع ECDSA بصيغة XAdES على hash المستند وخصائص التوقيع، بمفتاح جهاز مسجل وشهادة من الهيئة.
الفوترة الإلكترونية في السعودية (فاتورة)
المصادر
- الضوابط والمتطلبات والمواصفات الفنية والقواعد الإجرائية اللازمة لتنفيذ أحكام لائحة الفوترة الإلكترونية (قرار المحافظ رقم 62738 وتاريخ 1443/11/23هـ) (vfile dated 20230519 (decision 62738)) — ZATCA
- Controls, Requirements, Technical Specifications and Procedural Rules for Implementing the Provisions of the E-Invoicing Regulation (Decision No. 62738 dated 23/11/1443H) (vfile dated 20230519 (decision 62738)) — ZATCA
- E-invoicing Detailed Technical Guidelines (vVersion 2) — ZATCA
- Detailed Guidelines for E-Invoicing (vVersion 2) — ZATCA
- Integration Sandbox API pages (Swagger): reporting, clearance, compliance, production CSID, renewal (ve-Invoicing Sandbox Release 2.1.0 (page lists 2.1.1 as latest)) — ZATCA
تاريخ المراجعة: 4 نوفمبر 2026. ما يخص جوداكس مأخوذ من شيفرة البرامج نفسها.