تكامل أنظمة نقاط البيع، وأنظمة إدارة الطلبات، وأنظمة تخطيط موارد المؤسسات
اربط الأنظمة التي تُشغلها حاليًا - نظام نقاط البيع، ونظام إدارة الطلبات، ونظام تخطيط موارد المؤسسات (ERP) - بنظام ولاء SocialHub. قم بتهيئة موصل مُدار لـ SAP، أو Dynamics 365، أو Manhattan Active Omni، أو IBM Sterling، أو Salesforce داخل التطبيق — أو قم بدمج أي نظام آخر من خلال نفس الموصل المُدار v2 REST API، المُصادق عليه باستخدام مفتاح المستأجر، والمُحدد نطاقه لكل نقطة نهاية، والمُدقق في كل استدعاء. الكورية — ko-KR تُختصر إلى ko طلب تصدير الكورية
نظام API واحد، ثلاثة أنواع من الأنظمة
جميع عمليات التكامل المذكورة أدناه هي الإصدار الثاني REST API عبر بروتوكول HTTPS باستخدام مفتاح مستأجر Authorization: Bearer fl_live_…. استخدم مفتاحًا للقراءة فقط لأغراض المطابقة، ومفتاحًا للكتابة فقط عند منح النقاط أو استرداد القسائم. بالنسبة لمنصات التجارة الإلكترونية (Shopify، أمازون، متجر تيك توك)، يُفضل استخدام موصلات القنوات الأصلية - هذا الدليل مخصص للأنظمة التي لا تحتوي على موصل قناة أصلي.
نقطة البيع
حوّل عملية الشراء داخل المتجر إلى قيمة ولاء: اكسب نقاطًا على عملية البيع واستبدل القسائم عند الدفع.
OMSإدارة الطلبات
اجعل الطلبات عبر الإنترنت والقنوات المتعددة تربح - والمرتجعات تسترد - مرتبطة بمعرفات طلباتك. اربط الطلبات عبر الإنترنت والقنوات المتعددة بمعرفات طلباتك.
ERPتخطيط موارد المؤسسة
قم بتحديث متجرك وقائمة الأعضاء الرئيسية (أضف تحديثًا أو أدرجًا من قِبلك) externalId) وتوافق تدريجياً مع نظام السجلات الخاص بك.
الموصلات المُدارة
بالنسبة لخمسة أنظمة مؤسسية، لن تحتاج لكتابة أي كود تكامل على الإطلاق - ما عليك سوى تهيئة اتصال في Data & Integrations (نقطة النهاية + بيانات الاعتماد المشفرة)، والتحقق منه، وإجراء تجربة تشغيلية. يقوم كل موصل بتوحيد طلبات المورد وعملائه ومنتجاته، وتوجيهها عبر نفس API الموضح أدناه - بنفس النطاقات، ونفس خاصية التكرار، ونفس قناة التحكم. ويُشار إلى كل موصل بمدى التحقق الذي تم إجراؤه.
Salesforce — نظام إدارة علاقات العملاء / نظام إدارة الطلبات
تم التحقق باستخدام بيانات اختبارطلب / إرجاع طلب / جهة اتصال الحساب / المنتج 2 عبر REST + SOQL؛ بيانات اعتماد العميل OAuth.
SAP S/4HANA — نظام تخطيط موارد المؤسسات (ERP)
تم التحقق باستخدام بيانات اختبارطلب المبيعات / شريك العمل / بيانات المنتج الرئيسية عبر خدمات OData A2X؛ BTP OAuth.
Dynamics 365 — ERP / CRM
تم التحقق باستخدام بيانات اختبارتم التحقق من صحة قاعدة البيانات (CE)؛ تم دعم قسم المالية والعمليات. مصادقة OAuth لـ Entra ID.
مانهاتن أكتيف أومني - نظام إدارة العمليات (OMS)
في التحقق من صحة شريك التصميمالطلب / الإرجاع / العميل؛ تم الانتهاء من عمليات الربط وفقًا لوثيقة ربط واجهة المستخدم الخاصة بالمستأجر.
IBM Sterling — OMS
في التحقق من صحة شريك التصميمgetOrderList / يتم إرجاعها عبر المغلف REST API؛ رموز الحالة مُهيأة لخط أنابيبك.
تم التحقق باستخدام بيانات اختبار: أُنشئت عمليات الربط واختُبرت استنادًا إلى واجهة API المنشورة من المورّد، ثم تُتحقق وتُعتمد في البيئة الفعلية عند النشر الأول لديك. قيد التحقق مع شريك التصميم: تُستكمل عمليات الربط أثناء الإعداد وفق وثيقة التكامل الخاصة بالمستأجر لديك. يمكن دمج الأنظمة غير المدرجة هنا مباشرة عبر واجهة API أدناه.
إثراء بيانات العملاء والتسويق
ميزة منفصلة عن عملية تسجيل الطلبات: اربط المنصة التي تحتوي على ملفات تعريف عملائك، وسيقوم Flash بإثراء كل بريد إلكتروني عند إرساله ببيانات خاصة بكل مستلم (الاسم، مرحلة دورة حياة العميل، السمات المخصصة). إنها عملية بحث للقراءة فقط عبر البريد الإلكتروني - لا تُنشئ أعضاءً ولا تكشف عن معلومات شخصية حساسة. قم بتهيئة الاتصال في البيانات والتكاملات، وسيتم التحقق من سلامة كل اتصال باستخدام بيانات اعتمادك الحالية فور حفظه.
CDP
Salesforce سحابة البيانات · التجزئة · Adobe منصة التجربة
CRM
HubSpot · Microsoft Dynamics 365
التسويق
Braze · Klaviyo · قابل للتكرار
المصادقة هي آلية خاصة بكل مُورّد - مفتاح API، أو مفتاح خاص، أو بيانات اعتماد عميل OAuth2 (بالنسبة لبيانات OAuth، يقوم Flash بجلب رمز وصول جديد في كل مرة، لذا لا يتم تخزين أي بيانات اعتماد طويلة الأمد). يتم تشفير بيانات الاعتماد أثناء التخزين ولا يتم عرضها مرة أخرى.
تكامل نقاط البيع
يحوّل نظام التسجيل عملية الشراء إلى قيمة ولاء في مكالمة واحدة: يتم تسجيل البيع كطلب، ويقوم SocialHub بحل مشكلة العضو (بواسطتك). externalIdالبريد الإلكتروني، أو memberIdويمنح نقاطًا وفقًا لقواعد البرنامج الخاصة. ابحث عن العضو أو أنشئه باستخدام مفتاحك الخاص عند الحاجة.
مكافأة على عملية بيع (بعد الطلب)
// One call: post the sale as an order. SocialHub resolves the member, applies the
// program's earn rules (tier multiplier + daily cap) and records the order — you
// don't compute points. The member is resolved by memberId > externalId > email.
POST https://flash.socialhub.ai/api/v2/orders
Authorization: Bearer fl_live_…
Idempotency-Key: pos-90871 // safe retries — one sale never awards twice
Content-Type: application/json
{
"externalOrderId": "90871",
"customer": { "externalId": "POS-CUST-5512" }, // or { "email": "…" } / { "memberId": "…" }
"totalAmount": 120.00,
"storeId": "st_…"
}
// → 200 { "data": { "awarded": 6, "balance": 1820, "memberId": "mem_…" } }
// Not a member yet → { "awarded": 0, "reason": "not-a-member" } (never auto-created).ابحث عن العضو أو أنشئه
// Look up a member by your own key or email (exact match), or create one:
GET https://flash.socialhub.ai/api/v2/members?externalId=POS-CUST-5512 // or ?email=ada@acme.com
// → 200 { "data": [ { "id": "mem_…", "externalId": "POS-CUST-5512", … } ], "total": 1 }
POST https://flash.socialhub.ai/api/v2/members // create/upsert (marketing consent stays OFF)
{ "email": "ada@acme.com", "fullName": "Ada Lovelace", "externalId": "POS-CUST-5512" }
// → 201 created / 200 existing (idempotent on externalId)استبدل قسيمة عند الكاشير
// Cashier scans the member's coupon code → mark it redeemed at the register.
POST https://flash.socialhub.ai/api/v2/coupons/{couponId}/redeem
Authorization: Bearer fl_live_…
// → 200 redeemed
// → 404 coupon not found / already redeemed (treat as "do not honor")اقرأ رصيد العضو، ومستوى عضويته، وقسائمه باستخدام GET /members/{id}/points، /tier، و/coupons لعرضها عند الدفع.
تكامل إدارة الطلبات
بالنسبة لمنصات التجارة الإلكترونية التي تحتوي على موصل أصلي (Shopify، أمازون، متجر تيك توك)، قم بتفعيله وانتهى الأمر. أما بالنسبة لأي نظام آخر لإدارة الطلبات، فقم بنشر أحداث طلباتك في الطلبات API - حيث يتم استيعاب المكافآت التلقائية وفقًا لقواعد البرنامج، واسترداد النقاط بشكل متناسب. يقوم نظام إدارة الطلبات الخاص بك بإجراء المكالمات (لا حاجة إلى رابط ويب وارد).
الطلبات تُربح؛ والمبالغ المستردة تُسترد
// On Shopify / Amazon / TikTok Shop? Use the NATIVE channel connectors (Settings →
// Channels). For any OTHER OMS, your system calls these on its own order events.
//
// order paid / fulfilled → ingest (auto-awards by the program's earn rules):
POST https://flash.socialhub.ai/api/v2/orders
Idempotency-Key: SO-44821
{ "externalOrderId": "SO-44821", "customer": { "email": "ada@acme.com" }, "totalAmount": 240.00 }
// → 200 { "data": { "awarded": 12, "memberId": "mem_…" } }
// Same id + a DIFFERENT amount → 409 ORDER_CONFLICT (orders are immutable).
// order returned / refunded → proportional points claw-back, idempotent per refund:
POST https://flash.socialhub.ai/api/v2/orders/SO-44821/refund
{ "refundId": "re_1", "reason": "returned 1 item", "amount": 80.00 } // omit amount = full
// → 200 { "data": { "clawedBack": 4, "balance": 1816 } }
// Backfill / bulk: POST /orders/batch (≤100, 207 Multi-Status, per-item results).لست عضواً بعد؟ عائد الاستيعاب: 0 / reason:notعضو (لا يتم إنشاؤه تلقائيًا أبدًا). قم بتسجيلهم باستخدام POST /members أولاً عندما تريد أن يربح الطلب.
تكامل نظام تخطيط موارد المؤسسات (ERP) والبيانات الرئيسية
حافظ على ولاء العملاء متوافقًا مع نظام سجلاتك في كلا الاتجاهين: قم بتحديث بيانات المتجر وبيانات الأعضاء الرئيسية (عملية التحديث والإدراج المتكررة) من قِبلك externalIdثم قم بالتوفيق تدريجياً مع ؟updatedSince= لذلك، كل عملية مزامنة لا تسحب إلا ما تغير.
الضغط على زر "المتجر الرئيسي"
// Push your store master to SocialHub (upsert by your ERP store code):
POST https://flash.socialhub.ai/api/v2/stores
{ "name": "Downtown Flagship", "externalId": "ERP-STORE-018", "city": "New York" }
// → 201 created / 200 updated (idempotent on externalId)
// PUT /api/v2/stores/{id} updates a known store. GET to reconcile / pull ids.تحديث بيانات الأعضاء وتسويتها تدريجيًا
// Push the member master (idempotent upsert by your externalId; consent OFF unless
// you explicitly opt in). Nightly full re-push is safe — existing members update.
POST https://flash.socialhub.ai/api/v2/members/batch // ≤100 per call, 207 Multi-Status
{ "members": [ { "email": "ada@acme.com", "fullName": "Ada Lovelace", "externalId": "ERP-7741" } ] }
// Incremental reconcile — only what changed since your last sync:
GET https://flash.socialhub.ai/api/v2/members?updatedSince=2026-06-26T00:00:00Z&limit=200
GET https://flash.socialhub.ai/api/v2/orders?updatedSince=2026-06-26T00:00:00Z // orders too
// For governed business metrics (GMV, redemption, active members) into BI, query the
// semantic layer over MCP (metrics:read) instead of aggregating raw rows yourself.نشر كتالوج المنتجات (PIM)
// Push your product catalog (idempotent upsert by your own external_id). One
// endpoint takes brands, categories, products, variants and inventory together.
POST https://flash.socialhub.ai/api/v2/catalog/import
{ "source": "erp",
"brands": [ { "externalId": "B-AURELIA", "name": "Aurelia" } ],
"categories": [ { "externalId": "C-RINGS", "name": "Rings" } ],
"products": [ { "externalId": "P-9001", "title": "Solitaire Ring",
"brandExternalId": "B-AURELIA", "categoryExternalId": "C-RINGS",
"descriptionHtml": "<p>18k…</p>",
"content": [ { "externalId": "P-9001-spec", "contentType": "spec",
"body": "1.0ct, 18k white gold, GIA" } ] } ],
"variants": [ { "externalId": "V-9001-7", "productExternalId": "P-9001",
"sku": "AUR-RING-7", "price": 4200 } ],
"inventory": [ { "variantSku": "AUR-RING-7", "locationRef": "WH-1", "available": 12 } ] }
// → 200 with per-entity {inserted,updated} + errors[] (a bad row never aborts the batch).
// On Shopify? Products map in automatically — images + rich descriptions included.
// Read back: GET /api/v2/products · /products/{id} · /categories · /brandsمعالجة الدفعات ≤100/استدعاء (207 نتائج متعددة الحالات، لكل عنصر)؛ التزم بحد معدل كل مفتاح، وقم بإعادة مزامنة كاملة خارج أوقات الذروة. يتم استيراد الكتالوج من مصدر خارجي - لا يقوم SocialHub أبدًا بكتابة المنتجات مرة أخرى إلى نظام تخطيط موارد المؤسسات (ERP) الخاص بك.
التفويض، والنطاقات، والأمان
مفاتيح على مستوى المستأجر
كل مكالمة تحمل معها fl_live_ يتم ربط المفتاح بفريق واحد. لا تنتقل المفاتيح بين المستأجرين؛ أنشئ مفاتيح منفصلة لكل عملية تكامل حتى تتمكن من تغيير أحدها دون التأثير على البقية.
إعدادات مسبقة للقراءة والكتابة
تستخدم عمليات المطابقة مفتاحًا للقراءة فقط. امنح نطاق الكتابة فقط لمسار نقاط البيع/نظام إدارة الطلبات الذي يمنح النقاط أو يسترد القسائم - أقل امتياز لكل نظام.
مفتاح التكرار
أرسل ترويسة Idempotency-Key عند عمليات الكتابة (تحمل الطلبات ترويسة خاصة بها). externalOrderId أيضًا). تعيد محاولة الاتصال تشغيل النتيجة الأصلية؛ يتم رفض نفس المفتاح مع حمولة مختلفة - لا يتم منح أي عملية بيع مرتين.
مدقق افتراضيًا
يتم تسجيل كل استدعاء API ويكون مرئيًا ضمن API المفاتيح ← النشاط الأخير، لذا يمكن دائمًا تتبع عمليات الكتابة في التكامل إلى مفتاح.
مرجع نقطة النهاية الكاملة: REST API · البدء السريع · MCP (المقاييس في ذكاء الأعمال)
هل يتم دمج نظام خلفي؟
تحدث إلى مهندس حول نظام نقاط البيع/نظام إدارة الطلبات/نظام تخطيط موارد المؤسسات، وهوية الأعضاء عند الدفع، ومعالجة المرتجعات، أو مهام المطابقة.
تحدث إلى فريق الهندسة