تكامل الفاتورة مع أنظمة نقاط البيع POS

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

يخاطب هذا الدليل المطوّرين ومسؤولي الأنظمة وأصحاب منشآت التجزئة التي تبيع مباشرة للأفراد: المتاجر، الصيدليات، محطات الوقود، المقاهي، العيادات، وكل نشاط يصدر فواتير عند نقطة الدفع. هذا السيناريو يختلف جوهريًا عن تكامل أنظمة تخطيط الموارد (ERP) للمكتب الخلفي وعن التكامل البرمجي عبر واجهة برمجية مباشرة، وقد أفردنا كلًا منهما في موضعه. هنا نركّز على الحالة الميدانية: السرعة، حجم الفواتير العالي، والبيع وجهًا لوجه.

لماذا تختلف نقطة البيع عن باقي سيناريوهات التكامل

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

في المقابل، تكامل أنظمة ERP في المكتب الخلفي يخدم في الغالب فواتير الشركات الكاملة (B2B)، وهذه تخضع لنموذج «المقاصة» (Clearance): تنتظر الفاتورة موافقة مسبقة من الهيئة قبل تسليمها للمشتري. هذا الفارق وحده يفرض تصميمًا تقنيًا مختلفًا تمامًا عند نقطة البيع.

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

يترتب على ذلك ثلاث خصائص تقنية تميّز سيناريو نقطة البيع:

• الإصدار محلي وفوري في الجهاز، لا يعتمد على رحلة ذهاب وإياب لحظية مع الهيئة قبل إتمام البيع.
• رمز الاستجابة السريع (QR) إلزامي ومرئي على إيصال العميل، لأنه وسيلة التحقق الميدانية من الفاتورة.
• كل جهاز نقطة بيع يُسجَّل كوحدة إصدار مستقلة (EGS Unit) لها شهادتها التقنية الخاصة.

عنوان الفقرة التالية: مخطط تدفق الفاتورة عند نقطة البيع

جهاز نقطة البيع كوحدة إصدار مستقلة (EGS Unit)

في المرحلة الثانية من الفوترة الإلكترونية، لا تتعامل الهيئة مع منشأتك ككيان واحد عند الإصدار، بل مع كل جهاز إصدار على حدة. الجهاز الذي يولّد الفواتير يُسمى وحدة توليد الفواتير الإلكترونية (E-invoice Generation Solution)، ويُختصر بـ EGS Unit. كل صندوق كاشير، وكل جهاز نقطة بيع، وكل تطبيق إصدار يُعدّ وحدة EGS مستقلة.

هذا التمييز جوهري عند التجزئة. متجر بثلاثة صناديق دفع لديه ثلاث وحدات EGS. كل وحدة تمرّ بدورة تهيئة (Onboarding) مستقلة مع منصة فاتورة، وتحصل على شهادتها التقنية الخاصة. لا يجوز أن يتقاسم جهازان شهادة واحدة.

الشهادة التي تربط الوحدة بالهيئة هي شهادة الامتثال التقني، ومعرّفها هو CSID (وليس CCSI). هذه الشهادة هي ما يوقّع به الجهاز فواتيره، وهي ما يثبت أن الفاتورة صدرت من وحدة معتمدة. للتفصيل التقني الكامل راجع دليل شهادة Compliance CSID.

دورة تهيئة جهاز نقطة بيع جديد

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

1. توليد زوج مفاتيح (مفتاح خاص ومفتاح عام) داخل الجهاز أو النظام.
2. إنشاء طلب توقيع شهادة CSR يحمل بيانات المنشأة ومعرّف الوحدة.
3. طلب رمز التفعيل (OTP) من منصة فاتورة عبر بوابة الهيئة.
4. إرسال طلب الامتثال واستلام شهادة الامتثال CSID.
5. اجتياز فحوص الامتثال على عيّنات فواتير، ثم استلام شهادة الإنتاج PCSID.

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

كيف يولّد جهاز نقطة البيع فاتورة مبسّطة سليمة

في لحظة الدفع، يبني الجهاز فاتورة بصيغة UBL 2.1 تحمل مجموعة عناصر إلزامية. كل عنصر يولَّد محليًا في الجهاز قبل الطباعة بأجزاء من الثانية. العناصر الأساسية:

رمز الاستجابة السريع في الفاتورة المبسّطة ليس صورة تزيينية. هو حقل إلزامي يحمل تسعة عناصر بترميز TLV (Tag-Length-Value) ثم تُرمَّز النتيجة بصيغة Base64. هذه العناصر تشمل اسم البائع، ورقمه الضريبي، وطابع التاريخ والوقت، وإجمالي الفاتورة، وقيمة الضريبة، وقيمة تجزئة الفاتورة، والتوقيع، والمفتاح العام. مثال مبسّط على بنية حقل واحد بترميز TLV:

Tag    Length   Value
0x01   0x0B     "Qoyod Store"        (seller name)
0x02   0x0F     "300000000000003"    (VAT number)
0x03   0x14     "2026-06-24T12:41:00Z" (timestamp)
0x04   0x06     "115.00"             (invoice total)
0x05   0x05     "15.00"              (VAT total)

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

عنوان الفقرة التالية: تشريح إيصال نقطة البيع المتوافق

تدفق المعاملة خطوة بخطوة في الجهاز

لفهم التكامل من منظور تقني، إليك تسلسل ما يحدث داخل الجهاز من لحظة الضغط على زر الدفع حتى تسليم الإيصال:

1. يُغلق البائع السلة ويختار طريقة الدفع، فيُرسل الطلب إلى وحدة الإصدار في الجهاز.
2. تبني الوحدة مستند الفاتورة بصيغة UBL 2.1 وتعبّئ البنود والضريبة والإجمالي.
3. تحسب الوحدة قيمة تجزئة الفاتورة وتربطها بقيمة PIH للفاتورة السابقة.
4. توقّع الوحدة الفاتورة بمفتاحها الخاص فتنتج الختم التشفيري.
5. تولّد الوحدة رمز QR بترميز TLV ثم Base64.
6. يُطبع الإيصال ويُسلَّم للعميل فورًا، فتكتمل المعاملة من منظور العميل.
7. تُوضع نسخة الفاتورة (XML) في طابور الإبلاغ المحلي.
8. يرسل النظام الفاتورة إلى منصة فاتورة في الخلفية خلال نافذة 24 ساعة، ويستلم الإقرار.

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

طلب الإبلاغ نفسه نداء برمجي بسيط إلى منصة فاتورة. شكله المنطقي مثال توضيحي:

POST /invoices/reporting/single
Content-Type: application/json

{
  "invoiceHash": "NWZ...base64...",
  "uuid": "3cf5ee18-ee25-44ea-a444-2c37ba7f28be",
  "invoice": "PD94bWwg...UBL-as-base64..."
}

Response 200 OK
{
  "reportingStatus": "REPORTED",
  "validationResults": { "status": "PASS" }
}

التعامل مع انقطاع الإنترنت في نقطة البيع

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

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

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

السرعة عند الدفع: لماذا لا يبطئ التكامل الكاشير

القلق المشروع في التجزئة أن تتسبب متطلبات الفوترة في إبطاء طابور الدفع. التصميم السليم يلغي هذا القلق لسببين.

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

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

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

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

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

إدارة عدة أجهزة وفروع في منشأة واحدة

منشآت التجزئة نادرًا ما تعمل بصندوق واحد. متجر متوسط قد يضم عدة صناديق في الفرع الواحد، وسلسلة قد تضم عشرات الفروع. كل صندوق وحدة EGS مستقلة، فكيف تُدار هذه المنظومة تقنيًا؟

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

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

عنوان الفقرة التالية: هيكل المنشأة متعددة الأجهزة

الأخطاء الشائعة في تكامل نقطة البيع

من واقع تطبيق المرحلة الثانية في التجزئة، تتكرر أخطاء تقنية محددة. تجنّبها يوفّر مخالفات ومراجعات لاحقة:

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

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

كيف يتولّى قيود تكامل نقطة البيع

يجمع قيود بين نظام محاسبي وبرنامج فاتورة إلكترونية ونظام نقاط بيع في منصة واحدة. هذا التكامل الداخلي يلغي الحاجة لربط ثلاثة أنظمة منفصلة:

• يصدر نظام نقاط البيع الفاتورة المبسّطة برمز QR متوافق في لحظة الدفع.
• يدير برنامج الفاتورة الإلكترونية شهادة كل جهاز (CSID) وتجديدها تلقائيًا.
• يبلّغ النظام منصة فاتورة عن كل فاتورة خلال نافذة 24 ساعة دون تدخل يدوي.
• يعمل الكاشير بدون إنترنت ويستكمل الإبلاغ عند عودة الاتصال.
• تتدفق بيانات المبيعات من كل جهاز إلى الحسابات والقوائم المالية مباشرة.

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

للاطلاع على السيناريوهات المجاورة، راجع دليل الإبلاغ الذي يشرح مسار الفاتورة المبسّطة بتفصيل أكبر في دليل الإبلاغ (Reporting)، ودليل الشهادة التقنية في دليل شهادة Compliance CSID.

الإشعارات الدائنة والمرتجعات عند نقطة البيع

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

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

كذلك يوجد الإشعار المدين (Debit Note) حين تزيد قيمة المعاملة بعد إصدار الفاتورة الأصلية. كلا الإشعارين يخضعان للمرحلة الثانية بالعناصر التقنية ذاتها. الجدول التالي يلخّص الفرق:

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

التكامل مع أجهزة الدفع والملحقات

جهاز نقطة البيع لا يعمل وحده، بل ضمن منظومة ملحقات: قارئ الباركود، الطابعة الحرارية، درج النقود، وأحيانًا جهاز الدفع (Payment Terminal). التكامل السليم يربط هذه الملحقات بمسار الإصدار دون أن يبطئه.

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

الفصل المهم هنا أن جهاز الدفع البنكي ودورة الفوترة الإلكترونية مساران منفصلان. عملية تحصيل المبلغ من بطاقة العميل تجري عبر جهاز الدفع البنكي، بينما إصدار الفاتورة المتوافقة يجري في وحدة الإصدار. النظام السليم يكمّل الفاتورة فور تأكيد الدفع، فلا يصدر فاتورة لعملية لم تكتمل، ولا يحصّل مبلغًا دون فاتورة.

أمن المفاتيح وحماية بيانات الإصدار

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

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

قيمة التجزئة (hash) بخوارزمية SHA-256 تضمن أن أي تعديل على بيانات الفاتورة بعد توقيعها يُكتشف فورًا، لأن أي تغيير بسيط في البيانات يغيّر قيمة التجزئة بالكامل. وربط كل فاتورة بتجزئة سابقتها عبر PIH يبني سلسلة لا يمكن حذف حلقة منها أو تعديلها دون أن تنكسر السلسلة كلها.

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

اختبار التكامل والتحقق من الجاهزية

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

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

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

أسئلة تقنية متكررة حول تكامل نقطة البيع

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

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

هل يختلف التعامل مع المطاعم عن متاجر التجزئة؟ المبدأ التقني واحد: فاتورة مبسّطة بنموذج إبلاغ ورمز QR. تختلف الواجهة وإدارة الطاولات والمطبخ، وهي ما يضيفه نظام كاشير المطاعم فوق هذا الأساس، دون تغيير منطق الفوترة الإلكترونية.

هل أحتاج كتابة كود لبناء رمز QR أو التوقيع؟ لا، عند استخدام قيود. هذه العمليات مبنية داخل المنصة. الأمثلة البرمجية في هذا الدليل لأغراض الفهم التقني فقط، لا للتنفيذ اليدوي.