NameDescriptionTypeAdditional information
productid

产品ID,通常为一个GUID值的string值(VARCHAR36),同门票系统中的“门票类型ID”,不会为空。

string

None.

productname

产品名称,同门票系统中的“门票类型名称”,不会为空。

string

None.

immediaterebaterule

现返规则,此值不为空,表示当前票型在未来7天内,有至少一个现返方案可用。

Collection of ImmediateRebateResult

None.

productgroupname

门票类型的逻辑分组名,用以对众多票型进行逻辑分隔,可以不使用。 如“乘船”“含船”等。

string

None.

issinglescenicspotticket

是否是单点票(单点票:门票只属于一个企业(实体或景区),不是指仅包含一个景点)。 “1”表示是,其他值表示否。

string

None.

unit

单位,通常为"张",但也有可能为“份”,不能折散销售的大套票可能为“份”

string

None.

pricetable

符合条件的价格表。 以日期-价格形式返回。 以标识不同的日期,价格的差异。

Collection of ScenicSpotProductDateItemResult

None.

minPrice

冗余字段---票价最低价格--用于首页展示。 以日期-价格形式返回。 以标识不同的日期,价格的差异。

decimal number

None.

isyearormonthcard

是否是年卡。 “1”是;其他值否。 当是年卡时,年卡购买和续费有专用的API,和购买普通票是不同的。

string

None.

minimum

最小单笔出售数量,0表示没有限制

integer

None.

effectivenumberofdays

当前票种有效期长,1日有效(使用当天有效)为1,2日有效为2,依此类推。 此日数是指从“生效日期”(约定的游览日期起,几天内可用)。

integer

None.

effectivemode

"A", "授权之日起,有效日数内有效"。 "B", "授权之日起,有效日数内有效,但不能越年"。 "C", "指定日期范围内有效"(此值表示,不论提交时“门票日期(或约定游览日期)为何值,提交成功后得到的票总是在指定日期范围内有效),示例:A票型生效期模式为“C”,特定有效期始(effectivestartdate)为20240510,特定有效期止(effectiveenddate)为20240512,则论是出售的时指定的门票日期(约定游览日期)20240501还是20240420,售出的票总是在20240510至20240512间可用(简单理解为期票)。 "D",自授权之晶起,有效日数内有效,允许前台售票时重定义(并不支持互联网销售时重定义,因此对于OTA,此选项同“A”)。

string

None.

effectivestartdate

当effectivemode ="C"时,此值有意思,表示特定的开始日期

string

None.

effectiveenddate

当effectivemode ="C"时,此值有意思,表示特定的截止日期

string

None.

webadvancecount

互联网预定提前单位数,表示要在约定的开始时间(演出)或约定的游览日期前多少个时间单位预订(包括支付)才有效,如果支付的提前时间不够,将不能提交。 系统支持两种主要的提前约束模式,分别是“日”和“小时”,在景区和演出这两种产品中的表达是不同的。 对于景区:提前N日时,表示必须提前N日(相对约定有游览日期或特定生效期始计算),提前N日的前一天23:59分前才能下达订单并支付才可以提交;提前N小时时,表示当天也可以下单,但最早的入园时间将指定为“订单支付时间”后的N小时。对于多日有效门票(或年卡),指定N小时的提前要求是无效的。 对于演出:提前N日时系统的行为同景区;提前N小时时,系统判断的依据是“指定场次的开演时间”,并不会修改订单成交后门票的入园许可时间(因为演出的时间是相对固定的)。

integer

None.

webadvanceunit

提前单位,D表示日,H表示小时;默认为日,不为H的其他值都可以视为日。

string

None.

needname

实名制约束,"1"表示必须一个证件号一张门票,“0”表示不需要实名制。 当此值为1,且rulesofidentity为空或没有记录时,表示只需要一个证件就行了,没有特殊要求。

string

None.

perpersonperticket

是否一人一票,“1”表示一人一票。

string

None.

rulesofidentity

身份证验证规则。 此规定约定,哪些身份证可以购买这种类型的门票,如年龄要求,地域要求,性别要求,生日要求等。 此清单不能反映“多少天内不能重复预定”的规则。 注意,当一个票型的身份证规则有多项时,规则与规则之间是或者的关系,实名信息命中其中一个规则,都可以视为合法。 此结果元素中的description属性可以表达在页面上展示给客人看。

Collection of ScenicSpotIdentityRuleResult

None.

isreferencetotheatre

是否是剧场类型的票(或者是个套票,包含了演出在里面)。 剧场类型的票,有剧目,场次,特定演出时间和座位。

string

None.

issegmentmode

当前票型是否处于时段模式。 注意了,以前的系统,是系统处于时段模式或非时段模式。 新的系统,可以支持某一些票型处于时段模式。 1:表示是,其他值表示否。 V4版及以前系统中:是否处于时段模式的参数,已经没有了含义。

string

None.

maxticketcount

最大限额

integer

None.

hadsellcount

已售数量

integer

None.

lineprice

划线价格。这个值可能理解为“原价”,本类型实例的pricetable属性中返回的“现价”,用于各OTA或小程序在绘制界面时,展示一个被划线了的“原价”。

string

None.

providepassporttypes

当前票型支持的过闸方式。 每一个票型,依据其过通行的区域,可能支持不同的过闸模式(区域的检票设备及供应商的设置共同决定)。

Collection of ScenicSpotProvidePassportTypeResult

None.

renegerules

执行退票时的违约金的计算规则。

Collection of ScenicSpotProductRenegeRuleResult

None.