邻聚云 · 连接器

连接器能力地图

由小程序与租户能力反推：商品库存、订单、发货、对账、事件五类集成点，与圈主移动端 ERP 授权（F4-10）互补。

创建应用→租户授权→API/回调→生产监控

已授权租户

2

今日回调成功

99.2%

应用与 Key

应用名	Client ID	平台审核	操作
邻聚库存桥	app_7x9k2m	已通过
订单拉取 Demo	app_demo01	审核中

创建应用后向租户发起授权（OAuth 示意）；租户管理员在租户中心审批。

租户授权记录

租户	权限范围	状态	操作
demo-retail	商品读/写、订单读、发货写	有效
demo-community	订单读	待租户确认

商品库存同步

POST /v1/tenants/{tenant_id}/skus/sync
Authorization: Bearer <access_token>

{ "sku_code": "ORANGE-5KG", "stock": 120, "version": 42 }

需幂等与版本号；与 F1-12 锁定库存策略在服务端仲裁。

订单拉取

GET /v1/tenants/{tenant_id}/orders?status=PAID&since=...

子单粒度（F3-17）；含费率与分账快照 ID 供对账。

发货回传

POST /v1/orders/{sub_order_id}/shipments
{ "carrier": "SF", "tracking_no": "SF123..." }

回写后触发物流轨迹订阅（F4-12）。

对账单下载

与租户/平台财务对账口径一致，不含货款托管字段。

事件订阅

事件	推送 URL	操作
order.paid	https://isv.example/hooks/linju
refund.success	https://isv.example/hooks/linju

沙箱与监控

沙箱租户

回调失败重试与签名校验文档独立于竞品，采用邻聚云规范命名。

邻聚库存桥

Client IDapp_7x9k2m

Client Secretsec_••••••••rotate

回调域名

demo-retail 授权

权限范围商品读/写、订单读、发货写

授权时间2026-09-01

状态有效

order.paid

推送 URL

签名密钥whsec_••••

重试策略指数退避 · 最多 24h