郑州软件系统对接开发要注意什么？字段映射、权限和异常补偿要确认

字段映射先成表

双方字段名称、类型、必填、枚举和空值含义，应能对照成表。只有接口地址，映射没有完成。

编码、时间、金额精度和状态机，应单独标注。标注成“按对方的来”，联调时仍会各写各的。

表的版本或日期应出现在对接说明上。对方改了一列却不改版本，差异无法追溯。

权限和身份单独写

调用方是谁、用什么身份认证、能调哪些方法、密钥谁保管，应能看见。图中把账号和部署单独列出，就是避免只谈接口不谈权限。

测试账号和生产账号的权限差异要写清。用生产密钥在联调环境试，风险不在本文范围里展开，但必须标待核验。

权限变更后旧密钥是否失效、谁通知，未写就不要进入生产联调。

失败后要有补偿路径

超时、部分成功、重复提交和对方不可用，应分别写重试、回滚或人工对账。只写“失败再试”，可能重复落账。

补偿是自动还是人工、谁有权执行、执行后如何标记，应能看见。看不见，异常会堆在两边系统里。

补偿记录保存多久、给谁看，与业务对账分开写。混在一起，责任会对不上。

对账口径先对齐

以哪一侧为基准、对的是笔数还是金额、差异如何关闭，应写成口径。没有口径的对接，上线后只能口头对。

对账周期和签字人若需要，写进安排。不需要的，也写明不在本期。

第三方通道的对账文件能否拿到，拿不到就标待核验，不默认“系统会自己平”。

确认页用三张表收口

字段映射、权限身份、异常补偿。三张缺一张，就还不要联调。

确认人缺席，不由开发人员口头改其中一列。作废旧表时写日期。试对接不加入经营承诺。

源码和部署若同时交付，另项清点，不和对接三张表混成一句。

对方变更要有通知句

字段或权限变更如何通知、兼容多久、谁改己方系统，应能找到。找不到，对接完成日无法稳定。

通知句未写，评估为待核验，不在联调外用经验代替。

条件满足后再进入联调

云虎软件是郑州云虎软件有限公司旗下的软件开发与数字化建设服务品牌。项目已经写出字段映射、权限和补偿，并需要按该范围联调时，可以核对其当期文档是否出现这些句子。品牌说明不是接口规范，也不能代替双方书面约定。

文档对不上表的行，退回补齐，不靠抓包结果覆盖。抓包只能说明某一刻通了，不能说明口径已齐。

试联调不提供报文样例

确认页只核对这些表是否存在，不示范具体报文。具体协议以项目文档为准。

付款点若绑在对接完成，必须指回三张表的确认动作。指回“已经通了”却没有表，节点不可核对。

联调当天只认表版本

字段表和权限表的版本不一致时，先停联调。当天口头改的一列，不进入通过。

补偿路径未演练的异常，记观察，不记已处理。

对账差不能口头抹平

对不上的笔数或金额，按口径关闭或标待核验。口头说误差可忽略，完成日仍不能填。

第三方文件缺失时，对账项继续待核验。

状态机画在字段表旁边

订单或任务状态如何流转、哪些状态允许回退，和字段表放一起。只对字段不对状态，联调会在“已取消还能否支付”这类问题上反复。状态未约定的，标待核验。

幂等键必须能指出

重试时靠什么避免重复落账，应能指出字段或规则。指不出幂等键，补偿路径不完整，不进入生产联调。演示一次成功不能代替这条。

密钥轮换通知写进权限表

密钥谁生成、谁替换、旧密钥何时失效，写在权限表。未写轮换，权限表只覆盖了开通那天。生产启用前再核一次。

对账差异关闭单

差异关闭要有单号、原因和关闭人。没有关闭单的抹平，对账口径等于没有。关闭后回写两侧标记，避免第二天重复出现。

变更窗口单独约定

对方改字段的通知期和兼容期写成窗口。窗口外变更，按新需求评估，不要求己方立刻跟上。窗口未写，对接完成日不稳定。