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

أكثر من كتلة إجمالي ضريبة تحمل التفصيل

المستند يحمل كتلة إجمالي ضريبة واحدة فيها التفصيل حسب الفئة، ولا يحمل ثانية مثلها. والفاتورة المختلطة الفئات حين تُقسَم إلى كتلة لكل نسبة، أو التفصيل المنسوخ إلى كتلة الريال أيضًا، يطلقان هذا الكود. ودرجته تحذير، فالفاتورة تُقبل.

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

Only one tax total (BG-22) with tax subtotals must be provided.Refer to Calculation of VAT.

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

هذه توأم BR-KSA-EN16931-09، لكنها تعدّ النوع الآخر من الكتل. مع التصريح بعملة الاحتساب يحمل المستند كتلتي cac:TaxTotal: كتلة مفصَّلة فيها مبلغ الضريبة الإجمالي وcac:TaxSubtotal لكل فئة ضريبية بعملة الفاتورة، وكتلة خالية من التفصيل تحمل مبلغ الضريبة الإجمالي بالريال وحده. تلك القاعدة تريد كتلة خالية واحدة بالضبط، وهذه تريد كتلة مفصَّلة واحدة بالضبط.

وكل الفئات تدخل تلك الكتلة الواحدة. فالرسالة تحيل إلى «Calculation of VAT»، وهو قسم حساب الضريبة في معيار تنفيذ XML الذي تنشره الهيئة، ويطلب تفصيلًا واحدًا لكل توليفة مميَّزة من رمز الفئة والنسبة، ومثاله المحلول يضع تفصيل الفئة الأساسية وتفصيل الفئة المعفاة متجاورين داخل cac:TaxTotal واحدة. فالفئة الثانية cac:TaxSubtotal ثانٍ، لا كتلة إجمالي ثانية.

والكتلة المقصودة هي التي تقع مباشرة تحت الفاتورة: المعيار نفسه يذكر موضع هذه القاعدة /ubl:Invoice/cac:TaxTotal/cac:TaxSubtotal، وقاموس البيانات يربطها بإجمالي ضريبة الفاتورة (BT-110) وبإجماليها بعملة الاحتساب (BT-111). أما cac:TaxTotal داخل كل بند فعنصر آخر، يحمل ضريبة البند (KSA-11) وإجماليه شاملًا الضريبة (KSA-12).

ودرجته في المخطط تحذير: المستند يُقبل ويُسجَّل التحذير معه.

لماذا يحدث؟

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

  • كتلة cac:TaxTotal لكل فئة ضريبية: فاتورة فيها بنود خاضعة وبنود صفرية تخرج بكتلتين في كلٍّ منهما تفصيل واحد، بدل كتلة واحدة فيها تفصيلان.
  • التفصيل منسوخ إلى كتلة الريال كذلك — كأن يحدث ذلك أثناء إضافة تلك الكتلة لإصلاح BR-KSA-EN16931-09 — فتحمل الكتلتان تفصيلًا ولا تبقى كتلة خالية، ويصل الكودان معًا.
  • نسبة واحدة مكتوبة بصيغتين، 15 في بند و15.00 في آخر، تُجمَّع فئتين وتأخذ كلٌّ منهما كتلة. والمعيار صريح في أن الأصفار اللاحقة لا تقسم التفصيل.
  • كتلة ضريبة المستند مكتوبة داخل الحلقة التي تمرّ على البنود، فيكسب المستند كتلة مفصَّلة لكل بند في مستواه هو، بدل كتلة داخل كل cac:InvoiceLine.
  • إشعار دائن أو مدين يُجمَّع بإلحاق كتلة ضريبة الفاتورة الأصلية بكتلة الإشعار نفسه.

كيف تصلحه

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

  1. 1
    جمّع البنود ثم اكتب كتلة مفصَّلة واحدة

    جمّع حسب رمز الفئة والنسبة — و15 و15.00 مجموعة واحدة — واكتب cac:TaxTotal واحدة فيها مبلغ الضريبة الإجمالي وcac:TaxSubtotal لكل مجموعة، بمبلغها الخاضع ومبلغ ضريبتها وcac:TaxCategory الخاصة بها. وحروف الفئات في BR-KSA-18.

  2. 2
    أبقِ كتلة الريال خالية

    الكتلة الأخرى cac:TaxTotal فيها cbc:TaxAmount بالخاصية currencyID="SAR"، ولا cac:TaxSubtotal فيها. فإن دخلتها نسخة من التفصيل فاحذفها: خلوّها من التفصيل هو وظيفتها، وقاعدتها BR-KSA-EN16931-09.

  3. 3
    اشتقّ الإجمالي من التفاصيل

    معيار تنفيذ XML يعرّف إجمالي ضريبة الفاتورة بأنه مجموع مبالغ ضريبة الفئات. فاجمع التفاصيل التي كتبتها للتو بدل حساب الإجمالي في مسار مستقل، فتتسق الكتلة المفصَّلة مع نفسها بحكم البناء.

  4. 4
    وافحص مسار الإشعارات وحده

    إن كانت الإشعارات الدائنة والمدينة تُبنى في كود غير كود الفواتير فاختبره منفصلًا: إشعار يُلحق كتلة ضريبة الفاتورة بكتلته يسقط هنا والفواتير كلها سليمة. وتفصيل الإشعارات في الإشعارات الدائنة والمدينة.

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

هل يمنعه ZATCA Tools؟

نعم، بحكم البناء. مُولِّد الحمولة يضع تفاصيل ضريبة المستند كلها — تفصيلًا لكل فئة — داخل إجمالي ضريبة واحد، ومكتبة الـ XML تكتب ذلك كتلة cac:TaxTotal واحدة فيها التفاصيل، وإلى جانبها كتلة خالية تحمل المبلغ نفسه بالريال. وقرأنا المخرَج بأنفسنا ولم نكتفِ بالنيّة: مستند يخلط بنودًا خاضعة وبنودًا صفرية يخرج بكتلة مفصَّلة واحدة فيها تفصيلان، وكتلة خالية واحدة. ولا تقبل شاشة ولا حقل في الـ API ولا تكامل متجر إجماليَّ ضريبة أو تفصيلًا أو مبلغ ضريبة من الخارج؛ الكتلتان محسوبتان من البنود.

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

BR-KSA-EN16931-09 تحذير
إجمالي الضريبة بالريال مفقود أو مكرر
BR-KSA-18 يرفض الفاتورة
رمز فئة الضريبة غير معتمد
BR-KSA-68 يرفض الفاتورة
عملة الاحتساب الضريبي (BT-6) غير موجودة

أسئلة شائعة

هل رُفضت فاتورتي بسبب هذا الكود؟ +
درجته في المخطط تحذير، والمستند معه يُقبل ويُسجَّل التحذير. فإن كانت فاتورتك مرفوضة فعلًا فالسبب في مكان آخر: رد الهيئة يفصل errorMessages التي ترفض المستند عن warningMessages التي تُسجَّل فقط. وطريقة قراءة الرد كاملةً في فاتورتي مرفوضة من الهيئة.
فاتورتي فيها بنود خاضعة وبنود صفرية — أليس الصحيح كتلتين؟ +
تفصيلان لا كتلتان. كل توليفة مميَّزة من الفئة والنسبة تأخذ cac:TaxSubtotal خاصًا بها داخل الكتلة المفصَّلة الواحدة، وهكذا بُني المثال المحلول في معيار تنفيذ XML تمامًا. أما الكتلة الثانية التي يحملها مستندك فعلًا فهي كتلة الريال الخالية.
بنود ملفي يحمل كلٌّ منها TaxTotal — هل تُحسب؟ +
المعيار يذكر موضع هذه القاعدة كتلةَ الضريبة التي تقع مباشرة تحت الفاتورة: /ubl:Invoice/cac:TaxTotal/cac:TaxSubtotal. أما cac:TaxTotal الخاصة بالبند فعنصر آخر مكانه داخل cac:InvoiceLine، بل إن بند الدفعة المقدمة يحمل فيها تفصيلًا خاصًا به عن قصد (KSA-31 وKSA-32). والذي نقرؤه من المخطط المُصرَّف نص كل قاعدة ودرجتها لا شرط تنفيذها، فلا نستطيع أن نريك الفحص نفسه؛ والملف الذي يحمل في مستوى الفاتورة كتلة مفصَّلة واحدة بالضبط هو الشكل الذي تصفه الرسالة.
أضفت كتلة الريال لإصلاح BR-KSA-EN16931-09 فظهر هذا — ماذا حدث؟ +
إن كانت الكتلة الجديدة منسوخة من المفصَّلة فهي تحمل التفصيل أيضًا: كتلتان مفصَّلتان ولا كتلة خالية، فينكسر العدّان معًا. احذف عناصر cac:TaxSubtotal من النسخة، فيصير في الملف كتلة من كل نوع.
أصلحت هذه — ولا تريد التالية

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

ابدأ مجانًا

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