文化场馆和旅游景区电子票务系统门票编码规则、数据接口规范.docx

（规范性）文化场馆和旅游景区电子票务系统门票编码规则统一编码规则单位编码采用注册制，由单位在初次申报文化场馆、旅游景区信息中生成。若对已申报单位信息进行变更，需要由单位向省文化和旅游厅申报核准后再执行。单位统一编码规则如下：统一编码规则数据项规则类型位数说明单位代码城市（地区）行政代码字符4位见国家统计局城市（地区）行政区划代码标准单位序号字符3位按照流水号罗列，位数不足3位高位补0。一个行政管辖单位分配一个独立序号景点代码景点类型字符2位如：00,主园；01,园中园；10,独立园区单位下属二级景点序号字符2位按照流水号罗列，包含景点、重点流量监控区域，如独立单位无分支景点按照00补位承载1:代码最大承载量代码字符6位按照LB/T034-2014相关规定并结合文化场馆或旅游景区实际上报承载量综合核算确认景点最大承载量代码字符6位按照LB/T034-2OM相关规定并结合文化场馆或旅游景区实际上报承载量综合核算确认单位属性单位类型字符3位如：国家AAAAA级旅游景区、博物馆、图书馆等单位收费类型字符1位详见“表C.3文化场馆或旅游景区收费形式”单位全称同工商登记名称字符100位如：敦煌莫高窟单位简称字符100位如：莫高窟以“天”计字符1位如:2天基础信息基础信息数据项规则类型位数说明承裁量代码最大承载量代码字符6位按照LB/T034-2OM相关规定并结合文化场馆或旅游景区实际上报承载量综合核算确认景点最大承载量代码字符6位按照LB/T034-2OM相关规定并结合文化场馆或旅游景区实际上报承载量综合核算确认单位属性单位类型字符3位如：代码表示国家AAAAA级旅游景区、博物馆、图书馆等单位收费类型字符1位详见“表C.3文化场馆或旅游景区收费形式”单位全称同工商登记名称字符100位如：敦煌莫高窟单位简称字符100位如：莫高窟以“天”计字符1位如：2（天）收费形式收费形式代码编号类型名称说明1免费开放2有限开放3封闭式门票票号编码规则门票票号由系统生成，编码规则如下:门票票号编码规则数据项类型位数说明单位统一编码字符11单位代码+景点代码，下同售票时间（年月日）字符6格式为YYMMDD每日出票流水号字符8保证不重复，位数不足高位补零门票预约、预订编码规范分销渠道商编码采用注册制，由渠道商在初次申报信息时生成。若对已申报渠道商信息进行变更,需要由渠道商向省文化和旅游厅申报核准后再执行。编码规则如下：门票分销商渠道商编码数据项类型位数说明分销渠道商字符6例如，携程为100Ool门票票面类型规范门票票面类型规范数据项类型位数说明门票票号字符26遵循门票票号编码规则有效使用期限字符4单位天。预约、预订出票后多久有效。（示例：OOIO）允许单次入园人数字符4同一张电子门票允许单次入园的游客数量（示例：0006）门票类型字符201：全价票：02：半价票；03：免费票：04：年卡：05：其他类型（示例：01）出入园类型字符201：单次入园：02：当日不限次数：03：多日不限次数：04：其他类型（示例：01）门票预约数据规范根据电子门票出票日期统计，未付款的订单门票为预约门票，其数据规范如下:数据项类型位数说明单位统一编码字符11分销渠道商字符6（示例：100001）出票时间字符122019年10月1日10时。分1秒（示例：20191001100001）门票类型字符201：全价票；02：半价票；03：免费票；04：年卡；05：其他类型（示例：01）计划出行日期字符82019年10月2日（示例：20191002）订单游客人数字符410人（示例：OOIO）购票者姓名字符5（示例：张三）购票者证件类型字符2Ol身份证，02护照，03军官证，04港澳通行证，05台湾居民往返大陆通行证，06其他（示例：01）购票者证件号字符18购票者手机号字符11中国大陆手机号门票预订数据规范根据电子门票出票日期统计，已付款的订单门票为预订门票，其数据规范如下:门票预订数据规范数据项类型位数说明单位统一编码字符11分销渠道商字符6（示例：100001）出票时间字符122019年10月1日IO时0分1秒（示例：20191001100001）门票类型字符201：全价票：02：半价票：03：免费票；04：年卡；05：其他类型（示例：01）计划出行日期字符82019年10月2日（示例：20191002）订单游客人数字符410人（示例:0010购票者姓名字符5（示例：张三）购票者证件类型字符2Ol身份证，02护照，03军官证，04港澳通行证，05台湾居民往返大陆通行证，06其他购票者证件号字符18购票者手机号字符11中国大陆手机号现场售票数据规范现场售票数据是指直接现场售票出票，或者通过网络预约渠道进行下单后在现场完成支付后出票行为中产生的现场售票数据，其数据规范如下：数据项类型位数说明单位统一编码字符11销售终端号字符4单位定义出票时间字符122019年10月1日10时O分1秒（示例：2019年Ol100O（三）入园日期字符82019年10月2日门票类型字符201：全价票：02：半价票；03：免费票；04：年卡；05：其他类型（示例：01）订单游客人数字符410人（示例：0010）购票者姓名字符5（示例：张三）购票者证件类型字符18Ol身份证，02护照，03军官证，04港澳通行证，05台湾居民往返大陆通行证，06其他购票者证件号字符18购票者手机号字符11中国大陆手机号出入园记录与管理入园凭证规范数据项类型位数说明门票票号字符26遵循门票票号编码规则分销渠道商字符6（示例：100001）入园凭证编码字符8预制随机字符，用于标示入园凭证（示例：OdfeVa39）入园身份证号码字符18无身份证信息时用0补位有效使用期限字符4单位天。预约、预订出票后多久有效。（示例：0010）允许单次入园人数字符4同一张电子门票允许单次入园的游客数量（示例：0006）门票类型字符201：全价票；02：半价票：03：免费票；04：年卡：05：其他类型（示例：01）出入园类型字符201：单次入园；02：当日不限次数；03：多日不限次数；04：其他类型（示例：01）出入园闸机编码规范出入园闸机编码规范数据项类型位数说明单位统一编码字符11入园时间字符122019年10月1日10时0分1秒（示例：20191001100001）入园人数字符42人次入园（示例：0002）单位出园数据实时记录规范如下:数据项类型位数说明单位统编码字符12出园时间字符122019年10月1日16时O分1秒（示例:20191001160001）出园人数字符41人次出园（示例：OOOD出入园验票与计数游客（访客、读者）持含有入园（馆）凭证信息的门票（FRlD介质、纸质门票、二维码、人脸识别）通过闸机或其他验票设备出入园（馆），按单次出入园（馆）人数进行计数，无出园闸机的，应通过相关辅助识别的方式实现人流量的统计。a）单文化场馆或旅游景区出入园（馆）；a）出入园（馆）包括单次出入园（馆）及多次出入园（馆）的情况，系统应能分别记录出入园（馆）的次数和出入园（馆）的人数；b）单文化场馆或旅游景区内多景点开放式出入园（馆）；c）系统应能记录并上报文化场馆或旅游景区人数和景点人数；d）单文化场馆或旅游景区多景点园中园式出入园（馆）；e）系统应能记录文化场馆或旅游景区人数和景点人数；针对文化场馆或旅游景区多景点园中园式入园（馆）游客（访客、读者）有二次出入单位的情况，系统应能分别记录出入园（馆）的次数和出入园（馆）的人数；f）多文化场馆或旅游景区联合售票出入园（馆）；g）针对多文化场馆或旅游景区联合售票出入园（馆）的情况，系统应能记录并上报文化场馆或旅游景区人数和景点人数；针对多文化场馆或旅游景区联合售票出入园（馆）游客（访客、读者）有二次出入的情况，单文化场馆或旅游景区系统应能分别记录出入园（馆）的次数和出入园（馆）的人数。实时流量计算规则文化场馆或旅游景区实时流量计算规则为系统中记录的实时入园人数总和减去实时出园人数总和。统计流量计算规则文化场馆或旅游景区统计流量计算口径为单位接待人次，即系统中记录的入园游客总人次（1人2次入园按2人次计）。（规范性）文化场馆和旅游景区电子票务系统数据接口规范数据总线A.1.1数据总线对接电子票务系统业务流程互联网预约订单同步推送到现场电子票务系统流程互联网预约订单通过网络预约平台推送至数据总线，数据总线查找到对应的门票服务接口，将订单信息数据路由推送到现场电子票务系统中，从而实现游客通过网络渠道购票，实现闸机检票入园。互联网预约平台信息上报至数据上报服务平台流程工作人员通过登录互联网预约平台，设置不同时段入园游客人数，设置完成以后，网络预约平台把数据实时通知到旅游企业服务总线系统，系统通过电商服务模块把入园游客人数等原始数据实时推送到数据中心的数据仓库中。经过数据仓库汇总统计后的电商预约信息,通过旅游企业总线系统的对外数据开放接口推送上报到数据上报服务平台，或者数据上报服务平台通过旅游企业服务总线系统对外数据开放接口，主动查询预约相关信息。门票管理系统信息上报至数据上报服务平台流程门票管理系统提供的标准的对外数据接口，旅游企业总线系统通过管理平台配置的数据对接策略，把门票管理系统的原始数据通过旅游企业总线票务接口推送到数据中心仓库中。经过数据仓库汇总统计后的票务系统数据通过旅游企业总线系统的对外数据开放接口推送上报至数据上报服务平台，或者数据上报服务平台通过旅游企业总线系统对外数据开放接口，主动查询门票系统相关信息。A.1.2旅游企业服务总线系统对接门票管理系统标准数据接口对接门票管理系统订单数据标准接口对接门票管理系统订单数据标准接口包含：对接在线监测接口、订单（非实名制）下单推送接口、订单（实名制）下单推送接口、订单（分时预约）下单推送接口、订单预下单推送接口、订单信息修改接口、订单退单接口、订单退单回滚接口、订单详情查询接口、获取订单凭证接口、订单凭证重发接口、订单下单通知接口、订单线上检票接口、订单核销通知接口对接电商服务平台标准数据接口对接电商服务平台标准数据接口包含：单位基本信息接口、票型信息接口、订单基本信息查口、订单明细信息查口、订单实名制信息接口、订单检票信息接口、订单退票基本信息接口、订单退票明细信息接口。对接分时预约平台标准数据接口分时预约库存信息推送接口对接门票管理系统基础数据标准接口对接门票管理系统基础数据标准接口包含：客户（旅行社）基本信息接口、单位基本信息接口、票型信息接口、线上交易明细接口、线下交易明细接口、线下支付方式交易流水接口、线上实名制信息接口、线下实名制信息接口、线上检票明细接口、线下检票明细接口、线上退单明细接口、线下退单明细接口、线上退单流水接口、离园信息接口、IC卡交易信息（开卡，补卡）接口、IC卡入园刷卡信息接口、订单详情快照信息接口、订单核销接口对接数据上报服务平台标准数据接口对接数据上报服务平台标准数据接口包含：客户（旅行社）基本信息接口、单位基本信息接口、票型信息接口、线上交易明细接口、线下交易明细接口、线下支付方式交易流水接口、线上实名制信息接口、线下实名制信息接口、线上检票明细接口、线下检票明细接口、线上退单明细接口、线下退单明细接口、线上退单流水接口、离园信息接口、IC卡交易信息接口、IC卡入园刷卡信息接口。A.1.3旅游企业服务总线系统接口说明接口通讯方式旅游企业服务总线系统与门票管理系统或者数据上报服务平台通过HTTPS的PoST方式请求，JSoN格式报文进行数据交互。消息报文格式请求和响应消息报文具有统一的格式，采用JSoN格式进行通讯参数兼容性请求是否成功，与请求参数的顺序无关请求是否成功，与请求JSoN中的键值对出现的顺序无关处理应答时，不应假设应答JSON中的键值对出现的顺序新的APl版本可能在请求或应答中加入新的参数或者JSON的键值对新的APl版本不会去除请求和应答中已经存在的必填参数或者JSoN的键值对当请求或应答中的JSON键值对的值为空（null）时，可以省略。请求头参数说明所有请求必须添加请求头,B.2及B.3中所有请求参数追加在请求头参数之后。请求头参数构成如下：请求头参数构成数据项类型位数说明appld字符32应用ID,由平台分配（示例：S20229191）requestId字符32请求编号,唯一标识本次请求（示例值：202206141614236660001）timestamp数字16时间戳（亳秒）（示例：1655261377448）nonceStr字符32随机字符（示例值：593BEC0C930BF1AFEB40B4A08C8FB242）version字符16协议版本（示例：VDsign字符32签名（示例值：863HF0C930BF!AHKU40B425C6FK298）响应参数说明响应参数为json格式:响应参数说明数据项类型位数说明code数字10状态码0表示成功，1表示失败（示例：0）msg字符128状态描述（示例：成功）data字符10000响应数据，B.2及B.3中各接口响应参数皆做为data子节点消息签名Sign规则假设请求头如下：appld:S20229191requestId:T202206141614236660001timestamp:1655261377448nonceStr:593BECOC930BFIAFEB40B4A08C8FB242version：Vl假设请求体json如下（如无请求体，取值）：*userNane*:"张小明"，"age”:30第一步：对所有参数按照key=value的格式，并按照参数名ASCH字典序排序，请求体key名为body,示例如下：appId=S20229191&body="userName：”张小明","age”:30&nonceStr=593BEC0C930BFlAFEB40B4A08C8FB242&requestId=T20220614161423666000l&timestamp=l655261377448&version=V1第二步：拼接appSecret密钥（不含）,示例如下：上一步排序后的字符串&key;XXXXXXXXXXX第三步：MD5加密（不含）,大写，示例如下：MD5（拼接后的完整字符串）.toUpperCase（）互联网分销支撑接口技术规范A.1.4获取商品库存和价格接口请求参数获取商品库存和价格请求参数数据项类型位数说明goodsCode字符40商品编号StartDay字符20商品库存开始日期endDay字符20商品库存结束日期响应参数获取商品库存和价格响应参数数据项类型位数说明goodsCode字符40商品编号goodsInfos字符500商品库存信息,可含多条库存信息；库存信息如下：stock,price,daystock数字10库存数量price字符10价格day字符10日期A.1.5订单下单接口请求参数订单下单接口请求参数数据项类型位数说明CertificateType字符30证件类型CertificateNo字符30证件号码IinkName字符30联系人IinkMobile字符20联系人手机号OrderCode字符20第三方订单号OrderPrice字符10订单总价格PayMethod字符10支付方式faceSrc字符50联系人照片路径groupNo字符20团号ticketrders字符2000门票子订单,可含多张门票订单；门票订单包含：SubOrderCode,price,quantity,totalPrice,goodsCode,occDate,goodsName,fsStartTime,fsEndTime,remarkSubOrderCode字符20第三方子订单号price字符10票价quantity数字10门票数量totalPrice字符20子订单总价goodsCode字符20票型编码occDate字符10游玩日期goodsName字符20票型名称fSStartTime字符10分时开始时间fsEndTime字符10分时结束时间remark字符20备注OtherVisitor字符2000游客信息,可含多名游客；游客信息包含：name,CertificateType,CertificateNo,faceUrlname字符20游客姓名CertificateType字符10证件类型CertificateNo字符20证件号faceUrl字符40人脸图片地址响应参数订单下单接口响应参数数据项类型位数说明OtaOrderCode字符20OTA订单号OrderCode字符20第三方订单号PayMethod数字10支付方式assiStCheckNo字符10辅助检票号PayStatus字符10支付状态imgUrl字符40二维码地址imgContent字符40二维码内容imgType字符10二维码类型ticketrders字符2000门票订单信息,可含多张门票订单；门票订单包含：SubOrderCode,quantity,occDate,StartTime,endTime,goodsCode,goodsName,fsStartTime,fsEndTime,remarkSubOrderCode字符20第三方子订单号quantity字符10数量occDate字符20指定游玩日StartTime字符10订单生效日期endTime字符10订单结束Fl期goodsCode字符10票型编码goodsName字符20票型名称fsStartTime字符10分时开始时间fsEndTime字符10分时结束时间remark字符20备注A.1.6订单预下单接口请求参数订单预下单接口请求参数数据项类型位数说明CertificateType字符30证件类型CertificateNo字符30证件号码IinkName字符30联系人IinkMobile字符20联系人手机号OrderCode字符20第三方订单号OrderPrice字符10订单总价格PayMethod字符10支付方式faceSrc字符50联系人照片路径groupNo字符20团号ticketrders字符2000门票子订单,可含多张门票订单；门票订单包含：SubOrderCode,price,quantity,totalPrice,goodsCode,occDate,goodsName,fsStartTime,fsEndTime,remarkSubOrderCode字符20第三方子订单号price字符10票价quantity数字10门票数量totalPrice字符20子订单总价goodsCode字符20票型编码occDate字符10游玩日期goodsName字符20票型名称fsStartTime字符10分时开始时间fsEndTime字符10分时结束时间remark字符20备注OtherVisitor字符2000游客信息,可含多名游客；游客信息包含：name,CertificateType,CertificateNo,faceUrlname字符20游客姓名CertificateType字符10证件类型CertificateNo字符20证件号faceUrl字符40人脸图片地址响应参数订单预下单接口响应参数数据项类型位数说明status字符20状态,例：处理成功A.1.7订单支付确认接口请求参数订单支付确认接口请求参数数据项类型位数说明OrderCode字符20OTA订单号响应参数订单支付确认接口响应参数数据项类型位数说明status字符20状态,例：处理成功A.1.8订单详情接口请求参数订单详情接口请求参数数据项类型位数说明OrderCode字符20OTA订单号响应参数订单详情接口响应参数数据项类型位数说明imgContent字符20二维码内容imgType字符10二维码类型imgUri数字20二维码链接quantity数字10票数IinkName字符10联系人姓名IinkMobile字符10联系人手机号OrderCode字符20订单号OrderStatus字符10订单状态assiStCheckNo字符10辅助码ticketrders字符2000子订单信息,可含多个子订单totalPrice字符10OTA子订单总价price字符10门票单价quantity数字10门票数量occDate字符20游玩日期goodsCode字符20门票编码goodsName字符20门票名称StartDate字符10有效期开始日期endDate字符10有效期结束日期SubThirdCode字符20OTA子订单号returnNum数字10退票数alreadyCheckNum数字10已检票数A.1.9订单信息修改接口请求参数订单信息修改接口请求参数数据项类型位数说明OrderCode字符20OTA订单号ncwMobile字符20新手机号new0ccDate字符10新的游玩时间HewCertificateNo字符20新证件号newCertificateType字符10新证件类型SubOrderCode字符20DTA子订单号响应参数订单信息修改接口响应参数数据项类型位数说明imgContent字符20二维码内容imgData字符10二维码流imgUrl字符20二维码链接quantity数字10票数IinkName字符10联系人姓名IinkMobile字符10联系人手机号OrderCode字符20OrderStatus字符10订单状态assiStCheckNo字符10辅助码ticketrders字符2000子订单信息,可含多个子订单：totalPrice字符10OTA子订单总价price字符10门票单价quantity数字10门票数量occDate字符20游玩日期goodsCode字符20门票编码goodsName字符20门票名称StartDate字符10有效期开始日期endDate字符10有效期结束日期SubThirdCode字符20OTA子订单号A.1.10获取订单凭证接口请求参数获取订单凭证接口请求参数数据项类型位数说明OrderCode字符20OTA订单号响应参数获取订单凭证接口响应参数数据项类型位数说明assiStCheckNo字符10辅助码imgUrl字符20二维码地址imgContent字符20二维码内容imgData字符100二维码流imgType字符10二维码类型A.1.11退订接口请求参数退订接口请求参数数据项类型位数说明order字符500订单信息，后部参数父节点OrderCode字符20OTA订单编号thIrdOrderCode字符20OTA子订单编号returnNum数字10退票数量CertificateType字符10证件类型CertificateNo字符40证件号码returnvisitors字符200退票游客信息CertificateName字符40身份证姓名CertificateNo字符40退票身份证号响应参数退订接口响应参数数据项类型位数说明audit字符10是否需要审核expectTime字符20预计审核时间A.1.12验证消费通知接口请求参数验证消费通知接口请求参数数据项类型位数说明CheckNotice字符200验证通知信息order字符500订单信息，后部参数父节点OrderCode字符20OTA订单编号SubOrderCode字符20OTA子订单编号checkNum数字10每次检票数total数字10门票总数量CheckTime字符20检票时间status字符10检票状态响应参数验证消费通知接口响应参数数据项类型位数说明status字符32通知状态SUCCeSS-成功A.1.13退订通知接口请求参数退订通知接口请求参数数据项类型位数说明retreatNotice字符200退票通知信息order字符500订单信息，后部参数父节点OrderCode字符20OTA订单编号SubOrderCode字符20OTA子订单编号checkNum数字10每次检票数retFeatBatchNo字符30门票总数量auditstatus字符10审核状态（示例值:auditStatus）响应参数退订通知接口响应参数数据项类型位数说明status字符32通知状态SUCCeSS-成功A.1.14下单通知接口请求参数下单通知接口请求参数数据项类型位数说明OrderNotice字符200下单通知信息OrderStatus字符10下单状态order字符500订单信息，后部参数父节点CertificateNo字符20眸系人证件号1InkName字符20联系人名称IinkMobile字符20联系人手机号OrderCode字符20订单号thIrdOrderCode字符20OTA订单号OrderPrice字符10订单总价payMethod字符10支付方式assiStCheckNo字符10辅助码PayStatus字符10支付状态smStatus字符10短信是否已发imgContent字符20二维码内容imgUrl字符20二维码链接imgData字符100二维码流ticketrders字符200子订单信息ScenicThirdCode字符20营销渠道子订单编号totalPrice字符10总价price字符10单价quantity数字10票数occDate字符10游玩日期goodsCode字符10票型编码/goodsName字符20票型名称remark字符20备注StartDate字符10有效期开始时间endDate字符10有效期结束时间响应参数下单通知接口响应参数数据项类型位数说明status字符32通知状态SUCCeSS-成功A.1.15查询分时预约时段和库存接口请求参数查询分时预约时段和库存接口请求参数数据项类型位数说明goodsCode字符10商品编码StartDate字符10开始日期endDate字符10结束日期响应参数查询分时预约时段和库存接口响应参数数据项类型位数说明fSStockDtos字符2000库存信息,可含多条库存信息；单条库存信息包括：num,StartTimc,endTime,occDatenum数字10数量StartTime字符10开始时段endTime字符10结束时段occDate字符10日期A.1.16开票接口请求参数开票接口请求参数数据项类型位数说明thirdSerialNo字符20第三方（调用方）流水号buyCategory字符10开票类别InvoiceCategory字符10发票类别taxationcategory字符10征税方式SaleDutyNo字符10分销商税号buyDutyName字符10买方名称buyAddress字符20买方地址buyTel字符20买方联系电话buyBankNo字符20买方银行账号receiVeMobile字符20接收消息手机号receiveEmail字符20接收消息邮箱OriginalInvoiceCode字符20蓝票对应发票代码OriginalNo字符20蓝票对应发票号码CorpCategory字符10企业类别CreateInvoiceBy字符10开票人checker字符10审核人InvoiceMsgs字符200发票信息goodsNo字符10商品编码ProjectName字符10项目名称/specifications字符10规格unit字符10单位num数字10数量totalPrice字符10总价rate字符10费率IaxRateFree字符10免税标识响应参数开票接口响应参数数据项类型位数说明resuItCode字符10结果码desc字符200描述SearchCode字符20开票方流水SerialNo字符20流水号jshj字符10价税合计即含税总额hjse字符10合计税额-开票税总额A.1.17开票查询接口请求参数开票查询接口请求参数数据项类型位数说明InvoiceCategory字符10发票类别thirdSerialNo字符20第三方流水SaleDutyNo字符10分销商税号响应参数开票查询接口响应参数数据项类型位数说明resuItCode字符10开票编码description字符2