Kaynaklar · Geliştirici Merkezi

POS, OMS & ERP Entegrasyonu

Halihazırda çalıştırdığınız sistemleri — satış noktası, sipariş yönetimi ve ERP — SocialHub sadakat programına entegre edin. SAP, Dynamics 365, Manhattan Active Omni, IBM Sterling veya Salesforce için yönetilen bir bağlayıcı yapılandırın veya aynı yönetilen v2 REST API aracılığıyla herhangi bir başka sistemi entegre edin; bu entegrasyon, bir kiracı anahtarıyla doğrulanır, uç nokta başına kapsamlandırılır ve her çağrıda denetlenir.

Bir API anahtarı alın API'a göz atın

Bir API, üç sistem türü

Aşağıdaki her entegrasyon, Authorization: Bearer fl_live_… kiracı anahtarıyla HTTPS üzerinden v2 REST API'dir. Mutabakat için salt okunur bir anahtar ve yalnızca puan verdiğiniz veya kupon kullandığınız yerlerde yazma kapsamlı bir anahtar kullanın. E-ticaret platformları (Shopify, Amazon, TikTok Shop) için yerel kanal bağlantılarını tercih edin; bu kılavuz, yerel bağlantısı olmayan sistemler içindir.

POS

Satış Noktası

Mağaza içi bir satın alımı sadakat değerine dönüştürün: satıştan puan kazanın ve kasada kuponları kullanın.

OMS

Sipariş yönetimi

Çevrimiçi ve çok kanallı siparişlerin kazanç sağlamasına ve iadelerin sipariş kimliklerinize göre geri alınmasına izin verin.

ERP

Kurumsal kaynak planlaması

Mağazanızı ve üye yöneticinizi güncelleyin (sizin tarafınızdan yapılan ekleme ve çıkarma işlemi). externalId) ve bunları kademeli olarak kayıt sisteminizle uyumlu hale getirin.

Yönetilen bağlantılar

Beş kurumsal sistem için entegrasyonu hiç yazmazsınız; Veri ve Entegrasyonlar'da bir bağlantı yapılandırın (uç nokta + şifrelenmiş kimlik bilgileri), bunu doğrulayın ve bir prova çalıştırın. Her bağlayıcı, satıcının siparişlerini, müşterilerini ve ürünlerini normalleştirir ve bunları aşağıda belgelenen aynı API yoluyla - aynı kapsamlar, aynı önemsizlik, aynı yönetilen kanal - yönlendirir. Her biri ne kadar doğrulandığıyla etiketlenir.

Salesforce — CRM / OMS

Test verileriyle doğrulandı

Sipariş / İade Siparişi / Hesap İletişimi / Ürün2, REST + SOQL aracılığıyla; müşteri kimlik bilgileri OAuth.

SAP S/4HANA — ERP

Test verileriyle doğrulandı

OData A2X hizmetleri aracılığıyla satış siparişi / iş ortağı / ürün ana verisi; BTP OAuth.

Dynamics 365 — ERP / CRM

Test verileriyle doğrulandı

Veri Evreni (CE) doğrulandı; Finans ve Operasyon iskelesi. Giriş Kimliği OAuth.

Manhattan Active Omni — OMS

Tasarım ortağı doğrulamasında

Sipariş / iade / müşteri; eşleştirmeler, kiracınızın Arayüz Eşleme Belgesi'ne göre tamamlanmıştır.

IBM Sterling — OMS

Tasarım ortağı doğrulamasında

getOrderList / REST API zarfı aracılığıyla geri döner; işlem hattınızda yapılandırılmış durum kodları.

Test verileriyle doğrulandı: Eşlemeler, sağlayıcının yayımladığı API esas alınarak oluşturulmuş ve test edilmiştir; ilk dağıtımınızda gerçek ortamda doğrulanıp onaylanır. Tasarım ortağıyla doğrulama aşamasında: Eşlemeler, ilk kurulum sırasında kiracınızın entegrasyon belgesine göre kesinleştirilir. Burada listelenmeyen sistemler aşağıdaki API üzerinden doğrudan entegre edilir.

Müşteri verileri ve pazarlama zenginleştirme

Sipariş yakalamadan ayrı bir özellik: müşteri profillerinizin halihazırda bulunduğu platformu bağlayın ve Flash, her e-postayı gönderme zamanında alıcıya özel özelliklerle (ad, yaşam döngüsü aşaması, özel nitelikler) zenginleştirir. Bu, e-postayla salt okunur bir aramadır; hiçbir zaman üye oluşturmaz veya kişisel bilgileri açığa çıkarmaz. Veri ve Entegrasyonlar'da bir bağlantı yapılandırın; kaydettiğiniz anda her bağlantının durumu, canlı kimlik bilgilerinizle karşılaştırılarak kontrol edilir.

CDP

Salesforce Veri Bulutu · Segment · Adobe Deneyim Platformu

CRM

HubSpot · Microsoft Dynamics 365

Pazarlama

Braze · Klaviyo · Yinelenebilir

Kimlik doğrulama, her satıcının kendi şemasıdır — bir API anahtarı, özel bir anahtar veya OAuth2 istemci kimlik bilgileri (OAuth olanlar için Flash her çalıştırmada yeni bir erişim belirteci alır, bu nedenle uzun ömürlü bir taşıyıcı saklanmaz). Kimlik bilgileri bekleme durumunda şifrelenir ve bir daha asla gösterilmez.

POS

Satış noktası entegrasyonu

Kayıt sistemi, tek bir işlemle satın almayı sadakat değerine dönüştürür: satışı sipariş olarak kaydedersiniz ve SocialHub üyeyi (sizin aracılığınızla) çözüme kavuşturur. externalIde-posta veya memberId) ve programın kendi kazanma kurallarına göre puanlar verir. İhtiyaç duyduğunuzda kendi anahtarınızla üyeyi arayın veya oluşturun.

Satışta ödül (siparişten sonra)

// 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).

Üyeyi bulun veya oluşturun

// 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)

Kasada kupon kullanın

// 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")

Üyenin bakiyesini, kademesini ve kuponlarını GET /members/{id}/points, /tier ve /coupons ile okuyarak kasada gösterin.

OMS

Sipariş yönetimi entegrasyonu

Yerel bağlayıcıya (Shopify, Amazon, TikTok Shop) sahip e-ticaret platformları için bu özelliği açın ve işlemi tamamlayın. Diğer herhangi bir sipariş yönetimi sistemi için, sipariş etkinliklerinizi Siparişler API'e gönderin — program kurallarına göre otomatik ödülleri alın ve pençe puanlarını orantılı olarak geri ödeyin. OMS'niz çağrıları yönlendirir (gelen web kancasına gerek yoktur).

Siparişler kazanır; geri ödeme

// 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).

Henüz üye değil misiniz? Verilen geri dönüş değerleri: 0 / reason:not-a-üye (asla otomatik olarak oluşturmaz). Onları POST ile kaydedin. /members Öncelikle siparişin kazanç sağlamasını istediğinizde.

ERP

ERP ve ana veri entegrasyonu

Sadakatinizi kayıt sisteminizle her iki yönde de uyumlu tutun: mağazanızı ve üye ana verilerinizi (sizin tarafınızdan idempotent upsert yöntemiyle) güncelleyin. externalId), daha sonra kademeli olarak ? ile uzlaştırın.updatedSince= böylece her senkronizasyon yalnızca değişenleri çeker.

Mağaza yöneticisini itin

// 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.

Üyeleri itin ve aşamalı olarak uzlaştırın

// 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.

Ürün kataloğunu (PIM) öne alın

// 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

Toplu işlem ≤100/çağrı (207 Çoklu Durum, öğe başına sonuç); anahtar başına oran sınırına uyun ve yoğun olmayan saatlerde tam yeniden senkronizasyonlar gerçekleştirin. Katalog içe aktarımı harici olarak yönetilir — SocialHub hiçbir zaman ürünleri ERP sisteminize geri yazmaz.

Yetkilendirme, kapsamlar ve güvenlik

Kiracı kapsamlı anahtarlar

Her arama, bir ekibe bağlı bir fl_live_ anahtarı taşır. Anahtarlar asla kiracılar arasında geçiş yapmaz; entegrasyon başına ayrı anahtarlar oluşturun, böylece diğerlerine dokunmadan birini döndürebilirsiniz.

Okuma ve yazma ön ayarları

Mutabakat işleri salt okunur bir anahtar kullanır. Yalnızca puan veren veya kupon kullanan POS/OMS yoluna yazma kapsamı verin; sistem başına en az ayrıcalık.

İdempotansiyel Anahtar

Yazma işlemlerinde bir Idempotency-Key başlığı gönderin (siparişler kendi externalOrderId'lerini de taşır). Tekrar denenen bir çağrı orijinal sonucu tekrarlar; farklı bir yük ile aynı anahtar reddedilir — bir satış asla iki kez ödüllendirilmez.

Varsayılan olarak denetlenir

Her API çağrı kaydedilir ve API Anahtarlar → son etkinlik altında görünür, böylece bir entegrasyonun yazma işlemleri her zaman bir anahtara kadar izlenebilir.

Tam uç nokta referansı: REST API · Hızlı Başlangıç · MCP (ölçütler BI'ya)

Bir arka uç sistemi entegre etmek mi istiyorsunuz?

POS/OMS/ERP, kasada üye kimliği, iade işlemleri veya mutabakat işleri hakkında bir mühendisle görüşün.

Mühendislikle konuş