# 撤销用户已核销团购优惠

-用户核销成功后、资金结算前可撤销核销，撤销时如券仍在有效期内，券变为【待使用】用户可再次使用；如撤销时券已过有效期，券变为【已过期】，触发过期自动退款； -核销成功后，如资金已结算，不支持撤销核销； -核销成功后，到达资金结算时间点，平台将自动发起分账，按照技术服务费率、佣金率等计算并分账至对应账户；

如撤销时接口返回“存在券无法执行此操作”失败，表明券为锁定状态（通常为核销处理中）。商家遇此情况可间隔1秒重试一次。如多次重试仍失败，则需要查询券信息、判断券状态是否符合撤销核销条件（券状态为已核销，如已核销仍不能撤销成功，则可能过了资金结算时间点）。

# 接口调用请求说明

单商户限频200QPS

http请求方式：POST
https://api.weixin.qq.com/channels/ec/voucher/revoke?access_token=xxxxxxxxx

# 请求参数示例

// 示例：加密code模式
{
   "revoke_request_no": "233244dfgfdfgsdfgsdf",
   "reovke_vouchers": [
       {
           "encrypted_code":"223dfsdf"
       },
       {
           "encrypted_code":"3445gffgh"
       }
    ]
}

// 示例：非加密code模式
{
   "revoke_request_no": "233244dfgfdfgsdfgsdf",
   "reovke_vouchers": [
       {
           "code":"123412",
           "sku_id":"fdsfdf"
       },
       {
           "code":"2235",
           "sku_id": "fdsfdf",
           "cancel_count":1
        }
    ]
}

# 回包示例

{
   "errcode": 0,
   "errmsg": "成功",
   "voucher_list":[
   {
     "code":"232323",
     "status": 1,
     "send_time": 1699856182,
     "update_time": 1699856182,
     "start_time": 1699856182,
     "end_time": 1699856182,
     "consume_time": 1699856182,
     "refund_time": 1699856182,
     "product_id":  "kbfff",
     "consume_store_name": "xxx旗舰店",
     "voucher_type": 1,
     "voucher_buy_amount": 0,
     "voucher_actual_amount": 0,
     "telphone_no": "fasdf343df34545",
     "openid": "xsdfs4534543534534",
     "code_type": 1,
     "order_id": "23434sdfsdf34342",
     "sku_id": "fdsfdf"
   },
   {
     "code":"23232323",
     "status": 1,
     "send_time": 1699856182,
     "update_time": 1699856182,
     "start_time": 1699856182,
     "end_time": 1699856182,
     "consume_time": 1699856182,
     "refund_time": 1699856182,
     "product_id":  "kbfff",
     "consume_store_name": "xxx旗舰店",
     "voucher_type": 1,
     "voucher_buy_amount": 0,
     "voucher_actual_amount": 0,
     "telphone_no": "fasdf343df34545",
     "openid": "xsdfs4534543534534",
     "code_type": 1,
     "order_id": "23434sdfsdf34342",
     "sku_id": "fdsfdf"
   },
   {
     "code":"32434454545",
     "status": 1,
     "send_time": 1699856182,
     "update_time": 1699856182,
     "start_time": 1699856182,
     "end_time": 1699856182,
     "consume_time": 1699856182,
     "refund_time": 1699856182,
     "product_id":  "kbfff",
     "consume_store_name": "xxx旗舰店",
     "voucher_type": 1,
     "voucher_buy_amount": 0,
     "voucher_actual_amount": 0,
     "telphone_no": "fasdf343df34545",
     "openid": "xsdfs4534543534534",
     "code_type": 1,
     "order_id": "23434sdfsdf34342",
     "sku_id": "fdsfdf"
   }
   ]
}

# 请求参数说明

参数名	类型	是否必填	说明
revoke_request_no	string	必填	撤销操作幂等串，商户自定义，请保证在小店下唯一
reovke_vouchers	Array <RevokeVoucher >	必填	待撤回核销的券列表，最多10张，需要属于同一个订单，不能为空。对于次卡类型商品，如果传多个相同的ReovkeVoucher，代表撤销多次。撤销核销多次/多张同时成功或同时失败，不会部分成功。
consume_request_no	string	选填	撤销核销次卡时必须要传此字段，说明撤销的核销单号。

# 回包参数说明

参数名	类型	是否必填	说明
errcode	number	必填	错误码
errmsg	string	必填	错误信息
voucher_list	Array<Voucher>	选填	用户券详情
fail_voucher_list	Array<OperateFailVoucher>	选填	无法操作的券，在明确有券无法核销时返回，含无法核销原因