معيار XML الخاص بزاتكا

توسعات UBL الإلزامية

تضيف زاتكا توسعات مخصصة إلى معيار UBL 2.1 القياسي للتعامل مع التوقيعات التشفيرية ورموز QR. يجب أن تحتوي كتلة UBLExtensions على:

• التوقيع الرقمي: توقيع متوافق مع XAdES-EPES.
• رمز QR: بتنسيق TLV ومشفر بـ Base64.
• الشهادة: المفتاح العام المستخدم في التوقيع.

سلسلة الهاش (PIH)

يجب أن يشير كل ملف XML إلى هاش SHA-256 للفاتورة السابقة الصادرة عن نفس الجهاز. هذا يضمن سلامة البيانات ويمنع الحذف.

<cac:AdditionalDocumentReference>
  <cbc:ID>PIH</cbc:ID>
  <cac:Attachment>
    <cbc:EmbeddedDocumentBinaryObject mimeCode="text/plain">
      [SHA-256 Hash of Previous XML]
    </cbc:EmbeddedDocumentBinaryObject>
  </cac:Attachment>
</cac:AdditionalDocumentReference>

الأخطاء الشائعة

1. الترميز: يجب أن يكون XML بترميز UTF-8 بدون BOM.
2. التقريب: يجب تقريب بنود الفاتورة إلى منزلتين عشريتين قبل الجمع.
3. UUID: يجب أن يكون معرفاً فريداً صالحاً من النسخة الرابعة (Version 4).