实务专题 · 交付验收

导出已受理,不等于文件已经生成

企业门户可以先受理报表请求,再由后台生成文件。签收成功页前,应约定等待状态、失败提示及允许下载的证据,避免只有排队记录却告诉客户报表已完成。

官方依据与范围

HTTP 202表示已受理处理,不代表完成,也不保证最终成功。 官方参考 · 2026年10月17日核对.

已填写的合成验收例子

合成教学例子,不是真实客户案例或真实平台测评。窄屏可横向滚动查看完整表格。

输入核对口径预期
202;任务J17排队仅受理显示等待,不提供下载
J17成功,有输出校验记录完成依据提供获授权下载
J17失败,保留原因终态失败说明重试,不能写已就绪

可执行的交付检查

  1. 设计门户提示前,约定任务标识与批准的状态词。
  2. 用一份合成报表请求测试排队、运行、成功与失败。
  3. 完成、通知和链接授权分别记录,就绪文件仍须属于请求用户。

怎样解释输出

教学检查器只分类状态记录,不执行队列。HTTP成功、邮件发出和可下载文件完成是三个节点,应要求供应商演示失败任务和迟到状态响应,不能只看成功路径。

明确的适用边界

不实现后台服务、邮件或权限,也不保证送达;实际门户仍需脱敏完成记录。

复核有限教学模型

保存两份文件到同一目录,用Node22或更新版本运行下面命令。JSON包含输入与预期;脚本仅处理合成数据,无网络、密钥、付款或付费API调用。通过不等于真实系统已经通过验收。

已填写输入与预期 · 可读教学脚本

node check.mjs async-export-job-completion-contract.json