截至 API 版本 2026-04,第三方物流提供商(3PL)和履约应用现在可以通过 fulfillmentOrderReportProgress 变更 报告履约订单的进度。此功能使履约服务能够表明工作已开始,并可选地添加简短的状态备注,以便商家查看其履约流程中的动态。
关键详情:
- 为 3PL 管理的订单报告进度适用于处于 IN_PROGRESS 状态的履约订单。
- 为商家管理的订单报告进度适用于处于 OPEN 或 IN_PROGRESS 状态的履约订单(需要 write_merchant_managed_fulfillment_orders 权限范围)。
- 支持可选的 reasonNotes 字段(最多 256 个字符),以提供额外的上下文信息。
- 新增 fulfillment_orders/progress_reported Webhook,用于跟踪进度报告的时机。
- fulfillmentOrder.supportedActions 字段在履约订单可以报告进度时,将返回 REPORT_PROGRESS 操作。
新 Webhooks
主题: fulfillment_orders/progress_reported
当在履约订单上报告进度时,会触发此 Webhook。有效载荷包括履约订单 ID 和状态、更新前的 initial_status,以及包含 reason_notes 和报告进度的应用或用户归属数据的 progress_report 详情。
主题: fulfillment_orders/manually_reported_progress_stopped
当已通过手动方式(通过 fulfillmentOrderReportProgress)报告过进度的商家管理型履约订单随后被标记为“准备发货”,从而从 IN_PROGRESS 状态转换回 OPEN 状态时,此 Webhook 将被触发。该 Webhook 允许应用知晓商家已“撤销”或“取消”他们之前报告的进行中状态。

