التبليغ (Reporting)

من فريق ماثل، مبني على مواصفات الهيئة و SDK 3.4.8 · آخر تحديث

التبليغ (reporting) هو مسار الفاتورة المبسّطة (B2C): تُعطى للمشتري فوراً بختم جهازك، وتُبلّغ لزاتكا خلال 24 ساعة من إصدارها.

التبليغ (Reporting) هو نموذج الفاتورة المبسّطة (B2C) وإشعاراتها. البائع يصدر الفاتورة ويختمها بشهادة جهازه ويعطيها المشتري على طول، وبعدها يرسلها للهيئة خلال 24 ساعة من إصدارها. الهيئة تتحقق منها وترد، لكنها ما تختمها ولا ترجع نسخة جديدة.

الطلب: POST على /invoices/reporting/single مع الترويسة clearance-status: 0، ونفس الجسم: invoiceHash وuuid والفاتورة base64. الرد فيه reportingStatus بقيمة REPORTED أو NOT_REPORTED.

وش يغلط؟ BR-KSA-98 تحذّر لو مر أكثر من 24 ساعة بين IssueDate وIssueTime ووقت الفحص، وتطلع حتى على عيّنات الاختبار القديمة. والمبسّطة لازم فيها QR (BR-KSA-27) وختم تشفيري (BR-KSA-60). ولأن الهيئة ما تختم المبسّطة، النسخة الموقّعة من جهازك هي المستند النظامي، فلا تضيّعها.

في ماثل، "type": "simplified" يمشي على التبليغ، والرد status: reported، وinvoice_xml هو الـ XML الموقّع اللي انرسل. احفظه مع الطلب واطبع الـ qr.

مثال

POST /invoices/reporting/single
accept-version: V2
clearance-status: 0

{"invoiceHash": "…", "uuid": "…", "invoice": "<base64 signed XML>"}

أسئلة شائعة

كم عندي وقت أبلّغ عن الفاتورة المبسّطة؟

24 ساعة من إصدارها. بعدها تطلع BR-KSA-98 كتحذير.

هل أنتظر رد الهيئة قبل ما أعطي العميل الفاتورة؟

لا. المبسّطة تُعطى للمشتري فوراً بعد ختمها وإضافة الـ QR، والتبليغ يصير بعدها.

أرسلت نفس الفاتورة مرتين، وش يصير؟

دليل الهيئة يقول إن إرسال نفس المستند مرتين غير مسموح، حتى لو ما انرفض وقت الإرسال. ماثل يحسب إعادة نفس الـ uuid مرة وحدة.

قواعد الهيئة المرتبطة

مصطلحات قريبة

خلّ ماثل يتعامل مع هذا عنك

ماثل يوقّع الفاتورة ويرسلها للهيئة ويمسك العدّاد والهاش بطلب واحد، ويرجّع الـ PDF مع رمز QR.

جرّب ماثل بدون تسجيل توثيق ماثل API