最新更新时间:2020.04.28 版本说明
用于服务商开发者在顾客下单后为顾客分配服务人员使用。
• 调用服务人员分配接口需在完成支付之前,若分配服务人员晚于支付完成,则将无法在支付凭证上出现服务人员名片入口。
适用对象:服务商
请求URL:https://api.mch.weixin.qq.com/v3/smartguide/guides/{guide_id}/assign
请求方式:POST
path 指该参数路径参数
query 指该参数需在请求URL传参
body 指该参数需在请求JSON传参
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
服务人员ID | guide_id | string[1,32] | 是 | path 服务人员在服务人员系统中的唯一标识 示例值:LLA3WJ6DSZUfiaZDS79FH5Wm5m4X69TBic |
子商户ID | sub_mchid | string[1,32] | 否 | body 服务人员所属商户的商户ID 示例值:1234567890 |
商户订单号 | out_trade_no | string[1,32] | 是 | body 商户系统内部订单号,要求32个字符内,仅支持使用字母、数字、中划线-、下划线_、竖线|、星号*这些英文半角字符的组合,请勿使用汉字或全角等特殊字符,且在同一个商户号下唯一。 示例值:20150806125346 |
{
"out_trade_no" : "20150806125346",
"sub_mchid" : "1234567890"
}
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
400 | PARAM_ERROR | 必填参数为空 | 根据错误提示,传入正确参数 |
服务人员ID格式错误 | 根据错误提示,传入正确参数 | ||
商户订单号格式错误 | 根据错误提示,传入正确参数 | ||
商户订单号过长 | 根据错误提示,传入正确参数 | ||
服务人员ID为空 | 根据错误提示,传入正确参数 | ||
商户订单号为空 | 根据错误提示,传入正确参数 | ||
400 | MCH_NOT_EXISTS | 商户号格式错误 | 请确认商户号是否有误 |
子商户号格式错误 | 请确认商户号是否有误 | ||
子商户号为空 | 请填写子商户号 | ||
400 | INVALID_REQUEST | 子商户未授权 | 子商户未授权,请联系子商户授权 |
子商户产品权限未开通 | 子商户产品权限未开通,请联系子商户开通 | ||
500 | SYSTEM_ERROR | 系统错误 | 请使用相同参数稍后重新调用 |
扩展父子商户票据错误 | 请使用相同参数稍后重新调用 | ||
调用云函数错误 | 请使用相同参数稍后重新调用 |