商品库存及价格查询

该接口用于已知票档后,同步最新的售价、库存等,该接口为批量接口。

GET /openapi/v2/tickets/batchDetails{?ids,sign,appId,timeStamp}

参数 :

name 意义 取值
sign 签名 483DFD2E8BE0AF2D486F04C7320C7C5E
appId 代理商的唯一id 1
timeStamp 时间戳 有效期10分钟 1482995969920
ids 票档id ,通过 "," 分割,不超过100个 119877,119878
请求示例(测试环境):
   curl 'http://openapi.beta.piaoniu.com/openapi/v2/tickets/batchDetails?ids=207355,207356&sign=1B36ED676EFB0133EC42E8303E8C6DEF&appId=10000&timeStamp=1489756931881'

返回值 :

name 意义
ticketGroupId 商品id
ticketCategoryId 票档id
salePrice 商品售价 (单张售价,非组合报价使用此价格,总价格为salePrice*张数)
selling 在售数量
priceList (购买多张时的组合报价,组合报价的说明加本页末尾)

组合报价 :

组合报价是一种特殊的报价形式,它会对购买同一商品的不同数量时给出不同价格。 在票牛的业务场景中,会存在这样的形式,例如:

  1. 如果有多个商家,一些商家价格有优势,一些商家库存有优势,那么会在选择不同库存时可能会给出不同商家的报价
  2. 商家设置了补贴,购买多张时价格会更低

组合报价可以有效提高库存的丰富度。接入方可以选择开启或者关闭组合报价。未开启组合报价时,将不会返回priceList字段。 开启后,需要在用户下单并选择数量后,传入对应数量的金额。例如下例中,用户购买207355票档4张,那么需要选择priceList[181,362,543,760,950]中的第4个报价,即760传入。

示例:
    [
        {
            "ticketCategoryId":207355,
            "ticketGroupId":97977,
            "salePrice":181,
            "isPremium":1,//1 溢价,2 平价,3 折扣
            "premiumPrice":2,//表示票档溢价部分的价格,默认0
            "selling":5,
            "priceList":[
              181,362,543,760,950
            ]
        },
        {
            "ticketCategoryId":207356,
            "ticketGroupId":97978,
            "eticketProvider":1, //1 :票牛方发券,2:供应商发券
            "salePrice":281,
            "isPremium":1,//1 溢价,2 平价,3 折扣
            "premiumPrice":2,//表示票档溢价部分的价格,默认0
            "selling":3,
            "priceList":[
              281,562,843
            ]
        }
    ]

变更历史

name 时间 内容
v1.1 2019-10-25 渠道定制字段

results matching ""

    No results matching ""