用途:当用户需要失败订单记录、数量、受影响商品,或解释一批订单为何失败时使用。更宽泛的“结账不可用”症状应从 b2c-checkout-triage 入手;部分结账失败根本不会生成订单。
范围与影响:用 config_inspect(CLI:b2c setup inspect)确定实例/站点,固定 UTC 起止边界与对比周期。缺少站点或时间窗时应询问,不要使用演示默认值。计数描述的是已索引订单,而非全部结账尝试或转化率。
访问与工具:枚举 FAILED 订单先用 scapi_search 检查 Admin Orders 查询支持,外部 OCAPI Shop POST /order_search 作为回退;SCAPI status=failed 曾返回 HTTP 400,响应枚举不能证明查询受支持。外部请求认证用 CLI b2c auth token --json 或 MCP 的 AM token 导出助手,仅用于外部客户端。失败原因与关联:logs_list_files 到发现的集成前缀,再有界调用 logs_get_recent,注意 error/customerror 默认可能漏掉支付集成。可疑商品或自定义属性用代码模式 Admin 读取,未知字段时展开实时 schema,对比已知失败/健康 ID 的字段。怀疑数据写入方时用 b2c-job-health 检查执行日志与实际数据效果。
检查与决策:对同一站点/时间窗查询 FAILED 与全部已索引订单总数,校验每个响应,报告失败/全部已索引订单;任一查询失败则比率未知,分母为零表示未定义而非零失败。最多选 10 条近期失败订单,含订单号、创建时间、状态、商品 ID,省略客户/支付字段,商品频次标注为样本并按订单去重。将安全订单/请求 ID 与时间戳同集成日志关联,判断失败是否按输入、提供商响应、区域或变更窗口聚集,不要仅凭 FAILED 状态推断支付拒付。归因属性前先对比一个健康输入。
缓解与恢复:调查不授权更改订单状态、重处理订单、重试扣款、退款、重跑集成或更改访问/索引。授权干预前需确认重复扣款/消息风险与部分影响,并在等价区间验证新结果。
升级与交接:提供站点/时间窗、总数/分母、样本量与安全 ID、重复错误、受影响输入、疑似写入方/组件、限制与下一负责人,按案例模板转交管理员、开发者、集成提供商或 Salesforce Support。缺少 Shop 访问权限是定向管理员请求,不是无失败的证据;提交案例等外部沟通需授权。