属性名
| 属性key
| 示例值
| 说明
|
库存
| limit_stock_rule
| { "limit": "1", "num": "10", "unit": "份" }
| 1limit、num、unit 使用字符串格式。 2limit="1" 时限制库存,需要填写 num 限制数量;limit="0" 时不限制库存,不要填写 num 限制数量。
|
商品详情图
| description_image
| { "url_list":[ "url1", "url2" ] }
| 1商品详情图的文件 id 列表。图片支持 jpg、jpeg、png 格式,宽度及宽高比为 1:1 ,750px*750px。文件 id 通过 alipay.marketing.image.enhance.upload(营销图片优化上传接口)上传资源获取。
|
原价设置方式
| original_price_source
| "0"/"1"
| 该字段与 commodity 搭配使用,控制 commodity.price 字段是否需要指定: ●"1":默认值,需设置单品原价,commodity.price 必须指定值。商品创建和修改时系统根据 commodity.price 自动计算替换 sku.original_price 商品原价字段。 ●"0":无需设置单品原价,commodity.price 为空。商品创建和修改时,必须设置 sku.original_price 商品原价字段。
|
套餐搭配
| commodity
| [ { "group_name": "商品组名", "total_count": 5, "option_count": 3, "item_list": [ { "name": "单品名称", "count": 1, "count_unit":"份", "price": 10050, "unit": "元" } ] } ]
| 1commodity 列表中每一个结构都代表一个商品组。 2每个商品组中都包含 group_name 商品组名、total_count 总数、option_count 选几以及 item_list 可选单品列表。 3item_list 中每一个结构都代表一个可选单品。 4每个 item_list 可选单品列表中都包含 name 单品名称、count 份数、count_unit 份数单位、price 价格以及 unit 价格单位。 5price 价格以分为单位,并且具体数值大小由 unit 指定,如 price=10050 且 unit ="元"时,最终价格为 100.5 元。price 是否填写与 original_price_source关联。
|
使用说明
| notification
| “请输入使用规则,注意该信息需与商品信息、售卖/使用信息保持前后一致,避免顾客理解错误而引起不必要的纠纷。”
| 1请使用字符串格式。 2长度限制 2000 字符。
|
可使用门店
| use_shop
| [ { "shop_id":"shop1" }, { "shop_id":"shop2" } ]
| 1shop_id 可使用门店id请使用字符串格式,shop_id 获取参见 门店管理介绍。
|
是否全选门店
| select_all_shop
| "0"/"1"
| 该字段与 use_shop 搭配使用: "0":默认值,use_shop 需传入可使用门店列表。 "1":全选门店,将一键绑定 pid 下全部门店。
|
不可用门店
| exclude_shop_list
| [ { "shop_id":"shop1" }, { "shop_id":"shop2" } ]
| 该字段与 select_all_shop 搭配使用,仅在全选门店时生效: select_all_shop 值: "0":部分选门店,默认 exclude_shop_list 列表为空; "1":全选门店,生效门店中,将排除 exclude_shop_list 列表中门店。
|
可使用日期
| use_date
| { "use_date_type":"1", "day_duration":"xx", "is_next_day": "1", "use_start_date":"yyyy-mm-dd", "use_end_date":"yyyy-mm-dd" }
| 1use_date_type、day_duration、use_start_date、use_end_date 请使用字符串格式。 2use_date_type"1" 代表指定日期,"2" 代表指定天数 3use_start_date 与 use_end_date 的粒度为天,如“2023-05-01”。 4use_date_type 为"1"时,需指定开始日期 use_start_date 和结束日期 use_end_date。 5use_date_type 为"2"时,需指定有效天数 day_duration,如"90"。 6可使用日期的开始时间不能早于售卖开始时间(sold_time)。 7is_next_day 为 null 代表当日起;is_next_day 为 "1" 代表次日起,use_date_type=2 时有效。
|
时间限制
| use_limit
| { "use_time_type":"1", "use_date_list":[ { "days_of_week":[ "1", "7", ], "start_time":"hh:mm:ss", "end_time":"hh:mm:ss", "end_time_type":"same_day" } ], "can_no_use_date_list":[ { "holidays":[ { "start_time":"hh:mm:ss", "end_time":"hh:mm:ss", "end_time_type":"same_day" } ], "date_list":[ { "start_date":"yyyy-mm-dd", "end_date":"yyyy-mm-dd", "start_time":"hh:mm:ss", "end_time":"hh:mm:ss", "end_time_type":"same_day" } ] } ] }
| 1use_time_type 请使用字符串格式,"1"代表任意时间可用, "2"代表指定时间可用。 2use_date_list 代表可用日期范围,周一~周日对应字符串"1"-"7",end_time_type 指定截止类型为当日或次日,语义示例:周一和周日的 07:00-18:00 (当日)可用。 3截止时间类型 end_time_type 中"same_day"代表开始时间与结束时间在同一天内,"next_day" 代表结束时间在开始时间的第二天。 4can_no_use_date_list 指定不可用日期范围。holidays:指定法定节假日不可用时段,如法定节假日10:00-16:00不可用。date_list:指定日期时间段不可用,如 2023-05-01 12:00 到 2023-05-01 18:00 不可用。 5当指定可使用日期(use_date)类型为“1”时,需保证 can_no_use_date_list 不可用日期范围在可使用日期范围内。
|
每人限购
| limit_buy_rule
| { "limit":"1", "num":"10", "is_day_limit":"1" }
| 1limit 、is_day_limit 、num 请使用字符串格式。 2limit="1" 代表设置每人限购,limit="0" 代表不设置每人限购。 3limit 指定为"0"不限制时,num 不允许指定。 4is_daly_limit 为 "null" 时代表 累计限制 ;is_daly_limit 为 "1" 时 代表 每日限制。
|
退款规则
| refund_rule
| { "refund_policy": ["6"], "conditional_refund_rule": [{ "day_start": 5, "day_end": 10, "percent": 50 }, { "day_start": 4, "day_end": 2, "percent": 30 }] }
| 1. refund_policy 请使用字符串列表格式。 2. refund_policy 取值范围: ●"1":"随时可退"; ●"2":"过期未核销自动退"; ●"3":"未核销可退"; ●"4":"不可退"; ●"5":" "阶梯退"; ●"6":"自定义"; ●"7":"过期未核销自动延期退"。 3. 针对票务商品,退款规则 refund_policy 中单传 "6" 代表自定义。 4. conditional_refund_rule 可空,仅 refund_policy 包含 "6" 时有效。场次开始前 n1 天-n2 天可退 x%。列表不传或规则未覆盖则默认全额退。 5.注意:
目前退款规则(refund_policy)中 "1" 和 "2" 必须同时传,其他都是单独传;例如,"refund_policy": ["1","2"]
|
由商家确认退款
| merchant_refund_confirm
| "1"
| 1请使用字符串格式。 2"1"代表退款需商家确认,"2"代表退款无需商家确认。 3医疗行业只支持 "2",代表退款无需商家确认。
|
使用方式
| usage_type
| { "usage_list":[ { "use_type":"1" }, { "use_type":"2", "use_path":"alipays url1" } ] }
| 1use_type 请使用字符串格式。 2使用方式 use_type 中"1"代表到店亮码,"2"代表小程序内使用。 3use_path:以alipays 开头,use_type=2 时,需要附带使用链接。
|
核销方式
| verify_type
| ["1","2"]
| 1请使用字符串列表格式。 2"1"代表商家用支付宝 pos 小程序验证核销,"2"代表商家用自有方式核销。
|
券码生成方式
| code_source_type
| "2"
| 1请使用字符串格式。 2"1"代表三方码核销(商家码核销), "2"代表一方码核销(支付宝码核销)。 3券码生成方式 code_source_type 默认为"2"。
|
收款方式
| settle_type
| { "settle_type":"1", "settle_pid_info":"xxxxx" }
| 1settle_type 请使用字符串格式。 2收款方式 settle_type 中"1"代表统一收款类型,"2"代表分店收款类型。 3若商户在商家平台/服务商平台入驻环节已设置统一收款账户,且指定统一收款方式(settle_type="1")时,统一收款账号 settle_pid_info 可不传。否则均需传入 settle_pid_info,且该账号做为统一收款账号。
|
预约规则
| preorder_rule
| { "need_appointment": true, "appointment_instruction": "预约说明:请至少提前一天预约。" }
| 1need_appointment 请使用 boolean 格式。 2 //true-需预约,false-无需预约。 3仅当 need_appointment 为 true 时需要填写 appointment_instruction 预约说明。
|
顾客信息设置
| contact_info_type
| "1"
| 1请使用字符串格式。 2 "1"代表需要顾客手机号,"2"代表不需要顾客手机号。
|
结算规则
| order_settle_rule
| { "order_settle_rule": "1" }
| 1order_settle_rule 值请使用字符串格式。 2默认"1",表示需凭证核销后结算。
|
详细描述富文本
| detail_rich_desc
| { "type":"1", "content":"夏日阳光早餐 " }
| 1type="1" 表示富文本格式,content 支持富文本格式,当前 content 字段整体长度限制为 3000 字符。 2当该字段与商品详情图(description_image)同时存在时,默认忽略详情图保留富文本。
|
购买优惠限制
| coupon_usage_rule
| "1" / "2"
| 1请使用字符串格式。 2枚举值:
"1":不可使用商家优惠券(默认值)
"2":可使用商家优惠券
|
商家核销工具
| verify_tool
| "pos机"
| 1请使用字符串格式,文本长度限制为 0-12 字符。
|
售卖类型
| rp_type
| "1"
| 1请使用字符串格式。 2 "1" 代表全日房。
|
早餐份数
| breakfast_num
| "1"
| 1请使用字符串格式。 2 "0":代表无早;
"1":代表单早;
"2":代表双早。
|
支付类型
| payment_type
| "1"
| 1请使用字符串格式。 2"1":代表预付;
"2":代表现付。
|
阶梯退规则
| stage_refund_info
| [{ "day": "0", "hour": "18", "fee_percent": "10" }]
| 1day、hour、fee_percent 请使用字符串格式。 2阶梯退规则明细,代表入住前 day 天的 hour 点,收取手续费 fee_percent%。 3仅当 refund_rule=5 时有效,day 前几天(0-30),hour 前几小时(0-24),fee_percent 手续费,格式为百分比(0%-99%)。
|
入住人数
| occupancy
| "1"
| 1请使用字符串格式。
|
是否立即确认
| instant_confirm
| "1"
| 1请使用字符串格式。 2"1":代表立即确认,"2":代表无需立即确认。
|
最小连住天数
| mini_lengthofstay
| "1"
| 1请使用字符串格式。
|
最大连住天数
| max_lengthofstay
| "7"
| 1请使用字符串格式。
|
导购标签
| selling_point_tag
| ["包邮"]
| 1请使用字符串列表格式。
|
最小提前预订小时
| min_adv_hours
| "24"
| 1请使用字符串格式。 2按入住时间的 23:59:59(一般认为 24 点) 来计算。
|
最大提前预订小时
| max_adv_hours
| "24"
| 1请使用字符串格式。 2按入住时间的 23:59:59(一般认为 24 点)来计算。
|
可用次数
| consumption_times
| "10"
| 1请使用字符串格式。
|
次序价
| stage_price
| { "stage_price_list": [ { "seq_no": "1", "sale_price": 10 }, { "seq_no": "2", "sale_price": 20 }, { "seq_no": "3", "sale_price": 30 } ] }
| 1次序价的序列号(seq_no)必须为整数。 2次序价的序列号(seq_no)必须大于 0。 3次序价的序列号(seq_no)必须是连续的。 4次序价的原价(original_price)必须大于 0。 5次序价的售价(sale_price)必须大于 0。 6次序价的售价(sale_price)不能大于原价(original_price)。 7次序价的最大数量(stage_price_list)不能超过 30。
|
线路游景点
| tour_scenic
| [ { "scenic_poi_id":"点位id", "scenic_id":"景区id", "scenic_name":"景区名称" },
{ "scenic_poi_id":"点位id", "scenic_id":"景区id", "scenic_name":"景区名称" } ]
| 1支付宝景区 id,最多 50 个。 2poiid 需门店侧校验,景区名称及景区 id 仅作存储,不校验景区 id、景区名称 及 poiid 关联关系。
|
资源确认类型
| confirm_type
| "1"
| 1请使用字符串格式。 2"1":即时确认,"2":二次确认。
|
跟团类型
| line_type
| "1"
| 1请使用字符串格式。 2"0":跟团游,"1":自由行。
|
最小成团人数
| min_group_size
| "1"
| 1请使用字符串格式。
|
最大成团人数
| max_group_size
| "10"
| 1请使用字符串格式。
|
参团线路类型
| route_type
| "0"
| 1请使用字符串格式。 2"0":目的地参团,"1":出发地参团。
|
始发地
| from_location
| [ "城市码1",
"城市码2" ]
| 1最多支持 100 个 lbs 地市级城市编码。
|
目的地
| to_locations
| [ "城市码1",
"城市码2" ]
| 1最多支持 30 个 lbs 地市级城市编码。
|
买家预定须知
| order_info
| "买家预定须知"
| 1<1500 个中文字符。
|
自费项目
| self_explanation
| "自费项目"
| 1<1500 个中文字符。
|
费用包含
| fee_include
| "费用包含"
| 1<1500 个中文字符。
|
费用不含
| fee_exclude
| "费用不含"
| 1<1500 个中文字符。
|
起订人数
| min_order_quantity
| "2"
| 1请使用字符串格式。
|
最低参团年龄
| min_age
| "10"
| 1请使用字符串格式。
|
购物信息
| pure_play
| "1"
| 1请使用字符串格式。 2"0":纯玩团,"1":含购物团-默认。
|
行程天数
| trip_days
| "5"
| 1请使用字符串格式。
|
行程晚数
| accom_nights
| "5"
| 1请使用字符串格式。
|
包含服务
| services_included
| ["0","1","2","3","4"]
| 1请使用字符串格式。 20:导游服务
1:免费接送机
2:赠送保险
3:独立成团
4:无购物
|
奢华酒店晚数
| luxury_hotel_num
| "3"
| 1请使用字符串格式。
|
高端酒店晚数
| upscalue_hotel
| "3"
| 1请使用字符串格式。
|
经济酒店晚数
| economic_hotel
| "3"
| 1请使用字符串格式。
|
包含早餐数量
| breakfast_num_include
| "3"
| 1请使用字符串格式。
|
包含正餐数量
| dinner_num
| "3"
| 1请使用字符串格式。
|
自理餐数量
| self_catering_meal
| "3"
| 1请使用字符串格式。
|
行程信息
| trip_element_list
| [{ "day": "第n天", "citycodelist": "包含城市编码列表json串", "type": "住宿", "tripdesc": { "hotelname": "酒店名称", "desc": "描述" } }, { "day": "第n天", "citycodelist": "包含城市编码列表json串", "type": "景点", "tripdesc": { "scenicnamelist": "景点名称数组json串", "sceniccitylist": "景点所在城市编码数组json串", "classicscenic": "是否经典景点", "desc": "景点描述" } } ]
| 1请使用字符串格式。 2天数序号:必填
包含城市:必填
行程类型:必填 3type 枚举值如下:
住宿:accommodation
景点:scenic
餐饮:catering
购物:shopping
自由活动:freetime
|
去程交通信息
| go_traffic_info
| { "transportway": 1, "group": 2, "nonstop": true, "trafficdesc": "交通说明", "departuretime": "10:00", "arrivaltime": "12:00", "planetype": "a330-700", "vendor": "海南航空", "trafficnumber": "hu8619", "stopcity": "guangzhou", "redeyeflight": "false" }
| 1请使用字符串格式。 2交通方式 transportwaylist 不能为空。 3transportwaylist 交通方式,可能的值范围如下: ○飞机:"1" ○火车:"2" ○汽车:"3" ○轮船:"4" ○不包含:"5" 4nonstop、planetype、vendor、trafficnumber、redeyeflight 在 transportwaylist 包含飞机("1")时必填,在 ransportwaylist 不含飞机("1")时不能填,传空或不传。 5出发时间和到达时间格式:00:00~23:59。 6交通分组 group 必须在 1~99999 之间。 7redeyeflight 为字符串 "true" 或 "false"。
"true”:是跨夜航班
“false”:不是跨夜航班
|
返程交通信息
| return_traffic_info
| { "transportway": 1, "group": 2, "nonstop": true, "trafficdesc": "交通说明", "departuretime": "10:00", "arrivaltime": "12:00", "planetype": "a330-700", "vendor": "海南航空", "trafficnumber": "hu8619", "stopcity": "guangzhou", "redeyeflight": "false" }
| 1请使用字符串格式。 2交通方式 transportwaylist 不能为空。 3transportwaylist 交通方式,可能的值范围如下: ○飞机:"1" ○火车:"2" ○汽车:"3" ○轮船:"4" ○不包含:"5" 4nonstop、planetype、vendor、trafficnumber、redeyeflight 在 transportwaylist 包含飞机("1")时必填,在 ransportwaylist 不含飞机("1")时不能填,传空或不传。 5出发时间和到达时间格式:00:00~23:59。 6交通分组 group 必须在 1~99999 之间。 7redeyeflight 为字符串 "true" 或 "false"。
"true”:是跨夜航班
“false”:不是跨夜航班
|
改期规则
| reschedule_rule
| "0"
| 1请使用字符串格式。 2"0":免费改期
"1":收费改期
"2":不可改期
|
套餐类型
| groupon_type
| "groupon_type": [ "高端体检", "入学体检" ]
| 可选项:
高端体检,核酸检测,婚前孕前,肠胃套餐,特价体检,入学体检,健康优选,新冠康复体检,中青年体检,父母体检,妇科检查,专科检查,驾驶证,可加项,入职体检,肿瘤筛查,儿童体检,证件体检,健康证,职业体检,减重服务,老年体检,女性体检,男性体检。
|
商品介绍
| good_introduction
| "good_introduction": "123"
| -
|
适用人群
| target_audience
| "target_audience": "女已婚"
| 通用、女性、男性、已婚女性、未婚女性。
|
性生活史
| sexual_history
| "sexual_history": "是"
| ●"label": "有","value": "是"; ●"label": "没有":"value": "否"
|
可约时间
| book_time_rule
| "book_time_rule": "当日可约"
| -
|
凯发k8官方网娱乐官方的支付方式(可选)
| payment_method
| "payment_method": [ "医保", "花呗分期" ]
| -
|
报告时效
| report_period
| "report_period": "4小时出报告"
| -
|
报告领取方式
| report_receive_type
| "report_receive_type": [ "门店自取" ]
| 门店自取,电子报告,邮寄上门。
|
提供早餐
| breakfast_provide
| "breakfast_provide": "是"
| -
|
开票方
| invoice_issuer
| "invoice_issuer": "开票方"
| -
|
客服链接
| customer_service_link
| "customer_service_link": ""
| -
|
演出海报
| post_img
| "post_img":{ "url_list": [ "a*z-v2to1nd9waaaaaaaaaaaaaavr1aq" ] }
| 演出关联的宣传海报图片,图片宽为348px,高度为464px。文件 id 通过 alipay.marketing.image.enhance.upload(营销图片优化上传接口)获取 image_id 可上传成功 。
|
演出日期
| performance_date_range
| "performance_date_range":{ "start_date": "2023-01-01", "end_date": "2023-01-03" }
| 演出日期范围;start_date描述演出开始日期,end_date描述演出结束日期,时间格式均为yyyy-mm-dd, 允许开始日期、结束日期相同。
|
开售时间
| sale_time
| "sale_time":"2023-01-01 1:01:01"
| 描述售卖开始时间。 时间格式均为yyyy-mm-dd hh:mm:ss。 售卖开始时间必须早于演出结束日期。
|
座位信息
| seat_info
| "seat_info":"1"
| "1":可选座 "2":不可选座 二选一
|
出票规则
| ticket_rule
| "ticket_rule":"1"
| "1":实名出票 "2":非实名出票 二选一
|
出票方式
| admission_rule
| "admission_rule":["1", "2"]
| "1":电子票 "2":纸质票 可多选
|
电子票入场方式
| eticket_rule
| "eticket_rule":"1"
| 出票方式为"1"(电子票)时必填。 "1":电子码 "2":身份证
|
纸质票获取方式
| paper_ticket_rule
| "paper_ticket_rule":"1"
| 出票方式为"2"(纸质票)时必填。 "1":快递送票 "2":电子码换票
|
销售阶段
| sales_stage
| "sales_stage":"available"
| "delisting":"未开售"
"wait_sale":"待开售"
"pre_sale":"预售中"
"available":"售卖中"
|
可使用场馆
| use_poi
| "use_poi":[ { "poi_id": "poi1" }, { "poi_id": "poi2" } ]
| poi_id 可使用点位 id,请使用字符串格式。
|
票务代理类型
| agent_type
| "agent_type":"1"
| 选择演出商品发布者的票务代理类型。 枚举值: ip/主办方自运营:0 一级票务平台(票务总代理):1 一级票务平台(票务代理):2 二级票务平台:3
|
项目介绍
| project_introduction
| "project_introduction": [{ "name": "例子", "desc": "例子", "important": "y" }]
| 1请使用字符串列表格式 2name : 项目名称 3desc:项目说明 4important: 是否重点项目。y:是 n:否。
|
服务流程
| service_process
| "service_process": [{ "category": "购买", "name": "例子", "desc": "例子" }, { "category": "预约", "name": "例子", "desc": "例子" }]
| 1请使用字符串列表格式 2category:服务分类。 ○"购买" ○"预约" ○"到店履约" ○"开票", ○"出报告" 3name:服务名称 4desc:服务说明
|