رمز QR بصيغة TLV

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

رمز QR في المرحلة الثانية فيه 9 وسوم بصيغة TLV مرمّزة base64: اسم البائع ورقمه الضريبي والوقت والمبالغ والهاش والتوقيع والمفتاح.

رمز QR في المرحلة الثانية مو رابط ولا نص عادي: هو 9 حقول، كل حقل مكتوب TLV يعني رقم الوسم ثم الطول ثم القيمة، والكل مدموج ومرمّز base64. الوسوم: 1 اسم البائع، 2 رقمه الضريبي، 3 وقت الإصدار، 4 الإجمالي مع الضريبة، 5 مبلغ الضريبة، 6 هاش الفاتورة، 7 التوقيع، 8 المفتاح العام، 9 توقيع الهيئة على الشهادة.

مكانه في الـ XML: cac:AdditionalDocumentReference قيمة cbc:ID فيه QR، والنص في cbc:EmbeddedDocumentBinaryObject بـ mimeCode="text/plain". وهذا العنصر يُحذف قبل حساب الهاش.

وش يغلط؟ BR-KSA-27 تشترط الـ QR، وجرّبنا SDK 3.4.8 وطلعت تنفّذ على المبسّطة بس. وBR-CL-KSA-14 تحدد الطول من 1 إلى 1000 حرف. وأخطاء البناء الشائعة: الوسم 4 أو 5 ما يطابق PayableAmount وTaxAmount في الـ XML، أو الوقت فيه منطقة زمنية والـ XML ما فيه، أو اسم بائع طويل أكثر من 127 بايت بدون ترميز طول BER. وفي الضريبية الهيئة تولّد الـ QR وقت الاعتماد.

ماثل يبني الوسوم من نفس المجاميع اللي في الـ XML، ويرجع qr عشان تطبعه، والـ PDF يرسمه لك.

مثال

<cbc:ID>QR</cbc:ID> → base64 TLV, decoded:
1 seller name   شركة توريد التكنولوجيا بأقصى سرعة المحدودة | Maximum Speed Tech Supply LTD
2 VAT number    399999999900003
3 timestamp     2022-08-17T17:41:08
4 total + VAT   231.15
5 VAT total     30.15
6 invoice hash  z5F9qsS6oWyDhehD8u8S0DaxV+2CUiUz9Y+UsR61JgQ=
7 signature     MEYCIQ…
8 public key    (DER bytes)
9 stamp sig.    (DER bytes)

أسئلة شائعة

كم حقل في QR المرحلة الثانية؟

9 وسوم بصيغة TLV مرمّزة base64، حسب دليل الهيئة. ماثل يضيف الوسم 9 في المبسّطة.

كيف أقرأ محتوى QR فاتورة؟

فك base64، وبعدها اقرأ كل حقل: بايت رقم الوسم، ثم الطول، ثم القيمة. أو استخدم قارئ QR في ماثل.

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

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

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

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

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