跳转到内容

商品-获取商品详情

POST /app/localLife/storage/product/detail
字段 名称 类型 是否必须
id 商品ID uint 是
字段 名称
code 0为成功其余都是失败
data array
msg 提示语

product

Gallery

Packages

Stores

Purchase

Expire

UnavailableDate

Consume

BuyLimitRule

BookingRule

UsageSheetRule

UsagePeopleRule

UsageDescribes

Settle

开启按日期/场次售卖后,商品详情会额外返回日期、场次、票种和价格库存规则字段。完整口径见:日期/场次/票种对接说明。

字段类型说明
date_session_enabledint是否开启按日期/场次售卖,0关闭,1开启
travel_date_startstring可选择出行日期开始,格式 YYYY-MM-DD
travel_date_endstring可选择出行日期结束,格式 YYYY-MM-DD
advance_booking_daysint最多提前预订天数,0仅当天,1最多提前1天
same_day_deadlinestring出行当日最晚预订时间,格式 HH:mm
session_enabledint是否启用场次,0仅日期,1日期+场次
traveler_info_typeint出行人信息类型,1非实名,2实名
skusarray票种列表,下单传 sku_id
sessionsarray场次列表,开启场次后下单传 session_id
session_ticketsarray场次与票种关系,包含该场次票种平日/节假日价格和每日库存
date_session_sku_rulesarray日期+场次模式下具体出行日期的价格与库存规则,每条记录都会带 travel_date

skus 保存票种自身平日价格和节假日价格字段。开启场次后,场次票种的平日/节假日价格以 session_tickets 为准。

date_session_sku_rules 不是所有商品必有。未开启按日期/场次售卖的商品仍按 SKU 基础价处理;开启后后台保存会按出行日期生成对应规则。未启用场次时按 travel_date + sku_id 使用票种每日库存;启用场次时按 travel_date + session_id + sku_id 使用场次票种每日库存。该字段不返回空 travel_date 的基础模板;场次票种基础关系、模板价格与默认库存配置请以 session_tickets 为准。

场次本身不再返回库存模式和库存。开启按日期/场次售卖且启用场次后,每个“场次+票种”都必须单独维护每日库存;stock_mode 字段仅作兼容保留,场次票种固定按 2 处理。

{
"code": 0,
"data": {
"product": {
"id": 2,
"created_at": 1723195825,
"updated_at": 1724145768,
"brand_id": 3,
"category1_id": 1,
"category2_id": 2,
"category3_id": 3,
"product_type": 1,
"usage": 1,
"title": "啦啦啦",
"price": 1002,
"origin_price": 1000,
"cost_price": 900,
"guide_price": 1001,
"image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01mBynvU224joZ4lmWd_!!3172677067-0-cib.jpg",
"gallery": [
{
"type": 1,
"src": "https://cbu01.alicdn.com/img/ibank/O1CN01mBynvU224joZ4lmWd_!!3172677067-0-cib.jpg"
},
{
"type": 1,
"src": "https://cbu01.alicdn.com/img/ibank/O1CN01mBynvU224joZ4lmWd_!!3172677067-0-cib.jpg"
}
],
"stock_type": 1,
"stock": 0,
"sale_at_start": "2024-08-21 00:00:00",
"sale_at_end": "2024-08-31 23:59:59",
"shop_type": 2,
"detail_images": "水电费十多个讽德诵功",
"is_display": 1,
"packages": null,
"stores": [
{
"id": 1,
"created_at": 1723195825,
"updated_at": 1723195825,
"product_id": 2,
"store_id": 1,
"store_name": ""
}
],
"purchase": {
"id": 1,
"created_at": 1723195825,
"updated_at": 1723195825,
"product_id": 2,
"need_mobile": 1,
"expire": {
"type": 1,
"days": 10,
"at": ""
},
"unavailable_date": {
"weekly": {
"selected": 1,
"weekdays": [
"Sunday",
"Monday"
]
},
"holidays": {
"selected": 1
},
"specified": {
"selected": 1,
"dates": null
}
},
"consume": {
"type": 2,
"times": null
},
"buy_limit_rule": {
"limited": 0,
"num": 0
},
"booking_rule": {
"need_booking": 0,
"advance_num": 0,
"advance_unit": 0
},
"with_discount": 0,
"usage_sheet_rule": {
"unlimited": 0,
"num": 0
},
"usage_people_rule": {
"unlimited": 0,
"num": 0
},
"usage_describes": null
},
"settle": {
"id": 1,
"created_at": 1723195825,
"updated_at": 1723195825,
"product_id": 2,
"independent": 2,
"store_rate": 100,
"ratio": 0
}
}
},
"msg": "操作成功"
}