4.2优惠券核销

本接口用于核销指定的优惠券，可批量核销

  请求参数说明

参数描述必填示例值类型最大长度
action接口参数组是object
└action需要调用的接口名称是co_cutstring
getGET参数组，本组参数需要参与签名是object
└no券号否281898619298number
└lsco批量核券id（多个券id逗号分隔。券id取自协议4.1中返回的coid）否1number
└bn业务单号否201908170001number
└op操作员否王五string
postPOST参数组是object
└pylsco否list
└└coid菜品券id（coid与no二选一）否26308703number
└└no菜品券号（coid与no二选一）否28*******722string
└└dgid线下菜品编号（菜品券必传）否4917938number
└└cutamt 菜品金额（菜品券必传）否0.01number

 请求示例

{
    "action": {
        "action": "co_cut"
    },
    "get": {
        "no": "281898619298",
        "lsco": "1",
        "bn": "201908170001",
        "op": "王五"
    },
    "post": {
        "pylsco": [
            {
                "coid": "26308703",
                "no": "28*******722",
                "dgid": "4917938",
                "cutamt": "0.01"
            },
            {
                "coid": "26689866",
                "no": "28*******723",
                "dgid": "4917938",
                "cutamt": "0.01"
            }
        ]
    }
}

  响应参数说明

参数描述必填示例值类型最大长度
status返回状态。接口成功时为1，出错为0是1number
info错误时会返回相应的错误信息是优惠券使用成功string
cash金额（非0为金额券，0为实物券）否100number
price券金额（仅在券为团购券是有效。可用于线下处理券相应的实收和折扣部分逻辑）否88number
codId核销记录明细ID否18600000499566number
eventId否coupon-1729157697984string
mbid平台id否5759774number
cono券号否1863001626493489number
coid券id否186300162649number
subject券摘要否string
result否object
└status返回状态。接口成功时为1 其他为错误是1number
└errcount否0number
└colist否list
└└status返回状态。接口成功时为1 其他为错误是1number
└└info错误时会返回相应的错误信息是券使用成功string
└└codId核销记录明细ID否18600000499567number
└└eventId否coupon-1729157698195string
└└mbid平台id否5759774number
└└cash金额（非0为金额券，0为实物券）否0number
└└cono券号否1863001626480778number
└└price券金额（仅在券为团购券是有效。可用于线下处理券相应的实收和折扣部分逻辑）否0.00number
└└coid券id否186300162648number
└└subject券摘要否string
duration接口耗时否706msstring
env服务器地址否betastring
request_time服务器时间否17:34:57.727string
msid门店编号否20243number

 响应示例

{
  "status": "1",
  "info": "券使用成功",
  "codId": "18600000499566",
  "eventId": "coupon-1729157697984",
  "mbid": "5759774",
  "cash": "10.00",
  "cono": "1863001626493489",
  "price": "0.00",
  "coid": "186300162649",
  "subject": "",
  "result": {
    "status": 1,
    "errcount": 0,
    "colist": [
      {
        "status": 1,
        "info": "券使用成功",
        "codId": "18600000499567",
        "eventId": "coupon-1729157698195",
        "mbid": "5759774",
        "cash": 0,
        "cono": "1863001626480778",
        "price": "0.00",
        "coid": "186300162648",
        "subject": ""
      }
    ]
  },
  "server_timestamp": 1729157698,
  "server_time": "2024-10-17 17:34:58",
  "server_name": "nx-217.hz",
  "duration": "706ms",
  "env": "beta",
  "request_time": "17:34:57.727",
  "msid": "20243"
}

新增调用方式：按优惠券类型核销

{

    "action": {
        "action": "co_cut"
    },
    "get": {
        "deid": "券id",（4.1和5.1查询获取）

        "mbid": "微卡平台id",（当使用deid时必传，5.1接口查询获取  mbid和accid二选一使用即可）

        "accid": "会员卡id",（当使用deid时必传，5.1接口查询获取  mbid和accid二选一使用即可）

        "dgid": "46322",（当deid为菜品券时必传，菜品id）

        "qty": "1",  (qty数量不传为默认核销全部，核销券数量)

        "cutamt": "100"（当deid为菜品券时必传，菜品金额）
    }
}