forumفتح موضوع جديد
فتح موضوع جديد

قالوا لنا بنعمل تكامل API — إيش يعني، وهل لازم يكون بند منفصل في العرض؟

MMeltemعضو جديد
المسمى الوظيفي
بائع كتب
نوع المنظمة
تعاونية
تاريخ الانضمام
سبتمبر 2024
رسالة
32
#1

عندنا شركة تصنيع وبيع تجزئة للأثاث. حاليًا نستخدم برنامج محاسبة وERP داخلي، والمخزون والفواتير كلها من هناك. الآن نتفاوض مع وكالة رقمية عشان نسوي موقع تجارة إلكترونية جديد وموقع مؤسسي.

في عرض التطوير اللي قدمته الوكالة بمبلغ 180.000 TL فيه بند من سطر واحد مكتوب "تكامل API مع أنظمتكم الحالية" وما فيه أي تفاصيل عن النطاق قدامه. لما سألنا في الاجتماع قالوا إن موقعكم بيتكلم مع نظام ERP وكل شي بيشتغل أوتوماتيك، بس ما دخلوا في التفاصيل التقنية.

إيش هو تكامل API بالضبط وليش يُترك هذا الشغل بهذا الشكل المبهم في العرض؟ هل لازم يُسعّر كبند عمل منفصل عن الموقع، أو هو جزء طبيعي من حزمة تطوير الويب؟ وإيش الحدود اللي لازم نرسمها في مرحلة العقد عشان ما نتضرر لاحقًا؟

GGökhan C***مشارك
المسمى الوظيفي
مسؤول المشتريات
قطاع
مطبعة
نوع المنظمة
مؤسسة متوسطة الحجم
تاريخ الانضمام
يونيو 2022
رسالة
181
الأكثر إفادة#2

الجواب المختصر: تكامل API هو الجسر التقني اللي يخلّي موقع التجارة الإلكترونية عندك وبرنامج المحاسبة أو المستودع يتبادلان البيانات لحظيًا بدون تدخل بشري. هذا الشغل ما لازم يُترك أبدًا كسطر واحد في العرض، بل لازم تُحدد اتجاه البيانات المنقولة وتكرارها كبند منفصل في المواصفات التقنية.

سبب ترك الوكالات لهذا البند مبهمًا هو إنها ما تقدر تتوقع العقبات التقنية اللي بتواجهها لما تدخل في الشغل. التكامل مو شغل من طرف واحد؛ مو كافي إن الموقع يكون جاهز، لازم برنامج ERP عندك كذلك يكون عنده دعم API وترخيص يسمح بفتح البيانات للعالم الخارجي. كثير من البرامج التجارية تطلب رسوم ترخيص إضافية لهذه الوحدة.

فيه ثلاث نقاط أساسية لازم توضحها في العقد: 1) اتجاه تدفق البيانات: هل المخزون والأسعار من المحاسبة بتتدفق للموقع، أو الطلبات وبطاقات العملاء من الموقع بتتكتب في المحاسبة؟ 2) تكرار التشغيل: هل البيانات تُحدّث لحظيًا أو مرتين في اليوم؟ 3) إدارة الاستثناءات: لما ينقطع الإنترنت أو ما يرد سيرفر ERP، كيف تُسجّل الطلبات المعلّقة في السجلات؟

نصيحتي، قبل ما توافق على العرض، احصل على توثيق API من الشركة اللي أخذت منها برنامج ERP وسلّمه للوكالة. بعد ما تدرس الوكالة هذا التوثيق، لازم تضيف التكامل كبند تسليم منفصل مع سيناريوهات اختبار وشروط ضمان في العرض.

VVildan Ş***مشارك
المسمى الوظيفي
فني مراقبة الجودة
قطاع
نسيج
نوع المنظمة
مؤسسة متوسطة الحجم
تاريخ الانضمام
أغسطس 2024
رسالة
162
#3

API هو الباب اللي يسأل فيه برنامجان بعضهما ويستقبلان ردًا بصيغة موحدة. بس إذا هذا الباب مسكّر من ناحية ERP، الوكالة ما تقدر تسوي شي من جهة الموقع. هل عند مزوّد ERP خدمات جاهزة بمعمارية REST، أو بينكتب خدمة جسر خاصة في النص؟ أي توقيع يُوقع قبل توضيح هذا بيولّد تكلفة إضافية.

PPerihan S***مشاركعضو المجتمع
تاريخ الانضمام
يوليو 2023
رسالة
352
#4

إحنا سوينا نفس الغلطة في مشروع مشابه. الوكالة كتبت التكامل بسطر واحد، ولما خلص الموقع قالت شركة المحاسبة "ترخيص API عندنا 50.000 TL والربط عليكم". الوكالة قالت "إحنا ما نتدخل في المحاسبة" وانسحبت على جنب. المشروع تعطّل ستة أشهر كاملة وكل شركة تلوم الثانية.

KKemal Ç***مشارك
المسمى الوظيفي
مندوب مبيعات ميداني
قطاع
بلاستيك
نوع المنظمة
شركة بـ 120 موظف
تاريخ الانضمام
أكتوبر 2022
رسالة
140

Doki · تصميم الواجهات · 2023

#5

خلّي البند ذاك من سطر واحد في العرض يتعدّل فورًا. اكتب في العقد جداول البيانات اللي بتنتقل واحد واحد: بطاقات المنتجات، قوائم الأسعار، كميات المخزون، وتفاصيل الطلبات. وكذلك اجعل مكان تسجيل الأخطاء عند تعارض البيانات شرطًا في العقد.

LLeyla Ç***خبير
المسمى الوظيفي
محاسبة أولية
قطاع
خدمات الأمن
نوع المنظمة
مؤسسة متوسطة الحجم
تاريخ الانضمام
يناير 2026
رسالة
1
#6

وفقاً لقانون العقود ومبادئ المواصفات الفنية، فإن التعهدات غير محددة النطاق بشأن التكامل قد تُفسر ضد مصلحة صاحب العمل في حال نشوء أي نزاع. يجب توضيح معايير قبول خدمات التكامل، والمدد الزمنية المسموحة لإصلاح الأخطاء، والطرف المسؤول عن تكاليف تراخيص برمجيات الطرف الثالث بشكل صريح في ملحق العقد.

VVildan D***مشارك
المسمى الوظيفي
فني مراقبة الجودة
قطاع
كهرباء وإلكترونيات
نوع المنظمة
وكيل إقليمي
تاريخ الانضمام
أبريل 2024
رسالة
160

Doki · تدريب الوعي بالتصيّد الاحتيالي · 2024

#7

وعدهم بتقديم موقع تعريفي للشركة، وبنية تحتية للتجارة الإلكترونية، وتكامل مخصص مع ERP بميزانية إجمالية قدرها 180.000 TL لا يبدو لي واقعياً على الإطلاق. التكامل السليم ثنائي الاتجاه يحتاج وحده إلى أسابيع من الاختبارات. على الأغلب سيقومون فقط بإنشاء نقل بسيط للطلبات ويعتبرون المهمة منتهية.

SSena M***مشاركعضو المجتمع
تاريخ الانضمام
ديسمبر 2024
رسالة
142
#8

صار معنا نفس الشي بالضبط، بعدها صارت تيجي الطلبات من الموقع بس نسب ضريبة القيمة المضافة أو الخصومات تترحل غلط على الـ ERP. الموظفين تبهدلوا من كثر التعديل اليدوي. نصيحة لا توافقوا على هالبند قبل ما تجهزوا جدول مطابقة البيانات.

JJülide S***خبيرعضو المجتمع
تاريخ الانضمام
سبتمبر 2023
رسالة
184
#9

هل برنامج ERP الذي تستخدمونه نظام سحابي حديث أم أنه يعمل على خادم محلي داخل الشركة؟ إذا كان بنية مكتبية قديمة الطراز، فسيتطلب الأمر عنوان IP ثابت وتهيئة للجدار الناري للوصول الخارجي؛ هل قامت الوكالة بفحص متطلبات هذه البنية التحتية؟

GGamze U***مشارك
المسمى الوظيفي
مدير التكنولوجيا
قطاع
مطبعة
نوع المنظمة
فريق من 8 أشخاص
تاريخ الانضمام
فبراير 2024
رسالة
270
#10

دعني أترك تنبيهًا. عند اتخاذ القرار، اكتب أسوأ سيناريو أيضًا، وليس الأفضل فقط.

إذا كان هناك من يفعلها بطريقة أخرى، فأنا فضولي لمعرفة ذلك.

CCansu I***محارب قديمعضو المجتمع
تاريخ الانضمام
يوليو 2022
رسالة
377
#11

هل يمكنك توضيح هذا أكثر؟ الحلول التي تنجح على نطاق صغير تنهار عند التوسع، تعلمت هذا متأخراً.

صححوا لي إن أخطأت.

KKadir G***مشاركعضو المجتمع
تاريخ الانضمام
سبتمبر 2022
رسالة
44
#12

مررت بهذا الطريق، دعني أشرح. ابدأ بتجربة صغيرة، لا تربط كل شيء دفعة واحدة.

الناس يدافعون عن العادات وليس العمليات. المقاومة تأتي من هناك. مثبت بالتجربة.

HHilal D***مشاركعضو المجتمع
تاريخ الانضمام
ديسمبر 2024
رسالة
166
#13

أوافق.

YYağmur P***خبير
المسمى الوظيفي
مدير علاقات العملاء
قطاع
كهرباء وإلكترونيات
نوع المنظمة
شركة بـ 120 موظف
تاريخ الانضمام
يونيو 2025
رسالة
405
#14

إذا كنت ستسلك هذا المسار، فحل هذه المشكلة من البداية. أرخص عرض سعر هو غالباً الأقل تفكيراً.

اكتبوا إذا كانت لديكم أسئلة، سأجيب قدر استطاعتي.

LLale K***مشاركعضو المجتمع
تاريخ الانضمام
أكتوبر 2025
رسالة
323
#15

شكراً لكتابة هذا، فهو صحيح تماماً. الناس يدافعون عن العادات وليس العمليات. المقاومة تأتي من هناك.

هذا كل شيء، أرجو المعذرة إذا أطالت.

FFerhat A***خبيرعضو المجتمع
تاريخ الانضمام
مارس 2026
رسالة
124
#16

هناك خطأ شائع جداً يقع فيه الكثيرون أثناء فعل هذا. الحلول التي تنجح على نطاق صغير تنهار عند التوسع، تعلمت هذا متأخراً.

بالطبع يختلف الأمر إذا كانت حالتك مختلفة.

MMert Ö***مشارك
المسمى الوظيفي
موزع وقود
نوع المنظمة
شركة ناشئة حديثة التأسيس
تاريخ الانضمام
نوفمبر 2023
رسالة
64
#17

ملخص سريع للجدد: إذا كانت هذه أول مرة، ابدأ صغيراً، والتوسع يأتي لاحقاً.

عند اتخاذ القرار، اكتب أسوأ سيناريو أيضًا، وليس الأفضل فقط.

PPerihan K***مشارك
المسمى الوظيفي
مدير المنتج
قطاع
خدمات تموين
نوع المنظمة
شركة من 20 شخصاً
تاريخ الانضمام
فبراير 2024
رسالة
220

Doki · موقع ويب مؤسسي · 2024

#18

نحن أيضاً واجهنا نفس المشكلة في فترة معينة. ابدأ بتجربة صغيرة، لا تربط كل شيء دفعة واحدة.

إذا كان هناك من يفعلها بطريقة أخرى، فأنا فضولي لمعرفة ذلك.

AAslı G***خبيرعضو المجتمع
تاريخ الانضمام
يناير 2023
رسالة
1
#19

شكرًا، هذا هو الجواب الذي كنت أبحث عنه.

FFatma E***مشاركعضو المجتمع
تاريخ الانضمام
أكتوبر 2025
رسالة
89
#20

شكرًا جزيلاً، سأجربها اليوم ولا تترددوا في السؤال، فالسائل يدفع ثمناً أقل دائماً.

مثبت بالتجربة.

اكتب رداً