NameDescriptionTypeAdditional information
ticketimg

二维码图片数据

string

None.

faceimg

人脸图片数据

string

None.

productid

产品ID(门票类型ID)。

string

None.

productname

产品名称(门票类型的名称)。

string

None.

ticketcode

门票内部识别号(内部识别号),依据这个号码,可以唯一地确定每一张门票。

string

None.

mobile

手机号码(预订时,指定的门票的手机号码),此值返回时已加掩码。

string

None.

familyname

姓名,string(32),实名制模式下,此值表示客人的姓名,此值返回时已加掩码。

string

None.

identitycode

身份证号,string(20),实名制模式下,此值表示客人的法定有效个人身份证件号码(如果是二代身份证,对于可以使用“二代证”检票的景区景点,此号所示的二代身份证可以直接用于检票),此值返回时已加掩码。

string

None.

identitycodetypecode

证件类型代码。

string

None.

identitycodetypename

证件类型名称。

string

None.

price

价格。多少钱/人(注意,不是多少钱/票)。

decimal number

None.

amount

数量,此值恒为一。表示一张门票。

integer

None.

personcount

人数,int,一人一票时,此值总为1,多人一票时,此值表示当前门票检票时,可以通行的人数。

integer

None.

freecount

赠送人数,int,此值仅在电子门票系统系统执行“现返”时,不为零,不为零时,表示现返人数,游宝星电子门票系统仅支持N免X模式的现返,如“10免1”。 一般情况下,此值为零;如果这个值不为零,表示减免的人数。 您为当前这张票支付的实际成本为“price * (personcount-freecount)

integer

None.

contains_the_show

当前门票是否包含了一场演出(或观影、赛事),“1”是,其他值否。 contains_the_show =1 and contains_scenicspot_count 小于等于1,表示这仅是一个演出(或观影、赛事)票,不含其他的权利。

string

None.

theatrical_id

(contains_the_show="1"时,此属性有值) 剧目的ID。

string

None.

need_select_scenic_or_seats

当前门票是否需要选座或选场次。 此值用于控制小程序的展示,当此值为“1”表示需要选座或选场选座。 注意,不是任何时候都需要选场次和座位,可能已有场次,仅选座位。

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.

seatinfo

(contains_the_show="1"时,此属性有值) 演出(放映或赛事)的座位信息,如“A区双号13排4,5,6座”。当一个票为多人,有多个座时,会显示在一条内容里。

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.

faceexists

是否已录入人脸。

string

None.

usesegment_code

使用阶段代码,1个字符,1,2,3,9等取值。

string

None.

usesegment_name

使用阶段的文本描述:如待使用,使用中,使用已完成,改签挂起等。

string

None.

provider_certcount

支持的凭证数量,1表示当前门票仅支持一个凭证,2表示可以支持两个及以上凭证(家庭票或年卡)。

byte

None.

exists_certcount

已录入的凭证的数量。

byte

None.

phyicsticket_gettimes

物理门票列印/印制次数,当此值大于0表示已前台取过门票或制过卡。具体的数值表示列印/制卡的次数。

integer

None.

summary

合计金额=personcount * price

decimal number

None.

paidsummary

实付金额=(personcount-freecount) * price。

decimal number

None.

checkinmediatype

过闸条件限定 I-限二代证 B-限条码 U-限IC卡 A-任意凭证

string

None.

checkinmediatypename

过闸条件限定名。本字段是对checkinmediatype代码的文字说明。

string

None.

check_verifymodecode

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

string

None.

check_verifymodename

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

string

None.

special_bl1

特殊字段,此字段的值由票务系统运维人员设置,当一个门票被手动禁用时,此字段不为空,表达一个状态,内容为文字,如“已被禁用”。

string

None.

special_bl2

特殊字段,此字段的值由票务系统运维人员设置,当一个门票被手动禁用时,此字段不为空,表达设置special_bl1时的情形,如“于2024-06-01被用户supervisor禁用,原因:XXXX”。

string

None.

isyear_card

是否年卡,“1”表示是。

string

None.

ismain_cert

是否主凭证,此值在单人票时,总是为“1”,在多人票时,如果是主要凭证,则为"1",其他家庭成员则为”0“。

string

None.

delayactivatestatus

是否允许延迟激活,“1”表示是,“0”表示否。当当前门票含有剧场时,此值应理解否“是否允许延迟激活和选座”。

string

None.

activatestatus

激活状态,“1”已激活,其他值未激活。

string

None.

lastactivatedaylimit

允许激活的最晚期限,格式YYYYMMDD。

string

None.

activateable

依据服务器时间判断,当前门票是否仍然可以选座和激活,“1”表示可以,“0”表示否。 当此值为“1”时,表示当前门票可以延迟激活,尚未激活且处于激活时限内。否则就只能退票了。

string

None.

valid_period_begins

有效期始(yyyyMMdd)。 这个值在门票未经历改签之前,通常都是约定的游览(观演)日期。 对于演艺(剧场)类的门票或含有演艺(剧场)项目的门票,需要特别注意,可能门票有几天有效期,查仅其中的某一天可以去观演,其他日则只能游玩与演出无关的景点。

string

None.

valid_period_end

有效期止(yyyyMMdd)。

string

None.

sellbillid

售票单号

string

None.

orderid

预订单号

string

None.