结论先给:如果供应商只交付文档而不承担实施,双方接口应当按“可执行交付物”设计,而不是按“文档页数”设计。具体做法是把接口拆成三层——输入接口、验收接口和退出接口,每一层都规定谁提供什么、以什么格式提供、由谁确认、确认后触发什么动作。这样做的代价是前期沟通成本上升,但能避免文档到手后无人能落地。反例是:如果贵司内部已有能独立完成配置和上线的人,且供应商文档只是补充说明,那么强推三层接口反而拖慢进度,此时只需保留输入接口和一份变更记录即可。
供应商只交文档时,最常见的失败不是文档写得差,而是双方对“交付完成”的定义不同。供应商认为发来一份策略说明就算交付,需求方认为要能照着做才算交付。判断方法很直接:拿文档里任意一个关键动作,交给一个没参与过该项目但熟悉业务的内部人员,看他能否在不追问供应商的前提下独立完成。
这一步的实际动作是:选文档中影响最大的一个环节做“盲测执行”。如果盲测失败,下一步不是要求供应商重写全部文档,而是只针对失败环节追加接口约定,把责任边界钉在具体动作上。
输入接口解决“给过来的东西能不能被接住”。只交文档时,容易漏掉的是配套素材和判断依据。建议在接口清单里至少写清四类内容:
这里要说明适用条件:输入接口的严格程度应与文档的后续使用周期匹配。如果这份文档只用于一次活动、用完即弃,就不必要求完整源文件和变更记录;如果文档要支撑长期运营,源文件和判断规则就不能省。
供应商只交文档不实施时,验收标准最容易写成“文档已提交”。这个标准无法区分可用与不可用。更稳的做法是把验收拆成两个独立节点:
假设一个场景:供应商交付了一份内容发布流程文档,形式验收通过。内部执行人按文档尝试完成一次发布,发现文档没有说明审核人不在时由谁代审。这个卡点就是执行验收的产出,它直接决定下一步是要求供应商补充规则,还是内部自行指定代审人。两种处理都成立,区别在于:如果代审规则属于原约定的服务范围,应要求供应商补充;如果不属于,内部补充并记入变更记录即可。
执行验收的关键是只做一个最小闭环,不追求覆盖全部场景。最小闭环跑通,说明文档主干可用;跑不通,说明接口还没设计完。
当旧内容、旧系统或旧合作关系需要退出时,接口设计还要多一层:哪些部分保留,哪些部分切断。只交文档的场景下,退出接口要回答三个问题:
这里有一个容易被忽略的判断:请求量、抓取量或某项统计归零,不能单独证明退出处理正确。它也可能是季节波动、渠道调整或统计口径变化导致的。要确认退出是否干净,应核对账号权限是否已转移、文档依赖是否已解除,而不是只看数据变化。
把上述三层落成一张双方确认的清单,比反复开会更有效。清单可以按以下字段组织,每行一个交付项:
填写时注意一个动作只对应一个确认人,避免“大家看一下”这种无法追责的表述。确认后触发的动作要具体,例如“确认后进入执行验收”“确认后释放尾款”“确认后移交账号权限”,而不是“确认后继续推进”。
下一步动作建议:先拿现有供应商文档做一次盲测执行,记录卡点;再根据卡点判断需要补的是输入接口、验收接口还是退出接口;最后把补充约定写成清单,由双方确认人签字或邮件确认。如果盲测顺利通过且内部具备执行能力,就不必补全三层接口,保留输入接口和变更记录即可,避免为流程而流程。