إعداد ربط ERPNext خطوة بخطوة
تربط نيون بنظام ERPNext عبر معالج من ست خطوات، فتنتقل الفواتير والمدفوعات والأصناف والأسعار بين النظامين تلقائياً.
في هذا الدرس ستتعلم
- تتصل بموقع ERPNext بمفتاح API أو بإنشاء مفتاح من اسم المستخدم
- تختار الشركة ونموذج البيع المناسب لنشاطك
- تجهّز ERPNext وتختبر أن إشعاراته تصل لنيون
- تربط كل موديول بمتجر وفئة احتياطية ومالك للأسعار، ثم تفعّل الربط
محاسبك يعمل على ERPNext، وطلباتك في نيون. بدون ربط، يعيد أحدهم إدخال كل فاتورة يدوياً، ويختلف المخزون بين النظامين خلال أيام. ربط ERPNext يجعل كل فاتورة ودفعة وحركة مخزون في نيون تُسجَّل في ERPNext تلقائياً، ويجلب الأصناف والأسعار من هناك إن أردت.
افتح المعالج
Section titled “افتح المعالج”من شريط مساحات العمل اختر النظام، ثم من مجموعة التكاملات اضغط ربط ERPNext: «اربط نظام ERPNext الخاص بك ليُسجَّل فيه كل فاتورة ودفعة وحركة مخزون تلقائياً.»
الخطوة 1: الاتصال
Section titled “الخطوة 1: الاتصال”-
عنوان ERPNext: «العنوان الذي تفتح به ERPNext في المتصفح، مثل https://erp.yourcompany.com». «لن يُغيَّر فيه شيء في هذه الخطوة.»
-
اختر طريقة الدخول:
- لديّ مفتاح API: اكتب مفتاح API والمفتاح السرّي. «من ERPNext: افتح ملفك الشخصي، ثم API Access، واضغط Generate Keys.»
- ليس لديّ مفتاح API: اكتب اسم المستخدم أو البريد في ERPNext وكلمة المرور، ثم تسجيل الدخول وإنشاء مفتاح. «تُستخدم كلمة المرور مرة واحدة لإنشاء حساب مخصّص لهذا التكامل، ثم تُهمَل. لا تُحفَظ إطلاقاً.»
-
اختبار الاتصال. عند النجاح: تم الاتصال.
الخطوة 2: الاختيار
Section titled “الخطوة 2: الاختيار”- يظهر «متصل باسم … · ERPNext …» للتأكد.
- الشركة: «ستُسجَّل مستندات نيون تحت هذه الشركة.»
- كيف تبيع؟ «إن لم تكن متأكداً فاسأل محاسبك — الاختيار يغيّر كل فاتورة مبيعات.»
| الخيار | المعنى | يناسب |
|---|---|---|
| آخذ عمولة (سوق إلكتروني) | «المتاجر تبيع للعميل وأنت تكسب عمولة إضافة إلى رسوم التوصيل. هذان فقط إيرادك.» | سوق فيه تجار |
| أشتري وأبيع | «أنت تبيع البضاعة بنفسك. قيمة الطلب كاملة إيراد لك، وما يستحقه المتجر تكلفة عليك.» | متجرك أو فروعك |
إن كانت الشركة تستخدم الجرد الدائم، يظهر تنبيه أن نيون لن يرسل قيود المخزون «تفادياً لتسجيل كل تكلفة مرتين».
الخطوة 3: التجهيز
Section titled “الخطوة 3: التجهيز”«يحتاج نيون وجود بعض العناصر في ERPNext الخاص بك. سترى بالضبط ما سيُنشأ قبل كتابة أي شيء.»
-
اضغط أرني ما الذي سيُنشأ. ترى ثلاث مجموعات: حقول المرجع، الحسابات، الإشعارات، مع عدد سيُنشأ وما «يوجد بالفعل ولن يُمسّ».
-
العنوان الذي يُشعِر عليه ERPNext: عنوان نيون العام الذي يرسل له ERPNext التغييرات. «يجب أن يكون عنواناً يمكن الوصول إليه من الإنترنت.» اضغط اختبر هذا العنوان:
- «وصل ERPNext إلى هذا العنوان بنجاح. التحديثات الفورية ستعمل.» ممتاز.
- «رُفض الاتصال» أو «تعذّر على ERPNext ترجمة اسم النطاق» أو «لم يصل… في الوقت المحدّد»: العنوان محلي أو خطأ أو محجوب بجدار حماية. اطلب العنوان الصحيح من الدعم.
-
أنشئها في ERPNext الخاص بي. عند النجاح: اكتمل الإعداد.
إن ظهر أن المفتاح «يخصّ مستخدماً ليس System Manager»: ارجع للخطوة 1 بمفتاح مدير؛ «يُستخدم للتجهيز فقط ولا يُحفظ». وإن ظهر أن بعض الحسابات تحتاج «قرار محاسب»، فدليل حساباتك مختلف عن القياسي؛ اعرضها على محاسبك.
الخطوة 4: الربط
Section titled “الخطوة 4: الربط”«ERPNext لديه كتالوج واحد ولا يعرف أيّ متاجرك يبيع ماذا.» لكل موديول:
- شركة ERPNext.
- متجر المنتجات المستوردة: المتجر الذي تُضاف إليه الأصناف القادمة من ERPNext.
- الفئة الاحتياطية: «تُستخدم فقط للمنتجات التي لا تطابق مجموعتها في ERPNext أي فئة هنا.»
- من يحدّد الأسعار:
| الخيار | ماذا يحدث؟ |
|---|---|
| نيون | «البائعون يحدّدون أسعارهم هنا. ERPNext يستلمها ولا يغيّرها.» |
| ERPNext | «الأسعار تأتي من ERPNext وتكون للقراءة فقط هنا.» الأسماء والصور والأوصاف تبقى في نيون |
| نيون و ERPNext معاً | «يمكن تعديل الأسعار والأسماء والأوصاف والتصنيفات من أي من النظامين، ويُعتمد آخر تعديل.» |
- قائمة الأسعار في ERPNext (حين تأتي الأسعار من هناك): مثل «Standard Selling». «فبدونه لا يمكن قراءة الأسعار من ERPNext.»
ثم حفظ ومتابعة.
الخطوة 5: المزامنة الأولى
Section titled “الخطوة 5: المزامنة الأولى”«إشعارات ERPNext تنقل ما يتغيّر من الآن فقط. هذه المزامنة تجلب ما لدى ERPNext أصلاً.» اضغط بدء المزامنة وتابع المراحل: الاتصال، دليل الحسابات، المورّدون، المستودعات، السنة المالية، الفئات والمنتجات. لكل مرحلة: مضاف، محدَّث، ولم يُطابَق.
ما يظهر تحت هذه تحتاج انتباهك، مثل مورّدين أو مستودعات لم تُطابَق: «مستندات الشراء الخاصة بهم ستنتظر حتى تُنشأ هناك أو تُربط يدوياً.»
الخطوة 6: الإنهاء
Section titled “الخطوة 6: الإنهاء”- ERPNext جاهز. يظهر مفتاح توقيع «لن يُعرض مرة أخرى»؛ انسخه واحفظه في مكان آمن إن أردت.
- فحص الاتصال: الاتصال يعمل أو فشل الاتصال.
- تفعيل: «تبدأ الطلبات الجديدة بالتدفق إلى ERPNext تلقائياً. الطلبات السابقة لا تُرسَل بأثر رجعي.»
- إيقاف مؤقت: «لا يُفقد شيء أثناء الإيقاف، ويُرسَل كل ما تراكم عند الاستئناف.»
- تغيير الإعدادات: يعيدك للمعالج.
أعلى الصفحة يظهر مُفعّل أو موقوف مؤقتاً.
الصيانة: سحب يدوي
Section titled “الصيانة: سحب يدوي”في نفس الصفحة الصيانة: سحب يدوي من ERPNext: «أعد استيراد نوع واحد من البيانات… دون إعادة معالج الإعداد كاملاً.» الأزرار: سحب الأصناف، سحب الفئات، سحب المستودعات، سحب الموردين. لسحب الأصناف اختر الموديول واختيارياً الأصناف المعدّلة منذ تاريخ. النتيجة: «تم فحص … · جديد … · محدَّث … · متجاوَز … · فاشل …».
أخطاء شائعة وحلولها
Section titled “أخطاء شائعة وحلولها”- إن فشل «اختبار الاتصال»، فراجع العنوان (بلا مسار إضافي) والمفتاحين، وأن المستخدم غير معطّل في ERPNext.
- إن لم تصل تغييرات الأسعار من ERPNext، فاختبار العنوان العام في الخطوة 3 لم ينجح، أو من يحدّد الأسعار = نيون.
- إن لم تُرسل طلبات قديمة، فهذا متوقع: الإرسال من لحظة تفعيل فقط.
🛠️ جرّبها بنفسك
على شركة تجريبية في ERPNext:
- أكمل الخطوات 1 إلى 5.
- تفعيل في الخطوة 6.
- أكمل طلباً تجريبياً في نيون حتى تم التوصيل.
- افتح نشاط ERPNext.
عند النجاح: يظهر مستند الطلب بحالة أُرسل، وتجد فاتورته في ERPNext تحت الشركة التي اخترتها.
الخلاصة
Section titled “الخلاصة”- اتصال ← اختيار الشركة ونموذج البيع ← تجهيز واختبار العنوان العام ← ربط الموديولات ← مزامنة أولى ← تفعيل.
- نموذج البيع ومالك الأسعار قراران يحددان أرقامك؛ اتخذهما مع محاسبك.
- الإيقاف المؤقت لا يُفقد شيئاً، والسحب اليدوي يعيد استيراد نوع واحد دون إعادة المعالج.
اختبر فهمكسوق فيه 30 تاجراً، وإيرادك عمولة ورسوم توصيل. أي نموذج بيع؟
في هذا النموذج العمولة ورسوم التوصيل فقط إيرادك، لا قيمة الطلب كاملة.
اختبر فهمكتريد أن تبقى الأسعار في ERPNext هي المرجع، ولا يغيّرها أحد في نيون. ماذا تختار في «من يحدّد الأسعار»؟
مع خيار ERPNext تأتي الأسعار من هناك وتكون للقراءة فقط في نيون.
اختبر فهمكأوقفت الربط مؤقتاً يومين أثناء صيانة ERPNext. ماذا يحدث لطلبات اليومين؟
لا يُفقد شيء أثناء الإيقاف، ويُرسَل ما تراكم عند الاستئناف.

