يتيح تكامل API للبرمجيات التي تستخدمها أن ترسل البيانات إلى بعضها وتستقبلها من بعضها. فإذا كان موقعك الإلكتروني ومتجرك الإلكتروني وبوابة الدفع وشركة الشحن وحساباتك في الأسواق الإلكترونية ومزوّد الفوترة الإلكترونية (e-Fatura) وبرنامج المحاسبة يحتفظ كلٌّ منها بالمعلومة نفسها بشكل منفصل، فهذا يعني أن فريقك يُدخل البيانات ذاتها يدويًا في عدة شاشات كل يوم. نحن نربط هذه الأنظمة ببعضها عبر واجهات API الخاصة بها، ونجعل البيانات تتدفق إلى المكان الصحيح في الوقت الصحيح وبطريقة يمكن تتبّعها.
من الأمثلة النموذجية على هذه الخدمة: إنشاء شحنة تلقائيًا للطلب الذي تأكد دفعه وإرسال رقم التتبع إلى العميل، وإصدار الفاتورة بصيغة e-Fatura أو e-Arşiv، وتحديث المنتجات على Trendyol وHepsiburada عند تغيّر المخزون، ووصول تسجيل نموذج جديد إلى نظام CRM. وحين لا تكفي إضافة جاهزة، نطوّر تكاملات مخصصة تعمل وفق قواعد عملك أنت.
ستجد في هذه الصفحة الأنظمة التي يمكننا التكامل معها مصنّفة فئةً فئة ومع أسماء الشركات: تكامل API لشركات الشحن، وتكامل نقاط البيع الافتراضية (Virtual POS)، وتكامل الأسواق الإلكترونية، وتكامل الفوترة الإلكترونية e-Fatura، وربط أنظمة المحاسبة وERP، والرسائل النصية SMS وWhatsApp والخرائط والذكاء الاصطناعي وغير ذلك. ونوضّح في كل بطاقة الفائدة العملية للتكامل.
لمن يناسب تكامل API؟
- شركات التجارة الإلكترونية: المتاجر التي تريد إدارة المنتجات والمخزون والأسعار والطلبات من مركز واحد بين موقعها والأسواق الإلكترونية مثل Trendyol وHepsiburada وN11 وAmazon.
- الشركات التي تجهّز شحنات كل يوم: الأعمال التي تريد التخلص من نسخ الباركود والملصق ورقم التتبع يدويًا من شاشة شركة الشحن.
- فرق المالية والمحاسبة: الشركات التي تريد ترحيلًا تلقائيًا للمبيعات بدلًا من إدخالها واحدةً تلو الأخرى في Logo أو Mikro أو Paraşüt أو لدى مزوّد e-Fatura.
- شركات الخدمات والاشتراكات: من يريدون ربط الدفع الإلكتروني والتحصيل المتكرر والفوترة التلقائية وإشعارات العملاء في مسار واحد.
- من يريدون فتح برمجياتهم للخارج: الشركات التي تريد تقديم واجهة API آمنة وموثّقة لتطبيقها على الجوال أو لوكلائها أو لشركائها في العمل.
- المؤسسات التي تستخدم أنظمة متعددة: الفرق التي توجد لديها نسخ مختلفة من البيانات نفسها في CRM وERP والموقع الإلكتروني والأدوات الداخلية.
ماذا تشمل خدمة API والتكاملات لدينا؟
الربط بالخدمات الجاهزة
ندرس وثائق API لخدمات الدفع والشحن والأسواق الإلكترونية والمحاسبة والاتصال، ونحدد شروط الوصول وحدود الاستخدام، ثم نضيف الربط إلى موقعك أو لوحة الإدارة أو تطبيق الجوال. وإذا كانت برمجياتك من تطوير شركة أخرى، نبدأ بفحص بنية الشيفرة وصلاحيات الوصول إلى الخادم.
تصميم REST API والتوثيق
إذا أردت فتح نظامك للخارج، نصمم نقاط النهاية وهياكل البيانات ورموز الأخطاء وقواعد ترقيم الصفحات والتفويض. ونعدّ لكل نقطة نهاية توثيقًا يتضمن أمثلة على الطلبات والاستجابات، فيُنجز فريق الجوال لديك أو شركاؤك الربط دون تخمين.
Webhook والمسارات القائمة على الأحداث
نجعل الحدث في نظام ما يُطلق إجراءً في نظام آخر فورًا: كتثبيت الطلب عند تأكيد الدفع، أو إرسال إشعار إلى العميل عند تغيّر حالة الشحنة. ونتحقق من توقيع كل Webhook وارد، وننفّذ العملية مرة واحدة فقط حتى لو وصل الإشعار نفسه مرتين.
مطابقة البيانات والمزامنة ثنائية الاتجاه
نحدد في جدول مطابقة مكتوب أي حقل يقابل أي حقل، وأي نظام هو المصدر المعتمد، وما الذي يسري عند التعارض. وتُحل الفروق في الفئات والمتغيرات ونسب الضريبة والوحدات في هذه المرحلة قبل كتابة أي شيفرة.
المهام المجدولة والنقل المجمّع
نُعدّ للأنظمة التي لا توفر إشعارات فورية مهامَّ تعمل على فترات محددة. وبهذه المهام تُستورد ملفات XML من الموردين وقوائم الأسعار المجمّعة وأسعار الصرف وملفات المخزون أو تُصدَّر بانتظام.
شاشات اللوحة والمراقبة
يمكننا إضافة سجلات العمليات وقوائم الأخطاء وشاشات إعادة الإرسال اليدوي لتتابع حالة التكامل من لوحة الإدارة. وعندما لا يُنقل طلب ما، يرى فريقك بنفسه السبب وطريقة إعادة إرسال السجل.
تكاملات الدفع ونقاط البيع الافتراضية
تكامل بوابات الدفع
نضيف الدفع بالبطاقة إلى موقعك أو تطبيقك: التحقق عبر 3D Secure، وخيارات التقسيط، والاسترداد الكامل والجزئي، وحفظ البطاقة والدفع المتكرر إذا كان المزوّد يدعمهما. ولا نترك نتيجة الدفع لإعادة توجيه المتصفح وحدها، بل نتحقق منها عبر الإشعار الذي يرسله المزوّد من خادم إلى خادم. ولا تُحفظ بيانات البطاقة على خادمك، بل تُستلم عبر نموذج الدفع الآمن الخاص بالمزوّد.
تكامل نقاط البيع الافتراضية للبنوك
إذا كان لديك عقد نقطة بيع افتراضية (Virtual POS) مباشر مع بنكك، نربط الدفع ببنية البنك دون وسيط. ويشمل ذلك مسار 3D Secure، وجدول التقسيط حسب برامج البطاقات، والتفويض المسبق والإقفال اللاحق، وعمليات الإلغاء والاسترداد. وإذا كنت تتعامل مع أكثر من بنك، يمكن توجيه كل دفعة إلى نقطة البيع المناسبة حسب نوع البطاقة.
تكاملات API للشحن والخدمات اللوجستية
تكامل API لشركات الشحن المحلية
عند تأكيد الطلب يُنشأ سجل الشحنة لدى شركة الشحن تلقائيًا؛ ويُطبع الباركود والملصق من لوحتك، ويُضاف رقم التتبع إلى الطلب وإلى البريد الإلكتروني أو الرسالة النصية المرسلة إلى العميل. وتُحدَّث حالات الشحنة عبر Webhook أو الاستعلام المنتظم. كما يُعدّ حساب الوزن الحجمي والتكلفة وإصدار رمز الإرجاع وبيانات الدفع عند الاستلام بقدر ما تتيحه واجهة API لدى الشركة. ومن أكثر الأمثلة طلبًا تكامل Yurtiçi Kargo وAras Kargo وMNG Kargo.
تكامل الشحن الدولي
إذا كنت تشحن إلى الخارج، نربط بنظامك خطوات الحصول على عروض الأسعار وإنشاء الشحنة وتجهيز الملصق والمستندات الجمركية وطلب المندوب والتتبع الدولي. وفي تكامل DHL Express API تُؤخذ بيانات الوزن والأبعاد ومعلومات المنتجات اللازمة للجمارك من الطلب تلقائيًا، ويُطبَّق النهج نفسه على UPS وFedEx وAramex وRoyal Mail.
تكاملات الأسواق الإلكترونية والفوترة الإلكترونية والمحاسبة
تكامل الأسواق الإلكترونية
نتيح لك إدارة منتجاتك من مكان واحد ونقلها إلى الأسواق الإلكترونية: مطابقة الفئات والخصائص، وتحديث المخزون والأسعار، وسحب الطلبات إلى لوحتك، وإعادة إرسال بيانات الشحن إلى السوق، وإجراءات الإلغاء والإرجاع. ومن أكثر الأمثلة طلبًا تكامل Trendyol API وتكامل Hepsiburada وربط Amazon SP-API. ويمكن أيضًا تحديد قواعد أسعار أو مخزون خاصة بكل سوق.
تكامل منصات التجارة الإلكترونية
إذا كان متجرك على Shopify أو WooCommerce أو منصة أخرى، نربط الطلبات ببرنامج المحاسبة والمخزون بنظام المستودع أو ERP. ونستخدم الروابط نفسها لنقل بيانات المنتجات والعملاء والطلبات عند الانتقال من منصة إلى أخرى.
تكامل e-Fatura وe-Arşiv وe-İrsaliye
عند إتمام البيع يُستعلم عمّا إذا كان المشتري مكلّفًا بنظام e-Fatura؛ وبناءً على النتيجة تُصدر فاتورة e-Fatura أو e-Arşiv عبر مزوّد التكامل الخاص بك، ويُرسل ملف PDF إلى العميل ويُسجَّل رقم الفاتورة في الطلب. كما تُعدّ إجراءات e-İrsaliye للشحنات واستلام الفواتير الواردة والإلغاء وفق واجهة API لدى المزوّد.
تكامل المحاسبة وERP
تُنقل الحسابات الجارية وبطاقات المخزون والطلبات والفواتير والتحصيلات تلقائيًا إلى نظام المحاسبة أو ERP لديك، ويعود المخزون والأسعار في الاتجاه المعاكس إلى الموقع عند الحاجة. ولأن السجلات تُحفظ بمفاتيح مطابقة، لا تُنشأ الفاتورة نفسها مرتين. ويمكن كذلك إعداد الربط مع Xero وQuickBooks وQuickFile وSage للشركات في المملكة المتحدة.
الاتصال والخرائط والهوية وواجهات API الأخرى
CRM وأدوات العمل
تصل نماذج الويب وطلبات عروض الأسعار وتسجيلات العملاء الجدد إلى نظام CRM لديك كجهات اتصال وفرص بيع؛ وعند تغيّر مرحلة البيع يصل إشعار إلى فريقك عبر Slack أو Teams. ويمكن تحويل طلبات الدعم إلى بطاقات في Jira أو Trello.
SMS وWhatsApp والمراسلة
تُرسل تأكيدات الطلبات وأرقام تتبع الشحنات وتذكيرات المواعيد ورموز التحقق لمرة واحدة عبر SMS أو WhatsApp. وتُعدّ رسائل القوالب المعتمدة عبر WhatsApp Business Platform (Cloud API)، مع مراعاة موافقات المستلمين في الرسائل التجارية.
إرسال البريد الإلكتروني
نربط رسائل البريد الإلكتروني الخاصة بالعمليات، مثل الطلبات والفواتير وإعادة تعيين كلمة المرور، بخدمة إرسال متخصصة، ونضبط سجلات SPF وDKIM وDMARC لتقليل خطر وصولها إلى مجلد الرسائل غير المرغوب فيها. ويمكن مزامنة قوائم النشرات البريدية مع Mailchimp أو Brevo.
خدمات الخرائط والموقع
تُبنى بخدمات الخرائط ميزات مثل محدد مواقع الفروع والوكلاء، والإكمال التلقائي للعناوين، وتحويل العنوان إلى إحداثيات، ورسوم التوصيل حسب المسافة، والتحقق من نطاق التوصيل.
التحقق من الهوية وتسجيل الدخول
يمكن لعملائك تسجيل الدخول بحساب Google أو Apple أو Microsoft أو Facebook دون إنشاء كلمة مرور؛ وفي التطبيقات المؤسسية تُعدّ جلسة دخول مركزية عبر OAuth 2.0 وOpenID Connect. ويُضاف عند الحاجة التحقق من رقم الهوية الوطنية التركية (T.C. kimlik).
- تسجيل الدخول عبر Google
- تسجيل الدخول عبر Apple
- تسجيل الدخول عبر Microsoft
- تسجيل الدخول عبر Facebook
- OAuth 2.0
- OpenID Connect
- التحقق من رقم الهوية التركية (T.C.)
أدوات Google ومحركات البحث
نربط أحداث Google Analytics 4 وTag Manager لتتبع التحويلات، وخلاصة Merchant Center لقوائم المنتجات، وCalendar للمواعيد، وSheets للتقارير. ويمكن إبلاغ Bing وYandex بالصفحات الجديدة والمحدَّثة عبر IndexNow.
تكامل الذكاء الاصطناعي
نربط النماذج اللغوية الكبيرة بنظامك لمهام مثل مسودات أوصاف المنتجات، وتصنيف طلبات الدعم، وتلخيص المستندات، والبحث الدلالي في محتواك الخاص. ولا يُرسل إلى النموذج إلا ما يلزم من بيانات، ويمكن عرض المخرجات على موافقة بشرية قبل النشر.
الفيديو والاجتماعات والحجوزات
تُنشر الفيديوهات التعليمية عبر YouTube أو Vimeo أو Bunny Stream، ويُنشأ رابط Zoom أو Google Meet تلقائيًا للمواعيد عبر الإنترنت. وفي منشآت الضيافة تُزامن بيانات الغرف والأسعار والحجوزات مع مدير القنوات.
خدمات الإشعارات وتطبيقات الجوال
نربط تطبيقك على الجوال بخدمات الإشعارات الفورية، والتحقق من المشتريات داخل التطبيق والاشتراكات، وتقارير الأعطال، ومراقبة الأخطاء. ويُتحقق من المشتريات عبر التحقق من جهة خادم المتجر.
- Firebase Cloud Messaging
- Apple Push Notification service
- المشتريات داخل التطبيق في App Store
- Google Play Billing
- Firebase Crashlytics
- Sentry
مصادر البيانات والبروتوكولات الأخرى
ويشمل هذا النطاق أيضًا تحديث الأسعار يوميًا وفق أسعار صرف البنك المركزي التركي (TCMB)، ونقل المنتجات بالجملة عبر ملفات XML من الموردين أو ملفات Excel وCSV، وتبادل الملفات عبر FTP أو SFTP، وخدمات SOAP في الأنظمة المؤسسية القديمة، وواجهات GraphQL API.
بشأن الشركات الواردة في القوائم: هذه أنظمة يمكننا التكامل معها عبر واجهات API الخاصة بها، ولا يعني ذلك شراكة أو وكالة أو اعتمادًا رسميًا. ويتطلب التكامل أن يكون لديك حساب خاص بك وصلاحية وصول إلى API لدى الشركة المعنية. ويمكن أيضًا ربط أنظمة غير مدرجة في القائمة ما دامت لديها واجهة API.
REST أم SOAP أم Webhook أم نقل الملفات: متى تُستخدم كل طريقة؟
| الطريقة | آلية العمل | الحالات المناسبة | النقاط التي نراعيها |
|---|---|---|---|
| REST API | طلب واستجابة عبر HTTPS، غالبًا بصيغة JSON | معظم خدمات الدفع والأسواق الإلكترونية والشحن وCRM | حدود الاستخدام، وتجديد رموز الوصول، وتغييرات الإصدارات |
| SOAP | استدعاءات خدمات قائمة على XML ومعرّفة عبر WSDL | بعض خدمات البنوك والشحن وe-Fatura والخدمات الحكومية، والأنظمة المؤسسية القديمة | التحقق من المخطط، والشهادات، وإدارة مهلة الانتظار |
| Webhook | يرسل النظام الآخر إشعارًا إلى عنوانك عند وقوع حدث ما | الأحداث الفورية مثل تأكيد الدفع وحالة الشحنة وتغيّر الطلب | التحقق من التوقيع، والإشعارات المكررة، والاستعلام عن الأحداث الفائتة |
| نقل الملفات (XML / CSV / FTP) | تُجهَّز الملفات وتُرفع أو تُنزَّل على فترات محددة | قوائم منتجات الموردين، والأسعار والمخزون بالجملة، والأنظمة التي لا تملك API | التحقق من الصيغة، وترميز الأحرف، والملفات غير المكتملة |
تُستخدم هذه الطرق معًا في معظم المشاريع: يُرسل الطلب عبر REST، وتصل تغييرات الحالة عبر Webhook، ويُستلم ملف المخزون المجمّع مرة واحدة يوميًا. ويحدد الاختيارَ ما يتيحه النظام الآخر ومدى حاجتك إلى بيانات محدّثة.
نهجنا التقني في التكاملات
- التحقق من جهة الخادم: تُفحص كل البيانات الواردة من نظام خارجي من حيث الصيغة والنوع والحقول الإلزامية؛ ولا يُقبل السجل الخاطئ في النظام.
- تحمّل الطلبات المكررة: حتى لو وصل الطلب أو الإشعار نفسه أكثر من مرة، تُنفَّذ العملية مرة واحدة.
- الطابور وإعادة المحاولة: عندما لا يستجيب النظام الآخر مؤقتًا، يُعاد إرسال الطلبات بطريقة مضبوطة، ويُبلَّغ عن الأخطاء الدائمة.
- سجلات العمليات: يمكن تتبع أي بيانات أُرسلت ومتى وإلى أي نظام؛ فيسهل العثور على مصدر المشكلة.
- بيئة الاختبار أولًا: تُجرَّب روابط الدفع والشحن وe-Fatura أولًا في بيئات الاختبار لدى المزوّدين، ثم يُنتقل إلى التشغيل الفعلي.
- حماية المفاتيح السرية: تُحفظ مفاتيح API في ملفات إعداد لا يمكن الوصول إليها من الويب، لا داخل الشيفرة؛ وتُمنح الصلاحيات وفق مبدأ الحد الأدنى من الامتيازات.
- العناية بالبيانات الشخصية: تُقصر البيانات المنقولة على ما يتطلبه العمل، وتُنشأ الاتصالات عبر قنوات مشفّرة، وتُراعى مبادئ KVKK وGDPR.
- الالتزام بحدود الاستخدام: تُقسَّم العمليات المجمّعة وفق حدود الطلبات لدى المزوّدين، وتُقلَّل الاستعلامات غير الضرورية بالتخزين المؤقت.
كيف يسير مشروع تكامل API؟
- الاستكشاف: نحدد معًا الأنظمة التي تستخدمها، والأعمال التي تُنجز يدويًا، والبيانات التي يجب أن تتدفق وإلى أين.
- الفحص التقني: ندرس وثائق API للخدمات المراد ربطها، وشروط الوصول، وبيئات الاختبار، وحدود الاستخدام.
- النطاق والعرض: نقدّم عرضًا مكتوبًا يتضمن جدول مطابقة البيانات ومخطط التدفق والمدة والسعر.
- التطوير والاختبار: نبني التكامل في بيئة الاختبار، ونجرّبه بسيناريوهات واقعية وحالات أخطاء.
- الإطلاق: نُطلقه ببيانات الوصول الفعلية، ونتابع العمليات الأولى معك.
- المراقبة والدعم: نتابع تغييرات الإصدارات لدى المزوّد، ونخطط للتحديثات اللازمة.
على أي أساس يُحدَّد سعر التكامل؟
- عدد الأنظمة: عدد الخدمات المراد ربطها وبنية API لكل منها.
- اتجاه تدفق البيانات: هل المطلوب نقل في اتجاه واحد أم مزامنة ثنائية الاتجاه.
- الحاجة إلى التحديث: هل تُنقل البيانات فوريًا أم على فترات محددة.
- تعقيد المطابقة: مقدار التحويل الذي تتطلبه الفروق في الفئات والمتغيرات والضرائب والوحدات.
- إمكانات المزوّد: جودة وثائق API، ووجود بيئة اختبار ودعم Webhook من عدمه.
- اللوحة والتقارير: هل تدخل شاشات المراقبة وقائمة الأخطاء وإعادة الإرسال اليدوي ضمن النطاق.
تتضح المدة والسعر في عرض مكتوب بعد الاستكشاف والفحص التقني.
لماذا ADK Yazılım؟
- أساليب نستخدمها في بنيتنا الخاصة: في نظام الطلبات لدينا يعمل الدفع بالبطاقة وإشعارات تأكيد الدفع والفوترة التلقائية وإشعارات البريد الإلكتروني وSMS مترابطةً معًا.
- نطاق واضح ومدة واضحة وسعر واضح: يُذكر في العرض كتابةً أي البيانات تُنقل وفي أي اتجاه، وما يقع خارج النطاق.
- شيفرة مختبرة وآمنة: يُختبر كل تكامل مع سيناريوهات الأخطاء، وتُحمى المعلومات السرية.
- أنظمة محلية ودولية: إلى جانب نقاط البيع الافتراضية وe-Fatura والشحن المحلي في تركيا، نربط أيضًا خدمات دولية مثل Stripe وXero وRoyal Mail.
- الدعم بعد الإطلاق: نُجري التحديثات عند تغييرات المزوّدين؛ وترسل طلبات الدعم عبر لوحة العملاء.

