外部协作接口清单是一张按“接口”逐行登记的表，每行写清一个外部协作接口的对接双方、交付物、格式与验收口径、提交与反馈时间、责任人和状态。本文给出一张可直接复制到表格工具的空白清单，并逐字段说明填写口径、区分必填与选填，再用一条完整示例演示从登记到关闭的过程，最后给出长期维护规则。
要点总览（TL;DR）
- 外部协作接口清单按“一个接口一行”登记，核心是让双方对交什么、何时交、按什么标准算通过达成一致。
- 空白模板共16列，其中接口编号、接口名称、所属伙伴/团队、我方负责人、外部对接人、输出物、验收标准、交付节点、当前状态为必填。
- 输入物、输出物、交付格式三列分别回答“我方先给什么”“外部交什么”“怎么交”，验收标准与反馈时限要成对填写。
- 清单建立后按例会节奏更新状态，交付节点或范围调整时在变更记录中追加日期、内容与确认人，已关闭行保留不删除。
- 接口数量增多时可将每行接口作为独立工作项承载，状态与变更随工作项流转维护。
可复制空白外部协作接口清单
下面这张表是本文的主交付物，可直接复制到 Excel、在线表格或项目管理工具中。表头共 16 列，与后文的字段说明、必填对照和填写示例使用同一套字段名。复制后先保留全部列，再按 S3 的必填规则决定哪些列必须填写。
| 接口编号 | 接口名称 | 所属伙伴/团队 | 我方负责人 | 外部对接人 | 接口类型 | 输入物 | 输出物 | 交付格式 | 验收标准 | 交付节点 | 反馈时限 | 变更与升级路径 | 当前状态 | 变更记录 | 备注 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
使用时有两点需要注意。接口编号建议采用“项目代号-序号”的格式，例如 PRJ01-003，保证新增接口时编号不重复、便于检索。当前状态列建议限定为固定几个取值，如“待确认、进行中、待验收、已关闭、已挂起”，避免每个人写出不同说法导致筛选失效。
每个字段填什么：接口清单字段说明
字段说明的作用是让不同填写人对同一列写出同一种信息。下面按“对接双方、交付内容、时间与验收、变更与状态”四组解释，每组内的字段填写口径保持一致。
| 字段名 | 含义 | 填写口径 |
|---|---|---|
| 接口编号 | 该接口在清单中的唯一标识 | 采用“项目代号-三位序号”，新增时顺延，不复用已关闭编号 |
| 接口名称 | 用一句话概括这个接口交付什么 | 写“动作+对象”，如“供应商提交控制器测试报告”，避免只写“测试报告” |
| 所属伙伴/团队 | 外部一方所属的公司、部门或团队 | 写到可追责的最小单位，如“XX 供应商-测试部”，不写笼统的“供应商” |
| 我方负责人 | 我方对该接口结果负责的人 | 写姓名，可附岗位；一人可负责多个接口，但每个接口只写一个主责人 |
| 外部对接人 | 外部一方接收和提交信息的联系人 | 写姓名与联系方式渠道；对接人变更时更新本列并在变更记录中注明 |
| 接口类型 | 接口的性质分类 | 按团队习惯取值，如“交付物提交、信息同步、评审确认、问题反馈”，全表统一用词 |
| 输入物 | 外部一方开始工作前需要我方提供的内容 | 写具体物件，如“接口协议文档 V2、样件清单”，不写“相关资料” |
| 输出物 | 外部一方按接口应交付的内容 | 写可清点的成果，如“测试报告、问题清单、签字确认单” |
| 交付格式 | 输出物以什么形式提交 | 写文件类型与载体，如“PDF 报告+原始数据表”“在线文档链接”；格式要求影响验收，需与输出物对应 |
| 验收标准 | 判定输出物通过的条件 | 写可核验的条件，如“覆盖全部 12 项测试用例、无未关闭的高等级问题、双方签字”；避免写“质量合格” |
| 交付节点 | 输出物应提交的日期或阶段点 | 写具体日期或明确的阶段名称，如“2025-06-30”或“样件到货后 5 个工作日内” |
| 反馈时限 | 一方提交后另一方给出意见的期限 | 写时长，如“收到后 2 个工作日内”；提交方与反馈方各指谁都应在备注中写明 |
| 变更与升级路径 | 接口内容或时间需要调整时找谁、按什么顺序处理 | 写“先找双方负责人协商，超期未决升级至项目接口人”，并写明升级联系人 |
| 当前状态 | 接口所处的处理阶段 | 从固定取值中选择，如“待确认、进行中、待验收、已关闭、已挂起” |
| 变更记录 | 接口关键调整的留痕 | 写“日期+变更内容+确认人”，如“06-12 交付节点由 06-30 调整为 07-05，双方负责人确认” |
| 备注 | 其他需要说明的信息 | 写依赖条件、特殊约定等；不把验收标准、时间节点等已有字段的内容重复写在这里 |
输入物、输出物与交付格式三列容易混淆，区分方法是：输入物回答“外部一方需要我方先给什么”，输出物回答“外部一方最终交什么”，交付格式回答“交的东西长什么样、通过什么渠道给”。三列都写具体，验收时才有对照依据。验收标准与反馈时限要成对考虑：验收标准定义“通过”，反馈时限定义“多久内给出通过或不通过的结论”，缺一项都会让接口停在“已提交但无人处理”的状态。
变更与升级路径字段常被省略，但它是清单能否长期使用的关键。外部协作中交付时间推迟、交付物范围调整很常见，如果清单里没有写明找谁协商、协商不成找谁，接口一旦卡住就只能靠个人关系推动。填写时至少写清两级：双方直接负责人协商，以及协商超期后的升级对象。
哪些必填、哪些选填
清单刚建立时不必追求填满所有列，先保证最低可用字段齐全，让双方对“交什么、什么时候交、按什么标准算通过”达成一致，其余字段随协作深入补充。下表给出必填与选填的划分及理由。
| 字段名 | 必填/选填 | 理由或适用场景 |
|---|---|---|
| 接口编号 | 必填 | 唯一标识，用于引用、筛选和变更记录定位 |
| 接口名称 | 必填 | 让人不看其他列也能知道这个接口是什么 |
| 所属伙伴/团队 | 必填 | 明确外部责任主体，便于按伙伴汇总 |
| 我方负责人 | 必填 | 接口出问题时需要有明确的我方责任人 |
| 外部对接人 | 必填 | 提交与反馈都需要具体联系人 |
| 输出物 | 必填 | 接口的核心是交付结果，缺失则清单失去意义 |
| 验收标准 | 必填 | 没有验收标准就无法判断接口是否完成 |
| 交付节点 | 必填 | 时间约定是外部协作最基本的约束 |
| 当前状态 | 必填 | 支撑进度跟踪与例会同步 |
| 接口类型 | 选填 | 接口数量多、需要分类统计时填写 |
| 输入物 | 选填 | 外部一方无需我方前置输入时可不填；有依赖时必须填写 |
| 交付格式 | 选填 | 格式要求影响验收时填写；口头同步类接口可省略 |
| 反馈时限 | 选填 | 需要双向确认或评审的接口建议填写 |
| 变更与升级路径 | 选填 | 周期长、跨多方的接口建议填写；一次性简单接口可省略 |
| 变更记录 | 选填 | 发生调整时填写，无变更可留空 |
| 备注 | 选填 | 按需补充依赖条件与特殊约定 |
字段缺失时按两种情况处理。必填字段暂时无法确定的，先填入已知内容并在备注中写明“待确认”及确认时间，不要让整行空着，否则接口在清单中等于不存在。选填字段在登记阶段可以留空，但一旦该接口出现相关情形，例如外部一方提出格式要求或交付时间需要调整，就应在当次更新中补填，而不是等到出问题再回头补。
填写示例：一个外部接口从登记到关闭
下面用一条演示情景说明各字段如何填写。情景设定为：某项目需要外部供应商提交控制器测试报告，示例中的名称、日期均为演示数据，不代表真实项目。
| 字段名 | 示例填写 | 填写说明 |
|---|---|---|
| 接口编号 | PRJ01-003 | 项目代号加序号，本项目第 3 个外部接口 |
| 接口名称 | 供应商提交控制器测试报告 | 动作加对象，一眼看出交付内容 |
| 所属伙伴/团队 | XX 供应商-测试部 | 写到可追责的最小单位 |
| 我方负责人 | 张明（测试接口人） | 我方对该接口结果负责的人 |
| 外部对接人 | 李工（供应商测试负责人） | 接收输入物并提交输出物的联系人 |
| 接口类型 | 交付物提交 | 按全表统一取值填写 |
| 输入物 | 测试用例清单 V2、样件交接单 | 外部一方开始测试前需要我方提供的内容 |
| 输出物 | 控制器测试报告、问题清单 | 可清点的交付成果 |
| 交付格式 | PDF 报告+原始数据表 | 文件类型与载体，与验收方式对应 |
| 验收标准 | 覆盖全部 12 项测试用例、无未关闭的高等级问题、双方签字确认 | 可逐项核验的通过条件 |
| 交付节点 | 2025-06-30 | 具体日期，便于跟踪 |
| 反馈时限 | 收到后 2 个工作日内 | 我方给出验收结论的期限 |
| 变更与升级路径 | 先由张明与李工协商；超 3 个工作日未决，升级至双方项目经理 | 写明两级处理顺序与升级对象 |
| 当前状态 | 进行中 | 登记时从固定取值中选择 |
| 变更记录 | 06-12 交付节点由 06-25 调整为 06-30，双方负责人确认 | 日期+变更内容+确认人 |
| 备注 | 测试环境由我方提供，6 月 10 日前就绪 | 补充依赖条件，不重复已有字段 |
这条接口的状态推进过程如下：登记时状态为“待确认”，双方核对输入物与验收标准后改为“进行中”；供应商按节点提交报告后，我方在反馈时限内完成验收，状态改为“待验收”再改为“已关闭”。期间交付节点发生一次调整，变更记录列留下日期、调整内容和确认人，后续追溯时无需翻聊天记录。如果验收未通过，状态回到“进行中”，并在备注中写明未通过的具体条目，与验收标准逐项对应。
清单的调整与维护方法
清单建立后需要按固定节奏维护，否则接口状态会停留在登记时的样子，清单逐渐失去参考价值。以下规则可作为团队维护清单的起点，具体频率按项目周期调整。
- 新增接口：协作中出现新的外部交付或信息同步需求时，当天登记一行，编号顺延，至少填齐必填字段；尚未确定的内容在备注中标注待确认项与确认时间。
- 关闭接口：输出物通过验收后，将状态改为“已关闭”，在变更记录中写明关闭日期与验收结论；已关闭的行保留在清单中，不删除，便于回溯。
- 状态维护节奏：建议在每次双方例会前更新一次状态，重点检查临近交付节点的接口；状态变化当天更新，避免集中补记。
- 变更记录：交付节点、输出物范围、验收标准发生调整时，均在变更记录列追加一条，写明日期、变更内容和确认人，不覆盖原有记录。
- 字段增删原则：新增字段前先确认现有字段无法承载该信息，新增后同步更新字段说明与必填对照，保证全表口径一致；删除字段时先确认没有在用数据依赖该列。
- 与项目计划、合同条款的边界：清单登记的是外部协作层面的接口与交接，项目排期以项目计划为准，商务与法律约定以合同条款为准；清单中引用这些内容时写清出处，不在清单内自行变更。
当接口数量增多、参与方分散时，把每行接口作为独立工作项承载，状态和变更记录随工作项流转维护，可以减少手工同步表格的负担。ONES 研发管理在方案层面支持打通需求、任务、测试及供应商等多角色协作过程，并围绕需求、基线和变更建立统一管理对象，支撑过程状态追踪与交付结果回溯；其方案模块中包含项目管理、知识库、测试管理、流程自动化等组合。团队可以把接口清单的字段映射为工作项属性，让状态推进与变更留痕在同一处完成。具体模块组合与配置方式以实际方案为准。
常见问题
外部协作接口清单和项目计划、合同分别管什么？
三者管理对象不同：接口清单登记外部协作层面的交付与交接，回答“谁在什么时间交什么、按什么标准验收”；项目计划管排期与依赖关系；合同条款管商务与法律约定。清单中引用项目计划或合同内容时写清出处，不在清单内自行变更这些约定。关联项目计划的排期管理归项目集管理，采购招标与合同法律条款审查不在清单范围内。
外部对接人中途换人，清单怎么处理？
更新“外部对接人”列，写清新任对接人姓名与联系方式渠道，同时在变更记录列追加一条，写明日期、更换原因和双方确认人。如果换人影响到交付节点或验收安排，一并更新对应字段并留痕。已关闭的历史接口保留原对接人信息，便于日后追溯。
必填字段暂时确定不了，能先空着吗？
不建议整行空着。必填字段暂时无法确定的，先填入已知内容，在备注中写明“待确认”的具体项和确认时间，让接口在清单中可见、可跟踪。选填字段登记阶段可以留空，但一旦出现相关情形，例如外部一方提出格式要求或交付时间需要调整，应在当次更新中补填。
接口验收没通过，状态和记录怎么改？
状态从“待验收”回到“进行中”，在备注中写明未通过的具体条目，与验收标准逐项对应，便于外部一方按条目整改。重新提交后再次进入“待验收”，通过后改为“已关闭”，并在变更记录中写明关闭日期与验收结论。
接口数量多、参与方分散时，还适合用一张表维护吗？
表结构可以保留，但手工同步状态和变更记录的成本会上升。此时可把每行接口作为独立工作项承载，状态推进与变更留痕随工作项流转完成，清单字段映射为工作项属性。ONES 研发管理在方案层面支持打通需求、任务、测试及供应商等多角色协作过程，并围绕需求、基线和变更建立统一管理对象，支撑过程状态追踪与交付结果回溯；具体模块组合与配置方式以实际方案为准。
