4.1优惠券查询

根据优惠券号查询券的有状态（券号可输入或扫描券二维码获得）

  请求参数说明

参数描述必填示例值类型最大长度
action接口参数组是object
└action需要调用的接口名称是co_checkstring
getGET参数组，本组参数需要参与签名是object
└no券号（no与coid二选一即可）否281898619298number
└getlistgetlist=1返回用户所有券、 getlist=2合并colist模式否1number
└merge必须和getlist一起调用。merge=1，（券类型最多返回500并且券分组展示）否1number
└coid券id（no与coid二选一即可）否81417132number
└coPage优惠券分页查询（ 不传则默认为1:单页固定500条）否1number

 请求示例

{
    "action": {
        "action": "co_check"
    },
    "get": {
        "no": "281898619298",
        "coid": "81417132",
        "getlist": "1",
        "coPage": "1",
        "merge": "1"
    }
}

  响应参数说明

参数描述必填示例值类型最大长度
status返回状态。接口成功时为1，出错为0是1number
info错误时会返回相应的错误信息是okstring
store券可用门店否果盘测试string
name优惠券名称否西瓜--单品券1string
coid券id否26689861number
cono券号否281898619298number
vdate有效期否20190710~20190731string
cash金额（非0为金额券，0为实物券）否0.00number
time券领用时间否2019-07-10 12:42:56string
price券金额（仅在券为团购券是有效。可用于线下处理券相应的实收和折扣部分逻辑）否0.00number
requireamt满XX元可用，用于控制券的使用金额否0number
deid否27694number
subject备注否 限量第5string
mbid平台id否6740019number
accid会员卡id否3812805number
type否1number
choose抵扣方式（单品券抵扣方式 0=按固定金额 1=按菜品金额比例）否1number
chooseval抵扣比例或者金额否100number
entitylist菜品信息否list
└dgid菜品id否4917938number
└name菜品名称否张飞酱牛肉string
└refid菜品外部编码否71008number
colist否list
└store券可用门店否果盘测试string
└name券名称否西瓜--单品券1string
└coid券id否26689866number
└cono券号否28*******723string
└vdate券有效期否20190710~20190731string
└cash金额（非0为金额券，0为实物券）否0.00number
└time券领用时间否2019-07-10 12:43:01string
└price券金额（仅在券为团购券是有效。可用于线下处理券相应的实收和折扣部分逻辑）否0.00number
└requireamt满XX元可用，用于控制券的使用金额否0number
└deid券类型id否27694number
└info券说明是1111111111number
└subject摘要否 限量第8string
└accid会员卡id否3812805number
└type1：单品券 0：现金券否1number
└choose抵扣方式（ 单品券抵扣方式 0=按固定金额 1=按菜品金额比例）否1number
└chooseval抵扣比例或者金额否100number
└entitylist菜品信息否list
└└dgid菜品id否4917938number
└└name券名称否张飞酱牛肉string
└└refid菜品外部编码否71008number
msid门店编号否6786number
tp使用类型：堂吃、外卖 、通用否通用string
maxUseQty单次最大使用张数否3number
src券来源平台（gp=果盘 dy=抖音）否gpstring
└src券来源平台（gp=果盘 dy=抖音）否gpstring

 响应示例

{
    "status": "1",
    "info": "ok",
    "src": "gp",
    "store": "果盘测试",
    "name": "西瓜--单品券1",
    "coid": "26689861",
    "cono": "281898619298",
    "vdate": "20190710~20190731",
    "cash": "0.00",
    "time": "2019-07-10 12:42:56",
    "price": "0.00",
    "requireamt": "0",
    "deid": "27694",
    "subject": " 限量第5",
    "maxUseQty":"3",
    "accid": "3812805",
    "mbid": "5759774",
    "type": "1",
    "choose": "1",
    "tp": "通用",
    "chooseval": "100",
    "entitylist": [
        {
            "dgid": "4917938",
            "name": "张飞酱牛肉",
            "refid": "71008"
        }
    ],
    "colist": [
        {
            "src": "gp",
            "store": "果盘测试",
            "name": "西瓜--单品券1",
            "coid": "26689866",
            "cono": "28*******723",
            "vdate": "20190710~20190731",
            "cash": "0.00",
            "time": "2019-07-10 12:43:01",
            "price": "0.00",
            "requireamt": "0",
            "deid": "27694",
            "info": "1111111111",
            "subject": " 限量第8",
            "accid": "3812805",
            "type": "1",
            "choose": "1",
            "chooseval": "100",
            "entitylist": [
                {
                    "dgid": "4917938",
                    "name": "张飞酱牛肉",
                    "refid": "71008"
                }
            ]
        }
    ],
    "server_timestamp": 1562733881,
    "server_time": "2019-07-10 12:44:41",
    "server_name": "wx-task2.hz",
    "msid": "6786"
}

未增加merge=1时返回

{

  "status": "1",
  "mbno": "47302320",
  "id": "4730232",
  "mbid": "5759774",
  "name": "雪碧",
  "phone": "15606132502",
  "gender": "1",
  "birthday": "20181018",
  "balance": "5795.99",
  "points": "310",
  "bns_balance": "40009.39",
  "subject": "666",
  "state": "1",
  "level": "5",
  "level_name": "钻石卡1",
  "credit": "0",
  "card_no": "90866",
  "card_type": "5",
  "card_name": "1",
  "card_balance": "1.00",
  "type": 0,
  "card_points": "1",
  "pt_ratio": "100:1",
  "ext_info": 666,
  "refId": "1234567890",
  "active": "1",
  "extid": "123456789012312345678",
  "expiry_date": "2019-07-25",
  "src_msid": "6786",
  "mb_right": {
    "recharge": 0,
    "mc_price": 0,
    "rebate": 0,
    "ratio": "",
    "use_pt": 1,
    "consumption": "10",
    "pt": "1",
    "use_reward": 1,
    "mc_consumption": "500",
    "card_createTime": "2021-01-13 16:50:10",
    "renew_list": [
      {
        "amt": "2.00",
        "expire": 12
      }
    ],
    "mc_reward": "1"
  },
"colist": [
    {
      "store": "全部",
      "name": "彭老板的券",
      "coid": "27207625",
      "cono": "28*******395",
      "vdate": "20190723~20190822",
      "cash": "30.00",
      "time": "2019-07-23 16:08:49",
      "price": 0,
      "requireamt": "100",
      "deid": "28200",
      "info": "这是券说明",
      "subject": "赠送",
      "accid": "4730232",
      "type": "0"
    } ],
  "server_timestamp": 1566296953,
  "server_time": "2019-08-20 18:29:13",
  "server_name": "wx-task2.hz",
  "msid": "10021"
}



增加：merge=1时返回
{
  "status": "1",
  "store": "全部",
  "name": "雪碧0730",
  "coid": "81196652",
  "cono": "826966521930",
  "vdate": "20210730~20211023",
  "cash": "10.00",
  "time": "2021-09-23 14:11:29",
  "price": "0.00",
  "requireamt": "0",
  "deid": "66240",
  "info": "1",
  "subject": "",
  "mbid": "5759774",
  "accid": "19020051",
  "type": "0",
  "tp": "通用",
  "count": "16",   （客人全部券数量）
  "qty": "14",     （客人当前返回的可用券数量）
  "colist": [
    {
      "list": {
        "store": "全部",
        "name": "雪碧316",
        "vdate": "20210826~20210925",
        "cash": "10.00",
        "time": "2021-08-26 10:03:35",
        "price": "0.00",
        "requireamt": "200",
        "deid": "58878",
        "info": "11",
        "subject": "商城购买优惠券[1](1000070522)",
        "accid": "19020051",
        "type": "0",
        "tp": "通用"
      },
      "qty": "2"    (当前券类型数量)
    },
    {
      "list": {
        "store": "全部",
        "name": "雪碧0730",
        "vdate": "20210730~20210930",
        "cash": "10.00",
        "time": "2021-08-31 09:53:35",
        "price": "0.00",
        "requireamt": "0",
        "deid": "66240",
        "info": "1",
        "subject": "会员等级升级奖励-1",
        "accid": "19020051",
        "type": "0",
        "tp": "通用"
      },
      "qty": "10"
    },
    {
      "list": {
        "store": "全部",
        "name": "个一样",
        "vdate": "20210831~20210930",
        "cash": "10.00",
        "time": "2021-09-02 16:33:01",
        "price": "0.00",
        "requireamt": "100",
        "deid": "67728",
        "info": "444",
        "subject": "",
        "accid": "19020051",
        "type": "0",
        "tp": "通用"
      },
      "qty": "2"
    }
  ],
  "rpc_time": "608.35ms",
  "rpc_request_time": "14:30:43",
  "rpc_time_consuming": "622.051ms",
  "request_time": "14:30:43.377",
  "server_timestamp": 1632378644,
  "server_time": "2021-09-23 14:30:44",
  "server_name": "wx-task2.hz",
  "duration": "722ms",
  "msid": "10021"

}


当getlist=2时

{
  "status": "1",
  "info": "ok",
  "mbid": "5759774",
  "accid": "9867588",
  "colist": [
    {
      "store": "全部",
      "name": "10元券",
      "coid": "186300150261",
      "cono": "18***********992",
      "vdate": "20240604~20240604",
      "cash": "10.00",
      "time": "2024-06-04 17:46:21",
      "price": "0.00",
      "requireamt": "0",
      "deid": "105061",
      "info": "",
      "subject": "",
      "accid": "9867588",
      "type": "0",
      "tp": "通用",
      "userScene": "全部"
    },
    {
      "store": "全部",
      "name": "10元券",
      "coid": "186300150262",
      "cono": "18***********830",
      "vdate": "20240604~20240604",
      "cash": "10.00",
      "time": "2024-06-04 17:46:22",
      "price": "0.00",
      "requireamt": "0",
      "deid": "105061",
      "info": "",
      "subject": "",
      "accid": "9867588",
      "type": "0",
      "tp": "通用",
      "userScene": "全部"
    }
  ],
  "server_timestamp": 1717494393,
  "server_time": "2024-06-04 17:46:33",
  "server_name": "nx-202.hz",
  "duration": "340ms",
  "env": "online",
  "request_time": "17:46:32.743",
  "msid": "20243"
}