📦 接口文档

🌐 English Version

POST detail 批次详情

地址：/api/order-batch/detail　·　说明：查询批次信息与逐单处理结果（订单号 / 跟踪号 / 面单 / 失败原因）。

参数说明

参数	必填	类型	说明
id	是	int	批次 ID（create 返回的 batch_id）

请求示例

GET /api/order-batch/detail?id=88
Header: vendor-token: xxxxx

返回示例

{
    "success": true,
    "code": 200,
    "data": {
        "batch": {
            "id": 88,
            "batch_no": "B20260921153000ab12",
            "status": 2,
            "status_text": "处理完成",
            "total_count": 2
        },
        "items": [
            {
                "row_no": 1,
                "reference": "ORDER-20260921-001",
                "parse_status_text": "成功",
                "rate_status_text": "询价成功",
                "print_status_text": "打单成功",
                "order_no": "20260921153000_ab12cd",
                "tracking": "9212345678901234567890",
                "label": "https://cdn.xxx.com/label/123_1699999999.pdf",
                "print_fee": 15.05,
                "fail_reason": ""
            }
        ]
    }
}

data 字段	类型	说明
batch	object	批次信息（含 status / status_text）
batch.status	int	批次状态：0待处理　1处理中　2处理完成　3处理失败
items	array	逐单明细，按提交顺序返回
items[].row_no	int	行号（从 1 起，与提交顺序一致）
items[].reference	string	提交时传入的订单参考号
items[].parse_status_text	string	校验结果（成功 / 失败）
items[].rate_status_text	string	询价结果：未询价 / 询价成功 / 询价失败
items[].print_status_text	string	打单结果：未打单 / 打单成功 / 打单失败
items[].order_no	string	系统订单号（打单成功后返回）
items[].tracking	string	渠道跟踪号 / 面单号（打单成功后返回）
items[].label	string	面单地址，可直接下载打印（打单成功后返回）
items[].print_fee	float	实际扣费金额
items[].fail_reason	string	失败原因（校验或打单失败时返回，成功为空）