NameDescriptionTypeAdditional information
price

未来30天内,离当天最近的一个日期的价格。 为了降低负载,此处不会返回一个价格表(每一天的价格,仅会返回当前价格或未来30天有售时的一个价格,用于展示)。

decimal number

None.

productid

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

string

None.

productname

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

string

None.

sellenabledstartday

许可开始销售的日期,格式“MMDD”。

string

None.

sellenabledendday

许可截止销售的日期,格式“MMDD"。

string

None.

sellenableddateresolve

许可开始销售-截止销售日期是否取反(取值表示一年之间,除sellenabledstartday至sellenabledendday以外的时间可售)。

string

None.

productgroupname

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

string

None.

issinglescenicspotticket

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

string

None.

unit

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

string

None.

isyearormonthcard

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

string

None.

providercertificatecount

支持凭证数量。 一般情况此值为1,表示一个票仅包含一个过闸凭证。 对于家庭年卡或家庭票,此值一般大于1,如3人家庭年卡,此值为3,表示当前票购买后,可以通过短信引导,录入多个家庭成员。 注意,不管这个值是多少,票还是一张(购买时提供一个家庭首要成员的信息,买下一张后,系统将通过短信引导客人通过手机录入其他的家庭成员)。

integer

None.

delayactivate

是否支持延迟激活或选座。 当当前票型无剧场关联时,此值表示延迟激活。 当当前票型与剧场关联(属于演出类产品或包含演出的产品)时,此值表示延迟选座。 延迟激活:买下这个门票时,并不指定票具体的有效期,系统将给购票人发送短信,引导客人通过手机完成入园日期的选定(激活)。客人购票后不激活的,可按退票规则申请退票。 延迟选座:买下这个门票时,并不指定票具体的场次、座位,系统将给购票人发送短信,引导客人通过手机完成场次、座位的选定。客人购票后不选座的,可按景区的购票规则退票。当客人选座时间超过演出开始时间的,选座将失败,只能退票处理。当客人选座时门票已售完的,选座将无法完成,只能退票。

string

None.

delayactoutofactendingdatemode

延迟激活门票激活期限届满时的处理方式. 取值“1”-自动激活(缺省值);“2”-阻止激活且允许按过期门票受理退票。

string

None.

delayactoutofactendingdatemodedesc

延迟激活门票激活期限届满时的处理方式的说明。

string

None.

delayactendingmode

延迟激活期限计算模式。 “D”表示自下单时指定的门票日期(游览日期)起,N天内允许激活; “S”表示无论何时下单,也无论指定哪个门票日期,在约定日期之前必须完成激活。

string

None.

delayactmaxdays

当delayactendingmode=“D”时,此值有意义,表示最大可延迟的天数。

integer

None.

delayactlastestday

当delayactendingmode=“S”时,此值有意义,表示至这一天止,必须激活,格式YYYYMMDD。

string

None.

sameonerepeatbuylimitdays

同一个持票人重复购买当前门票时必须间隔的天数。0或负值均表示不限制,其他值表示此值所有的日数内,一个持票人仅能购买一张。

integer

None.

minimum

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

integer

None.

effectivemode

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

string

None.

effectivemodename

生效期模式的说明。

string

None.

effectivenumberofdays

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

integer

None.

effectivestartdate

当effectivemode ="C"时,此值有意思,表示特定的开始日期,格式YYYYMMDD。此值表示,不论提交时“门票日期(或约定游览日期)为何值,提交成功后得到的票总是从这个日期开始生效。

string

None.

effectiveenddate

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

string

None.

check_verifymodecode

检票入园时的认证方式代码,如:1(仅有效性验证),2(有效性+二代证验证),3(有效性在生物特征识别),4,5。

string

None.

check_verifymodename

检票入园时的认证方式名,本字段是对check_verifymodecode代码的文件说明,如“有效性在生物特征识别”。

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.

netorderrealnamemode

持票人的实名信息要求(持票人是指订单明细(购买清单)中指定的人),不是指订单的主要联系人。 有四个取值: A-有效个人身份证件信息必填(缺省值)(证件类型、证件号必须,其他可以不填); B-中国境内移动电话号码必填(中国境内有机号必须,其他可以不填); C-有效个人身份证件或中国境内移动电话号码二选一(证件类型、证件号或手机号二选一); D-有效个人身份证件和中国境内移动电话号码均必填(都要)。

string

None.

netorderrealnamemodedesc

持票人实名信息要求的说明。

string

None.

perpersonperticket

是否一人一票,“1”表示一人一票。 对于互联网订单,此值恒为“1”。

string

None.

isreferencetotheatre

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

string

None.

issegmentmode

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

string

None.

lineprice

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

string

None.

introduction

关于这种产品的产品介绍。

string

None.

imgurl

当前产品的图片的URL。

string

None.

servicecontent

服务内容

string

None.

notice_of_purchase_and_use

购买与使用需知。 此属性可能是一个大字段,还有可能带有HTML格式字符。 不建议代理商直接使用。

string

None.

notice_of_refund

退改须知。 此属性可能是一个大字段,还有可能带有HTML格式字符。 不建议代理商直接使用。

string

None.

singleperorder

是否一个订单只能订购一张门票。 “1”表示是,一个订单只能订购一张。 “0”表示否,一个订单可以订购同型门票多张。 所有的支持凭证数大于1的,此值都将是“1”。

string

None.

serviceagreement

服务协议,是一个需要客人阅读的大字段。

string

None.

privacyagreenment

隐私协议。

string

None.

productpurchaseotes

景区订票规则。 这个字段来源于系统设置,由软件拼接而来,例如:即定即用,实名制购买,2日有效。

string

None.