الفوترة الإلكترونية والربط مع زاتكا — دليل المستخدم
قبل أن تبدأ
الفوترة الإلكترونية في النظام ليست شاشة منفصلة: الفاتورة هي فاتورة المبيعات نفسها، وما يضيفه الربط مع هيئة الزكاة والضريبة والجمارك هو توقيعها وإرسالها للمنصة ومتابعة حالتها. هذه الصفحة تشرح التهيئة كاملة، من ربط الشركة حتى متابعة حالة كل فاتورة.
الترتيب: تهيئة بيانات الشركة ← ربط الشهادات مع المنصة ← تجهيز بيانات العملاء ← إصدار الفواتير ومتابعة حالتها.
أولًا: تهيئة بيانات الشركة
تُضبط من: المحاسبة ← الشركة ← افتح شركتك، وستجد الحقول موزّعة على تبويبين: بيانات الشركة، وتبويب «ZATCA Setting».
البيانات الأساسية المطلوبة
- ⚠ تنبيه — هذه الحقول تدخل في الشهادة نفسها. أي خطأ فيها يعني شهادة خاطئة تُرفض فواتيرها، وتصحيحه يستلزم إعادة إصدار الشهادة من البداية. راجعها حرفًا بحرف قبل المتابعة.
تفعيل الفوترة وخياراتها
الإرسال في الخلفية وأوقاته
يمكن ضبط الإرسال ليعمل في الخلفية ضمن فترتين زمنيتين (جلستين) بتحديد وقت بداية ونهاية لكل منهما. الفائدة العملية: تجعل الإرسال يتم خارج ساعات الذروة فلا يبطئ شاشات البيع، مع ضمان إرسال فواتير اليوم قبل انتهائه.
الفروع ومراكز التكلفة
خيار «اعتبار مركز التكلفة كفرع» يجعل كل مركز تكلفة فرعًا مستقلًا لدى الهيئة. عند تفعيله يجب إضافة رقم السجل التجاري للفرع وعنوانه داخل مركز التكلفة نفسه. استخدمه إذا كانت فروعك مسجّلة لدى الهيئة كفروع منفصلة.
ثانيًا: ربط الشهادات مع المنصة
هذه الخطوات تُنفَّذ مرة واحدة لكل شركة (أو لكل فرع)، بالترتيب، من تبويب «ZATCA Setting».
1. إنشاء إعداد CSR
اضغط «إنشاء إعداد CSR»، فيبني النظام ملف الإعداد من بيانات شركتك (الاسم، الرقم الضريبي، نوع التسجيل ورقمه، الموقع، الفئة). راجع الناتج في حقل «CSR Config» وتأكد من صحته.
2. إنشاء CSR
- اضغط «إنشاء CSR»، فيولّد النظام المفتاح الخاص والعام وطلب توقيع الشهادة، وتظهر النتيجة في حقل «CSR Data». تُحفظ المفاتيح في قسم «Keys & Certificate».
- ⚠ تنبيه — المفتاح الخاص سر لا يُشارك ولا يُصدَّر خارج النظام. من يملكه يستطيع توقيع فواتير باسم منشأتك.
3. الحصول على رمز OTP
ادخل بوابة فاتورة في موقع هيئة الزكاة والضريبة والجمارك، وأصدر رمز OTP لجهاز الفوترة، ثم الصقه في حقل OTP. الرمز صالح لمدة محدودة — أكمل الخطوة التالية مباشرة بعد نسخه.
4. توليد شهادة الامتثال
اضغط «Generate Compliance CSID». عند النجاح يملأ النظام «Basic Auth from CSID» و«Compliance request id». هذه شهادة اختبار لا تصلح للإنتاج بعد.
5. فحص الامتثال
- اختر نوع التحقق من القائمة.
- أدخل رقم فاتورة تجريبية للاختبار.
- اضغط «Check Compliance».
- كرّر الفحص على كل الخيارات المطلوبة حتى تنجح جميعها.
هذه الخطوة هي التي تتحقق من أن فواتيرك مطابقة للمواصفة قبل الانتقال للإنتاج. لا تتجاوزها.
6. توليد شهادة الإنتاج النهائية
بعد نجاح فحص الامتثال، اضغط «Generate Final CSIDs»، فيُملأ حقل «Final Auth CSID». عندها تصبح المنشأة جاهزة للإرسال الفعلي.
بيئات المنصة
عناوين البيئات الثلاث معرّفة في قسم «URLs / API EndPoints». تأكد من أنك في بيئة الإنتاج قبل إصدار فواتير حقيقية.
خيارات الإرفاق
تفعيل هذه الخيارات يجعل كل فاتورة تحمل دليلها الكامل، وهو ما يختصر أي مراجعة أو تدقيق لاحق.
ثالثًا: تجهيز بيانات العميل
من: المبيعات ← العميل ← تبويب «التفاصيل». حقول زاتكا موجودة هنا مباشرة وليست في تبويب «ضريبة».
- ⚠ تنبيه — الفاتورة الضريبية (B2B) تتطلب رقم العميل الضريبي وعنوانه الوطني. الفاتورة المبسّطة (B2C) لا تتطلبهما. تحديد النوع الصحيح للعميل من البداية يمنع رفض فواتيره.
رابعًا: إصدار الفاتورة ومتابعتها
الفاتورة تُصدر من: المحاسبة ← فاتورة مبيعات ← «جديد»، بالخطوات المعتادة. والحقول الخاصة بزاتكا تجدها في قسم «ZATCA Integration Fields».
الحقول التي تظهر على الفاتورة
الضريبة وأسباب الإعفاء
أنواع الفواتير الخاصة
تُعلَّم بخانة اختيار على الفاتورة حسب الحالة:
تعليم النوع الصحيح ضروري، لأن كل نوع له متطلبات مختلفة في المواصفة، وإغفاله سبب شائع للرفض.
الخصومات
عند إعطاء خصم على الفاتورة، يجب تعبئة رمز سبب الخصم وسبب الخصم. وخيار «إرسال خصم السطر» يرسل الخصم على مستوى الصنف بدل مستوى الفاتورة.
متابعة حالة الإرسال
- افتح الفاتورة وراجع حقل ZATCA Status.
- إن كانت مرفوضة، اقرأ ZATCA Full Response لمعرفة سبب الرفض بدقة.
- صحّح السبب — غالبًا بيانات ناقصة في العميل، أو رمز إعفاء خاطئ، أو نوع فاتورة غير معلّم.
- أعد الإرسال.
وللمتابعة الجماعية يحتفظ النظام بسجلّي أحداث ونجاح لكل عمليات الإرسال، يمكن الرجوع إليهما لمعرفة ما أُرسل وما أخفق ومتى.
نقاط البيع وزاتكا
فواتير نقاط البيع لها حقولها الخاصة أيضًا: UUID، وحالة زاتكا، ورمز QR، وفئة الضريبة، ورمز سبب الإعفاء، إضافة إلى اسم جهاز نقطة البيع لدى زاتكا الذي يربط الفاتورة بالجهاز المسجّل. وأجهزة نقاط البيع تُسجَّل في جدول «ZATCA Offline Machines» في بيانات الشركة.
لأن الكاشير لا يحتمل انتظار ردّ المنصة في كل عملية، يُنصح بإلغاء «عرض استجابة زاتكا على الشاشة» وضبط الإرسال في الخلفية.
أسئلة متكررة
أين شاشة «الفاتورة الإلكترونية» في النظام؟
لا توجد شاشة منفصلة. الفاتورة الإلكترونية هي فاتورة المبيعات نفسها، والربط يضيف إليها التوقيع والإرسال ورمز QR ومتابعة الحالة.
فاتورة رُفضت من المنصة، من أين أبدأ؟
من حقل «ZATCA Full Response» في الفاتورة — يذكر سبب الرفض تحديدًا. وأشيع الأسباب: رقم ضريبي أو عنوان وطني ناقص لدى العميل، أو رمز سبب إعفاء خاطئ، أو نوع فاتورة خاصة لم يُعلَّم.
ما الفرق بين شهادة الامتثال وشهادة الإنتاج؟
شهادة الامتثال للاختبار والتحقق من مطابقة فواتيرك للمواصفة. وشهادة الإنتاج هي التي تُصدر بعد نجاح الفحص، وبها وحدها تُرسل الفواتير الحقيقية.
انتهت صلاحية رمز OTP قبل أن أكمل، ماذا أفعل؟
أصدر رمزًا جديدًا من بوابة فاتورة وأعد الخطوة. الرمز قصير الصلاحية، فاحرص أن تكون بقية البيانات جاهزة قبل إصداره.
لدينا عدة فروع، هل نكرّر الربط لكل فرع؟
إذا كانت الفروع مسجّلة لدى الهيئة كفروع منفصلة، فعّل «اعتبار مركز التكلفة كفرع» وأضف السجل التجاري والعنوان لكل مركز تكلفة، ويُربط كل فرع بشهادته.
هل تختلف الشاشات عن نسختنا؟
الشرح يتبع منطق النظام ووحداته، وقد تختلف بعض الشاشات حسب التخصيص المطبّق على حسابكم.
لمن أتوجه إذا احتجت مساعدة؟
تواصل مع الدعم الفني في iCloudITS. وربط زاتكا تحديدًا نساعدك فيه خطوة بخطوة داخل حسابكم، فهو إجراء يُنفَّذ مرة واحدة ولا يحتمل الخطأ.
نحن هنا لمساعدتك
فريق عمل داخل السعودية — يرد خلال ساعات العمل، من السبت إلى الخميس 9 صباحًا حتى 11 مساءً.
00966559996966واتساباحجز استشارة مجانيةاطلب عرض سعراكتب سؤالك بلغتك، ويجيبك مساعد الدليل بالخطوات مع رابط المصدر.
