2026-06-11 18:24:22 +08:00

1993 lines
68 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

{
"generatedAt": "2026-06-11 13:47:01",
"generatedAtLocal": "2026-06-11 13:47:01",
"source": "remote",
"filter": {
"platform": {
"value": "web",
"label": "网页端"
},
"project": {
"value": "all",
"label": "全部"
}
},
"module": {
"name": "订单待处理模块",
"key": "order.pendingOrder",
"folder": "order.pendingorder",
"interfaceCount": 25
},
"changes": {
"fromPreviousSnapshot": {
"moduleAdded": false,
"moduleRenamed": false,
"interfaceChanges": {
"addedMethods": [],
"deletedMethods": [
"order.pendingOrder.manualWaybill"
],
"paramsUpdatedMethods": [],
"responseUpdatedMethods": []
}
}
},
"interfaces": [
{
"method": "order.pendingOrder.list",
"title": "待处理订单列表,默认筛选 outbound_status != padding 且 step in [1,2]。",
"description": "待处理订单列表,默认筛选 outbound_status != padding 且 step in [1,2]。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "pagination",
"type": "object",
"required": false,
"description": "分页参数,支持 page / pageSize"
},
{
"name": "where",
"type": "object",
"required": false,
"description": "统一 where 条件对象;禁止传入 warehouse_id / warehouseId。"
},
{
"name": "sort",
"type": "object",
"required": false,
"description": "排序参数,支持 sortField / sortOrder"
}
],
"response": [
{
"name": "list",
"type": "array",
"required": true,
"description": "订单列表(raw 行数据,字段字典见 docs/order-workbench-list-api.md 中的“订单列表 raw 字段字典”章节)"
},
{
"name": "pagination",
"type": "object",
"required": true,
"description": "分页信息"
},
{
"name": "recheck_status",
"type": "string",
"required": false,
"description": "复核状态:none=未复核,fin=已复核"
}
]
},
{
"method": "order.pendingOrder.detail",
"title": "查询单个订单详情,返回订单头、商品明细和运单信息",
"description": "查询单个订单详情,返回订单头、商品明细和运单信息",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "ids / id / order_id / orderId",
"type": "array|string|number",
"required": true,
"description": "订单ID;支持 ids 数组、逗号分隔字符串或单个 id/order_id,至少提供一项"
},
{
"name": "tableType / tablePosition / type / moduleName",
"type": "string",
"required": false,
"description": "可选,指定订单表类型,支持 current/history/dispatch/outsourced/order/revieworder/pendingorder 等"
}
],
"response": [
{
"name": "order",
"type": "object",
"required": false,
"description": "订单头对象(raw 行数据)"
},
{
"name": "detail",
"type": "object",
"required": false,
"description": "等同于 order"
},
{
"name": "orderItems / items",
"type": "array",
"required": false,
"description": "商品明细数组"
},
{
"name": "expresses",
"type": "array",
"required": false,
"description": "运单信息数组"
},
{
"name": "waybill_codes",
"type": "array",
"required": false,
"description": "去重后的运单号字符串数组"
}
]
},
{
"method": "order.pendingOrder.reverseReviewOrder",
"title": "将待处理订单反审回待审核状态。",
"description": "将待处理订单反审回待审核状态。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "ids",
"type": "array",
"required": false,
"description": "订单 ID 列表;兼容 ids / id / order_id,建议传 ids"
},
{
"name": "id",
"type": "number",
"required": false,
"description": "兼容单个订单 ID"
},
{
"name": "order_id",
"type": "number",
"required": false,
"description": "兼容单个订单 ID"
}
],
"response": [
{
"name": "id",
"type": "number",
"required": true,
"description": "首条更新记录 ID"
},
{
"name": "inspection_status",
"type": "string",
"required": true,
"description": "新的审核状态"
},
{
"name": "step",
"type": "number",
"required": true,
"description": "新的流程步骤"
},
{
"name": "updated_at",
"type": "string",
"required": true,
"description": "更新时间"
},
{
"name": "updated_count",
"type": "number",
"required": true,
"description": "受影响行数"
},
{
"name": "ids",
"type": "array",
"required": true,
"description": "实际更新的订单 ID 列表"
}
]
},
{
"method": "order.pendingOrder.markPendingOutboundOrder",
"title": "将待处理订单批量标记为待出库。",
"description": "将待处理订单批量标记为待出库。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "ids",
"type": "array",
"required": true,
"description": "订单 ID 正整数数组;不支持 id、order_id 或逗号字符串"
}
],
"response": [
{
"name": "id",
"type": "number",
"required": true,
"description": "首条更新记录 ID"
},
{
"name": "outbound_status",
"type": "string",
"required": true,
"description": "新的出库状态"
},
{
"name": "updated_at",
"type": "string",
"required": true,
"description": "更新时间"
},
{
"name": "updated_count",
"type": "number",
"required": true,
"description": "受影响行数"
},
{
"name": "ids",
"type": "array",
"required": true,
"description": "实际更新的订单 ID 列表"
}
]
},
{
"method": "order.pendingOrder.cancelOrder",
"title": "将待处理订单批量取消,仅允许当前状态可取消的订单。",
"description": "将待处理订单批量取消,仅允许当前状态可取消的订单。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "ids",
"type": "array",
"required": true,
"description": "订单 ID 正整数数组;不支持 id、order_id 或逗号字符串"
}
],
"response": [
{
"name": "id",
"type": "number",
"required": true,
"description": "首条更新记录 ID"
},
{
"name": "status",
"type": "string",
"required": true,
"description": "新的订单状态"
},
{
"name": "step",
"type": "number",
"required": true,
"description": "新的流程步骤"
},
{
"name": "updated_at",
"type": "string",
"required": true,
"description": "更新时间"
},
{
"name": "updated_count",
"type": "number",
"required": true,
"description": "受影响行数"
},
{
"name": "ids",
"type": "array",
"required": true,
"description": "实际更新的订单 ID 列表"
}
]
},
{
"method": "order.pendingOrder.allocateExpressCode",
"title": "批量分配待处理订单的快递号,接收订单对象数组,复用 express.createWaybillCodePipeline。",
"description": "批量分配待处理订单的快递号,接收订单对象数组,复用 express.createWaybillCodePipeline。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "orders",
"type": "array",
"required": true,
"description": "订单对象数组;每个对象应为待处理订单列表或详情中获取的原始订单对象。每个订单对象必须包含 order_id 与 business_key;sys_platform_code 与 logistics_code 为订单对象自带字段,前端无需额外拼装或从外部构造,直接原样回传订单对象即可。其余字段会原样透传给运单创建链路。business_key 说明:business_key 是运单创建的序号键数组(例如:新分配 1 个运单号时传 [1];订单拆单时可能传 [2,3]),该字段会在 createWaybillCodePipeline 的返回 data 中原样返回,便于前端关联订单与运单创建结果。"
}
],
"response": [
{
"name": "flag",
"type": "string",
"required": true,
"description": "全局调用结果标识,成功时为 success"
},
{
"name": "code",
"type": "number",
"required": true,
"description": "业务状态码,200 表示成功"
},
{
"name": "message",
"type": "string",
"required": false,
"description": "返回信息"
},
{
"name": "data",
"type": "object",
"required": false,
"description": "createWaybillCodePipeline 返回的运单创建结果,包含 success/failed 列表与 summary 等字段"
}
]
},
{
"method": "order.pendingOrder.allocateStorage",
"title": "按订单批量分配储位(迁移自 order.storageAllocation.allocateStorage)。这是一个异步提交接口:调用后接口立即返回受理信息(包含 request_id),后端异步执行实际的储位分配与锁定操作;仓库上下文由当前登录用户提供(ctx.user.store_id)。接口不会在同步响应中返回分配明细(如 requested_order_ids、allocated_order_ids 等),客户端可通过请求 ID 或事件/查询链路获取最终结果。",
"description": "按订单批量分配储位(迁移自 order.storageAllocation.allocateStorage)。这是一个异步提交接口:调用后接口立即返回受理信息(包含 request_id),后端异步执行实际的储位分配与锁定操作;仓库上下文由当前登录用户提供(ctx.user.store_id)。接口不会在同步响应中返回分配明细(如 requested_order_ids、allocated_order_ids 等),客户端可通过请求 ID 或事件/查询链路获取最终结果。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "allow_storage_location / allowStorageLocation / is_allow_storage / isAllowStorage",
"type": "boolean",
"required": false,
"description": "是否允许使用存储储位,支持多种字段别名。"
},
{
"name": "order_ids / orderIds / ids / order_id / orderId / id",
"type": "array|string|number",
"required": true,
"description": "订单 ID 列表,支持数组、逗号分隔字符串或单个 ID(兼容多种别名)。"
}
],
"response": [
{
"name": "request_id",
"type": "string",
"required": true,
"description": "请求 ID(后端生成的唯一标识),用于查询任务状态或结果"
},
{
"name": "warehouse_id",
"type": "number",
"required": true,
"description": "生效的仓库 ID(来自当前用户 store_id)"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "受理提示信息,通常为 '请求已受理,后端异步处理中' 或错误说明"
}
]
},
{
"method": "order.pendingOrder.allocateStorageProgress",
"title": "按 request_id 查询储位分配异步任务状态/结果(由 allocateStorage 提交)",
"description": "按 request_id 查询储位分配异步任务状态/结果(由 allocateStorage 提交)",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "request_id / requestId",
"type": "string",
"required": true,
"description": "任务请求 ID,兼容字段 requestId"
}
],
"response": [
{
"name": "request_id",
"type": "string",
"required": true,
"description": "请求 ID(后端生成的唯一标识)"
},
{
"name": "status",
"type": "string",
"required": true,
"description": "任务状态枚举:submitted(已受理)/ running(进行中)/ success(成功)/ failed(失败)/ not_found(未找到)"
},
{
"name": "result",
"type": "object",
"required": false,
"description": "成功时返回底层分配结果,结构视实现而定"
},
{
"name": "error",
"type": "string",
"required": false,
"description": "失败时返回的错误信息"
},
{
"name": "warehouse_id",
"type": "number",
"required": false,
"description": "关联仓库 ID(若任务关联仓库时返回)"
},
{
"name": "update_time",
"type": "string",
"required": false,
"description": "最近一次状态更新时间,ISO8601 字符串"
},
{
"name": "message",
"type": "string",
"required": false,
"description": "额外提示信息"
}
]
},
{
"method": "order.pendingOrder.syncOrderIds",
"title": "同步待处理订单入口,支持批量传入 order_ids。服务端会按 create_channel 分组派发同步任务;若命中 SN 管理订单(is_sn_mgmt=Y),该订单会被拦截并标记失败,不允许走批量回传,需改用单订单回传。",
"description": "同步待处理订单入口,支持批量传入 order_ids。服务端会按 create_channel 分组派发同步任务;若命中 SN 管理订单(is_sn_mgmt=Y),该订单会被拦截并标记失败,不允许走批量回传,需改用单订单回传。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "order_ids / orderIds / ids / order_id / orderId / id",
"type": "array|string|number",
"required": true,
"description": "订单 ID 列表,支持数组、逗号分隔字符串或单个 ID。服务端会校验订单状态并执行批量同步拦截规则(含 SN 订单限制)。"
}
],
"response": [
{
"name": "flag",
"type": "string",
"required": true,
"description": "全局调用结果标识,成功为 success"
},
{
"name": "code",
"type": "number",
"required": true,
"description": "业务状态码,200 表示成功"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "返回信息,当前仅做受理提示"
},
{
"name": "data",
"type": "object",
"required": false,
"description": "服务层返回值,当前仅透传 order_ids"
}
]
},
{
"method": "order.pendingOrder.cancelAllocateStorage",
"title": "待处理模块的取消分配储位入口,直接对接 system service 的 cancelAllocateStorage。仅接受订单ID(order_ids)作为入参,不接受 allow_storage_location 或 warehouse_id/warehouseId;仓库上下文来自当前登录用户的 store_id。",
"description": "待处理模块的取消分配储位入口,直接对接 system service 的 cancelAllocateStorage。仅接受订单ID(order_ids)作为入参,不接受 allow_storage_location 或 warehouse_id/warehouseId;仓库上下文来自当前登录用户的 store_id。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "order_ids / orderIds / ids / order_id / orderId / id",
"type": "array|string|number",
"required": true,
"description": "订单 ID 列表;支持数组、逗号字符串或单个 ID(兼容多种别名)。"
}
],
"response": [
{
"name": "flag",
"type": "string",
"required": true,
"description": "全局调用结果标识,成功为 success"
},
{
"name": "code",
"type": "number",
"required": true,
"description": "业务状态码,200 表示成功"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "返回信息,成功或部分成功时给出摘要"
},
{
"name": "data",
"type": "object",
"required": false,
"description": "取消分配汇总结果,包含下列字段"
}
]
},
{
"method": "order.pendingOrder.updateOrderPlatform",
"title": "批量修改待处理订单的平台信息。用 code 查找 wms_platform 表,若平台存在则将订单的 sys_platform_code 和 sys_platform_name 更新为该平台的 code/name;若平台不存在则返回错误。只操作当前仓库的当前订单表,不处理其他订单表。",
"description": "批量修改待处理订单的平台信息。用 code 查找 wms_platform 表,若平台存在则将订单的 sys_platform_code 和 sys_platform_name 更新为该平台的 code/name;若平台不存在则返回错误。只操作当前仓库的当前订单表,不处理其他订单表。",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "order_ids",
"type": "number[]",
"required": true,
"description": "订单ID 正整数数组,不能为空"
},
{
"name": "code",
"type": "string",
"required": true,
"description": "平台编码,对应 wms_platform.code"
}
],
"response": [
{
"name": "updated_count",
"type": "number",
"required": true,
"description": "实际更新行数"
},
{
"name": "sys_platform_code",
"type": "string",
"required": true,
"description": "更新后的平台编码"
},
{
"name": "sys_platform_name",
"type": "string",
"required": true,
"description": "更新后的平台名称"
}
]
},
{
"method": "order.pendingOrder.updateOrderExpress",
"title": "批量修改待处理订单的快递信息。用 express_code 从当前仓库快递列表(带缓存)中查找对应项:若为自定义映射(is_system_setting=true),sys_logistics_code/name 写系统快递编码和名称,logistics_code/name 写自定义编码和名称;若为系统快递(is_system_setting=false),四个字段均写系统快递的 code/name;未找到则报错。只操作当前仓库的当前订单表,不处理其他订单表。",
"description": "批量修改待处理订单的快递信息。用 express_code 从当前仓库快递列表(带缓存)中查找对应项:若为自定义映射(is_system_setting=true),sys_logistics_code/name 写系统快递编码和名称,logistics_code/name 写自定义编码和名称;若为系统快递(is_system_setting=false),四个字段均写系统快递的 code/name;未找到则报错。只操作当前仓库的当前订单表,不处理其他订单表。",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "order_ids",
"type": "number[]",
"required": true,
"description": "订单ID 正整数数组,不能为空"
},
{
"name": "express_code",
"type": "string",
"required": true,
"description": "快递编码,可为系统编码或仓库自定义编码"
}
],
"response": [
{
"name": "updated_count",
"type": "number",
"required": true,
"description": "实际更新行数"
},
{
"name": "sys_logistics_code",
"type": "string",
"required": true,
"description": "写入的系统快递编码"
},
{
"name": "sys_logistics_name",
"type": "string",
"required": true,
"description": "写入的系统快递名称"
},
{
"name": "logistics_code",
"type": "string",
"required": true,
"description": "写入的快递编码(自定义或系统)"
},
{
"name": "logistics_name",
"type": "string",
"required": true,
"description": "写入的快递名称(自定义或系统)"
}
]
},
{
"method": "order.pendingOrder.cloneOrder",
"title": "克隆待处理订单。完整流程:1. 查找原订单,校验可取消状态(step 0/1/2/3);2. 若原订单已分配储位(storage_status='fin'),先清除已分配库存;3. 取消原订单(step→9, status→cancel),记录克隆日志;4. 以原订单业务数据创建新订单,所有流程状态字段重置为初始落库状态;5. 克隆订单明细(含 stock_id),重置 order_id 为新订单 ID;6. 对新订单记录克隆创建日志。",
"description": "克隆待处理订单。完整流程:1. 查找原订单,校验可取消状态(step 0/1/2/3);2. 若原订单已分配储位(storage_status='fin'),先清除已分配库存;3. 取消原订单(step→9, status→cancel),记录克隆日志;4. 以原订单业务数据创建新订单,所有流程状态字段重置为初始落库状态;5. 克隆订单明细(含 stock_id),重置 order_id 为新订单 ID;6. 对新订单记录克隆创建日志。",
"endpoint": "/system",
"authRequired": true,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "order_id",
"type": "number",
"required": true,
"description": "原订单ID,正整数"
}
],
"response": [
{
"name": "source_order_id",
"type": "number",
"required": true,
"description": "原订单ID(已取消)"
},
{
"name": "new_order_id",
"type": "number",
"required": true,
"description": "新订单ID(克隆生成)"
}
]
},
{
"method": "order.pendingOrder.createOrder",
"title": "手动创建待处理订单。根据货主策略(need_order_approval)决定初始步骤:need_order_approval=1 进待审核(step=0),need_order_approval=0 直接进待处理(step=1)。",
"description": "手动创建待处理订单。根据货主策略(need_order_approval)决定初始步骤:need_order_approval=1 进待审核(step=0),need_order_approval=0 直接进待处理(step=1)。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "store_id",
"type": "number",
"required": true,
"description": "货主ID(正整数)"
},
{
"name": "name",
"type": "string",
"required": true,
"description": "收件人姓名"
},
{
"name": "mobile",
"type": "string",
"required": false,
"description": "收件人手机号,mobile 与 tel 至少填一项"
},
{
"name": "tel",
"type": "string",
"required": false,
"description": "收件人电话,mobile 与 tel 至少填一项"
},
{
"name": "detail_address",
"type": "string",
"required": true,
"description": "详细地址"
},
{
"name": "province",
"type": "string",
"required": true,
"description": "省份(必填,空值返回 400)"
},
{
"name": "city",
"type": "string",
"required": true,
"description": "城市(必填,空值返回 400)"
},
{
"name": "area",
"type": "string",
"required": true,
"description": "区/县(必填,空值返回 400)"
},
{
"name": "town",
"type": "string",
"required": false,
"description": "镇/街道"
},
{
"name": "zip_code",
"type": "string",
"required": false,
"description": "邮编"
},
{
"name": "items",
"type": "array",
"required": true,
"description": "订单明细数组,每项含 item_id(商品主键,必填,正整数)和 plan_qty(计划数量,正整数);item_name(优先外部传入,其次从 StockStore 缓存获取,最后兜底'商品')、order_line_no、actual_price 为可选"
},
{
"name": "delivery_order_code",
"type": "string",
"required": false,
"description": "订单号,不填则自动生成(SYS + 时间戳 + 随机4位)"
},
{
"name": "logistics_code",
"type": "string",
"required": false,
"description": "快递编码,不填则读货主默认快递策略(policy_config.default_express_code)"
},
{
"name": "logistics_name",
"type": "string",
"required": false,
"description": "快递名称"
},
{
"name": "sys_platform_code",
"type": "string",
"required": false,
"description": "系统平台编码,不填则读货主默认平台策略(policy_config.default_platform_code)"
},
{
"name": "source_platform_code",
"type": "string",
"required": false,
"description": "来源平台编码"
},
{
"name": "source_order_codes",
"type": "string",
"required": false,
"description": "来源订单号"
},
{
"name": "shop_nick",
"type": "string",
"required": false,
"description": "店铺名称(自定义),最大长度 200"
},
{
"name": "order_type",
"type": "string",
"required": false,
"description": "订单类型"
},
{
"name": "is_urgency",
"type": "string",
"required": false,
"description": "是否紧急:Y/N,默认 N"
},
{
"name": "invoice_flag",
"type": "string",
"required": false,
"description": "是否需要发票:Y/N,默认 N"
}
],
"response": [
{
"name": "order_id",
"type": "number",
"required": true,
"description": "新创建的订单 ID"
},
{
"name": "delivery_order_code",
"type": "string",
"required": true,
"description": "订单号(传入值或自动生成值)"
},
{
"name": "step",
"type": "number",
"required": true,
"description": "初始步骤:0=待审核,1=待处理"
},
{
"name": "step_label",
"type": "string",
"required": true,
"description": "步骤说明:待审核 / 待处理"
},
{
"name": "items_count",
"type": "number",
"required": true,
"description": "商品种类数"
},
{
"name": "items_total",
"type": "number",
"required": true,
"description": "商品总件数"
}
]
},
{
"method": "order.pendingOrder.importOrdersFromExcel",
"title": "通过 Excel 文件批量创建订单。接受 base64 编码的 xlsx 内容,按订单号分组,每组创建一个订单(step 由货主策略决定)。每行代表一条商品明细;同一订单号的多行组成一个完整订单,头信息取每组第一行。(已作废)",
"description": "通过 Excel 文件批量创建订单。接受 base64 编码的 xlsx 内容,按订单号分组,每组创建一个订单(step 由货主策略决定)。每行代表一条商品明细;同一订单号的多行组成一个完整订单,头信息取每组第一行。(已作废)",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "file_base64",
"type": "string",
"required": true,
"description": "base64 编码的 .xlsx 文件内容"
}
],
"response": [
{
"name": "total",
"type": "number",
"required": true,
"description": "解析到的订单总数"
},
{
"name": "success_count",
"type": "number",
"required": true,
"description": "创建成功的订单数"
},
{
"name": "fail_count",
"type": "number",
"required": true,
"description": "创建失败的订单数"
},
{
"name": "success_orders",
"type": "array",
"required": true,
"description": "成功订单列表,每项含 delivery_order_code、order_id、step、step_label"
},
{
"name": "fail_orders",
"type": "array",
"required": true,
"description": "失败订单列表,每项含 delivery_order_code、error(失败原因)"
}
]
},
{
"method": "order.pendingOrder.parseAddress",
"title": "智能地址解析:使用 AI 将非结构化地址字符串解析为省/市/区/详细地址/收件人/手机号",
"description": "智能地址解析:使用 AI 将非结构化地址字符串解析为省/市/区/详细地址/收件人/手机号",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [],
"params": [
{
"name": "address",
"type": "string",
"required": true,
"description": "原始地址字符串(必填),如\"张三 13800138000 广东省广州市天河区体育西路100号\""
}
],
"response": [
{
"name": "code",
"type": "number",
"required": true,
"description": "1=成功,0=失败"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "提示消息"
},
{
"name": "data",
"type": "object",
"required": false,
"description": "解析成功时返回 province/city/area/detailAddress/name/mobile"
},
{
"name": "data.province",
"type": "string",
"required": false,
"description": "省份,如 广东省"
},
{
"name": "data.city",
"type": "string",
"required": false,
"description": "城市,如 广州市"
},
{
"name": "data.area",
"type": "string",
"required": false,
"description": "区/县,如 天河区"
},
{
"name": "data.town",
"type": "string",
"required": false,
"description": "乡镇/街道,如 员村街道"
},
{
"name": "data.detailAddress",
"type": "string",
"required": false,
"description": "详细地址,如 体育西路100号"
},
{
"name": "data.name",
"type": "string",
"required": false,
"description": "收件人姓名,如 张三"
},
{
"name": "data.mobile",
"type": "string",
"required": false,
"description": "收件人手机号,如 13800138000"
}
]
},
{
"method": "order.pendingOrder.updateAddress",
"title": "批量修改待处理订单的收件地址信息和备注。地址字段修改仅允许 post_status='none'(未分配快递)的订单;remark 字段修改不受 post_status 限制可对所有订单生效。至少需要提供一个地址字段(name/mobile/tel/zip_code/province/city/area/town/detail_address)或 remark,空值和纯空白会被忽略。更新成功后写入操作日志。",
"description": "批量修改待处理订单的收件地址信息和备注。地址字段修改仅允许 post_status='none'(未分配快递)的订单;remark 字段修改不受 post_status 限制可对所有订单生效。至少需要提供一个地址字段(name/mobile/tel/zip_code/province/city/area/town/detail_address)或 remark,空值和纯空白会被忽略。更新成功后写入操作日志。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "ids",
"type": "number[]",
"required": true,
"description": "订单ID 正整数数组,不能为空"
},
{
"name": "name",
"type": "string",
"required": false,
"description": "收件人姓名"
},
{
"name": "mobile",
"type": "string",
"required": false,
"description": "收件人手机号"
},
{
"name": "tel",
"type": "string",
"required": false,
"description": "收件人电话"
},
{
"name": "zip_code",
"type": "string",
"required": false,
"description": "邮编"
},
{
"name": "province",
"type": "string",
"required": false,
"description": "省份"
},
{
"name": "city",
"type": "string",
"required": false,
"description": "城市"
},
{
"name": "area",
"type": "string",
"required": false,
"description": "区/县"
},
{
"name": "town",
"type": "string",
"required": false,
"description": "镇/街道"
},
{
"name": "detail_address",
"type": "string",
"required": false,
"description": "详细地址"
},
{
"name": "remark",
"type": "string",
"required": false,
"description": "订单留言/备注,最大500字符。非空时批量覆盖所选订单的 remark 字段,不受 post_status 限制。"
}
],
"response": [
{
"name": "updated_count",
"type": "number",
"required": true,
"description": "实际更新的订单行数(取地址更新行数与备注更新行数的最大值)。remark 字段的更新计数独立于地址字段。"
},
{
"name": "ids",
"type": "number[]",
"required": true,
"description": "请求的订单ID数组(原样返回)"
}
]
},
{
"method": "order.pendingOrder.batchIntercept",
"title": "批量提交订单拦截请求(异步任务模式)。接收订单ID数组,提交后立即返回 task_id 和受理信息,后端异步将每个订单的 intercept_status 更新为 'requested' 并写入操作日志(ORDER_INTERCEPT_REQUEST)。相同 task_id 幂等提交会返回已存在任务的信息。仓库ID统一使用当前上下文(ctx.user.store_id)。",
"description": "批量提交订单拦截请求(异步任务模式)。接收订单ID数组,提交后立即返回 task_id 和受理信息,后端异步将每个订单的 intercept_status 更新为 'requested' 并写入操作日志(ORDER_INTERCEPT_REQUEST)。相同 task_id 幂等提交会返回已存在任务的信息。仓库ID统一使用当前上下文(ctx.user.store_id)。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "order_ids / orderIds / ids",
"type": "number[]",
"required": true,
"description": "订单ID数组;优先级 order_ids > orderIds > ids"
},
{
"name": "task_id / taskId",
"type": "string",
"required": false,
"description": "外部指定任务ID(用于幂等提交,不传则自动生成)"
}
],
"response": [
{
"name": "task_id",
"type": "string",
"required": true,
"description": "任务ID,格式 recheck_intercept_{warehouseId}_{timestamp}_{rand}(幂等提交时返回已有任务的 task_id)"
},
{
"name": "warehouse_id",
"type": "number",
"required": true,
"description": "仓库ID(取自当前上下文)"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "任务提交状态说明:'批量拦截任务已提交。' 或 '批量拦截任务已存在,请勿重复提交。'"
},
{
"name": "accepted_at",
"type": "string",
"required": true,
"description": "任务受理时间(ISO 字符串)"
},
{
"name": "status",
"type": "string",
"required": false,
"description": "提交状态(固定为 'success')"
},
{
"name": "state",
"type": "string",
"required": false,
"description": "幂等提交时返回已有任务的状态:submitted / running / success / failed"
}
]
},
{
"method": "order.pendingOrder.batchInterceptTaskProgress",
"title": "查询批量拦截任务进度。根据 task_id 返回任务的当前状态、进度百分比、已处理/已拦截订单数等信息。任务状态 state 包含 submitted(已提交)、running(执行中)、success(已完成)、failed(失败)、not_found(未找到)。",
"description": "查询批量拦截任务进度。根据 task_id 返回任务的当前状态、进度百分比、已处理/已拦截订单数等信息。任务状态 state 包含 submitted(已提交)、running(执行中)、success(已完成)、failed(失败)、not_found(未找到)。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "task_id / taskId",
"type": "string",
"required": true,
"description": "任务ID"
}
],
"response": [
{
"name": "task_id",
"type": "string",
"required": true,
"description": "任务ID"
},
{
"name": "state",
"type": "string",
"required": true,
"description": "任务状态:submitted / running / success / failed / not_found"
},
{
"name": "warehouse_id",
"type": "number",
"required": false,
"description": "仓库ID(not_found 时不返回)"
},
{
"name": "submitted_at",
"type": "number|null",
"required": false,
"description": "任务提交时间戳(毫秒)"
},
{
"name": "start_time",
"type": "number|null",
"required": false,
"description": "任务开始执行时间戳(毫秒,running/success/failed 时返回)"
},
{
"name": "end_time",
"type": "number|null",
"required": false,
"description": "任务结束时间戳(毫秒,success/failed 时返回)"
},
{
"name": "progress_percent",
"type": "number",
"required": false,
"description": "进度百分比 0-100(submitted/running/success/failed 时返回)"
},
{
"name": "total_order_count",
"type": "number",
"required": false,
"description": "总订单数(submitted/running/success/failed 时返回)"
},
{
"name": "processed_order_count",
"type": "number",
"required": false,
"description": "已处理订单数(仅 submitted/running 时返回)"
},
{
"name": "intercepted_order_count",
"type": "number",
"required": false,
"description": "已拦截订单数(submitted/running/success/failed 时返回)"
},
{
"name": "intercepted_order_ids",
"type": "number[]",
"required": false,
"description": "已拦截订单ID列表(仅 success 时返回)"
},
{
"name": "duration_ms",
"type": "number",
"required": false,
"description": "任务耗时(毫秒,success/failed 时返回)"
},
{
"name": "error_message",
"type": "string",
"required": false,
"description": "错误信息(仅 failed 时返回)"
},
{
"name": "error_code",
"type": "string",
"required": false,
"description": "错误码(仅 failed 时返回,默认 'BATCH_INTERCEPT_FAILED')"
}
]
},
{
"method": "order.pendingOrder.batchLock",
"title": "批量提交订单锁定请求(异步任务模式)。接收订单ID数组,提交后立即返回 task_id 和受理信息,后端异步将每个订单的 lock_status 更新为 'warehouse' 并写入操作日志(ORDER_LOCK)。相同 task_id 幂等提交会返回已存在任务的信息。仓库ID统一使用当前上下文(ctx.user.store_id)。",
"description": "批量提交订单锁定请求(异步任务模式)。接收订单ID数组,提交后立即返回 task_id 和受理信息,后端异步将每个订单的 lock_status 更新为 'warehouse' 并写入操作日志(ORDER_LOCK)。相同 task_id 幂等提交会返回已存在任务的信息。仓库ID统一使用当前上下文(ctx.user.store_id)。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "order_ids / orderIds / ids",
"type": "number[]",
"required": true,
"description": "订单ID数组;优先级 order_ids > orderIds > ids"
},
{
"name": "task_id / taskId",
"type": "string",
"required": false,
"description": "外部指定任务ID(用于幂等提交,不传则自动生成)"
}
],
"response": [
{
"name": "task_id",
"type": "string",
"required": true,
"description": "任务ID,格式 order_lock_{warehouseId}_{timestamp}_{rand}(幂等提交时返回已有任务的 task_id)"
},
{
"name": "warehouse_id",
"type": "number",
"required": true,
"description": "仓库ID(取自当前上下文)"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "任务提交状态说明:'批量锁定任务已提交。' 或 '批量锁定任务已存在,请勿重复提交。'"
},
{
"name": "accepted_at",
"type": "string",
"required": true,
"description": "任务受理时间(ISO 字符串)"
},
{
"name": "status",
"type": "string",
"required": false,
"description": "提交状态(固定为 'success')"
},
{
"name": "state",
"type": "string",
"required": false,
"description": "幂等提交时返回已有任务的状态:submitted / running / success / failed"
}
]
},
{
"method": "order.pendingOrder.batchLockTaskProgress",
"title": "查询批量锁定任务进度。根据 task_id 返回任务的当前状态、进度百分比、已处理/已锁定订单数等信息。任务状态 state 包含 submitted(已提交)、running(执行中)、success(已完成)、failed(失败)、not_found(未找到)。",
"description": "查询批量锁定任务进度。根据 task_id 返回任务的当前状态、进度百分比、已处理/已锁定订单数等信息。任务状态 state 包含 submitted(已提交)、running(执行中)、success(已完成)、failed(失败)、not_found(未找到)。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "task_id / taskId",
"type": "string",
"required": true,
"description": "任务ID"
}
],
"response": [
{
"name": "task_id",
"type": "string",
"required": true,
"description": "任务ID"
},
{
"name": "state",
"type": "string",
"required": true,
"description": "任务状态:submitted / running / success / failed / not_found"
},
{
"name": "warehouse_id",
"type": "number",
"required": false,
"description": "仓库ID(not_found 时不返回)"
},
{
"name": "submitted_at",
"type": "number|null",
"required": false,
"description": "任务提交时间戳(毫秒)"
},
{
"name": "start_time",
"type": "number|null",
"required": false,
"description": "任务开始执行时间戳(毫秒,running/success/failed 时返回)"
},
{
"name": "end_time",
"type": "number|null",
"required": false,
"description": "任务结束时间戳(毫秒,success/failed 时返回)"
},
{
"name": "progress_percent",
"type": "number",
"required": false,
"description": "进度百分比 0-100(submitted/running/success/failed 时返回)"
},
{
"name": "total_order_count",
"type": "number",
"required": false,
"description": "总订单数(submitted/running/success/failed 时返回)"
},
{
"name": "processed_order_count",
"type": "number",
"required": false,
"description": "已处理订单数(仅 submitted/running 时返回)"
},
{
"name": "locked_order_count",
"type": "number",
"required": false,
"description": "已锁定订单数(submitted/running/success/failed 时返回)"
},
{
"name": "locked_order_ids",
"type": "number[]",
"required": false,
"description": "已锁定订单ID列表(仅 success 时返回)"
},
{
"name": "duration_ms",
"type": "number",
"required": false,
"description": "任务耗时(毫秒,success/failed 时返回)"
},
{
"name": "error_message",
"type": "string",
"required": false,
"description": "错误信息(仅 failed 时返回)"
},
{
"name": "error_code",
"type": "string",
"required": false,
"description": "错误码(仅 failed 时返回,默认 'BATCH_LOCK_FAILED')"
}
]
},
{
"method": "order.pendingOrder.batchUnlock",
"title": "批量提交订单解锁请求(异步任务模式)。接收订单ID数组,提交后立即返回 task_id 和受理信息,后端异步将每个订单的 lock_status 更新为 'none' 并写入操作日志(ORDER_UNLOCK)。相同 task_id 幂等提交会返回已存在任务的信息。仓库ID统一使用当前上下文(ctx.user.store_id)。",
"description": "批量提交订单解锁请求(异步任务模式)。接收订单ID数组,提交后立即返回 task_id 和受理信息,后端异步将每个订单的 lock_status 更新为 'none' 并写入操作日志(ORDER_UNLOCK)。相同 task_id 幂等提交会返回已存在任务的信息。仓库ID统一使用当前上下文(ctx.user.store_id)。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "order_ids / orderIds / ids",
"type": "number[]",
"required": true,
"description": "订单ID数组;优先级 order_ids > orderIds > ids"
},
{
"name": "task_id / taskId",
"type": "string",
"required": false,
"description": "外部指定任务ID(用于幂等提交,不传则自动生成)"
}
],
"response": [
{
"name": "task_id",
"type": "string",
"required": true,
"description": "任务ID,格式 order_unlock_{warehouseId}_{timestamp}_{rand}(幂等提交时返回已有任务的 task_id)"
},
{
"name": "warehouse_id",
"type": "number",
"required": true,
"description": "仓库ID(取自当前上下文)"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "任务提交状态说明:'批量解锁任务已提交。' 或 '批量解锁任务已存在,请勿重复提交。'"
},
{
"name": "accepted_at",
"type": "string",
"required": true,
"description": "任务受理时间(ISO 字符串)"
},
{
"name": "status",
"type": "string",
"required": false,
"description": "提交状态(固定为 'success')"
},
{
"name": "state",
"type": "string",
"required": false,
"description": "幂等提交时返回已有任务的状态:submitted / running / success / failed"
}
]
},
{
"method": "order.pendingOrder.batchUnlockTaskProgress",
"title": "查询批量解锁任务进度。根据 task_id 返回任务的当前状态、进度百分比、已处理/已解锁订单数等信息。任务状态 state 包含 submitted(已提交)、running(执行中)、success(已完成)、failed(失败)、not_found(未找到)。",
"description": "查询批量解锁任务进度。根据 task_id 返回任务的当前状态、进度百分比、已处理/已解锁订单数等信息。任务状态 state 包含 submitted(已提交)、running(执行中)、success(已完成)、failed(失败)、not_found(未找到)。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "task_id / taskId",
"type": "string",
"required": true,
"description": "任务ID"
}
],
"response": [
{
"name": "task_id",
"type": "string",
"required": true,
"description": "任务ID"
},
{
"name": "state",
"type": "string",
"required": true,
"description": "任务状态:submitted / running / success / failed / not_found"
},
{
"name": "warehouse_id",
"type": "number",
"required": false,
"description": "仓库ID(not_found 时不返回)"
},
{
"name": "submitted_at",
"type": "number|null",
"required": false,
"description": "任务提交时间戳(毫秒)"
},
{
"name": "start_time",
"type": "number|null",
"required": false,
"description": "任务开始执行时间戳(毫秒,running/success/failed 时返回)"
},
{
"name": "end_time",
"type": "number|null",
"required": false,
"description": "任务结束时间戳(毫秒,success/failed 时返回)"
},
{
"name": "progress_percent",
"type": "number",
"required": false,
"description": "进度百分比 0-100(submitted/running/success/failed 时返回)"
},
{
"name": "total_order_count",
"type": "number",
"required": false,
"description": "总订单数(submitted/running/success/failed 时返回)"
},
{
"name": "processed_order_count",
"type": "number",
"required": false,
"description": "已处理订单数(仅 submitted/running 时返回)"
},
{
"name": "unlocked_order_count",
"type": "number",
"required": false,
"description": "已解锁订单数(submitted/running/success/failed 时返回)"
},
{
"name": "unlocked_order_ids",
"type": "number[]",
"required": false,
"description": "已解锁订单ID列表(仅 success 时返回)"
},
{
"name": "duration_ms",
"type": "number",
"required": false,
"description": "任务耗时(毫秒,success/failed 时返回)"
},
{
"name": "error_message",
"type": "string",
"required": false,
"description": "错误信息(仅 failed 时返回)"
},
{
"name": "error_code",
"type": "string",
"required": false,
"description": "错误码(仅 failed 时返回,默认 'BATCH_UNLOCK_FAILED')"
}
]
},
{
"method": "order.pendingOrder.batchUnintercept",
"title": "批量提交解除拦截请求(异步任务模式)。接收订单ID数组,提交后立即返回 task_id 和受理信息,后端异步将每个订单的 intercept_status 更新为 'none' 并写入操作日志(ORDER_INTERCEPT_CANCEL)。相同 task_id 幂等提交会返回已存在任务的信息。仓库ID统一使用当前上下文(ctx.user.store_id)。",
"description": "批量提交解除拦截请求(异步任务模式)。接收订单ID数组,提交后立即返回 task_id 和受理信息,后端异步将每个订单的 intercept_status 更新为 'none' 并写入操作日志(ORDER_INTERCEPT_CANCEL)。相同 task_id 幂等提交会返回已存在任务的信息。仓库ID统一使用当前上下文(ctx.user.store_id)。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "order_ids / orderIds / ids",
"type": "number[]",
"required": true,
"description": "订单ID数组;优先级 order_ids > orderIds > ids"
},
{
"name": "task_id / taskId",
"type": "string",
"required": false,
"description": "外部指定任务ID(用于幂等提交,不传则自动生成)"
}
],
"response": [
{
"name": "task_id",
"type": "string",
"required": true,
"description": "任务ID,格式 order_unintercept_{warehouseId}_{timestamp}_{rand}(幂等提交时返回已有任务的 task_id)"
},
{
"name": "warehouse_id",
"type": "number",
"required": true,
"description": "仓库ID(取自当前上下文)"
},
{
"name": "message",
"type": "string",
"required": true,
"description": "任务提交状态说明:'批量解除拦截任务已提交。' 或 '批量解除拦截任务已存在,请勿重复提交。'"
},
{
"name": "accepted_at",
"type": "string",
"required": true,
"description": "任务受理时间(ISO 字符串)"
},
{
"name": "status",
"type": "string",
"required": false,
"description": "提交状态(固定为 'success')"
},
{
"name": "state",
"type": "string",
"required": false,
"description": "幂等提交时返回已有任务的状态:submitted / running / success / failed"
}
]
},
{
"method": "order.pendingOrder.batchUninterceptTaskProgress",
"title": "查询批量解除拦截任务进度。根据 task_id 返回任务的当前状态、进度百分比、已处理/已解除拦截订单数等信息。任务状态 state 包含 submitted(已提交)、running(执行中)、success(已完成)、failed(失败)、not_found(未找到)。",
"description": "查询批量解除拦截任务进度。根据 task_id 返回任务的当前状态、进度百分比、已处理/已解除拦截订单数等信息。任务状态 state 包含 submitted(已提交)、running(执行中)、success(已完成)、failed(失败)、not_found(未找到)。",
"endpoint": "/system",
"authRequired": false,
"loginRequired": true,
"status": {
"isUsed": false,
"isPlaceholder": false
},
"headers": [
{
"name": "Authorization",
"type": "string",
"required": true,
"description": "Bearer token"
}
],
"params": [
{
"name": "task_id / taskId",
"type": "string",
"required": true,
"description": "任务ID"
}
],
"response": [
{
"name": "task_id",
"type": "string",
"required": true,
"description": "任务ID"
},
{
"name": "state",
"type": "string",
"required": true,
"description": "任务状态:submitted / running / success / failed / not_found"
},
{
"name": "warehouse_id",
"type": "number",
"required": false,
"description": "仓库ID(not_found 时不返回)"
},
{
"name": "submitted_at",
"type": "number|null",
"required": false,
"description": "任务提交时间戳(毫秒)"
},
{
"name": "start_time",
"type": "number|null",
"required": false,
"description": "任务开始执行时间戳(毫秒,running/success/failed 时返回)"
},
{
"name": "end_time",
"type": "number|null",
"required": false,
"description": "任务结束时间戳(毫秒,success/failed 时返回)"
},
{
"name": "progress_percent",
"type": "number",
"required": false,
"description": "进度百分比 0-100(submitted/running/success/failed 时返回)"
},
{
"name": "total_order_count",
"type": "number",
"required": false,
"description": "总订单数(submitted/running/success/failed 时返回)"
},
{
"name": "processed_order_count",
"type": "number",
"required": false,
"description": "已处理订单数(仅 submitted/running 时返回)"
},
{
"name": "unintercepted_order_count",
"type": "number",
"required": false,
"description": "已解除拦截订单数(submitted/running/success/failed 时返回)"
},
{
"name": "unintercepted_order_ids",
"type": "number[]",
"required": false,
"description": "已解除拦截订单ID列表(仅 success 时返回)"
},
{
"name": "duration_ms",
"type": "number",
"required": false,
"description": "任务耗时(毫秒,success/failed 时返回)"
},
{
"name": "error_message",
"type": "string",
"required": false,
"description": "错误信息(仅 failed 时返回)"
},
{
"name": "error_code",
"type": "string",
"required": false,
"description": "错误码(仅 failed 时返回,默认 'BATCH_UNINTERCEPT_FAILED')"
}
]
}
]
}