3.2.2发卡/券

### 3.2.2 优惠券发券
产生优惠券。

**method:** allinpay.shopoint.couponService.couponSend

**version:** 1.0

**业务请求参数**

| 字段名 | 参数类型 | 必填 | 最大长度 | 说明 | 取值 |
| --- | --- | --- | --- | --- | --- |
| shopId | String | 否 | | 店铺ID | |
| shopCode | String | 否 | | 店铺号 | 与shopId功能相同，shopId和shopCode同时输入则只取shopId，shopId和shopCode必输一项 |
| operUserId | String | 是 | | 收银员id | 收银员登录名称 |
| couponType | String | 是 | | 券类型 | 1-电子券 2-纸质券 |
| num | String | 是 | | 发券数量 | 正整数 |
| couponTemplateId | String | 是 | | 券模板Id | |
| idType | String | 否 | | 接受券的会员账号类型 | 1-手机号 2-会员卡号 3-Openid 5-外部ID |
| memberId | String | 否 | | 接受券的会员账号 | idType存在时必填 Openid不能被查询到时，将新建对应的用户 |
| orderId | String | 是 | | 外部发券订单号 | |
| sourceType | String | 否 | | 来源类型 | 1-手机号 2-Openid 3-导购ID 4-用户ID |
| sourceValue | String | 否 | | 来源值 来源类型（sourceType）存在时必填 | |
| remark | String | 否 | | 备注信息 | |
| extendInfo | JSON | 否 | | 自定义扩展信息 | 如： extendInfo: {"buyerType":"个人","buyerIdNo":"51*****217","buyerContact":"189***25", } |
| buyerMobile | String | 否 | | 购卡人手机号 | 多用途金额券或者实体卡为记名卡或者批次金额超过10000元时必填 需先调用会员实名接口 |

**业务响应参数**

| 字段名 | 参数类型 | 必填 | 最大长度 | 说明 | 取值 |
| --- | --- | --- | --- | --- | --- |
| code | Integer | 是 | | 返回码 | 0-表示成功 3-表示失败，具体失败原因参见msg字段 其他：参见4.1 公共返回码 |
| msg | String | 是 | | 错误信息 | |
| data.tranNo | String | 是 | | 流水号 | |
| data.shopName | String | 是 | | 店铺名称 | |
| data.tranDateTime | String | 是 | | 交易时间 | |
| data.instruction | String | 否 | | 券使用须知 | |
| data.list | ArrayList | | | 是 | 交易券明细 |
| data.list[].templateId | Integer | 是 | | 模板ID | |
| data.list[].couponName | String | 是 | | 券名称 | |
| data.list[].couponNo | String | 否 | | 券号 | 发券对象，或纸质券时有效 |
| data.list[].qrCodeContext | String | 否 | | 电子券二维码 | 无发券对象，且电子券时有效 |
**请求示例**

```json
{"shopId":"1","operUserId":"1","couponType":"1","num":"10","couponTemplateId":"307"}
```
**响应示例**

```json
{
"code": 0 ,
"data": {
"tranNo":"50806050005080208145",
"shopName": null ,
"tranDateTime": [
2020 ,
4 ,
10 ,
16 ,
3 ,
4 9
],
"list": [
{
"templateId": 307 ,
"couponName":"专门测试ZHT",
"couponNo": null ,
"qrCodeContext":"https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQF48DwAAAAAAAAAAS5odHRwOi8vd2VpeGluLnFxLmNvbS9xLzAyNDdIQUo1VEw5X1AxeFJTZ051Y0IAAgRlKJBeAwQQDgAA"
}
]
},
"sign":"VCpfqwnJGQvV5c3esmz5OpylgfIE6gGqtl3gS/Lrjz4dFt3icgeDA4yjZ9ZO+qJbGH85djwWp6EtTPPE/LRgI2TjWgiyuyR4FdJ7lM4ze/VwcAKxxWVj0OayjXLJblHxTtUNNjfzjH0ndnldQO7gigpvOfgMoampnbOq65SC+3o="
}
```

**部分响应失败枚举**

| code | msg |
| --- | --- |
|1001|shopCode错误|
|1001|shopId（或shopCode）未传递|
|1001|operUserId未传递|
|1001|couponType未传递|
|1001|券类型错误|
|1001|num未传递|
|1001|couponTemplateId未传递或不是正整数|
|1001|会员账户类型错误|
|1001|memberId未传递|
|1001|来源类型错误|
|1001|来源值未传递|
|1001|请先进行实名认证|
|1001|金额大于等于一万需要实名|
|2001|发券数量必须为整数|
|2001|发券数量错误|
|1001|operUserId未传递|
|3101|店铺号错误|
|3101|无效的couponTemplateId|
|3101|操作员不存在|
|3101|未能识别的(%s)顾客号(#%s)|
|3102|非本机构券模板|
|3102|非本机构店铺|
|3103|非店铺(#%d)操作员(#%s)|
|3103|店铺(#%d)不属于操作员(#%s)店铺组(#%d)|
|3201|发券失败[%s]|
|3202|外部订单号重复|