التكاملات / ERP / Visma Net ERP
دليل تكامل Visma Net لجدولة الإنتاج باستخدام SkyPlanner APS
يوضح دليل تكامل Visma Net للشركاء وفرق تقنية المعلومات كيفية ربط Visma Net (Visma.net ERP) بنظام SkyPlanner APS. يتكامل SkyPlanner مع Visma Net في الاتجاهين عبر Visma Net API:
- يستقبل SkyPlanner أصناف المخزون وKit specifications وأوامر البيع وأرصدة المخزون وأوامر الشراء.
- تتحول المهام المجدولة إلى سجلات Kit assemblies، وتُرحَّل عند اكتمال العمل.
- تُعاد ساعات عمل المشغّلين إلى Visma Net في سجلات Employee time cards.
- تُرسل آليات webhooks في SkyPlanner تغييرات الجدول فور حدوثها.
يضبط فريق SkyPlanner التكامل بما يلائم إعدادات Visma Net لديك خلال مرحلة التهيئة، ويواصل دعمه بعد بدء التشغيل الفعلي. هذا الدليل موجّه إلى الشركاء والمطورين الراغبين في المشاركة أو تطوير التكامل بأنفسهم باستخدام REST API الموثّقة من SkyPlanner (مرجع API).
واجهات التكامل في Visma Net
- Visma Net ERP API. واجهة REST بمواصفة OpenAPI لا تزال تحمل اسم “Visma.net ERP API v1″، وتضم مسارات v1 وv2. عنوان URL الأساسي هو
https://api.finance.visma.net. يُطبَّق تقييد على معدل الطلبات للنطاق القديمintegration.visma.netاعتبارًا من 1 فبراير 2026، ويجري إيقافه (إشعار). - SalesOrder service v3 على العنوان
https://salesorder.visma.net. انتهى العمر التشغيلي لنقاط نهاية أوامر البيع في v1 وv2. - إشعارات الويب عبر Visma Developer Portal.
- Background API. تضع الترويسة
erp-api-backgroundالاستدعاءات الطويلة في قائمة انتظار، وتُرجع الرمز 202 مع معرّف للمهمة، وتُشعرك عندما تصبح النتيجة جاهزة. - سيناريوهات الاستيراد والتصدير في Visma Net، باستخدام موفّري بيانات CSV أو Excel أو SQL لتحميل البيانات الرئيسية مرة واحدة.
لا تتضمن API نقاط نهاية لأوامر الإنتاج أو مسارات الإنتاج أو مراكز العمل، لأن هذه الكائنات غير موجودة في Visma Net. تأتي بيانات الجدولة من الأصناف والأطقم والأوامر والمخزون:
GET /v1/inventory: الأصناف المخزنية وغير المخزنية، بما في ذلك علامة الطقم وفئة الصنفGET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: بنود المكونات لكل مراجعةGET /v1/kitassembly: سجلات التجميع الحالية، مع إمكانية تصفيتها حسب النوع والحالة- SalesOrder service v3: الطلب مع التواريخ المطلوبة والبنود
GET /v1/inventorysummary/{inventoryNumber}: الكميات الموجودة والمتاحة في كل مستودعGET /v1/purchaseorderوGET /v2/PurchaseReceipt: المواد الواردة ومستندات الاستلام
تقبل جميع نقاط نهاية القوائم lastModifiedDateTime مع lastModifiedDateTimeCondition، إضافةً إلى pageNumber وpageSize، مما يتيح مزامنة التغييرات فقط في كل مرة.
المصادقة والحدود
يستخدم Visma Net نظام Visma Connect (OpenID Connect وOAuth 2.0):
- سجّل تكاملًا من نوع Service Integration في Visma Developer Portal.
- يوافق مسؤول بيئة العميل في Visma Net على التكامل.
- اطلب الرموز المميزة باستخدام تدفق بيانات اعتماد العميل على
https://connect.visma.com/connect/token، مع تمريرtenant_idونطاقات صلاحيات API مثلvisma_api:read. تسري الرموز المميزة لمدة 3,600 ثانية.
تُطبَّق حدود معدل الطلبات ضمن نافذة زمنية ثابتة مدتها ساعة لكل شركة وعميل API. تتضمن الاستجابات X-RateLimit-Limit وX-RateLimit-Remaining وX-RateLimit-Reset، وعند تجاوز الحد يُرجَع الرمز 429 مع Retry-After (حدود معدل الطلبات). وتحمي الترويستان ETag وIf-Match التحديثات.
يجري الشركاء الاختبارات على شركة تجريبية من خلال برنامج Integrator Programme المجاني من Visma. أما في SkyPlanner، فتستخدم REST API رمز API مميزًا للمصادقة (SkyPlanner Settings > API)، وهي موثّقة في Swagger/OpenAPI. يشرح الدرس التطبيقي للتكامل كيفية إجراء الاستدعاءات الأولى.
الأحداث وإشعارات الويب والاستعلام الدوري
تغطي إشعارات الويب في Visma Developer Portal الأحداث المهمة للجدولة:
- أحداث إنشاء صنف مخزني وتحديثه وتغييره: Inventory Item Created وUpdated وChanged
- أحداث تغيير أمر الشراء وتغيير حالته: Purchase Order Changed وStatus Changed
- أحداث تغيير أمر البيع وتغيير حالته: Sales Order Changed وStatus Changed، التي تنتقل إلى الناشر SalesOrderService
لا توجد أحداث تخص Kit assembly أو Kit specifications. يستعلم SkyPlanner عنها دوريًا باستخدام مرشحات lastModifiedDateTime. ويستعلم عن أرصدة المخزون عند تشغيل الجدولة. وفي الاتجاه الآخر، يرسل SkyPlanner إشعارات ويب عند تغيّر الحالة أو الجدول.
مطابقة البيانات
| كائن Visma Net (نقطة النهاية) | كائن SkyPlanner | الاتجاه | التواتر |
|---|---|---|---|
الأصناف المخزنية وغير المخزنية (/v1/inventory) | المنتجات والمواد | Visma Net → SkyPlanner | تحميل أولي، ثم إشعارات ويب |
Kit specifications (/v1/KitSpecifications) | بنية المنتج والمواد اللازمة لكل منتج | Visma Net → SkyPlanner | تحميل أولي، ثم استعلام دوري |
| أوامر البيع (SalesOrder service v3) | الأوامر مع مواعيد الاستحقاق وأولوية العميل | Visma Net → SkyPlanner | إشعار ويب |
سجل Kit assembly بحالة On hold (/v1/kitassembly)، إذا كانت سجلات التجميع تُنشأ في Visma Net | مهام الإنتاج | Visma Net → SkyPlanner | استعلام دوري |
ملخص المخزون (/v1/inventorysummary) | أرصدة المخزون لكل مستودع | Visma Net → SkyPlanner | استعلام عند تشغيل الجدولة |
أوامر الشراء ومستندات استلام المشتريات (/v1/purchaseorder، /v2/PurchaseReceipt) | المواد الواردة مع تاريخ التسليم؛ يُحدَّث المخزون عند تسليم المواد المطلوبة بأمر الشراء | Visma Net → SkyPlanner | إشعار ويب، ثم قراءة البيانات |
| غير موجود في Visma Net | خطوات العمليات، محطات العمل، الورديات، مصفوفة أوقات التهيئة، الأدوات، الموارد البديلة | تُدار في SkyPlanner | تُعدّ خلال مرحلة التهيئة |
إنشاء سجل Kit assembly وتحديثه (POST/PUT /v1/kitassembly) | المهمة المجدولة: صنف الطقم، الكمية، تاريخ الانتهاء المخطط | SkyPlanner → Visma Net | عند تغيّر الجدول، عبر إشعار ويب من SkyPlanner |
ترحيل سجل Kit assembly (/v1/kitassembly/{type}/{refNo}/action/release) | المهمة المكتملة: الإنتاج واستهلاك المكونات | SkyPlanner → Visma Net | عند الاكتمال |
استلام المخزون وصرفه (/v1/inventoryReceipt، /v1/inventoryissue، والترحيل) | الإنتاج واستهلاك المواد عند عدم استخدام الأطقم | SkyPlanner → Visma Net | عند الاكتمال |
سجل Employee time card (/v1/timeCard) | الساعات المسجلة لكل مشغّل | SkyPlanner → Visma Net | أسبوعيًا |
أنماط التكامل
1. التحميل الأولي للبيانات الرئيسية. اقرأ أصناف المخزون وفئات الأصناف وأحدث مراجعة من Kit specification لكل طقم. طابق كل بند من بنود المكونات مع مادة في SkyPlanner. ثم أنشئ البيانات غير المتوفرة في Visma Net: محطات العمل والورديات وخطوات العمليات مع أوقات التهيئة والتشغيل، ومصفوفة أوقات التهيئة، ومتطلبات الأدوات. استوردها بصيغة CSV أو Excel. هذا هو الجزء الأكبر من المشروع.
2. مزامنة الأوامر. اختر نموذجًا واحدًا للطلب:
- الاعتماد على أوامر البيع. تتحول البنود المفتوحة لأصناف الأطقم في أوامر البيع إلى أوامر في SkyPlanner، ويصبح التاريخ المطلوب هو تاريخ الاستحقاق.
- الاعتماد على سجلات التجميع. تتحول سجلات Kit assemblies المنشأة في Visma Net بحالة On hold إلى مهام في SkyPlanner.
تُستورد أوامر الشراء المفتوحة مع تواريخها. يعتبر SkyPlanner المواد المطلوبة متاحة في تاريخ تسليم أمر الشراء، ويحدّث المخزون عندما يُعيَّن الأمر إلى الحالة Delivered. وبالاستعانة بملخص المخزون، تتحقق الجدولة من المخزون والمشتريات الواردة معًا.
3. إرسال بيانات الجدولة إلى Visma Net. عند اعتماد الإعداد على أوامر البيع، ينشئ SkyPlanner سجل Kit assembly من النوع Production لكل مهمة مجدولة. ويحدد صنف الطقم والمراجعة والمستودع والكمية والمكونات، ويربط سجل التجميع ببند أمر البيع. ويكون تاريخ التجميع هو تاريخ الانتهاء المخطط. وعندما يغيّر Autopilot موعد المهمة، يُحدَّث التاريخ باستدعاء PUT قبل الترحيل.
يحتوي سجل Kit assembly على حقل Date واحد، لذا تبقى أوقات العمليات التفصيلية في SkyPlanner، ويتلقى Visma Net التاريخ المهم للمبيعات والمخزون.
4. تأكيدات العمل في أرض المصنع. يسجّل المشغّلون العمل باستخدام Mobile Confirmations أو Production Timer، وتحافظ سجلات الوقت على تحديث الجدول. وعند اكتمال الخطوة الأخيرة، يستدعي SkyPlanner إجراء الترحيل لسجل Kit assembly. يُرحّل هذا الإجراء الإنتاج واستهلاك المكونات، وتتبعه دفعة قيود دفتر الأستاذ العام. وتُجمَّع الساعات في سجلات Employee time cards أسبوعية، أو في حركات المشاريع عندما يكون العمل قائمًا على المشاريع.
5. قواعد ملكية البيانات وحل التعارضات. وثّق هذه القواعد قبل بدء التشغيل الفعلي:
| البيانات | النظام المسؤول |
|---|---|
| الأصناف، وKit specifications، وأوامر البيع، وأوامر الشراء، والمخزون، والتكلفة | Visma Net |
| خطوات العمليات، ومحطات العمل، وورديات العمل، وعمليات التجهيز، والأدوات | SkyPlanner |
| تسلسل المهام، وأوقات البدء والانتهاء، وتخصيص محطات العمل | SkyPlanner |
| تاريخ Kit assembly قبل الترحيل | SkyPlanner |
| مستندات Kit assemblies وبطاقات الوقت المرحّلة | Visma Net، مع الترحيل من SkyPlanner |
يؤدي تعديل Kit specification إلى إنشاء مراجعة جديدة. أعد قراءة أحدث مراجعة وتحديث ربط بياناتها، إذ لا يمكن استخدام سوى المراجعة الأخيرة للتجميع. وتظل التعديلات اليدوية على مكوّنات مستند التجميع سارية في Visma Net، لذا يعيد SkyPlanner قراءة المستند قبل ترحيله.
الخطوات المعتادة للمشروع
يكتمل التنفيذ عادةً خلال أسابيع من بدء التهيئة. وقبل ذلك، يمكنك استخدام بياناتك خلال التجربة المجانية لمدة 30 يومًا، وذلك بتصديرها عبر سيناريو تصدير في Visma Net ثم استيرادها بصيغة CSV أو Excel.
- تحديد النطاق. حدّد نموذج الطلب وجدول ربط البيانات وقواعد ملكيتها والوجهة التي ستتلقى التحديثات من SkyPlanner (Kit assembly أو إيصالات استلام المخزون).
- إعداد Visma Connect. سجّل Service Integration واحصل على موافقة مسؤول بيئة العميل. اختبر أولًا في شركة تجريبية.
- نموذج الإنتاج. إعداد محطات العمل وورديات العمل وخطوات العمليات وعمليات التجهيز والأدوات في SkyPlanner.
- التحميل الأولي للبيانات. أصناف المخزون وفئات الأصناف وKit specifications والمستودعات والمخزون.
- مزامنة أوامر البيع والشراء. استخدام webhooks لأوامر البيع وأوامر الشراء والأصناف، والاستقصاء الدوري لأطقم التجميع والمخزون. وتشمل هذه الخطوة تجديد رموز الوصول ومعالجة استجابات 429.
- إرسال التحديثات إلى Visma Net. إنشاء Kit assembly وتحديثه وترحيله، إلى جانب بطاقات الوقت.
- الاختبار بالتوازي. شغّل SkyPlanner بالتوازي مع الخطة الحالية وقارن التواريخ.
- بدء التشغيل الفعلي. فعّل إرسال التحديثات إلى Visma Net بعد التأكد من تطابق البيانات.
ما يجب مراعاته عند التخطيط للتكامل مع Visma Net
- لا توجد مسارات إنتاج لاستيرادها. تُعرَّف جميع خطوات العمليات وأوقات التجهيز والتشغيل في SkyPlanner من البداية. حدّد الجهد المطلوب والمسؤول عن هذا العمل.
- Advanced logistics. يتطلب Kit assembly مجموعة Advanced logistics. أما عند استخدام Standard logistics، فرحّل الإنتاج باستخدام Inventory receipt وInventory issue.
- المراجعات المقفلة. لا يمكن تعديل مراجعة Kit specification سبق استخدامها، ولا يمكن التجميع إلا باستخدام أحدث مراجعة.
- وحدات القياس. لكل Kit assembly وحدة قياس خاصة به. تأكد عند الاستيراد من توافقها مع الكميات في SkyPlanner.
- الاستقصاء الدوري في غياب الأحداث. لا تتوفر webhooks لأطقم التجميع. استخدم التغييرات المستخرجة استنادًا إلى
lastModifiedDateTimeبدلًا من إعادة تحميل البيانات كاملةً، حتى لا تتجاوز الحد الأقصى للطلبات في الساعة. - نقاط النهاية الحالية. اعتمد في بناء التكامل على
api.finance.visma.netوSalesOrder service v3 فقط. - موافقة مسؤول بيئة العميل. لن تنجح المصادقة ببيانات اعتماد العميل حتى يوافق مسؤول بيئة العميل على التطبيق. حدّد موعدًا مبكرًا لهذه الخطوة.
- بطاقات الوقت الأسبوعية. تتطلب بطاقات الوقت Advanced financials، وتُعدّ على أساس أسبوعي. اجمع ساعات المشغّلين لكل أسبوع أو رحّلها إلى معاملات المشروع.
من يتولى إعداد التكامل مع Visma Net ودعمه؟
- يتولى فريق SkyPlanner إعداد التكامل خلال التهيئة ودعمه بعد بدء التشغيل الفعلي. ويشمل ذلك جانب SkyPlanner، ونموذج الإنتاج غير المتوفر في Visma Net، واستدعاءات Visma Net API المتفق عليها. تختلف طريقة استخدام Visma Net من مصنع إلى آخر، وتُوظَّف هذه المعرفة في إعداد التكامل.
- يمكن لشريك Visma Net الذي تتعامل معه المشاركة. تقدم Visma نظام Visma Net بالتعاون مع شركاء معتمدين منها، وهم يعرفون إعدادات نظامك ويمكنهم مراجعة ربط البيانات وتطبيق Visma Connect. ويوفر SkyPlanner واجهة REST API ووثائق Swagger/OpenAPI وwebhooks.
- يمكن لمطوّريك بناء التكامل باستخدام واجهة REST API الموثّقة نفسها ورمز API. يكفي رمز API للبدء، ويقدّم فريق SkyPlanner المساعدة عند الحاجة. تتوفر الوثائق العامة في وثائق SkyPlanner.
بعد الربط، يتولى محرك Arcturus الجدولة استنادًا إلى أوامر Visma Net الحية، وتُعاد بيانات العمل المنجز إلى Visma Net في صورة مستندات Kit assemblies مرحّلة. تبدأ الأسعار من 199 € شهريًا، وتشمل 5 محطات عمل، مع فوترة شهرية. ويُقدَّم لك مسبقًا عرض سعر للتكامل يناسب إجراءات عملك واحتياجاتك، إلى جانب باقتك، لتعرف التكلفة الكاملة قبل البدء.
اطّلع على الأسعار، وتعرّف على سبب حاجة Visma Net إلى أداة جدولة في صفحة تخطيط الإنتاج في Visma Net وفق القدرة الفعلية للآلات والموظفين. وتجد نظرة عامة في صفحة Visma Net، وأنظمة ERP الأخرى في مركز التكامل مع أنظمة ERP.
آراء المصنّعين في SkyPlanner
2 ساعةتوفير كل أسبوع
“نقل SkyPlanner تخطيط الإنتاج لدينا من جداول Excel إلى تحسين الإنتاج في الوقت الفعلي.”
Kalle Kalliomäki، أخصائي سلسلة الإمداد
UTU · لوحات التوزيع ومعدات الفصل والتوصيل الكهربائية
يوفر تخطيط الإنتاج 2 ساعة من وقت العمل كل أسبوع، وتصل قائمة مهام جديدة إلى خط الإنتاج خلال ثوانٍ.
+90%في كفاءة الإنتاج
“ارتفعت كفاءة الإنتاج بنسبة 90%.”
Abdul Rucyinga، رئيس قسم تقنية المعلومات
Laboratory & Allied · صناعة الأدوية
ارتفعت كفاءة الإنتاج بنسبة 90%، وأصبح إعداد خطة محسّنة لثلاثة أشهر تشمل جميع محطات العمل يستغرق أقل من 30 دقيقة.
98%نسبة الالتزام بمواعيد التسليم، بعد أن كانت نحو 50%
“يؤدي SkyPlanner دورًا حاسمًا في الحفاظ على التزامنا بمواعيد التسليم.”
Hannu Lahtinen، المدير العام
KJH-Comp · تصنيع الأجزاء الميكانيكية من الصفائح المعدنية والتصنيع التعاقدي
ارتفعت نسبة الالتزام بمواعيد التسليم من نحو 50% لتصل إلى 98%، وأصبحت الجدولة تحتاج إلى مشرف واحد بدلًا من مشرفين اثنين.
6 أشهريرى فريق المبيعات خلالها القدرة الإنتاجية المتاحة مسبقًا
“يوفر SkyPlanner أساسًا موثوقًا لجميع أعمال تخطيط الإنتاج.”
Anu Järvinen، مديرة الإنتاج
Fredman Operations · أوراق تغليف آمنة لملامسة الأغذية
يرى فريق المبيعات القدرة الإنتاجية المتاحة لستة أشهر مقبلة، وتُجاب طلبات تعديل الجدول خلال ثوانٍ بعدما كانت تستغرق ساعة أو أكثر.
الأسئلة الشائعة
هل تتضمن Visma Net API أوامر إنتاج؟
لا. لا يتضمن Visma Net كائنات لأوامر الإنتاج أو مسارات الإنتاج أو مراكز العمل، ولذلك لا تتوفر هذه الكائنات في API. مستند الإنتاج هو Kit assembly على /v1/kitassembly، بينما يحتفظ SkyPlanner بمسارات الإنتاج ومحطات العمل.
ما آلية المصادقة التي يستخدمها التكامل؟
يستخدم التكامل Visma Connect مع تدفق بيانات اعتماد العميل في OAuth 2.0، ويُسجَّل بوصفه Service Integration في Visma Developer Portal. ويوافق عليه مسؤول بيئة العميل، وتكون رموز الوصول صالحة لمدة ساعة واحدة.
هل يستطيع Visma Net إرسال التغييرات فور حدوثها؟
نعم، بالنسبة إلى الأصناف وأوامر البيع وأوامر الشراء، وذلك عبر webhooks في Visma Developer Portal. أما Kit assemblies وKit specifications فلا تتوفر لها أحداث، وتُجلب تغييراتها بالاستقصاء الدوري التزايدي. وترسل webhooks الخاصة بـSkyPlanner تغييرات الجدول فور حدوثها.
كيف تُعاد بيانات الإنتاج المنجز إلى Visma Net؟
ينشئ SkyPlanner مستند Kit assembly لكل مهمة مجدولة، ويحدّث تاريخه باستمرار، ويستدعي إجراء release عند اكتمال المهمة. ويؤدي هذا الإجراء إلى ترحيل الإنتاج واستهلاك المكوّنات. وعند عدم استخدام أطقم التجميع، يؤدي Inventory receipt وInventory issue الغرض نفسه.
هل يمكننا اختبار SkyPlanner قبل بناء التكامل؟
نعم. تدعم التجربة المجانية لمدة 30 يومًا ما يصل إلى 20 محطة عمل، مع استيراد البيانات من Visma Net بصيغة CSV أو Excel، ولا تتطلب بطاقة ائتمان. ابدأ التجربة، أو تواصل مع فريق المبيعات لتحديد نطاق التكامل.
