← 返回案例库首页
CASE 03 · 开放接口
三方通知配置：订单 / 会员 / 商品，实时推送第三方
无缝对接第三方系统：在管理后台为每个门店配置会员、订单、商品三类推送 URL，收银业务发生时数据实时 POST 到客户系统。有开发能力的客户解析推送内容，即可把订单、会员、商品同步到自己的 ERP、小程序或会员平台。
客户背景（已脱敏）
- 客户类型
- 华中某市连锁超市总部（案例化名称：某超市总店），下辖 3 家门店
- 团队情况
- 自有开发团队，维护一套自研会员小程序与进销存报表系统
- 对接诉求
- 收银端产生的订单、会员新增/充值、商品变更，实时回传到自研系统，避免人工导出对账
- 上线效果
- 会员、订单、商品三类数据 T+0 实时同步，自研系统数据延迟从"每日导出"缩短到"秒级"
说明：以上客户名称、门店名、回调地址均为脱敏示例数据，仅用于说明功能使用方式。
使用场景
- 场景一：订单实时同步。门店每完成一笔收银，订单数据立即推送到客户自研系统，用于实时销售看板与自动对账。
- 场景二：会员资产同步。会员新增、资料修改、注销、充值、负充退款等操作实时推送，第三方系统会员余额与乐悠客保持一致。
- 场景三：商品资料同步。商品新增、改价、上下架信息实时推送，第三方商城 / 小程序商品库自动更新，无需重复维护。
配置步骤（管理后台）
进入通知配置。管理后台 → 通知 → 门店通知配置，顶部可按「通知类型」（会员通知 / 订单通知 / 商品通知）切换，并选择门店范围（管理员可对全部门店批量设置）。
填写回调地址。在对应门店行内输入回调地址（URL），例如
https://open.example-partner.com/api/leuke/callback，格式需为完整 https 地址。启用并保存。打开「是否启用」开关，点击「保存」；如需给多家门店配置同一地址，勾选门店后点「批量设置选中门店」。
开发联调。客户开发团队在推送接收端解析 JSON（notify_body），按 event / action 字段分发处理，并确保接口返回 HTTP 2xx；系统会自动记录推送日志，便于排查。
推送协议说明（供客户开发人员参考）
推送机制
POS 收银成功后，系统会向已启用的回调地址 POST JSON（即 notify_body）。内部触发接口为 POST /api/v1/shop_notify_set/notify，请求体为：
{ "notify_type": 1|2|3, "notify_body": { ... }, "notify_shopid": 门店ID }
其中 notify_type：1 = 订单通知，2 = 商品通知，3 = 会员通知。第三方回调接口请返回 HTTP 2xx，系统会记录推送日志。
会员通知主流字段（event 固定 member）
| 字段 | 说明 | 备注 |
|---|---|---|
| event | 事件类型 | 固定 member |
| type | 通知类型 | 固定 3 |
| action | 操作 | add 新增 / update 修改 / delete 注销 / recharge 充值 / refund 负充退款 |
| shopid | 门店 ID | — |
| member_id | 会员 ID | — |
| name | 会员姓名 | — |
| mobile | 手机号 | — |
| member_card | 会员卡号 | — |
订单通知、商品通知的字段结构同理，在后台「推送传参与响应示例」页签中分别查看；客户在推送页面解析商品、会员、订单数据后，即可同步到自己的系统。
收银系统下载
下载乐悠客收银-定制版
当前案例配套安装包：乐悠客收银-定制版（Windows）· 点击按钮即可直接下载安装。