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

قالوا "سنقوم بتكامل API" — كيف تسير العملية، وما المطلوب منا؟

NNuri N***مشاركعضو المجتمع
تاريخ الانضمام
نوفمبر 2023
رسالة
4
#1

نستقبل في موقعنا للتجارة الإلكترونية ما بين 60 و70 طلباً يومياً في المتوسط. حتى الآن كان أحد موظفينا يدخل الفواتير وحركات المخزون يدوياً في برنامج المحاسبة كل مساء. الآن اتفقنا مع فريق برمجي خارجي لتصبح الطلبات وحسابات العملاء والمخزون متزامنة تلقائياً. أعطونا ميزانية 45.000 TL ومدة إنجاز 3 أسابيع.

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

ما المراحل التي تمر بها عملية تكامل API هذه عملياً؟ وما الصلاحيات والحسابات والبيانات التي يجب علينا كشركة تأمينها حتى لا تتعطل العملية؟ وهل مدة 3 أسابيع واقعية برأيكم؟

RRecep T***عضو جديد
المسمى الوظيفي
مندوب مبيعات ميداني
قطاع
لوجستيات
نوع المنظمة
شركة ضمن مجموعة استثمارية
تاريخ الانضمام
أغسطس 2026
رسالة
39

Doki · إعداد النسخ الاحتياطي · 2023

الأكثر إفادة#2

الجواب المختصر: تكامل API هو أن يتخاطب موقعك وبرنامج المحاسبة تلقائياً بالبيانات ضمن قواعد محددة مسبقاً. وحتى تسير العملية عليك تفعيل ترخيص API لبرنامج المحاسبة، وتسليم وثائق المطورين للمبرمج، وتأمين بيئة اختبار يمكن العمل فيها دون المساس بالبيانات الحية.

تسير العملية معيارياً على أربع مراحل. المرحلة الأولى هي ربط البيانات؛ حيث تُطابَق الحقول في موقعك (اسم العميل، الرقم الضريبي، رمز المنتج، نسبة KDV، أجرة الشحن) مع الحقول في برنامج المحاسبة حقلاً بحقل. المرحلة الثانية هي تكامل بيئة التطوير والاختبار (sandbox)؛ وهنا ينشئ المبرمج طلبات وهمية ويجرب ترحيلها إلى نظام المحاسبة.

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

ما سيُطلب منك هو ثلاثة أشياء أساساً: 1) مفاتيح API ووثيقة المطورين التي تُؤخذ من شركة المحاسبة، 2) الوصول إلى قاعدة بيانات الاختبار، 3) موافقتك الخطية التي تشرح قواعد عملك (وقت إصدار الفاتورة، منطق تتبع المخزون، قواعد الخصم). إذا وفّر طرف المحاسبة الوثيقة التقنية كاملة فمدة 3 أسابيع معقولة جداً؛ لكن إذا كان دعم المحاسبة بطيئاً فقد تصل المدة إلى 5 أسابيع.

UUfuk S***مشارك
المسمى الوظيفي
محاسبة أولية
قطاع
زراعة
نوع المنظمة
تعاونية
تاريخ الانضمام
يونيو 2022
رسالة
74

Doki · دعم الاستجابة للحوادث · 2025

#3

الخطأ الأكثر حساسية هو عدم تطابق رموز المنتجات. إذا لم تكن رموز المخزون في موقع التجارة الإلكترونية مطابقة تماماً لرموز المخزون في المحاسبة، فسيفشل التكامل من اليوم الأول. قبل تسليم العمل للمبرمج، تحقق بنفسك في جدول Excel من أن جميع رموز منتجاتك مطابقة لطرف المحاسبة.

CCanمشارك
المسمى الوظيفي
خبير تحسين محركات البحث
تاريخ الانضمام
مارس 2024
رسالة
172
#4

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

KKader U***مشارك
المسمى الوظيفي
موظف متجر
قطاع
الإعلام والنشر
نوع المنظمة
شركة عائلية
تاريخ الانضمام
يونيو 2024
رسالة
86
#5

أنجزنا تكاملاً مشابهاً العام الماضي. استغرق الحصول على ترخيص API ومفاتيح الاختبار من شركة المحاسبة 9 أيام كاملة. انتهت برمجة فريق المبرمجين في 12 يوماً، لكن الاختبارات امتدت 8 أيام بسبب تعارض سطور الشحن والخصم مع المحاسبة. إجمالاً تمكنا من الانتقال إلى الحي في 29 يوماً.

OOrhan T***مشاركعضو المجتمع
تاريخ الانضمام
مارس 2024
رسالة
242
#6

قائمة التحضير من جانبك يجب أن تكون كالتالي: 1) اطلب بيئة اختبار (sandbox) ووثيقة من شركة المحاسبة. 2) وضّح مع محاسبك المالي كيف ستُعالج حالات الإلغاء والمرتجع والتسليم الجزئي واستخرج قواعد خطية. 3) قبل الانتقال إلى الحي، أصدر فواتير اختبارية في 15 سيناريو مختلفاً على الأقل.

YYaseminمشارك
المسمى الوظيفي
صاحب مشروع صغير
تاريخ الانضمام
يوليو 2024
رسالة
98
#7

برنامج المحاسبة عندكم سحابي ولا مثبّت على سيرفر محلي بمكتبكم؟ إذا كان يشتغل على جهاز بالمكتب فلازم IP ثابت وفتح بورت على السيرفر. وهذا ممكن يخلق ثغرة أمنية وكمان لما ينقطع إنترنت المكتب تتوقف عملية الربط؛ تكلمتوا في هذي النقطة؟

TTaner E***مشارك
المسمى الوظيفي
مسؤول المشتريات
قطاع
جلد
نوع المنظمة
شركة ناشئة حديثة التأسيس
تاريخ الانضمام
يونيو 2023
رسالة
132
#8

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

تعديل: كتبت خطأً أعلاه، أرجو المعذرة.

SSinemخبير
المسمى الوظيفي
مدير مشاريع
تاريخ الانضمام
أكتوبر 2023
رسالة
176
#9

وحّدوا فريق البرمجة مع قسم الدعم الفني لبرنامج المحاسبة في مجموعة إيميل مشتركة أو قناة تواصل. مو لازم أنت تفهم المصطلحات التقنية وتكون الجسر بينهم. خلّي البارامترات والـ endpoints يحلونها بينهم مباشرة أهل التقنية.

VVahide K***مشارك
المسمى الوظيفي
مصمم جرافيك
قطاع
طاقة
نوع المنظمة
شركة بـ 120 موظف
تاريخ الانضمام
نوفمبر 2023
رسالة
411
#10

بأول عملية ربط لنا ما حبينا ندفع 12.000 TL على بيئة اختبار، سوينا الاختبار مباشرة على قاعدة البيانات الحقيقية. لما المبرمج أصدر فاتورة تجريبية انبعثت للعميل الحقيقي فاتورة e-arşiv ورسائل SMS. ذاك اليوم فهمنا بوضوح تام إن الفلوس اللي تنعطى لبيئة الاختبار هي فعلاً أرخص تأمين.

OOnur M***خبير
المسمى الوظيفي
موظف محاسبة
قطاع
بلاستيك
نوع المنظمة
مؤسسة متوسطة الحجم
تاريخ الانضمام
مايو 2023
رسالة
7
#11

تم الحفظ.

HHüseyin S***محارب قديمعضو المجتمع
تاريخ الانضمام
يوليو 2022
رسالة
175
#12

الإجابة أعلاه لخصت جوهر الأمر. المسألة ليست الرقم، بل الأساس الذي بُني عليه.

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

İİbrahim Y***مشاركعضو المجتمع
تاريخ الانضمام
ديسمبر 2024
رسالة
182
#13

هناك نقطة لم أفهمها. إذا لم ينص العقد على ملكية الكود، تفقد قوتك التفاوضية عند المغادرة.

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

HHilal B***محارب قديم
المسمى الوظيفي
مصمم جرافيك
قطاع
كهرباء وإلكترونيات
نوع المنظمة
وكيل إقليمي
تاريخ الانضمام
ديسمبر 2023
رسالة
17
#14

دعني أشارك تجربتي. يجب فتح بيانات الوصول باسم المؤسسة، وليس بحسابات شخصية.

دعني أتركها كملاحظة، قد تكون مفيدة.

İİbrahim Y***مشاركعضو المجتمع
تاريخ الانضمام
فبراير 2026
رسالة
3
#15

أوافق.

EElifمشارك
المسمى الوظيفي
صاحب سلسلة مقاهي
نوع المنظمة
شركة تصنيع بـ 40 موظفًا
تاريخ الانضمام
أغسطس 2024
رسالة
63

Doki · دعم الاستجابة للحوادث · 2024

#16

لا تتجاهل شيئاً: أرخص عرض سعر هو غالباً الأقل تفكيراً.

لو كنت مكانك، لسلك هذا المسار.

HHavva K***مشاركعضو المجتمع
تاريخ الانضمام
يوليو 2024
رسالة
111
#17

الطريق الذي يبدو رخيصاً غالباً ما يكلف غالياً لاحقاً. يجب فتح بيانات الوصول باسم المؤسسة، وليس بحسابات شخصية.

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

MMehmet A***خبير
المسمى الوظيفي
مطور برمجيات
قطاع
تدريب
نوع المنظمة
مؤسسة بـ 300 موظف
تاريخ الانضمام
يوليو 2022
رسالة
2
#18

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

لو كنت مكانك، لسلك هذا المسار.

KKübra G***خبير
المسمى الوظيفي
مدير تقنية المعلومات
قطاع
الرياضة واللياقة
نوع المنظمة
شركة من 20 شخصاً
تاريخ الانضمام
نوفمبر 2025
رسالة
10
#19

عانيت من نفس الشيء. تقرير التقدم الأسبوعي المكتوب أكثر فائدة من السؤال المستمر عن المواعيد.

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

OOsman K***مشاركعضو المجتمع
تاريخ الانضمام
مارس 2024
رسالة
117
#20

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

لا تترددوا في السؤال، فالسائل يدفع ثمناً أقل دائماً. هذا كل شيء، أرجو المعذرة إذا أطالت.

اكتب رداً