EGS (وحدة حل الفوترة الإلكترونية)

من فريق ماثل، مبني على مواصفات الهيئة و SDK 3.4.8 · آخر تحديث

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

EGS اختصار E-invoice Generation Solution. حسب دليل الهيئة، حل الفوترة الإلكترونية ممكن يتكوّن من وحدة أو أكثر، والوحدة هي اللي تصدر الفواتير فعلياً: كاشير، أو نقطة بيع، أو سيرفر متجر إلكتروني.

كل وحدة تتسجّل في الهيئة لحالها: لها CSR وشهادة CSID خاصة، ولها سلسلة فواتير خاصة (عدّاد ICV وهاش PIH). هوية الوحدة داخل الـ CSR في subjectAltName: الرقم التسلسلي SN بصيغة 1-اسم الحل|2-الإصدار|3-رقم الوحدة، والرقم الضريبي في UID، وخريطة الوظائف في title (أربع خانات TSCZ: ضريبية، مبسّطة، ورقمين للحالات الخاصة، مثل 1100 للضريبية والمبسّطة).

وش يغلط؟ كاشيرين يشتغلون بنفس الشهادة ونفس السلسلة: يطلع رقمين بنفس العدّاد وتنكسر السلسلة. أو بيانات غير ASCII (عنوان بالعربي مثلاً) داخل subjectAltName، وopenssl يحذفها بصمت والهيئة ترد Invalid-CSR.

في ماثل كل جهاز ياخذ رقم تسلسلي خاص و device_token واحد. التوكن ما يتشارك بين جهازين، ولو صار يرد ماثل 409 device_token_reused. والباقات محسوبة بعدد أجهزة الإنتاج.

مثال

[ alt_names ]
SN = 1-Matheel|2-…|3-…
UID = 3…3
title = 1100
registeredAddress = RRRD2929
businessCategory = General

أسئلة شائعة

عندي ثلاث فروع وكل فرع فيه كاشيرين، كم EGS أسجّل؟

كل كاشير يصدر فواتير هو وحدة لحاله، يعني ست وحدات، كل وحدة بـ OTP وشهادة وسلسلة خاصة.

هل أقدر أشارك شهادة وحدة وحدة بين جهازين؟

ما ينصح فيه: الجهازين يتشاركون عدّاد وهاش، وأي فاتورتين بنفس الوقت تكسر السلسلة.

قواعد الهيئة المرتبطة

مصطلحات قريبة

خلّ ماثل يتعامل مع هذا عنك

ماثل يوقّع الفاتورة ويرسلها للهيئة ويمسك العدّاد والهاش بطلب واحد، ويرجّع الـ PDF مع رمز QR.

جرّب ماثل بدون تسجيل توثيق ماثل API