金蝶云·星辰集成:成长型企业的对账集成方案
金蝶云星辰 集成 成长型企业 对账
摘要:金蝶云·星辰(Kingdee Cloud Star,下文简称「星辰」)是金蝶在 2019 年推出的「成长型企业云 ERP」——目标客户是年收入 5 千万至 5 亿、员工 50-500 人、单组织或多门店的成长型企业,正好夹在金蝶 KIS(中小企业)和金蝶云星空(中大型企业)之间。对账集成从星空迁到星辰,最容易踩的三个坑是:① 认证协议换了——HMAC 双签名退场、OAuth 2.0 + JWT 上位,但星辰的 token scope 比苍穹更窄(按租户隔离),多门店账号体系需要单独处理;② 数据模型换了——星空的「动态表单 + 表别名 + 立账类型三分」在星辰上退化成「标准单据 + 多账簿维度」,对账脚本需要重新映射「应收 → 销售单 + 收款单」两段式语义;③ 集成通道换了——星空是 WebAPI Service Stub(RPC 风格),星辰是 OpenAPI REST(资源路径式),错误码体系完全不同(HTTP 4xx/5xx vs 金蝶协议层的
IsSuccess=false)。文章用星辰与星空/KIS/苍穹的 5 维对比表,给 CTO / ERP 实施一份选型与对接的实操路径,结尾给出 5 步接收验收清单。
关键词:金蝶云星辰、成长型企业、对账集成、OAuth 2.0、OpenAPI、销售单、收款单、多账簿
一、客户问的最多的问题:星辰和 KIS / 星空 / 苍穹是什么关系
「我们公司买的是金蝶云·星辰(不是云星空、不是精斗云、不是苍穹),你们这套对账系统能不能直接接上?」——这是 2026 年成长型企业客户在集成中心做对账接入时被问到最多的问题。答案先放在前面:能接,但要做协议适配。星辰不是 KIS 的「云升级版」,也不是星空的「轻量版」,而是金蝶「云原生 + 成长型企业」这条产品线上的独立分支。
| 维度 | 金蝶云·星辰 | 金蝶 KIS 云 | 金蝶云·星空 | 金蝶云·苍穹 |
|---|---|---|---|---|
| 定位 | 成长型企业(年收 5 千万 - 5 亿)云 ERP | 中小企业(年收 < 5 千万)云 ERP | 中大型企业(年收 5 亿 +)多组织 ERP | 大型集团 / 跨国云原生 PaaS |
| 部署形态 | 金蝶云端 SaaS(多租户) | 金蝶云端 SaaS | 私有部署 / 云端版(单租户) | 云原生 K8s(单租户) |
| 认证协议 | OAuth 2.0 + JWT(租户隔离) | OAuth 2.0 + JWT | HMAC 双签名 + Session Cookie | OAuth 2.0 + JWT |
| API 风格 | OpenAPI REST(资源路径式) | OpenAPI REST | WebAPI Service Stub(RPC 风格) | OpenAPI REST |
| 数据模型 | 标准单据 + 多账簿 | 标准单据 + 单账簿 | 动态表单 + 表别名 + 立账类型三分 | 动态领域模型 + 业务对象 |
| 单据体系 | 销售单 / 出库单 / 收款单 / 付款单 | 同星辰(简化版) | 应收单 / 应付单 / 收款单(立账三分) | 业务对象 + 视图 |
| 多组织支持 | 弱(组织是单层 + 多门店) | 不支持 | 强(多组织多账套) | 极强(多语言 + 多核算体系) |
| 凭证实时性 | T+1(次日生成) | 异步批处理 | 实时(审核即生成) | 实时(智能会计平台) |
| 适配企业 | 连锁零售 / 电商成长型 / 轻制造 | 商贸 / 小型服务 | 多组织多账套集团 | 跨国集团 / 复杂业务 |
星辰与星空最大的差异在单据语义 + 多组织能力。星空一张「应收单」(AR_receivable formId)通过 FSetAccountType 字段把业务应收、暂估应收、财务应收三种语义压在一张表上;星辰把这三种语义拆成了两张独立的单据——销售单(确认收入时点)+ 收款单(实际收款时点),中间靠「立账关系」字段(FSettleTypeId)自动联动。对账脚本要把电商订单 → 平台打款 → 星辰单据的映射关系重新做一遍,重点处理「已发货未收款」「已收款未开票」「退款倒挂」三类典型时序错位。
对于那些「从 KIS 迁到星辰」或「星辰迁到星空」的成长型企业客户,迁移不是「升级」——所有 handler、字段映射、签名逻辑都要重做一遍。下文先讲协议差异,再讲数据模型,最后给出迁移路径。
二、API 协议:从 HMAC 双签名 → OAuth 2.0 + JWT 的云端重构
金蝶云星空的金蝶对接用 11 个 HTTP 请求头 + 两层 HMAC 签名(X-Api-Signature + X-KD-Signature),是「为内网企业版定制的私有协议」。这套协议在星辰上完全不能复用——星辰走的是标准的 OAuth 2.0 + JWT 协议,与苍穹、KIS 云一致。流程如下(基于 2026-09 星辰 V8.0 测试租户验证):
// Step 1 · 获取 access_token(替代 HMAC 签名)
POST /kapi/v1/oauth2/token
Headers:
Content-Type: application/x-www-form-urlencoded
Authorization: Basic <base64(appId:appSecret)>
Body:
grant_type=client_credentials
scope=openapi // 星辰 scope 不可细化(苍穹可细化到业务对象)
→ Response
{
"access_token": "eyJhbGciOiJIUzI1NiIs...",
"token_type": "Bearer",
"expires_in": 7200, // 星辰默认 2 小时
"refresh_token": "...",
"scope": "openapi"
}
// Step 2 · 携带 token 调用业务接口
POST /kapi/v1/sal/saleOrder/save
Headers:
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
Content-Type: application/json;charset=UTF-8
Body:
{
"billNo": "SO20260925-0001",
"customerCode": "CUST001",
"bizDate": "2026-09-25",
"currency": "CNY",
"entries": [
{
"materialCode": "SKU001",
"quantity": 10,
"price": 99.5,
"amount": 995.0
}
]
}
四个关键变化值得拎出来说:
变化一:协议从「私有 RPC」退到「标准 REST」。 星空的请求体是金蝶私有的 DynamicFormService.Save + Model.FBillHead + FEntity 三段式;星辰的请求体是标准的 JSON + RESTful 资源路径(/kapi/v1/sal/saleOrder/save)。handler 实现可以直接用 axios/fetch,星空的 WebAPI 客户端不能复用——但好消息是苍穹/KIS 云的 OpenAPI 客户端可以 90% 复用。
变化二:签名从 HMAC 双签名退化为「Bearer Token 单鉴权」。 星辰不做请求签名——只要登录成功拿到 access_token、后续调用带 Authorization: Bearer 头即可。这意味着:
- CPU 开销接近 0(没有 SHA256 计算)——批量 PULL 销售单比星空更快;
- 会话泄露风险中等——
access_token一旦被截获,攻击者可以调用任何业务接口直到 token 过期(星辰默认 2 小时);handler 必须把 token 存在服务端内存,不能传给前端; - 会话过期是 HTTP 401(不是金蝶协议层的
IsSuccess=false),前端 axios 拦截器可直接用error.response.status === 401触发刷新——这与星空完全相反。
变化三:Scope 比苍穹更窄。 苍穹的 OAuth scope 可以细化到具体业务对象(AR_receivable.read、sal.saleOrder.write),星辰的 scope 只能是顶层枚举(openapi)。handler 不能按「销售单写权限」单独申请 token,只能用全量 openapi scope——这对权限审计要求严格的客户是个减分项,需要在星辰租户管理后台做 IP 白名单 + 操作日志审计来兜底。
变化四:租户隔离通过 orgId 而不是 acctId。 星空的账套号(acctId)是 URL 路径的一部分(/k3cloud/.../acctId=001/...),星辰的租户 ID(orgId)是 Header 的一部分(X-Org-Id: 1234567890)。多门店客户的不同星辰租户需要不同的 orgId,handler 凭据配置要按租户分组,不能按星空的「一个账套一个 acctId」一刀切。
集成中心架构下,星辰必须新增独立的 handler namespace——kingdee-cloud-star.*,与星空的 kingdee-cloud-galaxy.*、苍穹的 kingdee-cosmos.*、KIS 的 kingdee-kis.* 物理隔离:
下面这张集成中心方案的真实截图,是当前 9 个金蝶云星空 handler 的全景——星辰接入后会变成 9 + N 个 handler,命名空间前缀 kingdee-cloud-star:
三、数据模型:销售单 + 收款单的「立账关系」语义
认证换了是「皮」;数据模型简化是「骨」。星辰的单据体系比星空简单一个数量级——星空是「动态表单 + formId 三态复用」,星辰是「一张标准单据 + 几个固定字段 + 一个立账关系表」。但星辰比 KIS 多了一个多账簿维度——这是成长型企业最核心的需求(同一笔销售可以按「财务账」「管理账」「税务账」三套口径记录)。
星空 → 星辰单据对照表(基于 2026-09 星辰 V8.0 测试租户验证):
| 业务事实 | 金蝶云·星空 | 金蝶云·星辰 |
|---|---|---|
| 电商订单收入 | AR_receivable formId + FSetAccountType='1'(业务应收) | sal.saleOrder(销售单) |
| 出库发货 | 应收单下推 → 销售出库单 | stk.stkOutboundOrder(出库单,与销售单关联) |
| 平台打款 | AR_RECEIVEBILL(收款单) | rec.receiveBill(收款单) |
| 退款红字 | 负数应收单 + 负数收款单 | 负数销售单 + 负数收款单(红字标记) |
| 费用挂账 | AP_OtherPayable | pay.otherPayable(其他应付单) |
| 平台扣点 | 财务应付单分录 | exp.expenseAllocation(费用分摊单) |
| 凭证 | 自动生成 + WebAPI 触发 | T+1 自动生成(次日凌晨 02:00 跑批) |
| 多账簿 | 不支持(单账套) | 支持(财务账 + 管理账 + 税务账) |
差异体现在四个细节:
细节一:没有「立账类型三分」,但有「立账关系」表。 星辰不存在 FSetAccountType='2'(暂估)这种过滤字段——所有销售都是「权责发生制」,销售单审核后自动生成应收账款(财务账维度),收款单审核后自动核销应收账款。对账脚本不需要做「暂估 vs 财务」的三态识别——这是星辰接入最爽的一点。但星辰额外有一张 rec.receiveBillLink 立账关系表,记录「哪张销售单对应哪张收款单」——对账脚本必须读这张表才能完成「销售单 → 收款单」的双向溯源。
细节二:销售单与收款单是「关联单据」而不是「独立单据」。 星空的销售出库单可以从应收单下推(Push 接口 + RuleId),星辰的销售单与收款单通过 linkBillNo(关联单据号)字段互相引用——它们之间是「业务关系」的逻辑关联,不是「下推」的物理操作。handler 推送销售单后必须回写 linkBillNo,下次推送收款单才能反查到上游销售单——这是星辰最容易踩的坑。
细节三:凭证是「T+1 异步」而不是「审核即生成」。 星空可以在应收单审核时同步生成凭证(凭证模板挂在单据审核事件上),星辰的凭证是后台批处理生成的(默认每天凌晨 02:00 跑一次扫描前一日审核单据)。这意味着:
- 对账 PULL 凭证需要按
bizDate + 1拉取(T+1 口径),不能按审核时间; - 但星辰的凭证生成是「幂等」的——同一条销售单重复审核不会重复生成凭证;
- handler 推送销售单后立即 PULL 凭证,80% 概率拿不到(凭证还没生成)——这与星空不同,星空必须等凭证生成才能做财务对账。
细节四:多账簿维度是星辰的核心差异化能力。 星辰可以同一笔销售按三套账簿记录(财务账按权责发生制、管理账按现金收付制、税务账按发票口径),accountingBook 字段决定入账账簿。对账场景下「管理账」口径最常用——CFO 需要的是「实际收了多少钱」,而不是「按发票应收多少钱」。handler 推送时必须显式传 accountingBook="MGMT",否则默认走财务账口径,对账金额会与电商账单的实际打款时点错位。
集成转换骨架(transform_documents × payload JSONB)在星辰与星空之间完全共用——这是「集成中心」抽象最大的价值:
也就是说:解析脚本、集成转换脚本、PULL 数据 → SupplyOrder 落库 → 收入对账匹配 → 生成 transform_documents——这些步骤在星辰与星空之间零成本共用,差异只在最后 100 米的 PUSH 引擎把通用骨架加工成星辰的 OpenAPI REST JSON Model。
下面是集成转换的完整流程图——星辰接入后,这条链路完全通用,只在 PUSH handler 这一段做 OAuth 2.0 适配:
四、星辰特有的电商对账场景:销售单 + 收款单 + 立账关系的三段式
星辰相比星空有 3 个电商场景能力,对账场景能用上的有:
能力一:销售单支持「平台预付 + 尾款」两段式立账。 星空的应收单只能按「一笔销售对应一张应收」,星辰的销售单支持「一张销售对应两段立账」——平台预付款自动生成一段应收账款,尾款(消费者签收后平台打款)自动生成第二段应收账款。这对电商场景的对账接入是巨大优势——业务用户不需要把一笔销售拆成两笔,星辰底层自动处理。
电商场景下的典型用法(基于 2026-09 星辰 V8.0 测试租户验证):
// 销售单 Save(电商订单 → 星辰销售单)
POST /kapi/v1/sal/saleOrder/save
{
"billNo": "SO-JD20260925-001", // 业务订单号作单号
"customerCode": "JD_MALL_001", // 平台作为客户
"bizDate": "2026-09-25",
"accountingBook": "MGMT", // 管理账口径
"isPlatformSettlement": true, // 平台预付 + 尾款模式
"settleStages": [
{ "stageName": "预付款", "ratio": 30, "linkBillType": "rec.receiveBill" },
{ "stageName": "尾款", "ratio": 70, "linkBillType": "rec.receiveBill" }
],
"entries": [
{
"materialCode": "SKU001",
"quantity": 10,
"price": 99.5,
"amount": 995.0,
"extField1": "113-0335242-1602666" // 电商订单号
}
]
}
能力二:自定义字段(extField1..extField20)可作平台对接标识。 星辰与星空一样有自定义字段——但星辰的自定义字段不需要金蝶顾问在账套里手动配置(星空的 F_UJOP_* 字段需要金蝶顾问发布),星辰的 extField1..extField20 是每张单据结构里就有的固定字段,业务用户可以直接用。这对成长型企业的对账接入是巨大优势——不需要金蝶顾问介入,业务用户自己在星辰客户端打开「单据自定义」就能看到字段。
对账场景下推荐用法:
-- 星辰单据头自定义字段约定(业务用户可改)
extField1 -- 电商订单号(业务订单号)
extField2 -- 平台编码(JD_POP / DOUYIN / ALIPAY / AMAZON / ...)
extField3 -- 平台店铺编码
extField4 -- 平台单据号(平台侧的原始单号)
extField20 -- 轻易云单据编号(幂等键,与星空的 F_UJOP_Text 角色一致)
能力三:凭证是 T+1 异步,不阻塞对账。 星空可以在应收单审核时同步生成凭证,星辰的凭证是 T+1 后台跑批生成的(默认每天凌晨 02:00 跑一次)。这意味着对账 PULL 凭证需要按 bizDate + 1 拉取(T+1 口径),handler 推送销售单后立即 PULL 凭证80% 概率拿不到——这与星空不同。
下面是金蝶 PUSH 的完整流程图——星辰接入后,这条链路完全通用,只在第 4 步做 OAuth 2.0 适配:
集成中心下挂转换单据的真实截图——这套机制对星辰与星空共用同一张表,只在 PUSH handler 那一段做协议适配:
「轻易云智能对账系统」在星辰对接上的策略是:认证 + 模型 + PUSH 三件套独立封装成 handler namespace(kingdee-cloud-star.*),与星空的 kingdee-cloud-galaxy.*、苍穹的 kingdee-cosmos.*、KIS 的 kingdee-kis.* 命名空间物理隔离,业务侧无需感知底层协议差异——配置侧还是 configJson.docTypes 那一套,运维侧还是 transform_documents 状态机,观测侧还是 integration_push_logs.responseSummary 完整记录星辰报错原文(HTTP 4xx/5xx 自动归一化为 JSON)。
五、星辰 vs KIS vs 星空 vs 苍穹:5 维选型决策表
把上文落到选型层面,给出 5 维决策表(CTO / ERP 实施可以直接拿走):
| 选型维度 | 选 KIS 云 | 选云·星辰 | 选云·星空 | 选云·苍穹 |
|---|---|---|---|---|
| 企业规模 | < 50 人单组织 | 50-500 人单组织多门店 | 500 人以上多组织 | 集团级多组织跨国 |
| 年收入 | < 5 千万 | 5 千万 - 5 亿 | 5 亿 + | 不限 |
| 实施预算 | < 30 万元/年 | < 100 万元(年付) | 50-500 万元 | 500 万 + |
| 部署形态 | 金蝶云端 SaaS | 金蝶云端 SaaS | 私有部署 / 云端版 | 必须云原生 / K8s |
| 集成成本 | 中(OAuth 2.0 已就绪) | 中(OAuth 2.0 新建) | 低(handler 已有 9 个) | 高(OAuth 2.0 + DDM 重建) |
| 现有集成复用 | 中(部分共用) | 中(部分共用) | 直接用(已有 9 个 handler) | 重新做(迁移成本) |
| 多账簿支持 | 不支持 | 支持(财务 + 管理 + 税务) | 不支持 | 支持(多核算体系) |
| 凭证实时性 | 异步批处理 | T+1 异步 | 审核即生成 | 审核即生成 |
判断标准:
- 如果企业是 2020 年后成立的小型电商、员工 < 50、单一组织——KIS 云 是最经济的选择(年付几千到几万);
- 如果企业是年收入 5 千万 - 5 亿、50-500 人、多门店连锁——金蝶云·星辰 是最对位的选择(标准云 SaaS 部署 + 多门店支持 + 多账簿维度);
- 如果企业规模在 200-1000 人、需要多组织多账套——金蝶云·星空,handler 已就绪;
- 如果是集团级、多语言、跨国——金蝶云·苍穹,迁移成本最高但协议最现代。
对于那些「正在从 KIS 迁到星辰」或「星辰迁到云星空」的成长型企业,集成中心需要支持双账套并行 PUSH——同一套对账脚本可以同时输出到星辰和星空两个目标系统。集成中心的转换单据全局视图已经为这种场景预留了状态机(DRAFT → CONFIRMED → PUSHING → PUSHED / FAILED),configJson.docTypes 数组里可以同时声明 sal.saleOrder(星辰)和 AR_receivable(星空),handler 自动按 docType 路由到对应 namespace。
六、5 步接收验收清单(星辰版)
如果客户已经在用星辰做对账集成,下面 5 步可以直接拿来做接收验收:
# Step 1 · OAuth 2.0 token 获取与会话管理
# 期望:返回 access_token;连续 3 次失败返回锁定;token 2 小时不过期
curl -X POST https://<star-server>/kapi/v1/oauth2/token \
-H "Authorization: Basic $(echo -n "$APP_ID:$APP_SECRET" | base64)" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&scope=openapi"
# Step 2 · 销售单查询(OpenAPI REST 响应解析)
# 期望:返回 JSON 数组含 billNo / customerCode / entries 等字段;中文正常
curl -X POST https://<star-server>/kapi/v1/sal/saleOrder/list \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "X-Org-Id: $ORG_ID" \
-H "Content-Type: application/json;charset=UTF-8" \
-d '{"filter": "bizDate >= \"2026-09-01\" AND status = \"C\""}'
# Step 3 · 收款单推送(Save + 立账关系回写)
# 期望:销售单审核后生成应收;收款单 Save 后自动核销应收;星辰返回 billNo
curl -X POST https://<star-server>/kapi/v1/rec/receiveBill/save \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "X-Org-Id: $ORG_ID" \
-H "Content-Type: application/json;charset=UTF-8" \
-d '{
"billNo": "RB-20260925-001",
"customerCode": "JD_MALL_001",
"bizDate": "2026-09-25",
"accountingBook": "MGMT",
"linkBillNo": "SO-JD20260925-001",
"amount": 995.0
}'
# Step 4 · 凭证查询(T+1 异步批处理结果)
# 期望:审核次日凌晨 02:00 后凭证可查;extField1 自定义字段携带电商订单号
curl -X POST https://<star-server>/kapi/v1/gl/voucher/list \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "X-Org-Id: $ORG_ID" \
-H "Content-Type: application/json;charset=UTF-8" \
-d '{"filter": "bizDate = \"2026-09-25\""}'
# Step 5 · 集成推送日志
# 期望:responseSummary 含星辰 OpenAPI 报错原文(HTTP 4xx/5xx 自动归一化);失败原因可读
SELECT "transformDocumentId", action, success, "responseSummary"
FROM integration_push_logs
WHERE "targetSystem" = 'kingdee-cloud-star'
ORDER BY "createdAt" DESC LIMIT 20;
如果 Step 1 的 access_token 能稳定获取 + Step 2 的 JSON 响应字段完整 + Step 3 的收款单立账关系正确回写 + Step 4 的 T+1 凭证按 extField1 关联到业务订单号 + Step 5 的 OpenAPI 报错可读,这套星辰对接基本可以验收。
七、Takeaway
金蝶云·星辰不是金蝶云星空的「轻量版」,而是金蝶「云原生 + 成长型企业 + 多账簿」这条产品线上的独立分支。对账集成从星空迁到星辰(或者反过来),最容易踩的三个坑是:**协议从 HMAC 双签名 + WebAPI 换成 OAuth 2.0 + OpenAPI REST(scope 不可细化)、数据模型从「动态表单 + 立账类型三分」简化成「标准单据 + 立账关系」二维语义、集成交付从「下推生成」退化为「关联单据 + linkBillNo 手工回写」。**任何一环没准备好,迁移就会卡在「OAuth scope 太宽权限审计不通过」「linkBillNo 没回写导致收款单找不到上游销售单」「T+1 凭证没生成导致对账金额时点错位」这种问题里。
星辰给成长型企业财务对账带来的真正价值,不是「便宜」而是「多账簿维度让对账口径与 CFO 视角一致」——管理账口径(accountingBook="MGMT")按现金收付制记录,CFO 可以直接看到「本月实际回款多少」,不需要从财务账的权责发生制数据里再做调整;平台预付 + 尾款两段式立账让电商场景的对账脚本从 30 个字段简化到 18 个字段,业务用户自己就能在星辰客户端用自定义字段 extField1..extField20 配置对接标识。但这些简化也要付出代价:scope 不能细化(权限审计需另想办法)、凭证是 T+1 不是实时的、立账关系不像星空那样有下推自动维护(必须手工回写 linkBillNo)。
走这条「星空 → 星辰 / KIS → 星辰 / 星辰 → 苍穹」任何一条迁移路径,「轻易云智能对账系统」的集成中心已经把流程固化为「handler namespace 隔离 + 转换层共用 + 观测层统一」的三段式——金蝶云星空用户迁到星辰时,业务侧改的是 docType(sal.saleOrder 替代 AR_receivable),不改流程;运维侧改的是 endpoint(OpenAPI REST 替代 WebAPI),不改状态机;观测侧改的是报错格式(HTTP 4xx/5xx 替代 IsSuccess=false),不改 dashboard。KIS / 星辰 / 星空 / 苍穹四套金蝶产品线在集成中心底下是并列的 N 个 handler,业务侧无需关心哪张单据走哪条路径——配置即路由,错误可归因。