# 同步工单

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

接口英文名：mmecapi_syncworkorder

工单同步，同步时为全量覆盖式，并非增量同步

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/aftersale/syncworkorder?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`

参数名	类型	必填	说明
complaint_id	string	是	纠纷单号
work_order_info	object	是	工单信息

# Body.work_order_info `Object Payload`

工单信息

参数名	类型	必填	说明
version	number	是	递增版本号（每次全量同步递增）
items	objarray	是	工单列表（全量替换）
work_order_id	string	是	工单ID

# Body.work_order_info.items(Array) `Object Payload`

工单列表（全量替换）

参数名	类型	必填	说明	枚举
status	number	是	工单状态，1-创建工单，2-处理工单，3-工单完结	枚举值
desc	string	是	描述	-
update_time	number	是	更新时间	-
result_type	number	是	终态结果类型，0-无结果（非终态），1-同意退款，2-拒绝退款（仅终态有效）	枚举值
refund_amount	number	否	退款金额（终态且同意退款时有效，单位分）	-
media_list	objarray	否	图片/视频素材列表	-

# Body.work_order_info.items(Array).media_list`Object Payload`

图片/视频素材列表

参数名	类型	必填	说明
type	number	是	媒体类型，填1
picture	object	是	图片信息

# Body.work_order_info.items(Array).media_list.picture `Object Payload`

图片信息

参数名	类型	必填	说明
tmp_media_id	string	是	临时媒体ID，上传图片，resp_type填0，取media_id

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	说明
errcode	number	错误码
errmsg	string	错误信息

# 4. 枚举信息

# Body.work_order_info.items(Array).status `Enum`

工单状态，1-创建工单，2-处理工单，3-工单完结

枚举值	描述
1	创建工单
2	处理工单
3	工单完结

# Body.work_order_info.items(Array).result_type `Enum`

终态结果类型，0-无结果（非终态），1-同意退款，2-拒绝退款（仅终态有效）

枚举值	描述
0	无结果（非终态）
1	同意退款
2	拒绝退款

# 5. 注意事项

本接口无特殊注意事项

# 6. 代码示例

请求示例

{
    "complaint_id": "",
    "work_order_info": {
        "version": 0,
        "items": [
            {
                "status": 0,
                "desc": "",
                "update_time": 0,
                "result_type": 0,
                "refund_amount": 0,
                "media_list": [
                    {
                        "type": 1,
                        "picture": {
                            "tmp_media_id": ""
                        }
                    }
                ]
            }
        ],
        "work_order_id": ""
    }
}

返回示例

{
    "errcode": 0,
    "errmsg": ""
}

# 7. 错误码

此接口没有特殊错误码，可参考通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具辅助定位和分析问题。

# 8. 适用范围

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

接口变更日志（1条）

2026 年 04 月 02 日

新增同步工单接口