مصطلحات الفوترة الإلكترونية (زاتكا)
كل مصطلح تقابله وأنت تربط نظامك مع منصة «فاتورة»، بالشرح والمثال والقاعدة اللي تفشل لو غلطت فيه.
- الاعتماد (Clearance) · الاعتماد (clearance) هو مسار الفاتورة الضريبية (B2B): تُرسل لزاتكا قبل ما توصل المشتري، والهيئة تتحقق منها وتختمها وترجعها معتمدة.
- فحوصات الامتثال · فحوصات الامتثال عيّنات يرسلها الجهاز لزاتكا بشهادة الامتثال قبل شهادة الإنتاج: فاتورة وإشعار دائن ومدين لكل نوع فاتورة، يعني ست للنوعين.
- شهادة الامتثال (Compliance CSID) · شهادة الامتثال هي أول شهادة يطلبها الجهاز من زاتكا مقابل CSR وOTP، ويستخدمها لفحوصات الامتثال قبل ما ياخذ شهادة الإنتاج.
- الإشعار الدائن (Credit Note) · الإشعار الدائن مستند يصدره البائع لإرجاع مبلغ للمشتري أو تصحيح فاتورة، رمزه 381، ولازم يرجع للفاتورة الأصلية ويذكر السبب.
- الختم التشفيري (XAdES / ECDSA) · الختم التشفيري هو توقيع XAdES على الفاتورة بخوارزمية ECDSA على منحنى secp256k1 بمفتاح شهادة الجهاز، يثبت مصدر الفاتورة وإنها ما تعدّلت.
- CSID (معرّف الختم التشفيري) · CSID هو شهادة تصدرها زاتكا لكل جهاز فوترة (EGS) باسم المنشأة، يوقّع بها الجهاز فواتيره ويتصل بها مع بوابة فاتورة.
- CSR (طلب توقيع الشهادة) · الـ CSR طلب يرسله جهاز الفوترة لزاتكا عشان ياخذ شهادة CSID، فيه المفتاح العام (secp256k1) وبيانات المنشأة والجهاز بحقول تطلبها الهيئة.
- الإشعار المدين (Debit Note) · الإشعار المدين مستند يزيد قيمة فاتورة سابقة أو ضريبتها، رمزه 383، ولازم يرجع للفاتورة الأصلية ويذكر سبب الإصدار.
- EGS (وحدة حل الفوترة الإلكترونية) · EGS هي وحدة حل الفوترة اللي تصدر الفواتير، مثل كاشير أو نقطة بيع أو سيرفر. كل وحدة تتسجّل لحالها وتاخذ CSID وسلسلة فواتير خاصة.
- منصة فاتورة (Fatoora) · منصة فاتورة هي بوابة زاتكا للفوترة الإلكترونية: يطلّع منها المكلّف رموز OTP لتسجيل أجهزته ويجدّد شهاداتها، وتستقبل الفواتير عبر الـ API.
- ICV (عدّاد الفاتورة) · ICV هو عدّاد متسلسل يختم به كل جهاز (EGS) كل فاتورة وإشعار يصدره، يبدأ من 1 ويزيد واحد مع كل مستند، وتتحقق منه القاعدة BR-KSA-33.
- هاش الفاتورة (Invoice Hash) · هاش الفاتورة في زاتكا هو SHA-256 بترميز base64 لملف XML بعد حذف التوقيع والـ QR وتوحيد صيغته (C14N11)، ويصير PIH للفاتورة اللي بعدها.
- رمز نوع الفاتورة (InvoiceTypeCode) · InvoiceTypeCode يحدد نوع المستند في زاتكا: 388 فاتورة، 381 إشعار دائن، 383 إشعار مدين، والسمة name (مثل 0100000 أو 0200000) تحدد ضريبية أو مبسّطة.
- OTP (رمز التسجيل من منصة فاتورة) · الـ OTP رمز لمرة وحدة يطلّعه صاحب المنشأة من منصة فاتورة عشان يسمح بتسجيل جهاز فوترة، صلاحيته ساعة، ويُرسل مع طلب شهادة الامتثال.
- PDF/A-3 (نسخة الفاتورة المقروءة) · PDF/A-3 صيغة PDF للأرشفة تسمح بإرفاق ملف داخلها، وزاتكا تقبلها لمشاركة الفاتورة وحفظها بشرط يكون الـ XML مضمّن فيها. الإرسال للهيئة يبقى XML.
- المرحلة الأولى والمرحلة الثانية · المرحلة الأولى (الإصدار) من 4 ديسمبر 2021 تطلب فواتير إلكترونية، والثانية (الربط) من 1 يناير 2023 على موجات تطلب XML موقّع ومرسل لزاتكا.
- PIH (هاش الفاتورة السابقة) · PIH هو هاش الفاتورة السابقة لنفس الجهاز، يُكتب في الفاتورة اللي بعدها عشان تتسلسل الفواتير. تشترط وجوده القاعدة BR-KSA-61.
- شهادة الإنتاج (Production CSID) · شهادة الإنتاج هي الشهادة اللي يوقّع بها الجهاز فواتيره النظامية ويرسلها لزاتكا، تطلع بعد نجاح فحوصات الامتثال وتُجدّد بـ OTP جديد.
- رمز QR بصيغة TLV · رمز QR في المرحلة الثانية فيه 9 وسوم بصيغة TLV مرمّزة base64: اسم البائع ورقمه الضريبي والوقت والمبالغ والهاش والتوقيع والمفتاح.
- التبليغ (Reporting) · التبليغ (reporting) هو مسار الفاتورة المبسّطة (B2C): تُعطى للمشتري فوراً بختم جهازك، وتُبلّغ لزاتكا خلال 24 ساعة من إصدارها.
- الفاتورة الضريبية المبسّطة · الفاتورة المبسّطة هي فاتورة البيع للأفراد (B2C)، رمز معاملتها يبدأ بـ 02، تُختم بشهادة الجهاز وفيها QR، وتُبلّغ لزاتكا خلال 24 ساعة.
- الفاتورة الضريبية (Standard) · الفاتورة الضريبية هي فاتورة البيع بين المنشآت (B2B)، رمز معاملتها يبدأ بـ 01، فيها بيانات المشتري وتاريخ التوريد، وتعتمدها زاتكا قبل التسليم.
- UBL 2.1 (صيغة XML للفاتورة) · UBL 2.1 هو معيار XML اللي تُكتب به فواتير المرحلة الثانية في زاتكا، وتتحقق منه الهيئة بالـ XSD وقواعد EN 16931 وقواعد السعودية.
- فئات الضريبة (S وZ وE وO) · فئات ضريبة القيمة المضافة في فاتورة زاتكا أربع: S أساسية، Z صفرية، E معفاة، O خارج النطاق. كل بند له فئة، وكل فئة لها تفصيل ضريبي.
- رموز VATEX (أسباب الإعفاء) · رموز VATEX هي أسباب الإعفاء أو النسبة الصفرية في فاتورة زاتكا، مثل VATEX-SA-32 للتصدير. كل فئة (Z وE وO) لها رموزها، والرمز الغلط يكسر BR-KSA-CL-04.
- بيئات زاتكا الثلاث (المطورين، المحاكاة، الإنتاج) · زاتكا عندها ثلاث بيئات: بوابة المطورين للتجربة، والمحاكاة ببيانات المنشأة بدون أثر نظامي، والإنتاج للفواتير النظامية. ولكل بيئة شهاداتها.
خلّ ماثل يتعامل مع هذا عنك
ماثل يوقّع الفاتورة ويرسلها للهيئة ويمسك العدّاد والهاش بطلب واحد، ويرجّع الـ PDF مع رمز QR.
جرّب ماثل بدون تسجيل توثيق ماثل API