# 查询工单详情
接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。
接口英文名：GetMchTicketDetail
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/platformkf/getmchticketdetail?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用。
# 第三方调用
本接口支持第三方平台代微信小店商家调用。第三方服务商调用模式介绍
该接口所属的权限集 id 为：131
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代微信小店商家进行调用，具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String Parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证，可使用 access_token（微信小店商家）、authorizer_access_token（服务商代调用） |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ticket_id | string | 是 | 工单id |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| merchant_ticket | object | 工单详细信息，结构同工单列表中的ticket_item_list中的元素 |
| errcode | number | 错误码，0 表示成功 |
| errmsg | string | 错误信息 |
# 4. 注意事项
本接口无特殊注意事项
# 5. 代码示例
请求示例
{
"ticket_id": "123"
}
返回示例
{
"merchant_ticket": {
"ticket_id": "123",
"ticket_class_type": 9,
"merchant_reply": 0,
"ticket_state": 2,
"ticket_begin_time": 1771987997,
"ticket_deal_end_time": 1772074398,
"merchant_operate_time": 0,
"platform_operate_time": 0,
"description": "订单承诺发货时间：2026-01-23 14:33:17，发货已超时，且用户催发货，为避免“缺货”违规，请尽快处理工单。（当前仅预警，2026年3月起将逐步执行「缺货」赔付规则）<a href="https://store.weixin.qq.com/chengzhang/webdoc/wiki/407/e4ca8eb1ee772cf7/growth_center_rule_for_store/10?source=6&sourceType=4" target="_blank">「规则详情」</a>",
"order_id": "123",
"aftersale_id": "",
"platform_review_result": 0,
"order_info": {
"order_id": "123",
"actual_price": 11,
"goods_list": [
{
"good_name": "123",
"good_count": 1,
"product_id": 123,
"sku_id": 123,
"thumb_img": ""
}
]
},
"user_info": {
"description": "订单承诺发货时间：2026-01-23 14:33:17，发货已超时，且用户催发货，为避免“缺货”违规，请尽快处理工单。（当前仅预警，2026年3月起将逐步执行「缺货」赔付规则）<a href="https://store.weixin.qq.com/chengzhang/webdoc/wiki/407/e4ca8eb1ee772cf7/growth_center_rule_for_store/10?source=6&sourceType=4" target="_blank">「规则详情」</a>"
},
"merchant_operate": {
"urls": [],
"operate_source": 2,
"over_operate_time": 1772074399
},
"platform_operate": {
"is_archiving_over_time": true
},
"create_time": 1771987998,
"update_time": 1772340800,
"ticket_source": 2
},
"errcode": 0,
"errmsg": "ok"
}
# 6. 错误码
以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 |
|---|---|
| 40097 | 参数错误 |
# 7. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。
接口变更日志（1条）2026 年 04 月 17 日
新增 查询工单详情 接口