مفاتيح البوابة من منصة الفوترة الوطني

مفتاح فواترا (fwt_live_…) يصادقك لدينا. أمّا الإرسال الفعلي إلى البوابة فيتم بـ Client-Id و Secret-Key الخاصّين بمنشأتك، ويصدرهما نظام الفوترة الوطني نفسه من شاشة «ربط الأجهزة». هذه الصفحة تشرح من أين تأتي، وما الذي يتغيّر في منشأتك بعد إصدارها.

1 — المتطلّب السابق

من داخل بوابة الضريبة تضغط رابط «الفوترة الوطني» في القائمة العلوية، فتُنقل إلى شاشة إنشاء حساب نظام الفوترة الإلكتروني. الحساب الذي تنشئه هنا هو حساب المستخدم الرئيسي (Admin).

2 — نوعا الحساب

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

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

3 — شاشة «ربط الأجهزة»

4 — أدخلها في الإعدادات

من الإعدادات ألصق Client-Id و Secret-Key مع الرقم الضريبي وتسلسل مصدر الدخل. تُخزَّن مشفّرة ولا تُعرض بعد الحفظ.

5 — بعد الربط: شاشة التسوية

هذه شاشة التسوية التي ستستخدمها بعد الإطلاق: عدد الفواتير فيها يجب أن يطابق سجلّ نظامك و سجل الطلبات لدينا. أي فرق يعني فاتورة أُرسلت ولم تُسجَّل، أو العكس.

6 — الإرجاع

هذه الجملة تصف شاشة الإرجاع داخل المنصّة، حيث تحدّد الكمية المراد إرجاعها لكل بند. برمجياً لا تحتاجها: المرتجع لدينا مستند مستقل عبر POST /v1/credit-notes.

شعار المنشأة على الفاتورة

شعار المنشأة يُرفع من شاشة «إعدادات» في المنصة بحساب المستخدم الرئيسي، ويُضبط لكل تسلسل مصدر دخل على حدة. لا يمرّ عبر الـAPI، فاضبطه مرّة من المنصة.

أشكال الفواتير الثلاثة

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

المصدر: «نظام الفوترة الوطني — دليل المستخدم الخاص بمنصة الـPortal». الاقتباسات منقولة للتوضيح التقني، واللقطات من الدليل نفسه وتعود ملكيتها لجهة إصداره. الدليل الرسمي هو المرجع عند أي اختلاف، وقد تتغيّر الشاشات مع تحديثات المنصّة.