الربط مع موزعي الوطنية (Alwatania Distributors)
الشركة التي توزّع لحساب «الوطنية» مطالَبة بأن تُبقي منصة الموزعين على اطلاع دائم: مَن العملاء الذين تبيع لهم، ومَن المندوبون الذين يزورونهم، وما الأصناف التي تتعامل فيها، وكل فاتورة ومردود تصدره. إعادة كتابة كل ذلك يدويًا على نظام ثانٍ بطيئة وعرضة للخطأ. ربط موزعي الوطنية يرسل هذه البيانات مباشرة من نما، فتُدخَل البيانات مرة واحدة في نما، ونما هو الذي يبلّغ بها المنصة.
الربط في اتجاه واحد: الإرسال فقط. يدفع نما البيانات الأساسية ومستندات المبيعات إلى منصة الوطنية، ولا يقرأ منها شيئًا سوى ردّها على كل طلب (قُبل، أو رُفض مع السبب). لا شيء على المنصة يغيّر سجلات نما.
ما تحتاجه
- الترخيص. الربط جزء من وحدة «نما للتكاملات» (NaMa Integrations) ويحتاج الترخيص
integrations-ksa-watania-samil(الرمز المختصر ADC). بدونه لا يظهر عنصر القائمة. - بيانات الدخول من الوطنية. تعطيك المنصة رابط الحصول على التوكن، والرابط الأساسي للواجهة البرمجية، ومعرّف العميل (Client Id)، ومفتاح الواجهة (API Key). كلها تُسجَّل على سجل واحد هو إعدادات ربط موزعي الوطنية.
- مهمة مجدولة أو اثنتان. لا يوجد زر إرسال في أي مكان. البيانات لا تخرج من نما إلا عندما يعمل أحد ثلاثة إجراءات جاهزة، من مهمة مجدولة من نوع إجراء (Action) أو من مسار كيان. صفحة إرسال البيانات الأساسية والفواتير تشرح طريقة إعدادها.
تجد الإعدادات في integrations ← الملفات ← إعدادات ربط موزعي الوطنية.
كيف تنتقل البيانات إلى المنصة
للمنصة مفرداتها الخاصة: محافظات (Provinces)، ومدن (Cities)، وفروع (Branches)، ومناطق (Regions)، وفئات عملاء (Client Classes)، ومندوبون (Salesmen)، وعملاء (Clients)، وأصناف (Items)، وتفاصيل أصناف (Item Details). كل واحد منها يُغذّى من ملف في نما، وطريقة الربط ثابتة — لا يوجد على الشاشة ما يربط حقلًا بحقل. ما تتحكم فيه هو طريقة تعبئة سجلات نما نفسها.
| ما تستقبله الوطنية | من هذا السجل في نما | ملاحظات |
|---|---|---|
| المحافظات والمدن | الشركة (LegalEntity) | كل شركة تُرسَل مرتين: مرة كمحافظة، ومرة كمدينة تتبع تلك المحافظة نفسها |
| الفروع | المجموعة (MasterGroup) | كل مجموعة تُوضع في مدينة شركتها. فرع العميل على المنصة هو مجموعة العميل، فمجموعات العملاء هي المهمة هنا |
| المناطق | المجموعة التحليلية (AnalysisSet) | تُوضع في مدينة شركتها |
| فئات العملاء | فئة عميل 5 (CustomerClass5) | فئة العميل على المنصة هي حقل فئة عميل 5 على العميل |
| المندوبون | الموظف (Employee) | المندوب المسجَّل على العميل وعلى الفاتورة |
| العملاء | العميل (Customer) | انظر قائمة الحقول أدناه |
| الأصناف | الصنف (InvItem) | الاسم العربي والإنجليزي فقط — لا تُرسَل تكلفة ولا سعر |
| تفاصيل الأصناف | الصنف (InvItem) | صف لكل وحدة في جدول الوحدات على الصنف؛ وهي الوحدات التي تقبلها المنصة في سطور الفواتير |
| الفواتير | فاتورة مبيعات، مردودات مبيعات | يُرسَل المردود بنوع الفاتورة Returned، والفاتورة بنوع Sale |
المنصة تحتاج هذه البيانات بهذا الترتيب — لا يمكن أن يصل عميل قبل المدينة والفرع اللذين ينتمي إليهما — ونما يرسلها بهذا الترتيب آليًا.
ما يُرسَل عن العميل
لكل عميل يرسل نما اسمه العربي والإنجليزي، وشركته (كمدينة)، وفئة عميل 5، ورقم التسجيل الضريبي، ورقم السجل التجاري، ورقم هاتف (الموبايل، أو تليفون 1 إذا كان الموبايل فارغًا)، ومجموعته (كفرع)، ومندوب المبيعات، وعنوانه (السطر الأول من العنوان، أو الثاني إذا كان الأول فارغًا)، وتاريخ إنشائه وتاريخ آخر تعديل عليه.
ما يُرسَل عن الفاتورة
لكل فاتورة مبيعات أو مردود: كود المستند كرقم للفاتورة، والعميل، وهل هي نقدية (Cash) أم آجلة (Credit) حسب علامة «اجلة» على المستند، وإجمالي الخصم (خصم الرأس مع خصومات كل السطور)، والضريبة، والصافي، وتاريخ الإصدار وتاريخ الاستحقاق، ومندوب المبيعات، وسطر لكل صنف بوحدته وكميته وحجم الوحدة وسعر الوحدة.
الأسماء والمعرّفات
حيث تقبل المنصة اسمًا واحدًا يرسل نما الاسم العربي. وحيث تقبل الاسمين، يُستبدل الاسم الفارغ بالآخر، ثم بالكود. والمنصة تعرّف كل سجل برقم يبنيه نما من المعرّف الداخلي للسجل، لا من كوده — فلا يلزم أن تكون أكوادك رقمية، ويحمل العميل الرقم نفسه في كل فاتورة تذكره.
ما الذي يُرسَل، ومتى
ثلاثة سلوكيات تحكم كل ما عداها في هذا الربط، وتفاجئ من يتوقع زر «مزامنة»:
- لا يُرسَل إلا الجديد أو المعدَّل. كل تشغيل ينظر فيما أرسله في المرة السابقة. السجل الأساسي الذي قُبل ولم يتغير منذ ذلك الحين يُتخطّى، فيبقى التشغيل المتكرر خفيفًا. ومستند المبيعات الذي قُبل لا يُرسَل مرة أخرى أبدًا، حتى لو التقطه الاستعلام من جديد.
- المحاولات الفاشلة تُعاد وحدها. السجل أو المستند الذي رفضته المنصة، أو الذي تعذّر إرساله لأن المنصة لم تكن متاحة، يُحاوَل من جديد في التشغيل التالي.
- كل إرسال يترك صفًا في السجل، وحذف ذلك الصف يجعل نما يعامل السجل كأنه لم يُرسَل قط. هكذا تفرض إعادة الإرسال — انظر سجلات الإرسال وإعادة الإرسال.
صفحات هذا القسم
- إعداد ربط الوطنية — الشاشة الوحيدة وحقولها.
- إرسال البيانات الأساسية والفواتير — الإجراءات الثلاثة ومدخلاتها، ومهام مجدولة ومسارات كيان جاهزة للنسخ.
- سجلات الإرسال وإعادة الإرسال — قراءة السجلين، وفرض إعادة الإرسال، والرسائل التي قد تظهر لك.