给会员赠送优惠券

POST

/api/anon/openapi/vip/coupon/give

最后修改时间：2024-08-29 07:31:31

责任人：肖工

给会员赠送优惠券，可一次性赠送多张。

请求参数

Query 参数

patientID

integer

患者ID

必需

示例值:

133

giveCount

integer

可选

赠送优惠券张数。可为空。默认赠送一张，赠送多张时请求体优惠券编码参数无效

Header 参数

FRHis-Open-Timestamp

string

必需

示例值:

{% mock 'timestamp' %}

FRHis-Open-App-Id

string

必需

示例值:

FRHis-Open-Token

string

必需

示例值:

Body 参数application/json

couponNo

string | null

优惠券编号

必需

优惠券的唯一编码。可为空，系统内部自动生成。如果不为空，则要求唯一

couponName

string

优惠券名称

必需

优惠券名称。比如：女神节优惠券

amount

number

必需

券额。优惠券面额，两位小数

reused

boolean

必需

是否允许多次使用。是否允许分次使用，每次只使用券额的一部分

effectiveDate

string | null

必需

优惠券生效时间。有效开始时间，不传值则默认当前时间

expireDate

string | null

必需

优惠券过期时间。不传值则认为不会过期，永久有效

memo

string | null

优惠券说明

必需

operatorID

integer | null

必需

操作员id。赠送优惠券员工id

示例

{
    "couponNo": "string",
    "couponName": "string",
    "amount": 0,
    "reused": true,
    "effectiveDate": "string",
    "expireDate": "string",
    "memo": "string",
    "operatorID": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/anon/openapi/vip/coupon/give?patientID=133' \
--header 'FRHis-Open-Timestamp: {% mock '\''timestamp'\'' %}' \
--header 'FRHis-Open-App-Id: {{appid}}' \
--header 'FRHis-Open-Token: {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "couponNo": "string",
    "couponName": "string",
    "amount": 0,
    "reused": true,
    "effectiveDate": "string",
    "expireDate": "string",
    "memo": "string",
    "operatorID": 0
}'

返回响应

🟢200成功

application/json

Body

errcode

integer

状态码

必需

0正常 1失败

errmsg

string

信息

必需

data

array[string]

返回结果

必需

生成的优惠券编码

示例

{
    "errcode": 0,
    "errmsg": "string",
    "data": [
        "string"
    ]
}

获取会员已领取优惠券列表

作废优惠券