Name | Description | Type | Additional 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. |