← 返回教程列表
字段与单据金蝶云星辰

金蝶云星辰销售订单详情字段映射:先确认业务语义,再编写转换规则

发布于 更新于 华远智联科技有限公司技术团队

接口字段、权限与调用限制可能随产品版本调整。本文用于说明对接与排查思路,实际接入请核对当前官方文档,并在测试环境验证。

适用于将销售订单详情映射到CRM、WMS或其他业务系统的场景。字段名看起来相近,并不能保证业务含义相同;“已收款”“已审核”“已出库”也不能相互替代。

先做一张字段映射表

每个目标字段都应记录:业务解释、源字段及路径、目标字段、类型、精度、空值处理、转换规则和样本。明确它来自表头、分录、关联资料还是需要另查的对象;无法确认的字段保持待核对,不直接根据中文名称猜英文参数。

状态字段单独核对

先由业务人员定义外部系统需要展示的状态,再查当前接口文档提供的状态含义。部分发货、部分收款和行级关闭可能同时存在,不能按未经核实的枚举大小取最大值来代表整张订单。需要派生状态时,写明组合条件与优先级,并列出反例测试。

金额与关联资料如何处理

区分数量、价税、折扣、费用及币种口径;不能在不了解规则时自行重算总额。客户、商品、仓库等关联资料使用明确标识匹配,名称仅用于展示或人工核对。字段缺失、字段为空、字段值为零,需要各自定义处理方式。

验收标准

准备新建、修改、部分履行、关闭及存在折扣的订单样本,逐项验证表头、分录和状态。对重复读取同一版本的订单,转换结果应一致;对更新后的订单,能解释哪些字段发生变化。最终保存映射表及脱敏样本,比只给出一段没有来源的JSON更利于维护。

参考与适用边界

本文提供问题排查与集成设计建议;具体字段、权限和业务限制需按当前文档在授权测试环境验证。

下一步:确认对接范围

需要将接口能力落地到业务系统?可先了解对应产品的实施范围与交付方式。

相关教程

需要专业的接口对接服务?

华远智联科技有限公司专注金蝶系列产品 API 对接,提供定制化开发方案,快速打通您的业务系统。

免费获取对接方案