电商订单同步
平台 Webhook/轮询 → 星辰销售订单 API → 出库扣库存 → 回写发货状态。关键点:SKU 映射表 + 幂等订单号。
OAuth 鉴权 · 订单/库存/财务 API · 电商/WMS 集成实战 — 联调文档 + 选型/商务内链,一站搞定。
你在做什么?选一个路径
app_key + app_secret → access_token → 业务接口(OAuth 2.0 授权码模式)
app_key 与 app_secret
code,再换取 access_token(有效期 2 小时)
access_token,并按接口要求传入 accountId / tenantId
refresh_token 静默续签,避免业务调用中断
# 1. 用授权码换 access_token
curl -X POST https://openapi.kingdee.com/koas/APP000041/api/oauth2/access_token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=authorization_code" \
-d "app_key=YOUR_APP_KEY" \
-d "app_secret=YOUR_APP_SECRET" \
-d "code=USER_AUTH_CODE"
# 返回
# {
# "access_token": "xxx",
# "refresh_token": "yyy",
# "expires_in": 7200,
# "accountId": "123456"
# }
# 2. 携带 token 调用业务接口
curl -X GET https://openapi.kingdee.com/jdy/v2/scm/inv_real_qty \
-H "Access-Token: xxx" \
-H "X-Account-Id: 123456"
具体 endpoint 与字段以 官方鉴权文档为准
官方核心资源 + 第三方实战指南
金蝶云·星辰开放 API 覆盖 5 大业务域,选需接入
销售单 / 采购单 / 退货单 CRUD、状态流转、审批
即时库存查询、入/出库、调拨、盘点、批次/序列号
物料档案、SKU、价目表、分类、货位
基础档案、联系人、信用额度、应收/应付
凭证、科目、期初/期末、报表、发票
10001 鉴权失败 ·
10002 token 过期 ·
20001 参数错误 ·
40001 资源不存在
429
官方配置指南 + 实战案例分析
官方案例解决「怎么做」,以下链接帮你回答「多少钱、怎么验收、要不要升级」
推荐学习顺序与时间规划
OpenAPI 文档见 open.jdy.com · ISV 扩展可选 开发者学院
平台 Webhook/轮询 → 星辰销售订单 API → 出库扣库存 → 回写发货状态。关键点:SKU 映射表 + 幂等订单号。
企微审批回调 → 星辰采购/费用单 → 状态回写。关键点:OAuth 与单据类型映射。
银企直联拉流水 → 对账 API 或 AI 匹配 → 生成凭证。关键点:手续费与未达账分类。
商城下单 → 星辰库存查询/锁定 → 支付成功后出库。关键点:超卖防护与安全库存。
API 对接完成后,客户还会问这些