微信小店
取消
中文
中文
EN
取消
  • 微信小店

    • # 获取商家工单列表

    接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

    接口英文名：GetMchTicketList

    分页查询商家名下的工单列表，支持按工单状态、分类、时间范围等条件过滤。

    # 1. 调用方式

    # HTTPS 调用

    POST https://api.weixin.qq.com/channels/ec/platformkf/getmchticketlist?access_token=ACCESS_TOKEN

    # 云调用

    • 本接口不支持云调用。

    # 第三方调用

    # 2. 请求参数

    # 查询参数 Query String Parameters

    参数名类型必填示例说明
    access_tokenstring是ACCESS_TOKEN接口调用凭证，可使用 access_token（微信小店商家）、authorizer_access_token（服务商代调用）

    # 请求体 Request Payload

    参数名类型必填说明
    ticket_statenumber否工单状态（1：待商家处理，2：待平台处理，3：已完结），不传则返回所有状态
    ticket_class_typenumber否工单类型 (当前仅支持「9:催发货」)
    search_ticket_idstring否工单id、订单id，任意其一
    search_start_timenumber否查询起始时间（Unix 时间戳，秒）-工单的创建时间
    search_end_timenumber否查询结束时间（Unix 时间戳，秒）-工单的创建时间
    sort_order_typenumber否排序方式（1：按创建时间排序，2：按工单截止时间升序）。默认按创建时间降序
    limitnumber否每页数量，默认 10，最大建议不超过 50
    startnumber否分页起始偏移量，从 0 开始

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    ticket_item_listobjarray工单列表
    totalnumber工单总数
    errcodenumber错误码，0 表示成功
    errmsgstring错误信息

    # Res.ticket_item_list(Array) Object Payload

    工单列表

    参数名类型说明
    ticket_idstring商家工单 ID
    ticket_class_typenumber工单分类类型（当前仅支持「9:催发货」）
    ticket_statenumber工单状态(（1：待商家处理，2：待平台处理，3：已完结）)
    ticket_begin_timenumber工单开始时间（Unix 时间戳，秒）
    ticket_deal_end_timenumber工单处理截止时间（Unix 时间戳，秒)
    merchant_operate_timenumber商户处理时间（Unix 时间戳，秒）
    platform_operate_timenumber平台处理时间（Unix 时间戳，秒）
    descriptionstring工单问题描述
    order_idstring关联订单 ID
    aftersale_idstring关联售后 ID
    platform_review_resultnumber平台审核结果（1：审核通过，协商一致支持用户，2：审核不通过，默认判支持用户，3：平台介入处理，判支持商家，4：平台接入处理，判支持用户，5：平台关闭工单）
    order_infoobject订单信息，见 OrderInfo 结构
    user_infoobject用户信息，见 UserInfo 结构
    merchant_operateobject商户处理记录，见 MerchantOperate 结构
    platform_operateobject平台处理记录，见 PlatformOperate 结构
    create_timenumber创建时间（Unix 时间戳，秒）
    update_timenumber更新时间（Unix 时间戳，秒）

    # Res.ticket_item_list(Array).order_info Object Payload

    订单信息，见 OrderInfo 结构

    参数名类型说明
    order_idstring小店订单 ID
    actual_pricenumber实付款，单位：分
    goods_listobjarray商品列表

    # Res.ticket_item_list(Array).order_info.goods_listObject Payload

    商品列表

    参数名类型说明
    good_namestring商品名称
    good_countnumber商品数量
    product_idnumber商品 ID
    sku_idnumber商品 SKU ID
    thumb_imgstring商品缩略图 URL

    # Res.ticket_item_list(Array).user_info Object Payload

    用户信息，见 UserInfo 结构

    参数名类型说明
    descriptionstring用户问题描述

    # Res.ticket_item_list(Array).merchant_operate Object Payload

    商户处理记录，见 MerchantOperate 结构

    参数名类型说明
    merchant_replynumber商家回复选项 ID，对应 OptionSet 中的 option_id
    descriptionstring商家补充说明
    confer_timenumber商家与用户协商的时间（Unix 时间戳，秒）

    # Res.ticket_item_list(Array).platform_operate Object Payload

    平台处理记录，见 PlatformOperate 结构

    参数名类型说明
    audit_resultnumber平台审核结果（1：审核通过，协商一致支持用户，2：审核不通过，默认判支持用户，3：平台介入处理，判支持商家，4：平台接入处理，判支持用户，5：平台关闭工单）
    reasonstring对商家的说明（审核不通过原因）
    is_agreenumber用户是否认可
    reply_descriptionstring回复用户话术
    platform_reply_timenumber平台答复时间（Unix 时间戳，秒）

    # 4. 注意事项

    本接口无特殊注意事项

    # 5. 代码示例

    请求示例

    {
  "search_start_time" : 1774972800,
  "search_end_time" : 1777564800,
  "limit" : 1,
  "start" : 0
}

    返回示例

    {
    "ticket_item_list": [
        {
            "ticket_id": "10202604141126472",
            "ticket_class_type": 9,
            "merchant_reply": 0,
            "ticket_state": 3,
            "ticket_begin_time": 1776137206,
            "ticket_deal_end_time": 1776223607,
            "merchant_operate_time": 0,
            "platform_operate_time": 1776223612,
            "description": "",
            "order_id": "123",
            "aftersale_id": "",
            "platform_review_result": 4,
            "order_info": {
                "order_id": "123",
                "actual_price": 1,
                "goods_list": [
                    {
                        "good_name": "123！",
                        "good_count": 1,
                        "product_id": 123,
                        "sku_id": 123,
                        "thumb_img": ""
                    }
                ],
                "order_type": 0
            },
            "user_info": {
                "description": "订单承诺发货时间：2026-04-14 11:26:46，发货已超时，且用户催发货，为避免“缺货”违规，请尽快处理工单。（当前仅预警，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": 1776223607
            },
            "platform_operate": {
                "audit_result": 4,
                "reason": "超时未处理，默认支持用户",
                "platform_reply_time": 1776223612,
                "busi_result_word": "商家超时未回复工单，未在缺货时限内如期发货，已“缺货”违规。"
            },
            "create_time": 1776137207,
            "update_time": 1776223612,
            "ticket_source": 2
        }
    ],
    "total": 8,
    "errcode": 0,
    "errmsg": "ok"
}

    # 6. 错误码

    以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

    错误码错误描述
    40097参数错误

    # 7. 适用范围

    本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。

    接口变更日志（1条）
    2026 年 04 月 17 日
    新增 获取商家工单列表 接口