الفوترة بصيغة XML لزاتكا: نظرة تقنية
بمجرد ما تتجاوز رموز الاستجابة السريعة وتدخل متطلبات المرحلة الثانية من زاتكا، الحديث يتحول لـ"XML" — مصطلح يعني شي محدد وتقني، مو بس "صيغة الملف اللي وراء الكواليس." هذا وش يشمله فعليًا.
ليش XML بدل PDF
فاتورة PDF مبنية عشان يقرأها إنسان — تبدو صحيحة، لكن الحاسب ما يقدر يستخرج بيانات منظّمة منها بموثوقية بدون معالجة إضافية. الفوترة بصيغة XML تنظّم كل جزء من البيانات — بنود، مبالغ ضريبة، تفاصيل أطراف، إجماليات — في حقول محددة بوضوح يقدر النظام يقرأها مباشرة ويتحقق منها آليًا بدون تفسير بشري. هذا الهيكل هو اللي يخلي التخليص والإبلاغ اللحظي ممكنين على نطاق زاتكا.
UBL 2.1: المعيار وراء الصيغة
معيار الفوترة الإلكترونية لزاتكا مبني على UBL 2.1 (لغة الأعمال الموحّدة)، معيار دولي واسع الاستخدام للمستندات التجارية المنظّمة، مُكيّف بحقول وقواعد تحقق خاصة بزاتكا. استخدام معيار راسخ بدل صيغة مخصصة بالكامل يعني الهيكل الأساسي يتبع أنماط مستخدمة أصلًا بالفوترة الإلكترونية دوليًا، مع متطلبات خاصة بالسعودية مضافة فوقه.
وش يحتويه ملف XML لفاتورة زاتكا
- تفاصيل رأس الفاتورة — رقم الفاتورة وتاريخها ونوعها (مبسّطة أو كاملة) وعملتها.
- بيانات البائع والمشتري — بما فيها أرقام تسجيل ضريبة القيمة المضافة، بتفاصيل أكثر مطلوبة للفواتير الكاملة من المبسّطة.
- بنود السطر — كل منتج أو خدمة، الكمية، سعر الوحدة، ومعاملة ضريبة القيمة المضافة المنطبقة.
- إجماليات الضريبة — مبالغ ضريبة القيمة المضافة مفصّلة بوضوح، تدعم الحسابات اللي زاتكا تتحقق منها.
- الختم التشفيري — توقيع رقمي يتحقق إن الفاتورة صادرة من نظام محدد مسجّل لدى زاتكا.
من XML للامتثال
إنشاء XML منظّم صح جزء واحد بس من امتثال المرحلة الثانية — الفاتورة كذلك تحتاج الختم التشفيري مُطبَّق، وبعدها الإرسال لزاتكا للتخليص (B2B) أو الإبلاغ (B2C) عبر تكامل واجهة برمجة تطبيقات زاتكا. كل جزء يعتمد على اشتغال الأجزاء الثانية صح؛ مستند XML مُنشَأ صح بختم غير صالح، أو ختم صالح على بيانات منظّمة غلط، الاثنان يفشلان الامتثال بأسباب مختلفة.
ليش هذا يهم حتى لو ما أنت تقني
ما تحتاج تقرأ XML بنفسك عشان تتأثر بهل برنامج فوترتك يولّده صح. اللي يهم عمليًا هو هل تنفيذ المرحلة الثانية عند موردك مبني على مواصفات زاتكا الفعلية، ومُختبَر مقابل تحقق حقيقي، ومُمثَّل بصدق فيما يخص الجاهز مقابل قيد التطوير.
الأسئلة الشائعة
ليش زاتكا تتطلب XML بدل فواتير PDF للمرحلة الثانية؟
XML ينظّم بيانات الفاتورة في حقول يقدر النظام يقرأها ويتحقق منها آليًا، وهذا ضروري للتخليص والإبلاغ اللحظي على نطاق واسع، على عكس PDF المبني أساسًا للقراءة البشرية.
وش معيار XML اللي تستخدمه زاتكا؟
صيغة زاتكا مبنية على UBL 2.1، معيار دولي للمستندات التجارية المنظّمة، مُكيّف بحقول خاصة بزاتكا.
وش البيانات اللي تشملها فاتورة XML لزاتكا؟
تفاصيل رأس الفاتورة، بيانات البائع والمشتري، بنود السطر، إجماليات الضريبة، وختم تشفيري يتحقق من مصدر الفاتورة.
الختم التشفيري نفس رمز الاستجابة السريعة؟
لا. الختم التشفيري يتحقق من مصدر الفاتورة على المستوى التقني، بينما رمز الاستجابة السريعة ملخص قابل للمسح لتفاصيل الفاتورة الأساسية للبشر وأدوات التحقق البسيطة.
أحتاج أفهم XML عشان أستخدم برنامج فوترة متوافق مع زاتكا؟
لا. البرنامج يولّد ويرسل XML المنظّم صح عنك؛ اللي يهم هو هل تنفيذ موردك مبني صح ومُمثَّل بصدق.
التفاصيل التقنية تهم، حتى لو أبدًا ما تشوفها مباشرة. ابدأ مجانًا مع بوكسارة للامتثال الكامل بالمرحلة الأولى اليوم، وتحديثات صادقة كل ما يتقدم تكامل المرحلة الثانية.