تخطَّ إلى المحتوى
Bulutegra المطوّرون
المطوّرون

مرجع التكاملات

لدى Bulutegra واجهة REST API للقراءة فقط وخطافات ويب (webhooks)؛ التوثيق متاح على developers.bulutegra.com. أما هذه الصفحة فهي جرد لشيء آخر: الاتصالات التي تبنيها Bulutegra على الخدمة الرسمية لكل نظام.

ما تتناوله هذه الصفحة

Bulutegra طبقة تكامل: تقع بين المنصات وموقعك الخاص ونظام ERP لديك. نحن نبني الاتصال ونتحمل الاختلافات في جانب القنوات، فتعمل أنت من لوحة واحدة بدل تعلّم الخصوصيات التقنية لكل قناة.

من بين 47 تكاملاً مدرجاً في هذا الموقع، هناك 22 اتصالاً مبنياً ويعمل، و25 تُنشأ عند الطلب. هذا يوضح ما يدعمه المنتج، ولا يقول شيئاً عمّن يبيع على أي قناة.

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

لا يظهر في هذه الجداول أي مفتاح أو كلمة مرور أو رقم بائع أو مثال لبيانات اعتماد. وعمود «ما نحتاجه منك» يذكر فقط أي معلومة مطلوبة.

الأسواق الإلكترونية

يمر كل اتصال بمنصة عبر خدمة البائع الخاصة بتلك القناة. تُقرأ الطلبات من القناة، ويُكتب المخزون والأسعار والإعلانات بالقدر الذي تدعمه القناة.

مرّر الجدول أفقياً لقراءته.

تكاملات المنصات: نوع الاتصال، والبيانات المقروءة والمكتوبة، والمعلومات المطلوبة، وحالة الإعداد
النظامالاتصالالمقروءالمكتوبما نحتاجه منكالإعداد
TrendyolREST · apigw.trendyol.comالطلبات، المنتجاتالمخزون، الأسعار، نشر المنتجات، المحتوىمفتاح API، والمفتاح السري لـ API، ورقم البائعالاتصال جاهز
HepsiburadaREST · oms-external.hepsiburada.com · listing-external.hepsiburada.comالطلبات، المنتجاتالمخزون، الأسعار، نشر المنتجات، المحتوىاسم المستخدم، ورقم التاجر، والمفتاح السريالاتصال جاهز
n11SOAP + REST · api.n11.comالطلبات، المنتجاتالمخزون، الأسعار، نشر المنتجات، المحتوىمفتاح التطبيق والمفتاح السري للتطبيقالاتصال جاهز
PazaramaOAuth2 + REST · isortagimgiris.pazarama.com · isortagimapi.pazarama.comالطلبات، المنتجاتالمخزون، الأسعار، نشر المنتجات، المحتوىمعرّف العميل والمفتاح السري للعميلالاتصال جاهز
ePttAVMSOAP (WS-Security) · ws.pttavm.comالطلبات، المنتجاتالمخزون، الأسعار، نشر المنتجات، المحتوىاسم المستخدم وكلمة المرورالاتصال جاهز
FLOREST · api.flo.com.trالطلباتالمخزون، الأسعارمعرّف APIالاتصال جاهز
ÇiçeksepetiREST · apis.ciceksepeti.comالطلبات، المنتجاتالمخزون، الأسعار، نشر المنتجات، المحتوىمفتاح APIالاتصال جاهز
idefixREST · merchantapi.idefix.comالطلبات، المنتجاتالمخزون، الأسعار، نشر المنتجاترقم البائع ومفتاح APIالاتصال جاهز
ModanisaRESTالطلباتالمخزون، الأسعاراسم مستخدم API وكلمة المرورالاتصال جاهز
AmazonAmazon Selling Partner API (SP-API)الطلبات، المنتجاتالمخزون، الأسعار، المحتوىتفويض تطبيق SP-API ومعرّف البائعالاتصال جاهز
eBayRESTالطلبات، المنتجاتالمخزون، الأسعار، نشر المنتجات، المحتوىتفويض تطبيق OAuthالاتصال جاهز
Walmart (US)OAuth2 + REST · Walmart Marketplace API v3الطلبات، المنتجاتالمخزون، الأسعار، نشر المنتجات، المحتوىمعرّف العميل والمفتاح السري للعميلالاتصال جاهز
EtsyOAuth2 + REST · Etsy Open API v3الطلبات، المنتجاتالمخزون، الأسعار، نشر المنتجات، المحتوىمفتاح التطبيق وتفويض المتجرالاتصال جاهز
OzonREST · api-seller.ozon.ruالطلبات، المنتجاتالمخزون، الأسعار، نشر المنتجات، المحتوىClient-Id · Api-Keyالاتصال جاهز
TemuREST · Temu Open APIالطلبات، المنتجاتالمخزون، الأسعار، نشر المنتجاتمفتاح التطبيق والمفتاح السري ورمز الوصولالاتصال جاهز
SHEINREST · SHEIN Open Platform APIأوامر الشراء، المنتجاتالمخزونتفويض المتجر من حساب البائع الرئيسيالاتصال جاهز
JumiaRESTالطلباتيُحدَّد أثناء الإعدادمعرّف API الخاص بالبائعالاتصال جاهز
noonREST · noon Partner API (JWT)المنتجاتنشر المنتجاتمفتاح حساب الخدمةالاتصال جاهز
Namshiيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
Allegroيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
WildberriesRESTالطلباتيُحدَّد أثناء الإعدادمفتاح APIالاتصال جاهز
TakealotREST · seller-api.takealot.comالطلباتيُحدَّد أثناء الإعدادمفتاح APIالاتصال جاهز
Ananasيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
JustYolيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب

عندما يذكر عمود «المكتوب» عبارة «يُحدَّد أثناء الإعداد»، فإن اتجاه الكتابة لتلك القناة يُفتح وفق صلاحيات حسابك ونتائج وضع الظل. ولا تُفعَّل صلاحية الكتابة لكل القنوات دفعة واحدة، بل قناة بقناة.

يُدار المخزون من مخزون واحد عبر جميع القنوات: فالبيع في قناة يخفض الكمية في غيرها. ولا يوجد سجل مخزون منفصل لكل قناة.

منصات التجارة الإلكترونية

إذا كان موقعك يعمل على منصة تجارة إلكترونية، تنضم منتجاته ومخزونه وأسعاره إلى المخزون نفسه، ويعمل الموقع كقناة إضافية.

مرّر الجدول أفقياً لقراءته.

منصات التجارة الإلكترونية: نوع الاتصال، والبيانات المقروءة والمكتوبة، والمعلومات المطلوبة، وحالة الإعداد
النظامالاتصالالمقروءالمكتوبما نحتاجه منكالإعداد
ikasGraphQL · api.myikas.com · adminapi.myikas.comالمنتجات والمتغيرات والمخزون والأسعاريُحدَّد أثناء الإعدادمفتاح API الإداريالاتصال جاهز
Shopifyيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
WooCommerceيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
Ticimaxيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
IdeaSoftيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
T-Softيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب

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

تنطبق راية الملكية هنا أيضاً: لكل منتج وقناة يكون واضحاً من المسؤول، Bulutegra أم نظام خارجي، فلا يحدث أن يحدّث نظامان الحقل نفسه في اتجاهين متعاكسين.

ERP

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

مرّر الجدول أفقياً لقراءته.

تكاملات ERP: نوع الاتصال، والبيانات المقروءة والمكتوبة، والمعلومات المطلوبة، وحالة الإعداد
النظامالاتصالالمقروءالمكتوبما نحتاجه منكالإعداد
Nebim V3Nebim V3 Integratorالطلبات والعملاء والمخزون (إجراءات للقراءة فقط)منفصلة وخاضعة للرقابةعنوان الخدمة، ومستخدم الخدمة، وكلمة المرورالاتصال جاهز
Logoيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
Mikroيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
SAPيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب

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

تغذية المورّد

إذا كنت لا تُنتج المنتجات بنفسك بل تشتريها من مورّد، يُقرأ الكتالوج من ملف تغذية.

مرّر الجدول أفقياً لقراءته.

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

تُقرأ الحقول من أعمدة ثابتة. ويُحسب السعر بمعامل لكل مورّد، ولا يُعرض للبيع المخزون الذي يقل عن الحد المتفق عليه.

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

شركات الشحن

يصل طلب المنصة مع شركة الشحن وطريقة التسليم. تُعرَّف هذه المعلومة لكل قناة وتُكتب في نظام ERP مع الطلب.

مرّر الجدول أفقياً لقراءته.

شركات الشحن: حالة الإعداد
النظامالاتصالالمقروءالمكتوبما نحتاجه منكالإعداد
Aras Kargoيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
Yurtiçi Kargoيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
MNG Kargoيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
PTT Kargoيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
Sürat Kargoيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
Hepsijetيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
Trendyol Expressيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
DHLيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
FedExيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
UPSيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب

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

قنوات التواصل والإعلان

هذه الأنظمة الثلاثة مدرجة ضمن مجموعة القنوات المعروضة في هذا الموقع.

مرّر الجدول أفقياً لقراءته.

قنوات التواصل والإعلان: حالة الإعداد
النظامالاتصالالمقروءالمكتوبما نحتاجه منكالإعداد
WhatsApp Businessيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
Metaيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب
Google Adsيُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُحدَّد أثناء الإعداديُنشأ عند الطلب

في الأنظمة الثلاثة يُنشأ الاتصال عند الطلب؛ ويُحدَّد النطاق والمعلومات المطلوبة أثناء الإعداد.

أربع قواعد تنطبق على كل اتصال

وضع الظل. يقرأ الإعداد فقط في البداية. تُجلب البيانات من الطرفين وتُقارن، ولا يُكتب شيء في أي مكان. فترى ما كان سيحدث قبل أن تُسلّم أي شيء.

التسليم قناة بقناة. لا تُفتح صلاحية الكتابة دفعة واحدة. فكل قناة تُشغَّل على حدة، ويُتحقق من المطابقة والبيانات قبل أن تبدأ تلك القناة بالكتابة.

مخزون واحد مشترك. يُدار المخزون من مكان واحد. والبيع في قناة واحدة يخفض الكمية في القنوات الأخرى.

مكبح التصفير الجماعي. إذا كان عدد رموز المنتجات التي ستُصفَّر في جولة واحدة غير طبيعي، يتوقف الإرسال ويصدر تنبيه. ولا توجد جولة صامتة تُفرغ كل القنوات.

ما نحتاجه منك لإنشاء الاتصال

يسرد عمود «ما نحتاجه منك» بيانات الاعتماد التي تنشئها في لوحة النظام نفسه. وهي تخص حسابك، ولا تستخدمها Bulutegra إلا نيابة عنك.

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

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

ما نفعله بشأن التخزين والنسخ الاحتياطي وتشفير القرص — وما لا نفعله — مكتوب بوضوح في صفحة الأمان: الأمان والوصول وحماية البيانات.

نظام غير مدرَج في القائمة

إذا لم تجد في هذه الجداول منصة أو منصة تجارة إلكترونية أو نظام ERP أو شركة شحن تحتاجها، فالاتصال يُنشأ عند الطلب.

السؤال الأول واحد دائماً: هل ينشر ذلك النظام خدمة بائع رسمية أو تغذية XML/CSV منتظمة، وهل هي متاحة على حسابك؟ إن كانت كذلك، يسير الاتصال بالترتيب نفسه: القراءة أولاً، ثم وضع الظل، ثم الكتابة قناة بقناة. وإن لم تكن، نقول مسبقاً ما الذي لا يمكن عمله.

لا نقدّم في هذه الصفحة أي وعود بشأن المدة. وبعد أن يتضح النطاق نشارك الجدول الزمني كتابةً.

لمن هذه الصفحة

شركة تبيع على المنصات

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

فريق ERP

في Nebim V3 الاتصال مبني. أما في أنظمة ERP الأخرى فيعتمد النطاق على الإصدار والوحدات المرخّصة ويُحدَّد أثناء الإعداد.

الوكالات والشركاء

الفرق التي تُعدّ عدة عملاء تتبع الترتيب نفسه في كل مرة: القراءة، ثم وضع الظل، ثم الكتابة قناة بقناة.

كيف يُبنى الاتصال
  1. النطاق: أي أنظمة، وأي اتجاه (قراءة أم كتابة)، وأي بيانات.
  2. بيانات الاعتماد: تُسلَّم البيانات التي تنشئها في لوحة كل نظام بالطريقة التي نتفق عليها أثناء الإعداد.
  3. وضع الظل: يقرأ النظام فقط، ويُظهر ما كان سيفعله، ولا يكتب في أي قناة.
  4. التسليم: بعد أن ترى النتيجة، تُفتح صلاحية الكتابة قناة بقناة.

الأسئلة الشائعة

هل لدى Bulutegra واجهة API خاصة بها؟

نعم. لديها واجهة REST API للقراءة فقط وخطافات ويب: يمكن لبرنامجك قراءة الطلبات والمنتجات والمخزون وحالة القنوات، وتصل الطلبات الجديدة وتغييرات الحالة وعمليات النقل إلى ERP عبر خطاف الويب. لا تستطيع الواجهة تغيير أي شيء — تتولى Bulutegra الكتابة إلى قنواتك ونظام ERP. تنشئ المفتاح في اللوحة من الإعدادات › Bulutegra API والخطافات؛ التوثيق على developers.bulutegra.com.

ماذا يعني «الاتصال جاهز» في الجدول؟

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

هل الوصول إلى API مدفوع؟

لا يوجد بند مستقل باسم «API» في جدول الباقات على صفحة الأسعار. فاتصالات التكامل لا تُباع كمنتج منفصل؛ بل تُقيَّم مع باقتك والنطاق الذي تطلبه. وإذا ترتّب على إعداد نظام غير مدرج في القائمة تكلفة، فسترى هذه التكلفة بنداً مستقلاً في العرض المكتوب. والباقات هنا: الأسعار.

كيف أُسلّم بيانات الاعتماد؟

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

هل توجد بيئة اختبار منفصلة؟

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

أخبرنا بالنظام الذي تريد ربطه وباتجاه تدفق البيانات، ونحدد النطاق معاً. استخدم النموذج أدناه أو اكتب إلى destek@bulutegra.com.

طلب تكامل

بإرسال هذا النموذج توافق على معالجة بيانات اتصالك لنتمكن من تقييم طلبك.