企迈云-开放平台

API 2.0

7.4.8 优惠冲正

开启令牌和权限后可调用。签名方式请查看开发指南

场景描述：使用优惠券核销中的业务标识去冲正（经过业务处理）

餐饮

请求地址

请求方式	版本信息	请求地址
POST	V2	http://openapi.zvcms.com/api/v2

公共参数

参数	参数类型	是否必填	默认值	描述
OpenId	string	是		密钥Id
GrantCode	string	是		授权code
Token	string	是		签名，参考《数字签名sign》
Timestamp	string	是		当前时间戳
Nonce	string	是		随机正整数
Action	string	是	communal.user.coupons-reverse	接口方法
Params	array	是		业务参数

请求参数

参数	参数类型	是否必填	描述
bizId	string	是	业务标识（必须与优惠券核销响应参数中的bizId一致）
changeType	int	是	更改方式:3核销-冲正/5冻结-冲正
groupId	int	否	集团ID
channel	string	否	账户名default
operationScene	array	否
├0	array	否
├appType	string	否	app类型
├deviceSn	int	否	手机/电脑/收银机识别码
├ip	string	否	终端IP
├opType	int	否	操作类型
├operatorId	string	否	操作员id
├operatorName	string	否	操作员名称
├sellerId	Int	否	商家ID
├sellerName	string	否	商家名称
├storeId	int	否	多门店id
├storeName	string	否	多门店名称
├storeSn	string	否	多门店编码
reason	string	否	原因

响应参数

参数	参数类型	描述
status	int	请求成功或者失败
code	int	成功/错误编码
message	string	成功/错误描述
data	array	返回信息

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "communal.user.coupons-reverse",
    "Params": {
        "bizId": "applipaywechat099888",
        "changeType": "3",
        "groupId": "",
        "channel": "",
        "operationScene": [
            {
                "appType": "",
                "deviceSn": "",
                "ip": "",
                "opType": "",
                "operatorId": "",
                "operatorName": "",
                "sellerId": "",
                "sellerName": "",
                "storeId": "",
                "storeName": "",
                "storeSn": ""
            }
        ],
        "reason": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": ""
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}