电商订单同步
平台 Webhook/轮询 → 星辰销售订单 API → 出库扣库存 → 回写发货状态。关键点:SKU 映射表 + 幂等订单号。
约 12 分钟读完 · OAuth 鉴权 + 错误码 + 集成实战
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 与字段以 官方鉴权文档为准
联调时最常遇到的 6 类返回,输入错误码可快速过滤
10001 · 鉴权失败
场景:access_token 无效或 app_key / app_secret 不匹配
10002 · access_token 过期
场景:业务接口返回 token 失效(默认 2 小时)
20001 · 参数错误
场景:缺少 accountId / 字段类型不符 / 必填项为空
X-Account-Id 与鉴权返回一致。40001 · 资源不存在
场景:按 ID 查单据 / 库存时记录未找到
HTTP 401 · 未授权
场景:换 token 或调业务接口时 Header 未带 token
Access-Token 拼写;授权码 code 仅一次有效,过期需重新授权。429 · 触发限流
场景:超过默认 10 QPS 或日调用上限
官方核心资源 + 第三方实战指南
点选业务域查看对接要点 · 页内先看清再查官方字典
销售单 / 采购单 / 退货单 CRUD、状态流转、审批
即时库存查询、入/出库、调拨、盘点、批次/序列号
物料档案、SKU、价目表、分类、货位
基础档案、联系人、信用额度、应收/应付
凭证、科目、期初/期末、报表、发票
inv_real_qty 查可用量;出库前锁定,失败回滚。批次/序列号场景需带 batchNo。全量接口参数 · open.jdy.com 官方开放平台 →
10001 鉴权失败 ·
10002 token 过期 ·
20001 参数错误 ·
40001 资源不存在
429
官方配置指南 + 实战案例分析
官方案例解决「怎么做」,以下链接帮你回答「多少钱、怎么验收、要不要升级」
推荐学习顺序与时间规划
OpenAPI 文档见 open.jdy.com · ISV 扩展可选 开发者学院
平台 Webhook/轮询 → 星辰销售订单 API → 出库扣库存 → 回写发货状态。关键点:SKU 映射表 + 幂等订单号。
企微审批回调 → 星辰采购/费用单 → 状态回写。关键点:OAuth 与单据类型映射。
银企直联拉流水 → 对账 API 或 AI 匹配 → 生成凭证。关键点:手续费与未达账分类。
商城下单 → 星辰库存查询/锁定 → 支付成功后出库。关键点:超卖防护与安全库存。
API 对接完成后,客户还会问这些
低代码选型有结论?16+ 平台官方授权 · License 省 15%-55% · 定制实施一站办 · IDE 编程工具请向厂商订阅