erp-uebernahmepunkte
في الإعدادات > نقاط استلام ERP، تهيئون كيفية استلام الطلبات من نظام ERP خارجي كملفات XML تلقائيًا في Klacks.
كيف يعمل الأمر
ثلاث طرق للتسليم: يمكن لنظام ERP توفير الملفات في مساحة تخزين نقطة الاستلام (Drop Point) (يجلبها Klacks تلقائيًا حسب جدول زمني)، أو دفعها مباشرة عبر HTTP-POST إلى نقطة استيراد (مصادَق عليها برمز وصول)، أو يمكن لمسؤولة رفع ملف XML يدويًا على هذه الصفحة عبر السحب والإفلات.
نقطة الاستلام (Drop Point) هي صندوق البريد المركزي الذي يديره Klacks نفسه لجميع ملفات الاستيراد — وتعرض ثلاثة أقسام: الوارد (بانتظار التشغيل التالي)، والمُعالَج (الأرشيف)، والأخطاء (ملفات غير صالحة مع سبب الخطأ، مع إمكانية إعادة الاستيراد). يتحكم جدول زمني (تعبير Cron، الافتراضي كل ساعة) بالإضافة إلى مفتاح تفعيل/إيقاف مؤقت في الجلب التلقائي.
رموز الوصول لا تُحتاج إلا عندما يقوم نظام ERP بتسليم الملفات عبر الدفع (Push). يبدأ كل رمز بـ klacks_erp_، وهو صالح لمدة تتراوح بين يوم و730 يومًا (الافتراضي 365)، ويُعرض كنص صريح مرة واحدة فقط عند الإنشاء. رمز كهذا صالح حصريًا لنقطة الاستيراد، وليس لبقية الوصول إلى API، ويمكن إلغاؤه في أي وقت.
المعالجة: تُربط الطلبات، بناءً على معرّف النظام المصدر ومرجع العميل الخارجي (أو بديلًا عن ذلك الشركة/الرمز البريدي/الشارع)، بعميل قائم أو تُنشئ عميلًا جديدًا، وتنشأ في البداية كمسوَّدة يجب على المخططين مراجعتها واعتمادها. تسليم جديد معدَّل لطلب معتمَد بالفعل يُنهي القديم تلقائيًا وينشئ نسخة جديدة مرتبطة به؛ أما التسليمات المتكررة غير المعدَّلة فلا تؤدي إلى أي إجراء.
من الجيد معرفته
- تُرفَض الطلبات الفردية الخاطئة (مثلًا بدون يوم أسبوع أو بمرجع مكرَّر) دون منع بقية الطلبات الصالحة في نفس الملف؛ ومع ذلك يُنقل الملف بأكمله إلى قسم الأخطاء حتى لا يُغفَل أي شيء.
- تُؤرشَف الملفات المعالَجة، ولا تُحذف.
- صيغة XML الدقيقة (الحقول الإلزامية، صيغ التاريخ، منطق يوم الأسبوع) موثَّقة في الدليل مباشرة على صفحة الإعدادات وكذلك عبر ملف نموذجي قابل للتنزيل.
- تقع هذه التهيئة ضمن قسم الإعدادات، وهي بذلك مقتصرة على الأدوار الإدارية.
جرّبوا مباشرة: ملعب Klacks — تسجيل الدخول admin@test.com / P@ssw0rt1، تتم إعادة ضبط البيانات يوميًا.