عملية استعراض مواد التسوّق الخاصة بالبيع عبر الإنترنت JSON

تُستخدم هذه العملية لعرض قائمة المواد (المنتجات) المتوفرة للبيع عبر الإنترنت، وذلك من خلال الاتصال بخادم النظام عبر واجهة برمجة التطبيقات (API).

الخطوات العملية داخل النظام:

1. من نافذة التسوّق:
   يقوم المستخدم بفتح واجهة التسوّق في النظام.
2. الضغط على زر "إحضار المواد":
   عند الضغط على هذا الزر، يتم إرسال طلب (Request) إلى الخادم لجلب قائمة المواد المرتبطة بمتجر الإنترنت.

تفاصيل الطلب (Request)

• العنوان (Server):
  http://127.0.0.1:1818/
  وهو العنوان المحلي للخادم (localhost).
• طريقة الإرسال (Method):
  POST
  أي أن البيانات تُرسل إلى الخادم باستخدام طريقة "النشر".

معلومات الرأس (Header)

Version: 1.0

Type: ShopRecord

Username: JSON

Password: 00000

هذه المعلومات تُستخدم للتعريف بنوع الطلب وإصدار البروتوكول، وكذلك للمصادقة (Authentication).

محتوى الطلب (Body)

{

  "storesShop": "7E47F890-650E-4577-80C2-A88261444FC9",

  "lastUpdate": "2000-01-01",

  "isExportAll": true

}

    storesShop: المعرّف الفريد (GUID) للمتجر المطلوب جلب بياناته.

    lastUpdate: تاريخ آخر تحديث تمت مزامنته مسبقاً؛ ويُستخدم الخادم لتحديد ما إذا كانت هناك بيانات جديدة بعد هذا التاريخ.

    isExportAll: إذا كانت قيمته (true)، فسيقوم النظام بإرسال جميع المواد بغضّ النظر عن تاريخ التحديث.

النتيجة (Response)

يرد الخادم ببيانات على شكل JSON تتضمّن قائمة المواد التي تنتمي إلى المتجر.

كل مادة تحتوي على معلومات مفصلة مثل:

    Number: الرقم التسلسلي للمادة.

    Code: الرمز الداخلي للمادة.

    Name / LatinName: اسم المادة بالعربية واللاتينية.

    GroupName / GroupLatinName: اسم المجموعة التي تنتمي إليها المادة (مثل: مطعم، سوبرماركت، إلكترونيات...).

    Consumer: السعر المخصص للمستهلك.

    VAT: نسبة الضريبة المضافة.

    Qty: الكمية الحالية في المخزون.

    IsImage: يوضح إن كانت المادة تحتوي على صورة أم لا.

كما أن بعض الحقول الأخرى تحدد خصائص إضافية مثل حجم الوحدة (Unity)، وجود اللون أو المقاس، وأسعار الجملة والتصدير وغيرها.