Skip to main content

电子券核销查询接口

基本信息

接口名称:电子券核销查询接口状  态:已完成
接口路径:POST /paas/micro/ecoupon/query-verifyQuery更新时间:2022-08-20 00:36:27
Mock地址:https://apimock.e-buychina.com/mock/617/paas/micro/ecoupon/query-verifyQuery

请求参数

Headers:

参数名称参数值是否必填
Content-Typeapplication/json

Body:

参数名称类型必填默认值备注其他信息
uuidstring请求序列最大长度:50
最小长度:1
Mock:@now('yyyyMMdd')-@string('lower',32)
appIdstring请求APPID最大长度:50
最小长度:1
Mock:@natural
actionstring交易类型最大长度:50
最小长度:1
Mock:verifyQuery
timestampnumber时间戳Mock:@timestamp
signTypestring签名类型最大长度:20
最小长度:1
Mock:sha256
signstring签名值最大长度:500
最小长度:1
Mock:@natural
langstring语言Mock:zh_CN
contentobject请求报文
  originalUuidstring原始请求流水号最大长度:64
最小长度:10
Mock:@now('yyyyMMdd')-@string('lower',32)
  codesarray查询code列表,为空查询原是核销的所有code

返回数据

参数名称类型必填默认值备注其他信息
uuidstringuuid最大长度:50
最小长度:1
Mock:makeEcoupon
appIdnumber请求APPIDMock:@timestamp
successstring交易是否成功最大长度:50
Mock:@word
actionstring交易类型最大长度:50
Mock:@csentence
timestampnumber返回时间戳
errorCodestring错误码最大长度:500
Mock:@natural
errorMessagestring错误信息
signTypestring签名类型
signstring签名值
contentobject返回报文
  verifyCodeResultListarray
    makeOrderIdstring订单号
    faceValuenumber面值
    codestring码号
    ticketIdinteger批次号
    ticketNamestring批次名称
    ticketTypestring批次类型
    ticketRemarksstring批次备注
    ticketProductIdinteger产品号
    thirdSendTicketIdstring制码批次Id
    returnCashParamstring拓展字段
    thirdActivityIdstring第三方活动Id
    totalUseTimesinteger总共可使用次数
    remainUseTimesstring剩余可使用次数
    printDatastring此值仅在易百POS上核销时需要用到
    goodsListarray折抵商品列表
      skustringsku
      qtystringqty
      pricestring价格单位分
      typestring品类
      specstring规格
      rebateCodestring折扣
      reduceAmountstring折抵金额
      goodsTagstring返回产品明细标记
    fundsChannelobject资金渠道
      totalAmountnumber总金额
      userRealAmountnumber用户实付金额
      merchantRealAmountnumber用户实收金额
      discountAmountnumber折抵金额
      channelBenefitnumber渠道优惠
      merchantBenefitnumber商户优惠
      benefitAmountnumber总优惠金额
      merchantCustomRealAmountnumber商户指定实付
      merchantCustomBenefitnumber商户指定优惠
    fineGrainedLimitobject最细粒度限量规则
      grainedKeystring
      limitMaxValueinteger
      currentinteger
    userInfoobject用户信息
      mobilestring
      thirdPlatformTypestring
      thirdUserIdstring
    remarksstring
    verifyStatusstring
    errorMessagestring

备注

  1. ticketId为券批次号,由券系统提供给销售渠道。销售渠道再根据其顾客选购商品上传正确的批次号。
  2. commissionDate = -1时,所制串码的状态为“03:未激活”。销售渠道拿到该串码后,择机调用激活接口将串码状态变更为“00:初始状态”。
  3. 相对有效期和绝对有效期,只可择其一上送,若二者均上送,以绝对有效期优先。
  4. 选择上传相对有效期时,可以选择上送commissionDate,若未上送则commissionDate字段系统默认为0。commissionDate = 0表示当日生效,commissionDate = 1表示次日生效,以此类推。
  5. 商户授权时,若未填写销售价,则制码时资金渠道必填。并且在核销串码时,将制码资金渠道中商户实收金额作为净值下发给收银机。

变更历史

变更日期变更内容
2021-12-15
2021-12-02
2021-12-02
2021-11-30
2021-11-30
2021-11-30
2021-11-30
2021-11-30
2021-11-30
2021-11-30
2021-11-18
api-id=34137