تستهدف هذه الصفحة مستخدمي الأعمال والعمليات. التفاصيل المعمارية والتقنية للمطوّرين في docs/ERP_INTEGRATION.md.
السلوك الافتراضي: في الإعدادات الجديدة، لا تُكتب الطلبات إلى ERP تلقائيًا. المهام تصل إلى القائمة كـ «مراجعة يدوية»؛ نزّل CSV واستورده إلى ERP. الإرسال التلقائي وأوضاع الكتابة الآمنة والوكيل المحلي الاختياري يُفعَّلون لاحقًا.
التدفق العام
- أنشئ سجل Logo أو Mikro ضمن لوحة التحكم → تكاملات المحاسبة، عيّنه نشطًا، واختر وضع كتابة آمن (افتراضي: CSV يدوي فقط).
- في لوحة التحكم → مطابقة منتجات ERP، أكمل مطابقة SKU → رمز مخزون ERP والوحدة وضريبة القيمة المضافة (مزامنة من المنتجات أو إضافة صفوف).
- تأكد أن للعملاء رمز دفتر/حساب (cari) أو رقم ضريبي؛ عند إنشاء الطلب، تدخل مهمة إلى قائمة انتظار طلبات ERP.
- نزّل CSV من القائمة أو تفاصيل الطلب واستورده إلى ERP. فعّل الإرسال التلقائي فقط بعد استقرار العملية.
المسارات: /dashboard/accounting · /dashboard/integration-mapping?provider=logo أو provider=mikro · /dashboard/integration-outbox.
التحضير المشترك
توضيح على جانب ERP
- كيف تُنشأ الطلبات: CSV يدوي، مجلد استيراد مراقب، stored procedure / وكيل محلي.
- هل حقول SKU للمنتج/المتغير في Convord تطابق رموز مخزون ERP (أو جدول مطابقة).
- كيف يُحدَّد العميل في ERP (<strong>رمز cari/دفتر</strong> مفضّل؛ وإلا الرقم الضريبي).
المنتجات وSKU المتغيرات في Convord
املأ SKU لكل منتج. إن استخدمت الأوزان/المتغيرات، لكل متغير SKU خاص به.
لوحة المطابقة
أدر مجموعة المطابقة النشطة في مطابقة منتجات ERP: أضف صفوف SKU أو «مزامنة من المنتجات»؛ تحقق من الوحدة وضريبة القيمة المضافة الافتراضية. تنزيل CSV من القائمة يتطلب لقطة مطابقة.
الكتابة الآمنة والأتمتة
في الإعدادات، وضع كتابة آمن: CSV يدوي فقط، ملف استيراد فقط، أو procedure فقط. إرسال ERP التلقائي معطّل افتراضيًا؛ فعّله فقط بعد ~20 نقلًا ناجحًا وبيانات مطابقة/عملاء متينة.
Logo — من منظور المستخدم
Convord يكتب الطلب أولًا إلى قائمة انتظار outbox. مسارات Logo الشائعة: استيراد CSV يدوي أو (متقدم) stored procedures SQL / وكيل محلي. «اختبار اتصال REST» الكلاسيكي لا يُستخدم لـ Logo؛ دفع Logo REST المباشر معطّل في الإنتاج.
في لوحة التحكم
- تكاملات المحاسبة → Logo → بدء الإعداد / الإعدادات.
- اختياريًا نقطة نهاية API / مفتاح API لجسر؛ للعمليات عيّن وضع كتابة آمن وعلّم التكامل نشطًا.
- أكمل مطابقة SKU في مطابقة منتجات ERP (
provider=logo).
- أنشئ طلبًا تجريبيًا → نزّل CSV من قائمة انتظار طلبات ERP أو من تفاصيل الطلب.
Mikro — من منظور المستخدم
النمط الشائع: إسقاط CSV مفصول في مجلد استيراد. البديل: سحب بيانات رئيسية عبر bridge (عملاء/منتجات/مخزون) وConvord ERP Agent محلي اختياري. دفع الطلبات ما زال عبر outbox.
في لوحة التحكم
- تكاملات المحاسبة → Mikro → الإعدادات.
- اختر النقل: ملف (مسار استيراد + بادئة ملف) أو bridge (URL). المتغير: Mikro Fly / Run / Jumbo، إلخ.
- في وضع الملف، أدخل مسار استيراد قابل للكتابة واختبار الاتصال؛ في وضع bridge استخدم فحص الصحة وأزرار المزامنة.
- لوحة المطابقة (
provider=mikro) + طلب تجريبي → قائمة / CSV.
CSV يدوي (بداية موصى بها)
المسار الافتراضي والاحتياطي:
- نزّل CSV للمهمة من قائمة انتظار طلبات ERP (يجب وجود لقطة مطابقة).
- بدلاً من ذلك نزّل CSV لـ Logo / Mikro من تفاصيل الطلب (
/dashboard/orders/{id}/erp-manual-export/logo أو .../mikro).
- أعمدة اسم المنتج (PRODUCT_NAME / UrunAdi) تساعد التحقق في Excel؛ بدون مطابقة، قد يظهر عمود المخزون SKU الداخلي.
أعمدة Logo: ORDER_NO;STOCK_CODE;PRODUCT_NAME;QTY;UNIT;UNIT_PRICE
أعمدة Mikro: BelgeNo;StokKodu;UrunAdi;Miktar;Birim
التنسيق: UTF-8 (BOM)، الفاصل ;.
قائمة تحقق (ملخص)
| الخطوة | Logo | Mikro |
|---|
| سجل تكامل + نشط + وضع كتابة آمن | نعم | نعم |
| SKU المنتج/المتغيرات مكتملة | نعم | نعم |
| مطابقة منتجات ERP (SKU + وحدة/ضريبة) | نعم | نعم |
| رمز cari للعميل أو الرقم الضريبي | نعم | نعم |
| طلب تجريبي → قائمة → CSV | نعم | نعم |
| مسار استيراد / bridge أو وكيل | اختياري | نعم |