العملاء

صفحة العملاء (قسم المبيعات في شريط التنقل) هي دليل مؤسستك للجهات التي تبيع لها: المستشفيات والشركات والأفراد الذين تصدر لهم الفواتير وعروض الأسعار وأوامر البيع. الملف يجمع ما تحتاجه هذه المستندات في مكان واحد (الاسم القانوني، والمعاملة الضريبية، والرقم الضريبي، والسجل التجاري، والعنوان الوطني، وجهات الاتصال) فتختار العميل في نموذج المستند وتُعبَّأ بياناته بدل كتابتها كل مرة. الدليل ملك المؤسسة كلها: ما يضيفه زميلك تراه أنت.

القائمة

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

ملف العميل

زر عميل جديد يفتح النموذج، وهو أربعة أقسام:

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

المعاملة الضريبية

المعاملة الضريبية تقول ما الذي يُطبع في خانة المشتري على الفاتورة. مسجّل في ضريبة القيمة المضافة (السعودية) هي الحالة الافتراضية، وتتطلب الرقم الضريبي للعميل (15 رقمًا يبدأ وينتهي بـ3)؛ الملف لا يُحفظ بدونه، فاختر معاملة أخرى لمشترٍ لا رقم له. غير مسجّل يطبع السجل التجاري أو المعرّف الآخر بدل الرقم الضريبي، وهو ما تطلبه الهيئة للفاتورة الضريبية مع مشترٍ غير مسجّل. مسجّل في دول الخليج يطبع رقمه الضريبي الخليجي معرّفًا من نوع GCC، وغير مسجّل في دول الخليج وخارج دول الخليج تعاملان كالمشتري غير المسجّل. الاختيار يحدد أيضًا ما تعرضه صفحة مسودة الفاتورة تحت «ما ينقصها قبل الإصدار».

على المستندات

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

عميل هو مورّد أيضًا

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

الصلاحيات

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

الواجهة البرمجية وMCP

كل ما سبق متاح عبر واجهة REST وخادم MCP: customers_list وcustomers_get وcustomers_create وcustomers_update وcustomers_delete وcustomers_link_vendor وcustomers_unlink_vendor بالنطاقين customers.read وcustomers.write. أدوات الإنشاء في الفواتير وأوامر البيع وعروض الأسعار تقبل customer_id لربط المستند بملف؛ على الفاتورة تُنسخ كتلة المشتري من الملف حيثما تُركت خاناتها فارغة، ويعيد customers_get أحدث مستندات العميل مع عددها.