ربط الفوترة الإلكترونية مع زاتكا عبر API في المرحلة الثانية: كيف يعمل خطوة بخطوة

ربط الفوترة الإلكترونية مع زاتكا عبر API في المرحلة الثانية هو الاتصال المباشر بين نظام الفوترة ومنصة فاتورة التابعة لهيئة الزكاة والضريبة والجمارك، يرسل عبره النظام كل فاتورة بصيغة محددة. تُعتمد الفاتورة الضريبية قبل أن تصل إلى المشتري، وتُصدر المبسطة فورًا ثم يُبلَّغ عنها خلال 24 ساعة. وإن كان برنامجك يقوم بذلك فلا حاجة إلى كتابة أي برمجة.

كلمة API، أي الربط البرمجي، تبدو عملًا للمبرمجين، لكنها تعني ببساطة طريقة تخاطب نظامين. والهيئة هي التي تحدد شكل هذا الخطاب، فتلتزم أنظمة المرحلة الثانية بقواعد واحدة. ونشرح هنا الأجزاء بلغة بسيطة ليحكم صاحب المنشأة أو مسؤول التقنية هل يبني الربط بنفسه أم يعتمد على برنامج جاهز.

قبل أن يرسل النظام فواتير فعلية يجب تسجيله لدى الهيئة، وتسمى التسجيل الأولي، وينفذها المكلّف نفسه على منصة فاتورة ولا ينفذها مزود البرنامج. تحصل أولًا على رمز تحقق لمرة واحدة (OTP) من المنصة، ثم تُنشئ طلب توقيع شهادة (CSR) تطلب به من الهيئة هوية رقمية لنظامك.

ترد الهيئة بمعرّف CSID للامتثال لا يُستخدم إلا في التجربة، ثم يرسل نظامك فواتير نموذجية لتمر بفحوصات الامتثال. فإذا نجحت أصدرت لك الهيئة CSID للإنتاج وبدأت الفواتير الفعلية. وقد يرشدك البرنامج خطوة بخطوة، لكن هذه الخطوات تخص منشأتك لا مزود البرنامج، فدوّن من أجراها ومتى أجراها.

ينشئ النظام لكل فاتورة ملف بيانات بصيغة XML وفق تصميم قياسي اسمه UBL 2.1. تخيّل نموذجًا لكل حقل فيه اسم ثابت، فتقرأه أجهزة الهيئة دون تخمين. ويضيف النظام حول هذا الملف عناصر أخرى، ولكل عنصر منها وظيفة بسيطة، نوضحها في القائمة التالية لتعرف ما يلزم نظامك.

لا يكتب أحد هذه العناصر يدويًا؛ فالمفترض أن ينشئها البرنامج كلما ضغط الموظف على زر الإصدار. ولأن العداد والبصمة يربطان الفواتير في سلسلة، فعلى النظام أن يتذكر آخر فاتورة أرسلها، وهذه الذاكرة من أدق ما في الربط الذي يبنيه صاحب المنشأة بنفسه، فلا تغفل عنها.

• المعرّف الفريد للفاتورة: لا تشاركه فاتورة أخرى
• قيمة عداد الفواتير: عدّ متسلسل للفواتير الصادرة
• البصمة الرقمية للفاتورة السابقة: تربط الفواتير في سلسلة
• الختم التشفيري: ختم رقمي يربط الفاتورة بنظامك
• رمز QR: رمز يُمسح لقراءة أهم بيانات الفاتورة
• نسخة PDF/A-3 اختيارية: ملف مقروء يمكن أن يحمل ملف XML داخله

خذ مقهى صغيرًا مثلًا. يدفع الزبون عند الصندوق فتكون الفاتورة ضريبية مبسطة، يطبعها الصندوق في الحال ثم يبلّغ النظام عنها الهيئة خلال 24 ساعة. ولأن الإصدار يسبق الإبلاغ، فانقطاع الإنترنت لفترة قصيرة لا يوقف طابور الزبائن ما دامت الفاتورة تُرسل إلى الهيئة قبل انقضاء الساعات الأربع والعشرين.

وخذ تاجر جملة يصدر فاتورة لأحد المحلات. هذه فاتورة ضريبية فتمر بالاعتماد: تستلمها الهيئة أولًا ولا يستلمها المحل إلا بعد قبولها. وإذا لم تقبلها الهيئة فلا بد من تصحيح بياناتها وإرسالها من جديد. فاختر نظامًا يُظهر الفواتير المرفوضة بوضوح، وسمِّ شخصًا يراجعها كل يوم دون انتظار.

التطوير الذاتي يناسب شركة لديها مطورون واحتياجات فوترة غير معتادة. وكتابة النسخة الأولى أسهل. أما العمل المستمر فهو إبقاء الربط سليمًا كلما غيّرت الهيئة قواعدها، واختبار كل تعديل في بيئة المحاكاة، وإصلاح الأعطال في أكثر الساعات ازدحامًا. ويلزم أن يتولاه شخص ما دمت تصدر فواتير.

أما البرنامج الجاهز فينقل جزءًا كبيرًا من هذه الصيانة إلى المزود، ويجيبك عند حدوث خلل. لكنك تعتمد عليه حينئذ، فاسأل كيف تصل التحديثات وما سرعة الدعم عند الحاجة. وفي الحالتين تُجري منشأتك التسجيل الأولي بنفسها. وهذه أسئلة تطرحها على المطور أو المزود قبل أن تقرر.

• أي خطوات المرحلة الثانية يتولاها نظامكم وأيها علينا؟
• كيف تصلنا تعديلات قواعد الهيئة ومن يختبرها؟
• هل نجرب أولًا في بيئة المحاكاة؟
• ماذا يحدث للفواتير عند انقطاع الإنترنت أو المنصة؟
• أين نرى الفواتير المرفوضة أو غير المرسلة؟

تطبق الهيئة المرحلة الثانية على دفعات مرقمة، تُختار كل منها بحسب إيرادات ضريبة القيمة المضافة في سنوات محددة. وتخطر الهيئة المكلفين في الدفعة مباشرة قبل موعد ربطهم بستة أشهر على الأقل، وقد أعلنت حتى الآن 25 دفعة. فاسأل الهيئة عن دفعتك وموعدك قبل أي قرار.

أعلنت الهيئة أن الدفعة 24 شملت من تجاوزت إيراداتهم الخاضعة لضريبة القيمة المضافة 375,000 ريال في 2022 أو 2023 أو 2024، وموعدها النهائي 30 يونيو 2026 على أبعد تقدير، وقد انقضى. وتشمل الدفعة 25 من تجاوزت إيراداتهم الخاضعة للضريبة 187,500 ريال في 2022 أو 2023 أو 2024 أو 2025، وموعدها النهائي 1 فبراير 2027 على أبعد تقدير.

تدعم فاتوراز متطلبات الفوترة الإلكترونية لدى الهيئة في المرحلتين الأولى والثانية. ويجري التسجيل الأولي على منصة فاتورة بيد المكلّف نفسه، وتُرشدك فاتوراز خطوة بخطوة داخل مساحة عملك. وتعمل التجربة المجانية في بيئة المحاكاة التابعة للهيئة، فتتدرب على حالاتك الحقيقية قبل أن تصدر فاتورة فعلية واحدة.