مستكشف رموز الرفض والأخطاء في زاتكا
اكتب رمزاً مثل BR-KSA-44 أو الصق رد منصة فاتورة كاملاً، واعرف معنى القاعدة والحقل الذي يسببها عادة في ساب بزنس ون وطريقة إصلاحها.
الأداة
تشرح هذه الأداة قواعد منشورة من هيئة الزكاة والضريبة والجمارك (زاتكا). وهي ليست أداة رسمية من زاتكا ولا تغني عن التحقق في منصة فاتورة ولا عن وثائق زاتكا التي تبقى هي المرجع. نصوص القواعد ملخصة من معيار تنفيذ XML الإصدار 1.2، فراجع الإصدار الحالي على zatca.gov.sa. ربط حقول ساب بزنس ون ربط نموذجي يجب تأكيده مع حل التوطين لديك. Kodenova استوديو مستقل لتطوير ساب بزنس ون وأنظمة ERP والذكاء الاصطناعي، وSAP وSAP Business One علامتان تجاريتان لشركة SAP SE.
كيف تقرأ رد الرفض من زاتكا؟
تتحقق منصة فاتورة من كل مستند وفق قواعد العمل في معيار زاتكا. ويصف الدليل الفني التفصيلي لهيئة الزكاة والضريبة والجمارك ثلاث نتائج: مستند صحيح، أو مقبول مع تحذيرات، أو مرفوض. الخطأ يعني رفض المستند وعدم اعتماده أو الإبلاغ عنه، والتحذير يعني قبوله مع ضرورة تصحيح السبب في المستندات القادمة. ويكفي خطأ واحد لرفض المستند بالكامل.
يتضمن الرد رمزاً لكل مشكلة، وهذا الرمز هو ما تبحث عنه هذه الأداة.
أكثر رموز الرفض والأخطاء في زاتكا من ساب بزنس ون
| الرمز | المعنى | السبب المعتاد في ساب بزنس ون |
|---|---|---|
| BR-KSA-44 | الرقم الضريبي للمشتري 15 رقماً يبدأ وينتهي بـ 3 | مسافات أو رقم سجل تجاري في OCRD.LicTradNum |
| BR-KSA-63 | عنوان المشتري في السعودية يحتاج الشارع ورقم المبنى والرمز البريدي والمدينة والحي | عنوان العميل غير مكتمل (CRD1 / INV12) |
| BR-KSA-37 | رقم مبنى البائع 4 أرقام | عنوان الشركة في بيانات الشركة |
| BR-KSA-66 / 67 | الرمز البريدي للبائع أو للمشتري السعودي 5 أرقام | ADM1.ZipCode / CRD1.ZipCode |
| BR-KSA-40 | الرقم الضريبي للبائع 15 رقماً يبدأ وينتهي بـ 3 | OADM.TaxIdNum |
| BR-KSA-17 | الإشعار الدائن أو المدين يحتاج سبباً | لم يُسجل سبب في الإشعار الدائن |
| BR-KSA-56 | الإشعار يحتاج رقم الفاتورة الأصلية | الإشعار لم يُنشأ من الفاتورة |
| BR-CO-15 | الإجمالي شاملاً الضريبة = الإجمالي بدون ضريبة + الضريبة | فرق تقريب في إجمالي المستند |
| BR-KSA-EN16931-11 | صافي السطر = الكمية × السعر + الرسوم - الخصومات | أسعار بمنازل عشرية أكثر مما يُرسل في XML |
| BR-KSA-F-03 | لا عناصر فارغة | حقول فارغة في النظام تُكتب كوسوم فارغة |
يحتوي الجدول الكامل على 131 قاعدة مع الحقل في ساب بزنس ون وطريقة الحل لكل منها.
مجموعات القواعد
- BR: قواعد المعيار الأوروبي EN 16931 الأساسية، مثل وجوب رقم الفاتورة.
- BR-CO: قواعد الحساب: مجاميع الأسطر وإجماليات المستند وضريبة كل فئة.
- BR-KSA: القواعد السعودية: صيغة الرقم الضريبي والعنوان الوطني وعدّاد الفاتورة وتجزئة الفاتورة السابقة ورمز QR ومرجع الإشعار الدائن.
- BR-KSA-DEC: المنازل العشرية.
- BR-KSA-CL: قوائم الرموز (العملة ورموز الإعفاء VATEX ورموز أسباب الرسوم).
- BR-KSA-EN16931: النسخة السعودية من قواعد الحساب.
- BR-KSA-F: قواعد الصيغة (التواريخ والعناصر الفارغة والمبالغ الموجبة وأطوال الحقول).
مصدر القواعد
كل قاعدة هنا مأخوذة من معيار تنفيذ الفاتورة الإلكترونية بصيغة XML، الإصدار 1.2 (19 مايو 2023) الصادر عن زاتكا، القسم 13، مع ذكر القسم والصفحات لكل صف. أما وصف الخطأ والتحذير فمن الدليل الفني التفصيلي للفوترة الإلكترونية، الإصدار 2 (نوفمبر 2022).
لم ندرج قواعد فئات الضريبة (BR-S وBR-Z وBR-E وBR-O) ولا قواعد BR-CL وBR-DEC، ولا القاعدة BR-KSA-EN16931-06 لأن نصها غير واضح. والمعيار لا يحدد أي القواعد تُعاد كخطأ وأيها كتحذير، لذلك لا نخمّن: الرد الذي يصلك هو المرجع.
إصلاح الفاتورة المرفوضة في ساب بزنس ون
أصلح السبب أولاً في ساب بزنس ون: بطاقة العميل أو بيانات الشركة أو مجموعة الضريبة أو التقريب. وبحسب إرشادات زاتكا يُرسل المستند المصحح كمستند جديد له عدّاد فاتورة ومعرّف UUID وتجزئة خاصة به، ولا يُعدّل المستند المرفوض ويُعاد إرساله.
حقول ساب بزنس ون في الجدول ربط نموذجي. بعض حلول التوطين والإضافات تحفظ القيم (UUID والعدّاد والتجزئة ورمز QR ورموز الإعفاء) في جداول أو حقول مخصصة خاصة بها، لذلك تأكد من الحقل مع حل التوطين لديك.
لفحص ملف XML كامل قبل إرساله استخدم مدقق فاتورة زاتكا المرحلة الثانية، واقرأ أسباب رفض الفاتورة من زاتكا وطريقة حلها.
الفاتورة الإلكترونية لزاتكا مع ساب بزنس ون
تربط Kodenova نظام ساب بزنس ون بمنصات الفوترة الإلكترونية، ولدينا خمسة أنظمة فوترة إلكترونية تعمل فعلياً: زاتكا (السعودية) وSRI (الإكوادور) وFEL (غواتيمالا) وDTE (السلفادور) وPanama FE. اطلع على الفاتورة الإلكترونية لزاتكا مع ساب بزنس ون وخدمة ربط الفوترة الإلكترونية وتطوير ساب بزنس ون.
روابط ذات صلة
- الفاتورة الإلكترونية لزاتكا مع ساب بزنس ون
- خدمة ربط الفوترة الإلكترونية
- تطوير ساب بزنس ون
- مدقق فاتورة زاتكا المرحلة الثانية
- أسباب رفض الفاتورة من زاتكا
- كل الأدوات المجانية
تشرح هذه الأداة قواعد منشورة من هيئة الزكاة والضريبة والجمارك (زاتكا). وهي ليست أداة رسمية من زاتكا ولا تغني عن التحقق في منصة فاتورة ولا عن وثائق زاتكا التي تبقى هي المرجع. نصوص القواعد ملخصة من معيار تنفيذ XML الإصدار 1.2، فراجع الإصدار الحالي على zatca.gov.sa. ربط حقول ساب بزنس ون ربط نموذجي يجب تأكيده مع حل التوطين لديك. Kodenova استوديو مستقل لتطوير ساب بزنس ون وأنظمة ERP والذكاء الاصطناعي، وSAP وSAP Business One علامتان تجاريتان لشركة SAP SE.
ثلاث خطوات بدون تسجيل
الصق الرمز أو الرد
اكتب BR-KSA-63 أو ابحث بكلمة مثل "الرمز البريدي"، أو الصق رد منصة فاتورة بصيغة JSON أو نص.
اقرأ القاعدة
يظهر لكل رمز نص القاعدة من معيار زاتكا وشرح مبسط بالعربية والإنجليزية والقسم الذي وردت فيه.
أصلح السبب من المصدر
اعرف الحقل في ساب بزنس ون الذي يغذي القاعدة عادة وما الذي يجب تعديله قبل إرسال مستند جديد.
أسئلة حول هذه الأداة
ما معنى الرمز BR-KSA-44 في زاتكا؟
يعني أن الرقم الضريبي للمشتري في الفاتورة ليس 15 رقماً يبدأ وينتهي بالرقم 3. تطبق زاتكا هذه القاعدة كلما أُرسل رقم ضريبي للمشتري في فاتورة غير تصديرية. والسبب المعتاد في ساب بزنس ون وجود مسافات أو شرطات أو رقم سجل تجاري في حقل الرقم الضريبي للعميل.
ما الفرق بين الخطأ والتحذير في زاتكا؟
بحسب الدليل الفني لهيئة الزكاة والضريبة والجمارك، الخطأ فشل في التحقق يؤدي إلى رفض المستند، أما التحذير فيُرفق بمستند تم قبوله. ويكفي خطأ واحد لرفض المستند كله. يجب تصحيح سبب التحذير في الفواتير القادمة، لكن الفاتورة المقبولة نفسها تبقى صحيحة.
لماذا ترفض زاتكا الفاتورة بسبب عنوان المشتري؟
للمشتري في السعودية تشترط القاعدة BR-KSA-63 الشارع ورقم المبنى والرمز البريدي والمدينة والحي، وتشترط القاعدة BR-KSA-67 رمزاً بريدياً من 5 أرقام. في ساب بزنس ون تأتي هذه البيانات من عنوان العميل، فأكمل العنوان الوطني في عنوان الفوترة وتأكد من نسخه إلى الفاتورة.
هل يمكن تعديل الفاتورة المرفوضة وإعادة إرسالها؟
ليس كالمستند نفسه. أصلح السبب في ساب بزنس ون ثم أرسل مستنداً مصححاً له عدّاد فاتورة ومعرّف UUID وتجزئة خاصة به، كما تصف إرشادات زاتكا. لا يُغيّر عدّاد المستند المرفوض ولا تجزئته ولا يُعاد استخدامهما، وتستمر سلسلة تجزئة الفاتورة السابقة منه.
من أين جاءت رموز قواعد زاتكا في هذه الأداة؟
من معيار تنفيذ الفاتورة الإلكترونية بصيغة XML الصادر عن زاتكا، الإصدار 1.2 بتاريخ 19 مايو 2023، القسم 13. كل صف في الأداة يذكر القسم والصفحات. ندرج فقط القواعد التي تحققنا منها في هذه الوثيقة، ونصف حقل ساب بزنس ون بأنه ربط نموذجي يجب تأكيده مع حل التوطين.
هل ترسل الأداة الفاتورة أو الرد إلى أي جهة؟
لا. البحث واستخراج الرموز يتمان في متصفحك، ولا يُرسل أي شيء تلصقه إلى Kodenova أو زاتكا أو أي جهة أخرى. الأداة تشرح الرموز ولا تتحقق من الفاتورة كاملة؛ لذلك استخدم مدقق فاتورة زاتكا المرحلة الثانية المجاني أو أدوات الامتثال الرسمية من زاتكا.
مصممة لفرق SAP Business One
رفض متكرر من زاتكا في ساب بزنس ون؟
نتتبع كل رمز حتى الحقل المسبب في ساب بزنس ون، ونصلح البيانات الأساسية وربط ملف XML مع الحفاظ على سلسلة التجزئة. أخبرنا بالرموز التي تظهر لديك.