福州贤巧信息技术有限公司 · 2018 年注册于福州鼓楼工作日 09:00–18:00 · contact@yrsxkj.cn
首页/新闻资讯/老旧系统对接新平台,接口层要预留哪些字段
系统集成 · 2026-04-02

老旧系统对接新平台,接口层要预留哪些字段

对接时只按当前需求传字段,半年后加一个业务场景就要改接口。字段预留做得早,后续扩展的成本能降一个量级。

老旧系统对接新平台,接口层要预留哪些字段

接口设计最常见的短视是“够用就行”:当前只需要传订单号、金额、状态,就只传这三个。等业务提出要按门店统计、要支持拆单、要区分线上线下,接口结构就要重做,连带两边系统都要改。

第一类要预留的是标识类字段。除了业务主键,还要有全局唯一号、来源渠道、业务类型、门店或组织编码。这些字段当下可能不用,但一旦要做多组织统计或数据合并,没有它们就只能靠名称匹配,而名称是最不可靠的关联依据。

第二类要预留的是时间类字段。创建时间、业务发生时间、更新时间、状态变更时间要分开,不要只留一个“时间”。业务发生时间与系统录入时间经常不是同一天,跨期单据的统计口径就依赖这个区分。

第三类要预留的是金额与数量类字段的结构。除了总额,要能拆出单价、数量、折扣、税额、运费。只传总额的接口,在需要按品类核算或处理部分退款时无法支撑。数量同理,要区分下单数量、发货数量、退货数量。

第四类要预留的是扩展容器。在报文里保留一个扩展字段区,允许后续追加键值对,而不改动接口结构。同时约定版本号,新版本接口向下兼容旧版本,避免一端升级导致另一端不可用。

预留不是无限加字段。原则是:凡是用于关联、统计、追溯的字段必须有;凡是纯展示的字段可以后补。按这个原则梳理一遍,通常能覆盖未来两三年的大部分扩展场景,而不至于把接口做得臃肿难维护。