金蝶云星空销售订单与销售易基础资料查询接口字段手册权威教程

这个接口解决什么问题

在金蝶云星空与销售易并存的私有化集成场景里，业务方最常问的就是「同一份订单/币别/银行账号，两套系统到底以谁为准」。我们把金蝶销售订单、销售易结算币别、销售易我司银行账号这三类高频查询接口封装成 QUERY_ONLY 策略落到集线器，供下游编码对照、单据同步、收款核销等环节统一取数，从而避免两套系统直接互调带来的脏数据与频次失控。

接口能力总览

• 认证方式：金蝶云星空采用私有化部署下的用户口令 + 数据中心授权，应用需绑定具体组织/账套；销售易采用 OAuth2.0 或 Session Token，私有化域名需在内网做白名单。
• 请求结构：金蝶走 QueryBill 或 ExecuteBillQuery 风格的表单请求，需在 FieldKeys 中显式声明返回字段；销售易走标准 REST + SOQL 风格的 where/limit/offset。
• 响应结构：金蝶返回嵌套对象数组，关联字段如 FCustId.FNumber 需要「点路径」嵌套提取；销售易返回扁平 JSON，自定义对象以前缀 customEntity__c / customItem__c 区分。
• 分页模式：金蝶用 Limit + StartRow（每页通常 100–500 行），销售易用 limit + offset（单次上限需参考官方文档）。
• 增量模式：金蝶推荐 FApproveDate>='{{LAST_SYNC_TIME}}' and FDocumentStatus='C' 仅拉已审核单据；销售易用 LastModifiedDate >= {{LAST_SYNC_TIME}}。

典型字段映射

在轻易云上如何配置

在轻易云数据集成平台里，这类查询策略通常以「适配器 + 字段映射器」组合落地：

1. 适配器层：金蝶云星空使用官方 Kingdee 适配器，在连接配置里填入私有化域名、账套、用户与口令；销售易使用自定义对象适配器，把 customEntity70__c / customEntity36__c 注册为可识别的「单据类型」。
2. 调度与策略：三个 QUERY_ONLY 策略在轻易云的策略中心并行编排，调度上把基础资料（币别、银行账号）放在销售订单之前，确保下游映射时集线器里已有对照表。
3. 字段映射器：轻易云的字段映射器会自动把 FCustId.FNumber 这类嵌套字段展开成扁平列，并允许在映射表达式里直接引用对照表完成 FNumber → 销售易 id 的转换。
4. 增量与重试：平台内置 LAST_SYNC_TIME 变量、指数退避重试与失败表，落库失败不会推进游标，断点续跑比较省心。

跨方案实战要点

1. 基础资料先行：币别、银行账号这类低频变更的主数据，必须先于或与销售订单并行落到集线器，否则下游订单同步会因找不到对照而失败。
2. 只拉已审核：金蝶侧增量条件务必加 FDocumentStatus='C'，否则增量会反复拉同一批草稿，导致集线器脏数据膨胀。
3. 嵌套字段必须声明：金蝶 FCustId.FNumber 这类点路径字段，若不在 FieldKeys 里写完整路径，返回结果会直接缺字段，定位时容易误判为接口报错。
4. 对照表是生命线：客户、物料、币别、银行账号四张对照表缺一不可，建议在轻易云里做成独立的主数据策略，由其下游订单/合同策略引用。
5. 调度频次分层：订单类建议每 5–10 分钟，基础资料可每日或每 6 小时，盲目高频调度既压垮源系统也浪费配额。
6. 隐私脱敏前置：联系人、电话、地址在落库前就要按字段级做脱敏或加密，否则后续审计和跨租户复用都会踩雷。

踩坑复盘

• FieldKeys 漏配嵌套字段：金蝶适配器返回 {}，90% 是因为 FieldKeys 没把 FCustId.FNumber 这类嵌套字段写完整。稳妥的做法是把所有需要下钻的字段一次性列齐。
• LAST_SYNC_TIME 提前推进：批次还没全部落库成功就把游标推进，结果部分订单漏同步又无重跑线索。我们现在坚持「整批成功后再更新 LAST_SYNC_TIME」。
• 币别编码不对齐：销售易 customItem8__c 与金蝶 FSettleCurrId.FNumber 没建立对照就直接同步，订单里就会出现「CNY/RMB」混用。稳妥的做法是先在集线器跑一次全量对照脚本，差异告警后再增量。
• 限流被静默丢弃：金蝶私有化部署偶发 429，没尊重 Retry-After 直接按固定间隔重试，会被源端进一步限流。这里要按服务端响应动态退避。
• 明细行没有外键：只把明细行落库却没带回主表 FID，导致后续无法与主表 join。建议明细行映射时把 FSaleOrderEntry_FEntryId 与 FID 同时带回。

何时选用

这套 QUERY_ONLY 聚合模式适用于金蝶云星空与销售易并存的私有化环境，需要把订单与基础资料统一落到集线器做编码对照与下游分发；当业务已迁移到单系统、或对实时性要求必须走消息推送而非定时拉取时，本方案就不再是最优解。