券模板发券接口 - 客如云 API

(下行接口)客如云提供通过券模板发券接口

curl --location --request POST 'https://gldopenapi.keruyun.com/open/v1/crm/coupon/manualSend?appKey=&shopIdenty=&brandId=&version=&timestamp=&sign=' \ --header 'Content-Type: application/json' \ --data-raw '{ "brandId": 2479, "shopId":247900002, "customerId": 9527, "coupons": [ { "couponId":1234567, "count":1 } ] }'

{ "code": 0, "message": "string", "messageUuid": "string", "result": [ { "coupInstanceId": 11122, "couponId": 12345678, "holderId": 9527 } ] }

请求参数

Query 参数

appKey

string

必需

开发者申请服务客如云分配的appKey

默认值:

shopIdenty

string

必需

客如云门店id （门店维度接口传递门店ID）

默认值:

brandId

string

必需

客如云品牌id（品牌授权的接口传递品牌ID）

默认值:

version

string

必需

版本,默认2.0（1.0版本仍可用）

默认值:

2.0

timestamp

string

必需

时间戳,单位:秒,时间戳校验签名,开放平台校验签名时用此参数和服务器当前时间戳对比不能大于300秒，我方服务器使用阿里云授时中心

默认值:

sign

string

必需

签名，64位长度的字符串，获取规则详见签名规则

默认值:

Body 参数application/json

brandId

integer

客如云品牌Id

必需

shopId

integer

客如云门店Id

必需

customerId

integer

顾客Id

可选

coupons

array[object (ManualCouponInfoTO) {2}]

发券信息

必需

couponId

integer

券模版id

必需

count

integer

发券数量，大于0

必需

customerInfo

object (ManualCouponCustomerInfoTO)

可选

开放用户信息，顾客customerId为空时，字段customerInfo不能为空

mobile

string

手机号

可选

wxOpenId

string

微信openId

可选

示例

返回响应

🟢200成功

application/json

Body

result

array[object (ManualCouponSendResultVO) {3}]

规则

可选

coupInstanceId

integer

优惠券ID

必需

couponId

integer

优惠券模板ID

必需

holderId

integer

必需

持有用户ID，同customerId相同

code

integer

必需

错误码；0：成功；其他值认为失败

message

string

返回信息

必需

messageUuid

string

错误信息序列码

必需

apiMessage

string

必需