شرح المرحلة الثانية
مرحلة الربط والكامل

ما هي المرحلة الثانية (مرحلة الربط)؟

تُعرف المرحلة الثانية باسم مرحلة الربط والكامل، وتتطلب أن يتصل برنامج المحاسبة الخاص بك مباشرة بخوادم هيئة الزكاة والضريبة والجمارك (منصة فاتورة). على عكس المرحلة الأولى حيث كان حفظ ملف PDF محلياً كافياً، تتطلب المرحلة الثانية توقيع كل فاتورة رقمياً واعتمادها (أو الإبلاغ عنها) في الوقت الفعلي.

المعيار التقني (XML UBL 2.1)

لا تقبل هيئة الزكاة ملفات PDF العادية. يجب أن تكون الفاتورة بصيغة XML مبنية على معيار UBL 2.1. ملف الـ PDF الذي تراه هو مجرد تمثيل مرئي لهذه البيانات.

هيكل ملف XML

يجب أن يحتوي ملف XML المتوافق على معرفات فريدة وسلاسل تشفير (Hash Chains). إليك نظرة مبسطة على هيكل الفاتورة القياسية:

<!-- Standard UBL Invoice Structure -->
<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2">
    <cbc:ProfileID>reporting:1.0</cbc:ProfileID>
    <cbc:ID>INV-2025-001</cbc:ID>
    <cbc:UUID>8e6000cf-1a98-4174-b3e7-4933cc0341e5</cbc:UUID>
    <cbc:IssueDate>2025-01-25</cbc:IssueDate>
    
    <!-- Previous Invoice Hash (Critical for Chain) -->
    <cac:AdditionalDocumentReference>
        <cbc:ID>PIH</cbc:ID>
        <cac:Attachment>
            <cbc:EmbeddedDocumentBinaryObject mimeCode="text/plain">NWZIY2ViNjZm...</cbc:EmbeddedDocumentBinaryObject>
        </cac:Attachment>
    </cac:AdditionalDocumentReference>
    ...
</Invoice>

مواصفات رمز الاستجابة السريعة (QR Code)

رمز الـ QR في المرحلة الثانية ليس مجرد رابط لموقع إلكتروني. هو سلسلة مشفرة بصيغة Base64 تحتوي على حقول بصيغة TLV (Tag-Length-Value).

أخطاء الرفض الشائعة وكيفية إصلاحها

عند الربط مع الهيئة، قد تواجه هذه الأخطاء من منصة فاتورة. إليك كيفية التعامل معها: