Name | Description | Type | Additional information |
---|---|---|---|
checktimerules |
当前门票可以通行的各景点的景点检票起始时间,截止时间,离园截止时间。 |
Collection of ScenicSpotProductCheckTimeResult |
None. |
notice_of_purchase_and_use |
购买与使用需知。 此属性可能是一个大字段,还有可能带有HTML格式字符。 不建议代理商直接使用。 |
string |
None. |
notice_of_refund |
退改须知。 此属性可能是一个大字段,还有可能带有HTML格式字符。 不建议代理商直接使用。 |
string |
None. |
providepassporttypes |
当前票型支持的过闸方式。 每一个票型,依据其过通行的区域,可能支持不同的过闸模式(区域的检票设备及供应商的设置共同决定)。 |
Collection of ScenicSpotProvidePassportTypeResult |
None. |
renegerules |
执行退票时的违约金的计算规则。 |
Collection of ScenicSpotProductRenegeRuleResult |
None. |
ticketcheckrecords |
已经产生的检票记录。 现在这个总是返回为空,因为这个可能有许多记录,可能需要分页。 |
Collection of TicketCheckRecord |
None. |
useperiod |
使用阶段 |
string |
None. |
customertype |
代理商的类型。 |
string |
None. |
customerid |
当前票是由哪个人购买的(代理商ID)。 |
string |
None. |
curstomername |
当前票是由哪个人购买的(代理商的名称)。 |
string |
None. |
productid |
产品ID(门票类型ID)。 |
string |
None. |
productname |
产品名称(门票类型的名称)。 |
string |
None. |
ticketcode |
门票内部识别号(内部识别号),依据这个号码,可以唯一地确定每一张门票。 |
string |
None. |
canrefund |
当前门票是否可以退票,“1”表示可以,其他值表示不可以。 |
string |
None. |
cannotrefundreason |
不能进行退票时,供应商给出的理由(如已经过了退票的截止时间)。 |
Collection of string |
None. |
refundandchanging_timelimit |
可以进行退票或改签的截止时间。 |
string |
None. |
mobile |
手机号码(预订时,指定的门票的手机号码)。 |
string |
None. |
name |
姓名,string(32),实名制模式下,此值表示客人的姓名。 |
string |
None. |
identitycode |
身份证号,string(20),实名制模式下,此值表示客人的法定有效个人身份证件号码(如果是二代身份证,对于可以使用“二代证”检票的景区景点,此号所示的二代身份证可以直接用于检票)。 |
string |
None. |
predict_refund_fee |
此本次查询的时刻止,如果发起退票,将需要支付多少违约的手续纲 |
decimal number |
None. |
price |
价格。多少钱/人(注意,不是多少钱/票)。 |
decimal number |
None. |
amount |
数量,此值恒为一。表示一张门票。 |
integer |
None. |
personcount |
人数,int,一人一票时,此值总为1,多人一票时,此值表示当前门票检票时,可以通行的人数。 |
integer |
None. |
freecount |
赠送人数,int,此值仅在电子门票系统系统执行“现返”时,不为零,不为零时,表示现返人数,游宝星电子门票系统仅支持N免X模式的现返,如“10免1”。 一般情况下,此值为零;如果这个值不为零,表示减免的人数。 您为当前这张票支付的实际成本为“price * (personcount-freecount) |
integer |
None. |
checkmethod |
"I"将使用二代证过闸,“B”将使用手机条码过闸,“T”将前台取票或自助机取票过闸,"F"支接人脸过闸。 |
string |
None. |
needname |
当前门票是否要求实名制,"1"表示是,其他值否。 “实名制”不仅是对购票的约束,实名制购买的门票,检票通常也是要求实名制的。 实名制的门票,转卖他人是不行的。 |
string |
None. |
valid_period_begins |
有效期始(yyyyMMdd)。 这个值在门票未经历改签之前,通常都是约定的游览(观演)日期。 对于演艺(剧场)类的门票或含有演艺(剧场)项目的门票,需要特别注意,可能门票有几天有效期,查仅其中的某一天可以去观演,其他日则只能游玩与演出无关的景点。 |
string |
None. |
valid_period_end |
有效期止(yyyyMMdd)。 |
string |
None. |
status |
可用状态 0-未到有效期(有效期在将来);1-有效期之内,且还没有使用过; 2-有效期之内,且有一个以上过闸权限;3-有效期之内,但已没有可消费的权限 ,4已过有效期且无消费记录,5-已退票,6-已过有效期且有消费记录但消费未全部完成,7-已过有效期且消费全部完成。 |
string |
None. |
orderid |
预订单单据号。 |
string |
None. |
createdtime |
支付时间/门票的生成时间(默认的情况下,支付的同时,订单会生成门票,因此是同一个时间),格式YYYYMMDDHHMMSS。 |
string |
None. |
sellbillid |
售票单号,售票单是门票系统的内部单据。 所有支付成功的预订单,系统都会同时生成一个售票单。 |
string |
None. |
summary |
合计金额=personcount * price |
decimal number |
None. |
paidsummary |
实付金额=(personcount-freecount) * price。 |
decimal number |
None. |
contains_the_show |
当前门票是否包含了一场演出(或观影、赛事),“1”是,其他值否。 contains_the_show =1 and contains_scenicspot_count 小于等于1,表示这仅是一个演出(或观影、赛事)票,不含其他的权利。 |
string |
None. |
get_phyphysical_ticket |
是否已在前台或自助机上取过物理票,“1”表示是,其他值否。 |
string |
None. |
contains_scenicspot_count |
包含的可检票的景点数。 |
integer |
None. |
theatre_id |
(contains_the_show="1"时,此属性有值) 剧场ID(当前系统设计为,一个票至多只能看一场有座位的演出)。 |
string |
None. |
theatre_name |
(contains_the_show="1"时,此属性有值) 剧场名称。 |
string |
None. |
theatrical_id |
(contains_the_show="1"时,此属性有值) 剧目的ID。 |
string |
None. |
theatrical_name |
(contains_the_show="1"时,此属性有值) 剧目名称(如“天门狐仙*新刘海砍樵”)。 |
string |
None. |
scene_id |
(contains_the_show="1"时,此属性有值) 演出场次的ID。 |
string |
None. |
scene_name |
(contains_the_show="1"时,此属性有值) 场次的名称(如“上午场”、“第一场”或“XX队VSXX队”)。 |
string |
None. |
scene_date |
(contains_the_show="1"时,此属性有值) 演出的日期(YYYYMMDD),当一个票只包含一个演出时,此值与有效期始,有效期止相同。 当一个票有多个游览的权利时,演出的日期为“有效期始至有效期止”间的某一天。 客人必须在这一天的指定时间前往观演。 |
string |
None. |
scene_starttime |
(contains_the_show="1"时,此属性有值) 演出(放映或赛事)开始的时间:HH:MM。 |
string |
None. |
scene_endtime |
(contains_the_show="1"时,此属性有值) 演出(放映或赛事)结束的时间:HH:MM。 |
string |
None. |
scene_checkin_ahead |
(contains_the_show="1"时,此属性有值) 演出(放映或赛事)检票相较于演出开始时间的提前分钟数(60表示开演前60分钟开检本场的票) |
integer |
None. |
scene_checkin_delay |
(contains_the_show="1"时,此属性有值) 演出(放映或赛事)检票相较于演出开始时间的推迟分钟数(5表示开演后5分钟仍可以检票入场) |
integer |
None. |
seatinfo |
(contains_the_show="1"时,此属性有值) 演出(放映或赛事)的座位信息,如“A区双号13排4,5,6座”。当一个票为多人,有多个座时,会显示在一条内容里。 |
string |
None. |
has_another_segment_mode_scenicspot |
当当前门票包含多个游览权利,入园之后,其中的某个游览权利需要通过预约行使用时,此值为“1”。 (如一个票能乘座索道上山【入园】和下山【出园】,上山在购票时就预约好时段,此处指示的仅是下山的时段,景区内设有【下山】分时段的服务,此时需要客人再行在手机或官方约定的渠道再预约一次,此值用来告知客户端 ,当前这个票,还有其他的可以执行的预约操作)。 |
string |
None. |
has_pre_segment_mode_scenicspot |
当当前门票包含的游览权利中所指示的景点有一个处于分时段模式且在购票时就预约了这个景点的入园时间段时,此值为“1”,表示是;其他值表示否。 当前系统仅支持在一个票中,至多包含一个分时段的景点。 当分时段检票时,依据时段约定的时间到达约定的景点,将有最小的排队时间。 注意:当一个门票,含有多个景点的游览权利时(如桃花源+龚滩古镇+乌江游船三日游,其中只有乌江游船是预约的),通常有效期是多天,但强烈推荐游客在约定的预订日期和时间到达预约游览的景点。 此值仅能指示,游客在购票时在约定好的预约日期和时间段,不能指示游客到达景区之后,再行预约的其他的项目(如一个票能乘座索道上山【入园】和下山【出园】,则此处指示的仅是上山的时段,景区内可能设有【下山】分时段的服务,此时需要客人再行在手机或官方约定的渠道再预约一次,则这一次预约不由此值来指示)。本系统有其他的API来处理这种类型的预约,以解少客人的排除时间。 |
string |
None. |
pre_segment_servicecode |
(has_pre_segment_mode_scenicspot='1'时,此值有含义)。 购票时选定的时段所属的服务项目的ID。 |
string |
None. |
pre_segment_servicename |
(has_pre_segment_mode_scenicspot='1'时,此值有含义)。 购票时选定的时段,所属服务项目的名称,如“A线游”,“B线游”,“乘船”等。 |
string |
None. |
pre_segment_code |
(has_pre_segment_mode_scenicspot='1'时,此值有含义)。 购票时选定时段的时段号。 |
integer |
None. |
pre_segment_starttime |
(has_pre_segment_mode_scenicspot='1'时,此值有含义)。 时段的开始时间,HH:MM。这个时间,是指开始检票的时间。 |
string |
None. |
pre_segment_endtime |
(has_pre_segment_mode_scenicspot='1'时,此值有含义)。 时段的截止时间,HH:MM。这个时间,是指约定的检票完成的时间。 注意,如果错过了时段,门票的游览权利并不会丢失,一般情况下,供应商都会有相应的应急预案来处理这种情形的违 约(如排入后一时段尾)。 |
string |
None. |
pre_segment_date |
(has_pre_segment_mode_scenicspot='1'时,此值有含义)。 分时段检票时的预约日期(YYYYMMDD)。 |
string |
None. |
fingerprintcount |
指纹生物特征数 |
integer |
None. |
facecount |
人脸生物特征数。 |
integer |
None. |
barcodeindex |
通过指定的链接,获取二维码图片的特别内容。 这个内容是一个特殊标识,可以用来直接获取门票的二维码内容。 如http://xxxx.com/e/e/barcodeindex这样就能直接展示出电子门票来。 这个链接不会对获取者进行校验,因此也是一个十分危险的字段。 但如果要把门票编在一个短信中,发送到客人的手机上,则此值为必须。 |
string |
None. |
barcodebuffer |
当门票的过闸方式为手机条码时,我们将生成一个BUFFER,这个BUFFER可以直接用QR码制生成为一个二维码并显示。 游客可以使用这个码过闸。 |
Collection of byte |
None. |
checkinmediatype |
过闸条件限定 I-限二代证 B-限条码 U-限IC卡 A-任意凭证 |
string |
None. |