接口设计的核心不是把文档写得更厚,而是把“谁在什么条件下可以动哪一层”写成可执行的交接规则。如果供应商只交付策略、结构或配置说明,而不进入账户操作,你需要在“自己团队照文档执行”和“另找实施方接手”之间做选择。两种做法都成立,但前提不同:前者要求你方有能独立判断异常的人,后者要求文档能脱离原供应商的语境被第三方读懂。
供应商只交文档不实施,常见有两种解释。一种是能力边界:对方擅长策略与结构设计,不承接日常投放或页面改动,交付物本身就是最终产品。另一种是责任边界:对方能实施,但不愿承担账户操作、数据权限或改动后的连带责任,于是把执行推回给你。这两种解释对应的接口设计完全不同。
如果是能力边界,接口重点是“把判断依据交清楚”,文档要包含取舍逻辑,而不只是结论。如果是责任边界,接口重点是“把动作和确认权切开”,每一步实施都需要你方书面确认,供应商只对文档内容本身负责。把责任边界误当成能力边界,你会拿到一份看似完整、但没人对落地结果负责的说明;反过来,则会让本可执行的供应商退回纯咨询姿态。
不要靠对方口头表态判断,看三类证据。
这三个信号里,条件分支最可靠,因为它留下了可验证的推理痕迹。权限和复核意愿可能受合规流程影响,单独看容易误判。
方案一:你方内部执行,供应商只做文档与答疑。适用条件是你有至少一名能独立处理账户异常、并能判断文档结论是否适用于当前页面的人。接口上要约定答疑窗口、响应形式和超出文档范围的问题如何处理。代价是执行速度受你方排期限制,且文档中的假设一旦与实际情况不符,偏差由你方承担。
方案二:另找实施方,按文档执行。适用条件是文档能脱离原供应商语境被第三方读懂,即术语有定义、优先级有排序、例外情况有说明。接口上要约定实施方遇到文档未覆盖情形时的停手规则,以及由谁裁决歧义。代价是沟通链路变长,且原供应商通常不对第三方执行结果负责。
两种方案可以并存:核心账户自己执行,边缘项目交给实施方。但同一条改动不应同时由两方操作,否则出问题时无法归因。
无论选哪种方案,接口至少要覆盖四件事:交付物的最小可用单元、变更的确认路径、异常的上报对象、以及验收的判断主体。下面是一段假设的接口约定示例,用于说明写法,不代表任何真实项目:
交付单元:每个页面一份改动说明,含目标、依据、优先级、回退方式。
确认路径:改动涉及账户结构时,由我方负责人确认后执行;仅涉及文案时,执行方自行判断。
异常上报:执行中发现文档结论与页面实际不符,暂停该条并记录,不自行改写依据。
验收主体:由我方负责人判断改动是否按文档落地,供应商只判断文档结论是否被正确理解。
这段约定的关键在于把“判断文档对不对”和“判断执行对不对”分给不同主体。如果两件事都压给同一方,接口就退化成口头协作。
可立即执行的动作是:从供应商已交付的文档中随机抽三条改动建议,让一位不参与该项目的人按文档独立复述“改什么、为什么改、什么情况下不改”。如果三条里有一条无法复述出条件,说明文档缺少判断依据,此时选方案二会让实施方频繁停手询问,成本高于预期;此时更稳妥的做法是先要求供应商补齐条件分支,再决定是否引入实施方。这个动作的结果直接决定你下一步是补文档还是补人手,而不是先签实施合同再回头补依据。