أخطاء زاتكا في الفاتورة الإلكترونية وحلولها
هذي الأخطاء والتحذيرات اللي واجهتنا فعلاً وحنا نبني محرك ماثل ونجرّبه على بوابة الهيئة. لكل كود: وش معناه، ليش يطلع، وكيف تحلّه. وإذا تستخدم ماثل، أغلبها محلول قبل ما توصل الفاتورة للهيئة.
العدّاد والهاش (السلسلة)
BR-KSA-33 و BR-KSA-34 · عدّاد الفاتورة (ICV)
المعنى: كل فاتورة لازم تحمل عدّاد الفاتورة (ICV) في cac:AdditionalDocumentReference برقم ICV، وقيمته أرقام بس. غيابه خطأ يرفض الفاتورة.
الحل: عدّاد لكل جهاز يزيد واحد مع كل فاتورة وما ينعاد ضبطه. زِده بعد قبول الهيئة للفاتورة، والفاتورة المرفوضة صلّحها وأرسلها بنفس العدّاد. تفاصيل BR-KSA-33
BR-KSA-61 و BR-KSA-26 · هاش الفاتورة السابقة (PIH)
كل فاتورة تحمل هاش اللي قبلها (SHA-256 بصيغة base64). أول فاتورة على الجهاز تستخدم القيمة الابتدائية المنشورة في SDK الهيئة، وبعدها احفظ invoice_hash من كل رد مقبول. تفاصيل BR-KSA-61
الهاش ينكسر بعد التوقيع
أي تعديل على الـ XML بعد حساب الهاش، حتى إعادة تنسيقه، يخلّي الهاش غلط. احسب الهاش آخر شي، ولا تلمس المستند بعده.
البائع والمشتري
BR-KSA-09 و BR-KSA-37 · عنوان البائع
عنوان البائع لازم فيه الشارع، ورقم المبنى، والرمز البريدي، والمدينة، والحي، ورمز الدولة (BR-KSA-09)، ورقم المبنى ٤ أرقام بالضبط (BR-KSA-37). BR-KSA-09 · BR-KSA-37
BR-KSA-08 · معرّف البائع
معرّف البائع (BT-29) يجي مرة وحدة بأحد المخططات: CRN أو MOM أو MLS أو SAG أو OTH أو 700، وبحروف وأرقام بس. الأشهر: السجل التجاري بـ schemeID="CRN". تفاصيل
BR-KSA-42 و BR-KSA-81 و BR-KSA-44 · بيانات المشتري في الفاتورة الضريبية
الفاتورة الضريبية (B2B) وإشعاراتها لازم فيها اسم المشتري (BR-KSA-42). وإذا المشتري ما عنده رقم ضريبي، لازم معرّف ثاني له (BR-KSA-81). وإذا فيه رقم ضريبي، لازم يكون ١٥ رقم يبدأ وينتهي بـ ٣ (BR-KSA-44). المبسّطة ما تحتاجها. BR-KSA-42 · BR-KSA-81 · BR-KSA-44
BR-KSA-10 · عنوان المشتري
عنوان المشتري في الفاتورة الضريبية لازم فيه الشارع والمدينة ورمز الدولة. رسالة الهيئة تذكر المشتري من خارج السعودية، لكن الفحص الفعلي في SDK يطبّقها على كل فاتورة ضريبية. ما تنطبق على المبسّطة. تفاصيل
الإشعارات الدائنة والمدينة
BR-KSA-56 و BR-KSA-17 · مرجع الإشعار وسببه
الإشعار الدائن (381) والمدين (383) لازم يرجع للفاتورة الأصلية (BillingReference، BR-KSA-56)، ولازم يذكر سبب الإصدار (BR-KSA-17، وغيابه خطأ يرفض الإشعار). وخلّ المبالغ موجبة، فنوع المستند هو اللي يحدد الاتجاه. BR-KSA-56 · BR-KSA-17
المجاميع والبنود
BR-CO-10 و BR-CO-13 و BR-CO-15 · المجاميع
مجموع صافي البنود يساوي مجموع البنود (BR-CO-10)، والإجمالي قبل الضريبة يساوي البنود ناقص الخصومات زائد الرسوم على مستوى المستند (BR-CO-13)، والإجمالي مع الضريبة يساوي الإجمالي قبلها زائد الضريبة (BR-CO-15، خطأ يرفض الفاتورة). تفاصيل BR-CO-15
BR-KSA-EN16931-11 و BR-KSA-51 · حساب البند
صافي البند = الكمية × السعر (على كمية الأساس) + رسوم البند − خصوماته، والبند مع الضريبة = صافيه + ضريبته. تفاصيل
BR-16 و BR-25 و BR-26 · البنود
الفاتورة لازم فيها بند واحد على الأقل (BR-16)، وكل بند له اسم (BR-25) وسعر صافي (BR-26). حتى لو برنامجك يرسل الإجمالي بس، سوّ بند واحد يحمل المبلغ كامل.
BR-KSA-19 · سبب الرسوم
كل رسوم على مستوى المستند تحتاج رمز سبب. تفاصيل
BR-KSA-EN16931-08 و BR-CO-18 · مجموع الضريبة
عنصر TaxTotal واحد بس يحمل تفصيل الضريبة (TaxSubtotal)، والفاتورة لازم فيها تفصيل ضريبة واحد على الأقل (BR-CO-18). تفاصيل
الضريبة والإعفاء
BR-KSA-CL-04 و BR-KSA-24 · رمز سبب الإعفاء
البند الصفري (Z) أو المعفى (E) يحتاج رمز سبب من قائمة الهيئة (VATEX-SA-…، BR-KSA-CL-04)، والخارج عن نطاق الضريبة (O) يحتاج رمز استثناء (BR-KSA-24) وهو VATEX-SA-OOS. انتبه: الرمز القديم VAT-OOS-SA يعطي تحذير CL-04، جرّبناها على قواعد SDK الهيئة. BR-KSA-CL-04 · BR-KSA-24
BR-KSA-68 و BR-KSA-EN16931-02 · عملة الضريبة
TaxCurrencyCode لازم يكون موجود (BR-KSA-68) وقيمته SAR (BR-KSA-EN16931-02)، والاثنين أخطاء ترفض الفاتورة. تفاصيل
BR-KSA-16 · رمز طريقة الدفع
إذا الفاتورة فيها طريقة دفع (BT-81)، رمزها لازم من قائمة UNTDID 4461 المعتمدة (مثل 10 للكاش، 30 للتحويل، 48 للبطاقة). تفاصيل
المهلة وطول الحقول
BR-KSA-98 · مهلة الـ ٢٤ ساعة
الفاتورة المبسّطة لازم تتبلّغ للهيئة خلال ٢٤ ساعة من إصدارها. تفاصيل
BR-KSA-F-06 · طول الحقول
عائلة قواعد لحدود طول كل حقل. القيمة الفاضية أو الأطول من الحد تعطي تحذير. جدول الحدود كلها
أشياء ما لها كود لكنها توقفك
- العنوان العربي يختفي من الـ CSR: openssl يسقط الحقول غير اللاتينية واللي بعدها بدون أي رسالة، والهيئة ترفض الـ CSR. اكتب حقول الـ CSR بطريقة تحفظ العربي.
- الكود 303 (clearance معطّل): بعض الحسابات ترجع 303 على مسار الـ clearance، والحل الرجوع لمسار الـ reporting.
- "Submitted before" (406) في فحوصات الامتثال: كل فحص ينحسب مرة لكل شهادة، فإعادة إرساله ترجع 406. اعتبره نجاح وكمّل.
- نجاح الـ sandbox نص الطريق: شهادة الإنتاج تطلع باسم المنشأة نفسها بـ OTP من حسابها في «فاتورة»، فخطّط لربط أول عميل بدري.
كل القواعد مع شروحاتها متاحة كبيانات مفتوحة (JSON) على GitHub.
عندك رد من الهيئة؟ الصقه في قارئ رد زاتكا ويشرح لك كل كود فيه.
وشوف وين قواعد زاتكا تختلف عن نصها: ٦ ملاحظات مجرّبة.
كل قواعد زاتكا
قواعد السعودية (BR-KSA)
- BR-CL-KSA-14 · قيمة رمز QR يجب أن تكون بين 1 و1000 حرف
- BR-CUSTOM-VALIDATION-01 · الرقم الضريبي للبائع يجب ألا يطابق الرقم الضريبي للمشتري
- BR-KSA-03 · كل فاتورة تحتاج معرّفاً فريداً UUID
- BR-KSA-04 · تاريخ الإصدار يجب ألا يكون في المستقبل
- BR-KSA-05 · رمز نوع الفاتورة يجب أن يكون 388 أو 383 أو 381 أو 386
- BR-KSA-06 · رمز معاملة الفاتورة (السمة name) يجب أن يتبع الصيغة NNPNESB
- BR-KSA-07 · فواتير التصدير لا يجوز أن تكون فوترة ذاتية
- BR-KSA-08 · معرّف البائع بنوع صالح (CRN, MOM, MLS, SAG, OTH, 700)
- BR-KSA-09 · عنوان البائع: الشارع والمبنى والرمز والمدينة والحي والدولة
- BR-KSA-10 · الفواتير الضريبية تحتاج شارع المشتري ومدينته ورمز دولته
- BR-KSA-11 · البنود غير الخاضعة للضريبة (O) نسبتها 0 إن وُجدت
- BR-KSA-12 · الخصومات غير الخاضعة للضريبة (O) نسبتها 0 إن وُجدت
- BR-KSA-13 · الرسوم غير الخاضعة للضريبة (O) نسبتها 0 إن وُجدت
- BR-KSA-14 · معرّف المشتري يجب أن يستخدم نوعاً مسموحاً
- BR-KSA-15 · الفاتورة الضريبية (388) تحتاج تاريخ التوريد
- BR-KSA-16 · رمز وسيلة الدفع يجب أن يكون رمزاً صالحاً من UNTDID 4461
- BR-KSA-17 · الإشعارات الدائنة والمدينة تحتاج سبب الإصدار
- BR-KSA-18 · رمز فئة الضريبة يجب أن يكون S أو Z أو E أو O
- BR-KSA-19 · كل رسم على مستوى المستند يحتاج رمز سبب
- BR-KSA-20 · كل رسم على مستوى البند يحتاج رمز سبب
- BR-KSA-21 · كل رسم على مستوى المستند يحتاج نص سبب الرسم (BT-104)
- BR-KSA-22 · كل رسم على مستوى البند يحتاج نص سبب الرسم (BT-144)
- BR-KSA-23 · تفصيل الضريبة المعفى (E) يحتاج رمز سبب الإعفاء (BT-121)
- BR-KSA-24 · تفصيل الضريبة غير الخاضع (O) يحتاج رمز السبب (BT-121)
- BR-KSA-25 · الفاتورة المبسطة بإعفاء EDU/HEA تتطلب اسم المشتري
- BR-KSA-26 · مرفق تجزئة الفاتورة السابقة (PIH) غير فارغ وبنوع text/plain
- BR-KSA-27 · الفاتورة المبسطة يجب أن تحتوي على رمز QR (KSA-14)
- BR-KSA-28 · معرّف معلومات التوقيع يجب أن يكون ...ubl:signature:1
- BR-KSA-29 · معرّف التوقيع ومرجعه يجب أن يكونا ...signature:Invoice
- BR-KSA-30 · طريقة التوقيع يجب أن تكون معرّف XAdES المغلّف
- BR-KSA-31 · الفاتورة المبسطة لا تكون فوترة ذاتية (الخانة 7 = 0)
- BR-KSA-33 · كل فاتورة تحتاج قيمة عداد الفاتورة (ICV، KSA-16)
- BR-KSA-34 · قيمة عداد الفاتورة (ICV، KSA-16) أرقام فقط
- BR-KSA-35 · تاريخ انتهاء التوريد (KSA-24) يتطلب تاريخ التوريد (KSA-5)
- BR-KSA-36 · تاريخ انتهاء التوريد (KSA-24) لا يسبق تاريخ التوريد (KSA-5)
- BR-KSA-37 · رقم مبنى البائع يجب أن يكون 4 أرقام بالضبط
- BR-KSA-39 · رقم التسجيل الضريبي للبائع (BT-31) مطلوب
- BR-KSA-40 · الرقم الضريبي للبائع (BT-31): 15 رقمًا يبدأ وينتهي بـ 3
- BR-KSA-42 · الفاتورة الضريبية وإشعاراتها تتطلب اسم المشتري (BT-44)
- BR-KSA-44 · الرقم الضريبي للمشتري (BT-48): 15 رقمًا يبدأ وينتهي بـ 3
- BR-KSA-49 · إعفاء EDU/HEA يتطلب هوية المشتري الوطنية (BT-46 بنوع NAT)
- BR-KSA-51 · مبلغ البند شامل الضريبة (KSA-12) = صافي البند + ضريبته
- BR-KSA-52 · كل بند يحتاج مبلغ ضريبة البند (KSA-11) في الفاتورة القياسية
- BR-KSA-53 · كل بند يحتاج مبلغه شامل الضريبة (KSA-12) بالفاتورة القياسية
- BR-KSA-56 · إشعارات الدائن والمدين يجب أن تشير للفاتورة الأصلية (BT-25)
- BR-KSA-60 · الفاتورة المبسطة تتطلب عنصر cac:Signature (KSA-15)
- BR-KSA-61 · كل فاتورة تحتاج تجزئة الفاتورة السابقة (PIH، KSA-13)
- BR-KSA-63 · المشتري السعودي يحتاج عنوانًا وطنيًا كاملًا (فاتورة قياسية)
- BR-KSA-66 · الرمز البريدي للبائع (BT-38) يجب أن يكون 5 أرقام بالضبط
- BR-KSA-67 · الرمز البريدي للمشتري السعودي (BT-53) 5 أرقام بالضبط
- BR-KSA-68 · كل فاتورة تحتاج رمز عملة الضريبة (BT-6)
- BR-KSA-69 · تفصيل الضريبة الصفرية (Z) يحتاج رمز السبب (BT-121)
- BR-KSA-70 · وقت الإصدار (KSA-25) مطلوب بصيغة hh:mm:ss أو hh:mm:ssZ
- BR-KSA-71 · الفاتورة المبسطة الملخصة تتطلب اسم المشتري
- BR-KSA-72 · الفاتورة المبسطة الملخصة تتطلب تاريخي بداية التوريد ونهايته
- BR-KSA-73 · المبلغ المدفوع مسبقًا (BT-113) يتطلب مرجع دفعة مقدمة كامل
- BR-KSA-74 · رمز نوع مستند الدفعة المقدمة (KSA-30) يجب أن يكون 386
- BR-KSA-75 · سطر الدفعة المقدمة يتطلب المبالغ والفئة والنسبة الضريبية
- BR-KSA-76 · نسبة ضريبة الدفعة المقدمة بالنسبة الصفرية (Z) تساوي صفرًا
- BR-KSA-77 · نسبة ضريبة الدفعة المقدمة المعفاة (E) تساوي صفرًا
- BR-KSA-78 · نسبة ضريبة الدفعة المقدمة غير الخاضعة (O) تساوي صفرًا
- BR-KSA-79 · ضريبة تفصيل السطر = المبلغ الخاضع × النسبة ÷ 100
- BR-KSA-80 · المبلغ المدفوع مسبقًا يساوي مجموع مبالغ الدفعات وضريبتها
- BR-KSA-81 · الفاتورة الضريبية دون رقم ضريبي للمشتري تتطلب معرّفًا آخر له
- BR-KSA-82 · مبالغ سطر الدفعة المقدمة يجب أن تكون صفرًا
- BR-KSA-83 · رمز سبب الإعفاء في تفصيل الضريبة يتطلب نص السبب
- BR-KSA-84 · نسبة الضريبة للفئة القياسية S يجب أن تكون 15 أو 5
- BR-KSA-85 · هاتف المشتري يبدأ بـ 0 أو + ويليه من 4 إلى 15 رقمًا
- BR-KSA-86 · بريد المشتري الإلكتروني يتبع صيغة XXX@YYY.ZZ
- BR-KSA-87 · سعر صرف الضريبة يتطلب عملة المصدر وعملة الهدف والسعر
- BR-KSA-88 · عملة المصدر في سعر الصرف تطابق عملة الفاتورة
- BR-KSA-89 · عملة الهدف في سعر الصرف تطابق عملة الضريبة
- BR-KSA-90 · سعر صرف الضريبة لا يتجاوز 14 خانة
- BR-KSA-92 · فواتير القطاع الحكومي يجب أن تتضمن رقم العقد
- BR-KSA-93 · تفصيل ضريبة السطر بالنسبة الصفرية (Z) يتطلب رمز سبب الإعفاء
- BR-KSA-94 · تفصيل ضريبة السطر المعفاة (E) يتطلب رمز سبب الإعفاء
- BR-KSA-95 · تفصيل ضريبة السطر غير الخاضعة (O) يتطلب رمز سبب الإعفاء
- BR-KSA-96 · رمز سبب الإعفاء في السطر يتطلب نص السبب
- BR-KSA-97 · فاتورة بغير الريال: إجمالي الضريبة بالريال يختلف عن الإجمالي
- BR-KSA-98 · تُرسل الفاتورة المبسطة خلال 24 ساعة من إصدارها
- BR-KSA-99 · رقم ضريبة المشتري لا يكون فارغًا عند وجود العنصر
- BR-KSA-CL-01 · رمز عملة الفاتورة يجب أن يكون صالحًا وفق ISO 4217
- BR-KSA-CL-02 · سمة currencyID لكل مبلغ تطابق عملة الفاتورة
- BR-KSA-CL-03 · قيمة mimeCode للمرفق يجب أن تكون من الأنواع المسموحة
- BR-KSA-CL-04 · رمز سبب الإعفاء يجب أن يناسب فئة الضريبة
- BR-KSA-CL-06 · رموز أسباب الرسوم يجب أن تكون من قائمة UNTDID 7161
- BR-KSA-CL-07 · رمز سبب إعفاء الدفعة المقدمة يناسب فئتها الضريبية
- BR-KSA-DEC-01 · نسبة خصم المستند من 0 إلى 100 وبخانتين عشريتين كحد أقصى
- BR-KSA-DEC-02 · نسب الضريبة من 0 إلى 100 وبخانتين عشريتين كحد أقصى
- BR-KSA-DEC-03 · مبلغ ضريبة السطر بخانتين عشريتين كحد أقصى
- BR-KSA-DEC-04 · مبلغ السطر شاملًا الضريبة بخانتين عشريتين كحد أقصى
- BR-KSA-DEC-06 · مبالغ الدفعة المقدمة وضريبتها بخانتين عشريتين كحد أقصى
- BR-KSA-EN16931-01 · معرّف العملية ProfileID يجب أن يكون reporting:1.0
- BR-KSA-EN16931-02 · عملة احتساب الضريبة TaxCurrencyCode يجب أن تكون SAR
- BR-KSA-EN16931-03 · مبلغ الخصم أو الرسم = المبلغ الأساسي × النسبة ÷ 100
- BR-KSA-EN16931-04 · نسبة الخصم أو الرسم تتطلب وجود المبلغ الأساسي
- BR-KSA-EN16931-05 · المبلغ الأساسي للخصم أو الرسم يتطلب وجود النسبة
- BR-KSA-EN16931-06 · الخصم على مستوى السعر يجب أن يكون ChargeIndicator = false
- BR-KSA-EN16931-07 · صافي سعر الصنف = السعر الإجمالي ناقص خصم السعر
- BR-KSA-EN16931-08 · إجمالي ضريبة واحد فقط يحتوي على تفاصيل الضريبة
- BR-KSA-EN16931-09 · عند وجود رمز عملة الضريبة يلزم إجمالي ضريبة بدون تفاصيل
- BR-KSA-EN16931-11 · صافي البند = الكمية × صافي السعر ± رسوم وخصومات البند
- BR-KSA-EN16931-12 · كمية أساس سعر الصنف يجب أن تكون أكبر من صفر
قواعد الفاتورة الأساسية (EN 16931)
- BR-02 · يجب أن تحمل كل فاتورة رقم فاتورة (BT-1)
- BR-03 · يجب أن تحمل كل فاتورة تاريخ إصدار (BT-2)
- BR-04 · يجب أن تحمل كل فاتورة رمز نوع الفاتورة (BT-3)
- BR-05 · يجب أن تحمل كل فاتورة رمز عملة الفاتورة (BT-5)
- BR-06 · يجب ذكر الاسم القانوني للبائع (BT-27)
- BR-08 · يجب ذكر العنوان البريدي للبائع (BG-5)
- BR-09 · يجب أن يتضمن عنوان البائع رمز الدولة (BT-40)
- BR-13 · يجب ذكر إجمالي الفاتورة دون ضريبة القيمة المضافة (BT-109)
- BR-14 · يجب ذكر إجمالي الفاتورة شاملًا ضريبة القيمة المضافة (BT-112)
- BR-15 · يجب ذكر المبلغ المستحق الدفع (BT-115)
- BR-16 · يجب أن تحتوي كل فاتورة على بند واحد على الأقل (BG-25)
- BR-21 · يجب أن يحمل كل بند في الفاتورة معرّفًا (BT-126)
- BR-22 · يجب أن يحمل كل بند في الفاتورة الكمية المفوترة (BT-129)
- BR-24 · يجب أن يحمل كل بند صافي مبلغ البند (BT-131)
- BR-25 · يجب أن يحمل كل بند اسم الصنف (BT-153)
- BR-26 · يجب أن يحمل كل بند صافي سعر الصنف (BT-146)
- BR-31 · يجب أن يحمل كل خصم على مستوى المستند مبلغًا (BT-92)
- BR-32 · يجب أن يحمل كل خصم على مستوى المستند رمز فئة الضريبة (BT-95)
- BR-36 · يجب أن تحمل كل رسوم إضافية على مستوى المستند مبلغًا (BT-99)
- BR-37 · رمز فئة الضريبة (BT-102) إلزامي لكل رسوم على مستوى المستند
- BR-41 · يجب أن يحمل كل خصم على مستوى البند مبلغًا (BT-136)
- BR-43 · يجب أن تحمل كل رسوم إضافية على مستوى البند مبلغًا (BT-141)
- BR-45 · يجب أن يحمل كل تفصيل ضريبي المبلغ الخاضع للضريبة (BT-116)
- BR-46 · يجب أن يحمل كل تفصيل ضريبي مبلغ الضريبة (BT-117)
- BR-47 · يجب أن يحمل كل تفصيل ضريبي رمز فئة الضريبة (BT-118)
- BR-48 · نسبة الضريبة (BT-119) إلزامية في كل تفصيل ضريبي إلا للفئة O
- BR-49 · يجب أن تتضمن وسيلة الدفع رمز وسيلة الدفع (BT-81)
- BR-52 · يجب أن يحمل كل مرجع لمستند إضافي معرّفًا (BT-122)
- BR-53 · مع عملة الضريبة (BT-6) يُذكر إجمالي الضريبة بها (BT-111)
- BR-54 · يجب أن تحمل كل خاصية صنف اسمًا (BT-160) وقيمة (BT-161)
- BR-55 · يجب أن يتضمن مرجع الفوترة رقم الفاتورة السابقة (BT-25)
- BR-DEC · الخانات العشرية
المجاميع والحسابات (BR-CO)
- BR-CO-04 · كل بند في الفاتورة يحتاج رمز فئة ضريبة القيمة المضافة
- BR-CO-10 · إجمالي مبالغ البنود يجب أن يساوي مجموع صافي البنود
- BR-CO-11 · إجمالي الخصومات يجب أن يساوي مجموع خصومات مستوى المستند
- BR-CO-12 · إجمالي الرسوم يجب أن يساوي مجموع رسوم مستوى المستند
- BR-CO-13 · الإجمالي دون الضريبة = البنود - الخصومات + الرسوم
- BR-CO-14 · إجمالي الضريبة يجب أن يساوي مجموع مبالغ تفصيل الضريبة
- BR-CO-15 · الإجمالي مع الضريبة = الإجمالي دون الضريبة + الضريبة
- BR-CO-16 · المستحق = الإجمالي مع الضريبة - المدفوع مقدماً + التقريب
- BR-CO-17 · ضريبة كل فئة يجب أن تساوي المبلغ الخاضع × النسبة
- BR-CO-18 · كل فاتورة تحتاج تفصيلاً واحداً على الأقل للضريبة
فئات الضريبة (S, Z, E, O)
- BR-E-01 · البنود المعفاة (E) تحتاج تفصيل ضريبة بالفئة E
- BR-E-05 · بنود الفاتورة المعفاة (E) يجب أن تكون نسبة ضريبتها 0
- BR-E-06 · خصومات المستند المعفاة (E) يجب أن تكون نسبة ضريبتها 0
- BR-E-07 · رسوم المستند المعفاة (E) يجب أن تكون نسبة ضريبتها 0
- BR-E-08 · المبلغ الخاضع للفئة E يجب أن يطابق البنود والتعديلات المعفاة
- BR-E-09 · مبلغ الضريبة في تفصيل الفئة المعفاة (E) يجب أن يكون 0
- BR-O-01 · البنود غير الخاضعة للضريبة O تتطلب تفصيل ضريبة للفئة O
- BR-O-08 · المبلغ الخاضع للضريبة للفئة O يطابق مجموع بنودها
- BR-O-09 · مبلغ الضريبة في تفصيل الفئة O يجب أن يكون صفراً
- BR-S-01 · البنود الخاضعة للنسبة الأساسية S تتطلب تفصيل ضريبة للفئة S
- BR-S-05 · نسبة الضريبة للبند ذي الفئة S يجب أن تكون أكبر من صفر
- BR-S-06 · نسبة ضريبة الخصم ذي الفئة S يجب أن تكون أكبر من صفر
- BR-S-07 · نسبة ضريبة الرسم ذي الفئة S يجب أن تكون أكبر من صفر
- BR-S-08 · المبلغ الخاضع للضريبة للفئة S يطابق مجموع بنودها
- BR-S-09 · ضريبة الفئة S = المبلغ الخاضع للضريبة × النسبة ÷ 100
- BR-S-10 · تفصيل الضريبة للفئة S يجب ألا يحتوي على سبب إعفاء
- BR-Z-01 · البنود الخاضعة لنسبة الصفر Z تتطلب تفصيل ضريبة للفئة Z
- BR-Z-05 · نسبة الضريبة للبند ذي الفئة Z يجب أن تكون صفراً
- BR-Z-06 · نسبة ضريبة الخصم ذي الفئة Z يجب أن تكون صفراً
- BR-Z-07 · نسبة ضريبة الرسم ذي الفئة Z يجب أن تكون صفراً
- BR-Z-08 · المبلغ الخاضع للضريبة للفئة Z يطابق مجموع بنودها
- BR-Z-09 · مبلغ الضريبة في تفصيل الفئة Z يجب أن يكون صفراً
قوائم الرموز (BR-CL)
- BR-CL-01 · يجب أن يكون رمز نوع الفاتورة من قائمة UNTDID 1001
- BR-CL-03 · يجب أن تكون سمة currencyID للمبالغ رمزًا من ISO 4217
- BR-CL-04 · يجب أن يكون رمز عملة الفاتورة من ISO 4217
- BR-CL-05 · يجب أن يكون رمز عملة الضريبة من ISO 4217
- BR-CL-14 · يجب أن تكون رموز الدول من ISO 3166-1
- BR-CL-16 · يجب أن يكون رمز وسيلة الدفع من قائمة UNCL4461
- BR-CL-18 · رموز فئات الضريبة يجب أن تكون من قائمة UNCL5305
صيغ الحقول (BR-KSA-F)
- BR-KSA-F-01 · يجب كتابة التواريخ بصيغة YYYY-MM-DD
- BR-KSA-F-02 · مؤشر الخصم أو الرسم يجب أن يكون false أو true
- BR-KSA-F-04 · مبالغ الفاتورة وكمياتها يجب ألا تكون سالبة
- BR-KSA-F-05 · وقت إصدار الدفعة المقدمة يجب أن يكون وقتاً صحيحاً hh:mm:ss
- BR-KSA-F-07 · رقم TIN للمشتري يجب أن يكون 10 أرقام تبدأ بـ 3
- BR-KSA-F-08 · رقم السجل التجاري CRN يجب أن يكون 10 أرقام
- BR-KSA-F-09 · الرقم الموحد 700 يجب أن يكون 10 أرقام تبدأ بـ 7
- BR-KSA-F-10 · رقم الهوية الوطنية NAT للمشتري 10 أرقام تبدأ بـ 1
- BR-KSA-F-11 · رقم الإقامة IQA للمشتري 10 أرقام تبدأ بـ 2
- BR-KSA-F-12 · رمز schemeID لمعرّف البائع أو المشتري بدون مسافات زائدة
- BR-KSA-F-13 · معرّف البائع أو المشتري يجب ألا يكون تسلسل أرقام وهمياً
- BR-KSA-F-06 · حدود طول الحقول
جرّب فاتورة على زاتكا الحين
بدون شهادة ولا مفتاح: ماثل يرسلها لبوابة المطورين ويرجع لك الرد، والأخطاء بنصّها لو فيه.
جرّب فاتورة أو اقرأ دليل الربط ←