BR-KSA-61 تحذير — الفاتورة تُقبل

بصمة الفاتورة السابقة (PIH) غير موجودة في الفاتورة

الحقل KSA-13 مفقود كليًا من ملف XML. الفرق بينه وبين BR-KSA-26، وكيف تضيفه، وقيمة أول فاتورة.

نص الرسالة كما ترسلها الهيئة بالإنجليزية، بلا تعديل

Previous invoice hash (KSA-13) must exist in an invoice.

ماذا يعني هذا؟

الفرق بين هذا الكود و BR-KSA-26 بسيط ومهم: هناك القيمة موجودة لكن صيغتها خاطئة، وهنا الحقل غير موجود من أصله. الهيئة تبحث عن كتلة cac:AdditionalDocumentReference التي معرّفها PIH فلا تجدها.

لماذا يحدث؟

مرتّبة من الأشيع إلى الأقل شيوعًا — الأرجح أن سببك في الأول أو الثاني.

  • قالب XML لا يحتوي كتلة PIH إطلاقًا — شائع في الأنظمة التي بُنيت على مثال للمرحلة الأولى ثم رُقّيت.
  • الكتلة موجودة لكن <cbc:EmbeddedDocumentBinaryObject> فيها فارغ.
  • معرّف الكتلة مكتوب بحروف صغيرة pih أو باسم آخر؛ المعرّف حسّاس لحالة الأحرف.
  • حذف الكتلة عن قصد في أول فاتورة لأنه «لا توجد فاتورة سابقة» — وهذا خطأ: أول فاتورة لها قيمة ثابتة.

كيف تصلحه

2 خطوات، ثم أعد إرسال الفاتورة.

  1. 1
    أضف الكتلة بالمعرّف الصحيح

    يجب أن تحتوي الفاتورة على cac:AdditionalDocumentReference بـ <cbc:ID>PIH</cbc:ID> وداخلها cac:Attachment ثم <cbc:EmbeddedDocumentBinaryObject mimeCode="text/plain"> تحمل البصمة بـ Base64.

  2. 2
    ضع القيمة الثابتة في أول فاتورة

    قيمة أول فاتورة هي Base64 لتجزئة حرف الصفر — راجع BR-KSA-26 للقيمة الكاملة. لا تترك الحقل فارغًا ولا تحذفه.

هذا الكود لا يمنع القبول، فالفاتورة الحالية نظامية. صحّح البيانات لتختفي التحذيرات من الفواتير القادمة.

هل يمنعه ZATCA Tools؟

نعم. الحقل يُبنى تلقائيًا في كل فاتورة يصدرها ZATCA Tools، وأول فاتورة تأخذ القيمة الثابتة دون تدخّل منك.

أكواد لها علاقة

أسئلة شائعة

هذا الكود تحذير أم خطأ؟ +
في مواصفة الهيئة مُصنَّف تحذيرًا (warning)، أي أن الفاتورة قد تُقبل مع تحذير بدلًا من أن تُرفض. لا تبنِ على ذلك: سلسلة بلا بصمات تعني أنك لا تستطيع إثبات تسلسل فواتيرك عند المراجعة.
ما علاقة البصمة بعدّاد الفاتورة ICV؟ +
كلاهما يثبت التسلسل من زاويتين: العدّاد رقم متزايد يقول «هذه الفاتورة رقم كذا»، والبصمة تربط محتوى الفاتورة بمحتوى ما قبلها. راجع BR-KSA-33.
أصلحت هذه — ولا تريد التالية

ZATCA Tools يبني التوقيع والبصمة والعدّاد والترميز عنك، ويتحقق من البيانات قبل الإرسال. مجاني بالكامل حاليًا، وبدون بطاقة ائتمانية.

ابدأ مجانًا

← كل أكواد أخطاء ZATCA