POS、OMS 和 ERP 集成
將您現有的系統（銷售點系統、訂單管理系統和企業資源規劃系統）與 SocialHub 會員忠誠度系統連結。配置一個 管理連接器 為了 SAPDynamics 365、Manhattan Active Omni、IBM Sterling 或 Salesforce 應用內整合－或透過同一受控系統整合任何其他系統 v2 REST API使用租用戶金鑰進行身份驗證，依端點進行範圍限定，並在每次呼叫時進行稽核。
一個API，三種系統類型
以下所有整合均基於 HTTPS 協議，使用 v2 REST API 版本，並附有 Authorization: Bearer fl_live_… 租用戶金鑰。使用唯讀金鑰進行對賬，僅在獎勵積分或兌換優惠券時使用寫入範圍金鑰。對於電子商務平台（Shopify、亞馬遜、TikTok Shop），建議使用原生通路連接器－本指南適用於沒有原生通路連接器的系統。
託管連接器
對於五個企業系統，您完全無需編寫整合程式碼——只需在 資料與整合 中設定連線（端點 + 加密憑證），進行驗證，然後執行一次試運行。每個連接器都會規範化供應商的訂單、客戶和產品，並透過下面記錄的同一個 API 介面進行傳輸——相同的範圍、相同的冪等性、相同的受控管道。每個連接器都會標示其驗證程度。
Salesforce — CRM / OMS
已通過測試資料驗證透過 REST + SOQL 訂購/退貨/帳戶聯絡人/產品2；客戶端憑證 OAuth。
SAP S/4HANA — ERP
已通過測試資料驗證透過 OData A2X 服務取得銷售訂單/業務夥伴/產品主資料；BTP OAuth。
Dynamics 365 — ERP / CRM
已通過測試資料驗證Dataverse (CE) 已驗證；財務與營運已建置框架。 Entra ID OAuth。
Manhattan Active Omni — OMS
在設計夥伴驗證中訂單/退貨/客戶；映射關係根據您租戶的介面映射文件最終確定。
IBM Sterling — OMS
在設計夥伴驗證中getOrderList / 透過 REST API 信封返回；狀態碼已配置到您的管道中。
已通過測試資料驗證：已依據廠商公開的 API 建立並驗證對應關係，首次部署時再於實際環境中驗證確認。設計合作夥伴驗證中：在導入期間，依據您所屬租戶的整合文件完成對應關係。此處未列出的系統，可直接透過下方 API 整合。
客戶數據與行銷增強
與訂單捕獲不同的功能：連接已存在客戶資料的平台，並且 Flash 在發送時使用每個收件人的特徵（名稱、生命週期階段、自訂屬性）豐富每封電子郵件。它是透過電子郵件進行的只讀查找 - 它永遠不會創建成員或暴露 PII。在資料和整合中配置連接，每個連接都會在您儲存時根據您的即時憑證進行運行狀況檢查。
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、Amazon、TikTok Shop），將其開啟即可完成。對於任何其他訂單管理系統，將您的訂單事件發佈到訂單 API — 根據計劃規則獲取自動獎勵，並按比例退還積分。您的 OMS 驅動呼叫（無需入站 Webhook）。
訂單賺取；退款追回
// 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-a-member（從不自動建立）。使用 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_ 密鑰。密鑰不會跨租戶使用；請為每個整合建立單獨的密鑰，以便您可以輪換使用其中一個密鑰而不會影響其他密鑰。
讀取與寫入預設
對帳作業使用唯讀密鑰。僅授予獎勵積分或兌換優惠券的 POS/OMS 路徑寫入權限－每個系統遵循最小權限原則。
冪等鍵
寫入時發送冪等鍵標頭（訂單也帶有自己的 externalOrderId）。重試呼叫會重播原始結果；相同的按鍵但不同的有效負載會被拒絕－一次銷售絕對不會獲得兩次獎勵。
預設審核
每次 API 呼叫都會被記錄，並可在 API 密鑰 → 最近活動 下查看，因此整合的寫入操作始終可追溯到密鑰。
完整端點參考：REST API · 快速入門 · MCP（指標匯入 BI）