马蜂窝开放平台

SKU 门票规则信息编辑

SKU门票规则信息编辑
注意：
1.门票规则信息包含两部分 1是预定须知 2是标准化票型信息
2.预订须知中限购规则部分当前仅向用户进行内容展示，马蜂窝不会做逻辑判断

调用频次

此接口调用频次上限默认为30次/分钟，如不能满足业务需要请添加马蜂窝开放平台交流群：201650204 申请调整。

请求URL

正式环境：https://openapi.mafengwo.cn/deals/rest

请求Action

action：sales.ticket.sku.rule.update

请求参数

参数名称	参数类型	必填	示例	描述
sku_id	int	是	12341	马蜂窝sku_id
cost_include	string	是	一切门票费用	费用包含
cost_exclude	string	是	一切个人消费及费用包含中未提及的任何费用。	费用不含
effective_type	int	否	1	生效时间类型 0是立即生效 1是出票后xx分钟生效默认 0
effective_time	int	否	20	生效时间当effective_type =1 此项必填
expiry_type	int	否	1	有效期类型 0-相对有效期，1-绝对有效期默认 0
expiry_date	date	否	2019-11-11	有效期类型为：“1-绝对有效期”时，必填；表示指定出行日期至所填日期有效
expiry_day	int	否	1	单位：天有效期类型为：“0-相对有效期”时，必填；填1表示指定出行日期1天内有效；
purch_limit_id_info	object	否	{}	身份证限购信息 eg:同一身份证{limit_day}天内,最多可购买{num}{unit}
└ limit_day	int	否	0	限制天数
└ num	int	否	1	限购数
└ unit	int	否	0	限购数单位 0 张 1 次默认0
purch_limit_phone_info	object	否	{}	手机号限购信息
└ limit_day	int	否	1	限制天数
└ num	int	否	1	限购数
└ unit	int	否	0	限购数单位 0张 1次默认 0
need_paper_ticket	int	否	0	是否需要换票 0是无需换票 1是需要换票1 默认是0
entrance_mode	array	是	[]	入园方式
{}	object	是	0
└ mode_id	int	是	1	入园方式标识ID 1-身份证 2-商家电子码 4-二维码 8-商家出行确认单 16-商家邮件 32-商家短信 64-实体票 128-护照 256-港澳通信证 512-台湾通行证
entrance_mode_type	int	否	1	入园方式是“或”还是“和”的关系 0:或 1:和
exchange_time_start	time	否	11:00:00	换票开始时间【开始时间大于结束时间时，则表示可跨天换票】
exchange_time_end	time	否	12:00:00	换票结束时间【开始时间大于结束时间时，则表示可跨天换票】
exchange_place	string	否	售票窗口	换票地点
entrance_time_start	time	是	12:00:00	入园开始时间【开始时间大于结束时间时，则表示可跨天入园】
entrance_time_end	time	是	14:00:00	入园结束时间
entrance_place	string	是	公园南门	入园地点
ext_note	string	否	补充说明	补充说明补充说明最多500字
invoice_note	string	否	发票说明	发票说明发票说明最多64字
poi_item_info	array	是	[]	poi 票型信息
{}	object	是	0
└ poi_id	int	是	12345	马蜂窝POI_ID
└ item_id	int	是	12234	票型ID
crowd_info	array	否		适用人群信息
{}	object	否	0
└ max_value	int	否		年龄最大值
└ min_value	int	否		年龄最小值

响应参数

参数名称	参数类型	示例	描述

响应示例

[
    
]

异常错误码

异常码	异常信息
10060088	POI 与产品关联目的地不匹配
10060075	票型绑定成功，规则修改失败
10060074	超过最大字符限制，补充说明最多500字，发票说明最多64字
10060073	换票信息填写不完整
10060072	出行有效日期不合法(须大于等于今天的日期)
10060071	有效期-X天内有效请填大于等于1小于等于255的数字
10060070	未填写有效期-出行日期
10060069	换票时间填写不完整
10060068	请填写出票后多少分钟后可以入园
10060067	同一手机号限购设置不完整
10060066	同一身份证限购设置不完整
10060065	必填项缺失
10060064	库存已关联的票型类型(内部/外部)和当前选择的票型类型不符
10060063	非联票只能关联1个poi
10060062	三个以上的景点票型名称必须一致
10060061	联票只能关联2~3个poi
10060060	请勿填写重复的poi
10060059	没有该库存操作权限
10060058	前台不可见产品不允许关联票型
10060057	不可同时关联通票票型和非通票票型
10060056	只有联票库存可关联通票票型
10060055	票型和库存属性不符
10060054	测试供应商只能关联测试poi
10060053	非景点门票品类SKU，无法完成景点门票SKU标准化
10060052	滑雪票旧属性结构SKU不允许关联此票型，请选择“重新设置属性结构”后，创建新SKU
10060051	SKU属性不合法['标准化门票SKU“票种类型”、“可用天数”属性不能够拥有“不限”、“其他”属性值']
10060050	SKU不存在
10060049	该poi下票型组合与{sales_id}产品下的sku重复
10060048	参数不全