الاعتماد (Clearance)

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

الاعتماد (clearance) هو مسار الفاتورة الضريبية (B2B): تُرسل لزاتكا قبل ما توصل المشتري، والهيئة تتحقق منها وتختمها وترجعها معتمدة.

الاعتماد (Clearance) هو نموذج الفاتورة الضريبية (B2B). الفاتورة تروح للهيئة أول، ومنصة فاتورة تتحقق إنها مطابقة لمعيار الـ XML وتسوي فحوصات إضافية، وبعدها تضيف ختمها التشفيري ورمز QR وترجع الـ XML المعتمد. هذا المعتمد هو اللي يتسلّمه المشتري.

الطلب: POST على /invoices/clearance/single مع الترويسة clearance-status: 1، والجسم فيه invoiceHash وuuid والفاتورة نفسها base64 في invoice. الرد فيه clearanceStatus بقيمة CLEARED أو NOT_CLEARED، وclearedInvoice وهو المستند المختوم.

وش يغلط؟ إنك تعطي المشتري نسختك قبل الاعتماد بدل النسخة المختومة. أو بيانات المشتري ناقصة: BR-KSA-42 للاسم، وBR-KSA-81 لمعرّف المشتري لو ما فيه رقم ضريبي، وBR-KSA-10 للعنوان. والضريبية لازم فيها تاريخ التوريد (BR-KSA-15). ولو الهيئة رجّعت 303، معناها الاعتماد موقّف عندها، والمطلوب إرسال الفاتورة تبليغ.

في ماثل، "type": "standard" يمشي على الاعتماد تلقائي، والرد status: cleared، وinvoice_xml هو المستند المختوم من الهيئة. احفظه هو، مو نسختك.

مثال

POST /invoices/clearance/single
accept-version: V2
clearance-status: 1

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

أسئلة شائعة

وش الفرق بين الاعتماد والتبليغ؟

الاعتماد للفاتورة الضريبية وتصير قبل ما تتسلّم للمشتري، والهيئة تختمها. التبليغ للمبسّطة ويصير خلال 24 ساعة بعد إصدارها، والهيئة ما تختمها.

الفاتورة رجعت مقبولة مع تحذيرات، هل هي معتمدة؟

إيه. التحذير ما يمنع القبول، والفاتورة دخلت السلسلة. الخطأ هو اللي يرفض.

مين يولّد رمز QR للفاتورة الضريبية؟

حسب دليل الهيئة، الهيئة تولّد نص الـ QR وقت الاعتماد مع ختمها، وأنت تطبعه من المستند المعتمد.

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

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

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

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

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