开发平台

电话咨询 400-000-7749

1.促销活动说明



2.根据优惠券规则Uid查询


接口地址 http://host:port/pospal-api2/openapi/v1/promotionOpenApi/queryCouponPromotionByUid
请求头
  • User-Agent: openApi
  • Content-Type: application/json; charset=utf-8
  • accept-encoding: gzip,deflate
  • time-stamp: 1437528688233
  • data-signature: BF706E6AC693BA3B1BABD32E6713431D
  • 请求方式 POST
    请求体
  • {
  • "promotionCouponUid": "1442802255016332217",
  • "appId": "abcdefghijklmn"
  • }
  • 参数名 是否必须 类型 说明
    promotionCouponUid Long 优惠券规则uid
    appId String Pospal配置的访问凭证
    返回结果
  • {
  • "status": "success",
  • "messages": [],
  • "data":
  • {
  • "forRShop": "1",
  • "forEShop": "1",
  • "forCustomer": "0",
  • "enjoyCustomerDiscount": "0",
  • "promotionCouponUid": "1442802255016332217",
  • "createUserAppId": "hanskang_appid",
  • "createUserAccount": "hanskang",
  • "enable": "1",
  • "name": "全场抵现券-满50减12",
  • "couponType": 10,
  • "requireAmount": 50.00,
  • "backAmount":12.00,
  • "startDate": "2015-09-21 00:00:00",
  • "endDate": "2015-09-30 23:59:59",
  • "beginDays":3,
  • "avaliableDays":6,
  • "description": "好吃",
  • "avaliableQuantity": "990",
  • "usedQuantity": "0",
  • "createdQuantity": "660",
  • "codeLength": "5",
  • "salable": "1",
  • "sellingPrice": "0.1",
  • "usageLimitType": 1,
  • "usageLimitTimes": 22,
  • "promotionRuleAssignUserAppIds": ["cyjtest6appid","cyjtest9appid"],
  • "promotionRuleAssignUserAccounts": ["cyjtest6","cyjtest9"],
  • "defaultImagePath": "couponImage/4424484/9b7ff429-ec4a-4b4d-980c-82610149feb6.jpg"
  • }
  • }
  • 字段名 类型 说明
    status String 是否正确处理请求,返回success或error,不区分大小写
    messages String[] 处理结果的消息
    errorCode int 业务处理的错误代码,参见错误代码表
    data Json
    forRShop Integer 1:实体店可用,0:实体店不可用
    forEShop Integer 1:网店可用,0:网店不可用
    forCustomer Integer 1: 会员专享,0:不限制
    enjoyCustomerDiscount Integer 会员可享受的折扣率,0或空享受折扣优惠。假设enjoyCustomerDiscount=90表示享受9九折优惠
    promotionCouponUid Long 优惠券规则uid
    createUserAccount String 创建优惠券规则门店的账号
    createUserAppId String 创建优惠券规则门店的AppId
    enable Integer 是否可用,1:可用,0:禁用,-1删除
    name String 促销活动(优惠券活动)名称
    couponType int 优惠券类型
    10:全场抵现券
    11:品类抵现券
    12:单品抵现券
    15:多品抵现券
    20:全场打折券
    21:品类打折券
    22:单品打折券
    23:单品特价券
    24:赠品提货券
    25:多品打折券
    30:免运费券
    requireAmount BigDecimal 最低消费金额 抵现券才有该字段
    backAmount BigDecimal 抵现金额 抵现券才有该字段
    discount BigDecimal 优惠折扣 比如返回78.00,表示打78折 打折券才有该字段
    startDate String 促销活动开始时间,格式为yyyy-MM-dd HH:mm:ss
    endDate String 促销活动结束时间,格式为yyyy-MM-dd HH:mm:ss
    beginDays int 领券后第x天生效 0表示立即生效
    avaliableDays int 有效期X天
    description String 促销活动(优惠券活动)描述
    avaliableQuantity Integer 剩余可用优惠券号(核销码)数量
    usedQuantity Integer 已使用(核销)优惠券号(核销码)数量
    createdQuantity Integer 已创建优惠券号(核销码)数量
    codeLength Integer 优惠券号(核销码)建议长度
    salable Integer 是否可销售,1:是,0或空:否
    sellingPrice BigDecimal 优惠券号销售价,空或0不收钱
    requiredAmount BigDecimal 满足多少金额才出券,空或0不限制
    usageLimitType Integer 使用限制:0/null-不限制,1-每日限制次数,2-每周限制次数,3-每月限制次数
    usageLimitTimes Integer 每日/每周/每月限制使用次数
    usageLimitAmountType Integer 使用限制:0/null-不限制,1-限制最多优惠金额
    usageLimitAmount Integer 限制最多优惠金额
    promotionRuleAssignUserAccounts String[] 使用门店用户账号(总部帐号发起查询时才有)
    promotionRuleAssignUserAppIds String[] 使用门店用户AppId(总部帐号发起查询时才有)
    defaultImagePath String 优惠券图片url 请自行拼接域名:https://img.www.onnagokoro.net/

    3. 查询可用优惠券规则


    接口地址 http://host:port/pospal-api2/openapi/v1/promotionOpenApi/queryCouponPromotions
    请求头
  • User-Agent: openApi
  • Content-Type: application/json; charset=utf-8
  • accept-encoding: gzip,deflate
  • time-stamp: 1437528688233
  • data-signature: BF706E6AC693BA3B1BABD32E6713431D
  • 请求方式 POST
    请求体
  • {
  • "appId": "abcdefghijklmn"
  • }
  • 参数名 是否必须 类型 说明
    appId String Pospal配置的访问凭证
    返回结果
  • {
  • "status": "success",
  • "messages": [],
  • "data":[
  • {
  • "forRShop": "1",
  • "forEShop": "1",
  • "forCustomer": "0",
  • "enjoyCustomerDiscount": "0",
  • "promotionCouponUid": "1442802255016332217",
  • "createUserAppId": "hanskang_appid",
  • "createUserAccount": "hanskang",
  • "enable": "1",
  • "name": "满额返现100减去50",
  • "startDate": "2015-09-21 00:00:00",
  • "endDate": "2015-09-22 23:59:59",
  • "description": "好吃",
  • "avaliableQuantity": "990",
  • "usedQuantity": "0",
  • "createdQuantity": "660",
  • "codeLength": "5",
  • "salable": "1",
  • "sellingPrice": "0.1"
  • }
  • ]
  • }
  • 字段名 类型 说明
    status String 是否正确处理请求,返回success或error,不区分大小写
    messages String[] 处理结果的消息
    errorCode int 业务处理的错误代码,参见错误代码表
    data List 字段描述参考根据优惠券规则Uid查询

    4. 添加优惠券号(核销码)


    接口地址 http://host:port/pospal-api/api/auth/openapi/promotion/addCouponcode/
    请求头
  • User-Agent: openApi
  • Content-Type: application/json; charset=utf-8
  • accept-encoding: gzip,deflate
  • time-stamp: 1437528688233
  • data-signature: BF706E6AC693BA3B1BABD32E6713431D
  • 请求方式 POST
    请求体
  • {
  • "appId": "abcdefghijklmn",
  • "code": "testCode",
  • "customerUid": 123456789,
  • "promotionCouponUid":1442802255016332217
  • }
  • 参数名 是否必须 类型 说明
    appId String Pospal配置的访问凭证
    promotionCouponUid Long 优惠券规则uid
    customerUid Long 会员Uid,如果有值,说明优惠券号挂到会员上
    code String 优惠券号(核销码),长度不能超过50(限英文或数字)
    注:优惠券号(核销码)必须保证每家门店全局唯一。
    返回结果
  • {
  • "status": "success",
  • "messages": [],
  • "data":{
  • "codeExpiredDate":"2015-09-22 23:59:59"
  • }
  • }
  • 字段名 类型 说明
    status String 是否正确处理请求,返回success或error,不区分大小写
    messages String[] 处理结果的消息
    errorCode int 业务处理的错误代码,参见错误代码表
    data Json
    codeExpiredDate Json 优惠券号(核销码)失效时间,格式为yyyy-MM-dd HH:mm:ss

    5.分页查询会员所有优惠券号(核销码)(id倒序)


    接口地址 http://host:port/pospal-api2/openapi/v1/promotionOpenApi/queryCustomerCouponCodePage
    请求头
  • User-Agent: openApi
  • Content-Type: application/json; charset=utf-8
  • accept-encoding: gzip,deflate
  • time-stamp: 1437528688233
  • data-signature: BF706E6AC693BA3B1BABD32E6713431D
  • 请求方式 POST
    请求体
  • {
  • "customerUid": 817903042980914293,//会员uid
  • "postBackParameter": {
  • "parameterType": "abcdef",//从返回结果中直接取出
  • "parameterValue": "abcdef"//从返回结果中直接取出
  • },
  • "appId": "abcdefghijklmn"
  • }
  • 参数名 是否必须 类型 说明
    customerUid Long 会员uid
    appId String Pospal配置的访问凭证
    postBackParameter Json Pospal查询首页时可以不传,之后的内容从返回结果中取出
    parameterType String 从返回结果中取出
    parameterValue String 从返回结果中取出
    返回结果
  • {
  • "status": "success",
  • "messages": [],
  • "data": {
  • "postBackParameter":{
  • "parameterType": "LAST_RESULT_MAX_ID",
  • "parameterValue": "68975"
  • },
  • "result": [
  • {
  • "createdByUserAppId": "hanskang_appid",
  • "createUserAccount": "hanskang",
  • "usedByUserAppId": "hanskang_appid",
  • "usedByUserAccount": "hanskang",
  • "code": "5213705",
  • "createdDateTime": "2015-09-22 23:59:59",
  • "expiredDate": "好吃",
  • "usedDateTime": "990",
  • "usedByTicketUid": "0",
  • "promotionCouponUid": "660",
  • "promotionCouponName": "5",
  • "promotionCouponAppId": "1",
  • "promotionCouponAccount": "0.1",
  • "promotionCouponStartDate": "0.1",
  • "promotionCouponEndDate": "0.1"
  • }
  • ],
  • "pageSize":"100"
  • }
  • }
  • 字段名 类型 说明
    status String 是否正确处理请求,返回success或error,不区分大小写
    messages String[] 处理结果的消息
    errorCode int 业务处理的错误代码,参见错误代码表
    data Json
    postBackParameter Json 分页查询回传到服务器的参数结构从第二页开始必须回传,如果没传,每次查询都是第一页
    parameterType String 从返回结果中直接取出用于回传,不能变其值
    parameterValue String 从返回结果中直接取出用于回传,不能变其值
    result List
    createdByUserAppId String 创建优惠券号(核销码)用户AppId
    createdByUserAccount String 创建优惠券号(核销码)用户账号
    code String 优惠券号(核销码)
    createdDateTime String 优惠券号(核销码)创建时间,格式为yyyy-MM-dd HH:mm:ss
    expiredDate String 优惠券号(核销码)过期时间,格式为yyyy-MM-dd HH:mm:ss如果为空,以promotionCouponEndDate为准
    usedByUserAppId String 使用优惠券号(核销码)用户AppId
    usedByUserAccount String 使用优惠券号(核销码)用户账号
    usedDateTime String 使用优惠券号(核销码)时间,格式为yyyy-MM-dd HH:mm:ss
    usedByTicketUid String 使用优惠券号(核销码)的流水单据Uid
    promotionCouponUid Long 优惠券规则Uid
    promotionCouponName String 优惠券规则名称
    promotionCouponAppId Integer 优惠券号(核销码)建议长度
    promotionCouponAccount String 创建优惠券规则用户账号
    promotionCouponStartDate String 优惠券规则-开始时间,格式为yyyy-MM-dd HH:mm:ss
    promotionCouponEndDate String 优惠券规则-结束时间,格式为yyyy-MM-dd HH:mm:ss

    6.分页查询核销过的优惠券号(核销码)


    接口地址 http://host:port/pospal-api2/openapi/v1/promotionOpenApi/queryUsedPromotionCode
    请求头
  • User-Agent: openApi
  • Content-Type: application/json; charset=utf-8
  • accept-encoding: gzip,deflate
  • time-stamp: 1437528688233
  • data-signature: BF706E6AC693BA3B1BABD32E6713431D
  • 请求方式 POST
    请求体
  • {
  • "startTime": "2017-05-01 00:00:00",//开始时间(包含)
  • "excludeEndTime": "2017-05-05 23:59:59",//结束时间(不包含)
  • "postBackParameter": {
  • "parameterType": "abcdef",//从返回结果中直接取出
  • "parameterValue": "abcdef",//从返回结果中直接取出
  • },
  • "appId": "abcdefghijklmn"
  • }
  • 参数名 是否必须 类型 说明
    startTime String 开始时间(包含),格式为yyyy-MM-dd HH:mm:ss
    excludeEndTime String 结束时间(不包含),格式为yyyy-MM-dd HH:mm:ssendTime - startTime <= 5天
    appId String Pospal配置的访问凭证,任何门店的AppId都可以查出所有用用过的核销码
    postBackParameter Json Pospal查询首页时可以不传,之后的内容从返回结果中取出
    parameterType String 从返回结果中取出
    parameterValue String 从返回结果中取出
    返回结果
  • {
  • "status": "success",
  • "messages": [],
  • "data": {
  • "postBackParameter":{
  • "parameterType": "LAST_RESULT_MAX_ID",
  • "parameterValue": "68975"
  • },
  • "result": [
  • {
  • "createdByUserAppId": "hanskang_appid",
  • "createUserAccount": "hanskang",
  • "usedByUserAppId": "hanskang_appid",
  • "usedByUserAccount": "hanskang",
  • "code": "5213705",
  • "createdDateTime": "2015-09-22 23:59:59",
  • "expiredDate": "好吃",
  • "usedDateTime": "990",
  • "usedByTicketUid": "0",
  • "usedByProductOrderId": 666,
  • "promotionCouponUid": "660",
  • "promotionCouponName": "5",
  • "promotionCouponAppId": "1",
  • "promotionCouponAccount": "0.1",
  • "promotionCouponStartDate": "0.1",
  • "promotionCouponEndDate": "0.1"
  • }
  • ],
  • "pageSize":"200"
  • }
  • }
  • 字段名 类型 说明
    status String 是否正确处理请求,返回success或error,不区分大小写
    messages String[] 处理结果的消息
    errorCode int 业务处理的错误代码,参见错误代码表
    data Json
    postBackParameter Json 分页查询回传到服务器的参数结构从第二页开始必须回传,如果没传,每次查询都是第一页
    parameterType String 从返回结果中直接取出用于回传,不能变其值
    parameterValue String 从返回结果中直接取出用于回传,不能变其值
    result List
    createdByUserAppId String 创建优惠券号(核销码)用户AppId
    createdByUserAccount String 创建优惠券号(核销码)用户账号
    code String 优惠券号(核销码)
    createdDateTime String 优惠券号(核销码)创建时间,格式为yyyy-MM-dd HH:mm:ss
    expiredDate String 优惠券号(核销码)过期时间,格式为yyyy-MM-dd HH:mm:ss如果为空,以promotionCouponEndDate为准
    usedByUserAppId String 使用优惠券号(核销码)用户AppId
    usedByUserAccount String 使用优惠券号(核销码)用户账号
    usedDateTime String 使用优惠券号(核销码)时间,格式为yyyy-MM-dd HH:mm:ss
    usedByTicketUid String 使用优惠券号(核销码)的流水单据Uid   根据单据uid查询
    usedByProductOrderId int 使用优惠券号(核销码)的订单id   根据id查询订单
    promotionCouponUid Long 优惠券规则Uid
    promotionCouponName String 优惠券规则名称
    promotionCouponAppId Integer 优惠券号(核销码)建议长度
    promotionCouponAccount String 创建优惠券规则用户账号
    promotionCouponStartDate String 优惠券规则-开始时间,格式为yyyy-MM-dd HH:mm:ss
    promotionCouponEndDate String 优惠券规则-结束时间,格式为yyyy-MM-dd HH:mm:ss

    7.分页查询所有促销规则


    接口地址 http://host:port/pospal-api2/openapi/v1/promotionOpenApi/queryPromotionPages
    请求头
  • User-Agent: openApi
  • Content-Type: application/json; charset=utf-8
  • accept-encoding: gzip,deflate
  • time-stamp: 1437528688233
  • data-signature: BF706E6AC693BA3B1BABD32E6713431D
  • 请求方式 POST
    请求体
  • {
  • "postBackParameter": {
  • "parameterType": "abcdef",//从返回结果中直接取出
  • "parameterValue": "abcdef"//从返回结果中直接取出
  • },
  • "appId": "abcdefghijklmn"
  • }
  • 参数名 是否必须 类型 说明
    appId String Pospal配置的访问凭证
    postBackParameter Json Pospal查询首页时可以不传,之后的内容从返回结果中取出
    parameterType String 从返回结果中取出
    parameterValue String 从返回结果中取出
    返回结果
  • {
  • "status": "success",
  • "messages": [],
  • "data": {
  • "postBackParameter":{
  • "parameterType": "LAST_RESULT_MAX_ID",
  • "parameterValue": "68975"
  • },
  • "result": [
  • {
  • "createdByUserAppId": "hanskang_appid",
  • "createUserAccount": "hanskang",
  • "id": 111,
  • "type": "PromotionProductDiscount",
  • "enable": 1,
  • "name": "1",
  • "startDatetime": "2016-10-31 00:00:00",
  • "endDatetime": "2016-10-31 23:59:59",
  • "uid": 1477882098197624800,
  • "forRShop": 1,
  • "forEShop": 1,
  • "promotionCouponUid": 1477882129037301000,
  • "enjoyCustomerDiscount": 0,
  • "forCustomer": 0,
  • "useType": 0
  • }
  • ],
  • "pageSize":100
  • }
  • }
  • 字段名 类型 说明
    status String 是否正确处理请求,返回success或error,不区分大小写
    messages String[] 处理结果的消息
    errorCode int 业务处理的错误代码,参见错误代码表
    pageSize int 本次查询预期从库存取出记录数,如果结果集的长度小于pageSize,不需要进行下一页查询
    postBackParameter Json 分页查询回传到服务器的参数结构,从第二页开始必须回传,如果没传,每次查询都是第一页
    parameterType long 从返回结果中直接取出用于回传,不能变其值
    parameterValue BigDecimal 从返回结果中直接取出用于回传,不能变其值
    result List 促销规则实体列表
    createUserAppId String 创建促销规则的账号对应的AppId
    createUserAccount String 创建促销规则的账号
    id long 促销规则Id
    type String 促销类型
    enable int 是否可用,1可用,0禁用,-1删除
    name String 销售规则名称
    startDatetime String 促销规则开始时间
    endDatetime String 促销规则结束时间
    uid Long 促销规则Uid
    forRShop int 是否实体店可用:1实体店可用,其它不可用
    forEShop int 是否网店可用:1网店可用,其它不可用
    promotionCouponUid Long 促销规则对应的优惠券规则UID
    enjoyCustomerDiscount BigDecimal 会员享受的折扣
    forCustomer int 是否针对会员

    8.使用优惠券号(对核销码进行核销)


    接口地址 http://host:port/pospal-api/api/auth/openapi/promotioncouponcode/use/
    请求头
  • User-Agent: openApi
  • Content-Type: application/json; charset=utf-8
  • accept-encoding: gzip,deflate
  • time-stamp: 1437528688233
  • data-signature: BF706E6AC693BA3B1BABD32E6713431D
  • 请求方式 POST
    请求体
  • {
  • "appId": "abcdefghijklmn",
  • "code": "testCode",
  • "customerUid": 123456789,
  • "useDateTime": "2015-09-22 23:59:59"
  • }
  • }
  • 参数名 是否必须 类型 说明
    appId String Pospal配置的访问凭证
    code String 优惠券号(核销码),长度不能超过50(限英文或数字)
    注:优惠券号(核销码)必须保证每家门店全局唯一。
    customerUid Long 会员Uid,如果有值,说明优惠券号挂到会员上
    useDateTime String 使用时间,默认为服务器时间,格式为yyyy-MM-dd HH:mm:ss
    返回结果
  • {
  • "status": "success",
  • "messages": "",
  • }
  • 字段名 类型 说明
    status String 是否正确处理请求,返回success或error,不区分大小写
    messages String[] 处理结果的消息
    errorCode int 业务处理的错误代码,参见错误代码表