客户发放优惠券

接口地址

/marketing/coupon/take

入参

字段说明

名称	类型	必填	示例	描述
idCustomer	Number	是	10545360219000304622	领券客户唯一标识。
idCouponTemplate	Number	是	116904	发放的优惠券模板唯一标识。
takeChannelCode	Number	是	1	优惠券领取渠道。1-线下，3-微信
takeSourceName	String	否	"门店推送"	优惠券领取方式名称，不传默认为“门店推送”。字数范围：1~10。
carRangeType	Number	否	1	优惠券适用车辆范围。枚举值如下：0（部分车辆），1（全部车辆）
idCarList	Number[]	否	[10545360219000304622]	优惠券适用车辆唯一标识，当优惠券适用车辆范围为"部分可用"时，该字段不能为空。
memo	String	否	"保养送洗车"	优惠券发放备注。字数范围：1~200.
idEmployee	Number	否	10545360219000304622	发放优惠券的员工唯一标识。
serialNumber	String	是	"b8b5418a439f417fa9527015aaf53bfb"	发券流水号。用作幂等，长度为10~32个字符。幂等的能力暂时未提供，后续会支持。

JSON示例

{
    "paramValues": [
        {
            "idCustomer": 10545360219000304622,
            "idCouponTemplate": 116904,
            "takeChannelCode": 1,
            "takeSourceName": "门店推送",
            "carRangeType": 0,
            "idCarList": [
                10545360219000304622,
                10545360219000304622
            ],
            "memo": "保养送洗车",
            "idEmployee": 10545360219000304622,
            "serialNumber": "b8b5418a439f417fa9527015aaf53bfb"
        }
    ]
}

出参

字段说明

名称	类型	示例	描述
success	Boolean	true	发放优惠券结果。true代表成功，false代表失败
idCustomer	Number	10545360219000304622	发放成功的优惠券实体唯一标识列表。
idCouponTemplate	Number	53045	发放的优惠券模板唯一标识。
idCoupon	Number	123456	优惠券实体唯一标识。优惠券发放失败不会返回该字段。
failMessage	String	"优惠券限领"	优惠券发放失败的原因。优惠券发放成功不会返回该字段

JSON示例

{
    "code": 200,
    "message": "OK",
    "data": {
        "idCustomer": "15772123085659979779",
        "idCouponTemplate": "53045",
        "idCoupon": "1123807",
        "success": true,
        "failMessage": null
    }
}

{
    "code": 200,
    "message": "OK",
    "data": {
        "idCustomer": "15772123085659979779",
        "idCouponTemplate": "53045",
        "idCoupon": null,
        "success": false,
        "failMessage": "优惠券库存不足"
    }
}