文档
测试
POST
接口地址:http://zjpt.gotoningbo.com:8001/admin/Api/docking_api

接口描述

请求格式:json

请求参数

参数名
类型
描述
必填
api_type
int
接口标识,示例:3
必填
type
string
操作类型,示例:save_order
必填
order_info
object
数据字典
必填
orderGetTicketName
string
取票人姓名,必填,示例:张三
必填
phoneCode
string
取票人电话区号,不填写时默认86(中国),示例:86
必填
orderGetTicketPhone
string
取票人手机号码,用于发送短信和彩信使用,必填,示例:15731445471
必填
certificateTypeNoFlag
string
刷取票身份证入园标志,Y -- 是,N -- 否 值为“Y”时:1、实名制(持票人姓名、证件号码、持票人手机号码)不能填写;2、取票人身份证号码(certificateTypeNo)可填可不填,填写了取票人身份证时可以通过取票人身份证号码刷闸机入园,示例:N
必填
certificateTypeNo
string
取票人身份证,示例:610404197603155734
必填
orderStarArrivalDate
string
游玩开始日期(格式:yyyy-MM-dd),必填,示例:2020-08-05
必填
orderEndArrivaDate
string
游玩结束日期(格式:yyyy-MM-dd),必填,示例:2020-08-05
必填
paymentTypeId
string
支付方式:1预存,2签单,3到付(预存:分销商先往景区账户充值,然后下单;签单:分销商先下单,然后每隔一段时间与景区结算;到付:到现场售票窗口取票时支付,部分景区支持),必填,示例:2
必填
thirdSideOrigiOrderNo
string
第三方原始订单号(OTA订单号),必填,示例:202008051435
必填
ticketInfomationList
array
数据列表,订单信息
必填
certificateParamList
array
数据列表,实名制信息
必填
holdTicketName
string
持票人姓名(一票多客入园标志为“Y”时不能填),示例:张三
必填
certificateTypeId
string
证件类型(一票多客入园标志为“Y”时不能填),1:身份证,2:护照,3:港澳通行证,默认身份证,示例:1
必填
certificateNo
string
证件号码(一票多客入园标志为“Y”时不能填),示例:610404197603155734
必填
touristPhone
string
持票人手机号码(一票多客入园标志为“Y”时不能填)
必填
orderTicketSum
string
购票数量,示例:3
必填
ticketTypeNO
string
票种编号,示例:10328
必填
activityTimeNo
string
场次编号(为剧场门票时,此参数必传),示例:2000254
必填
ticketPrice
string
票种签约价格(当景区支持自定义价格且下单票种为区间价格票种时为必填参数),示例:0.01
必填

响应参数

参数名
类型
描述
必填
messageCode
string
返回状态码,示例:0
必填
messageInfo
string
说明,示例:下单成功
必填
orderNo
string
票在旅途订单号,示例:11521541540129
必填
orderVoucherNo
string
取票凭证码,示例:8720442
必填
ticketBarcodeList
array
数据列表,入园信息二维码列表
必填
orderCertificateList
array
数据列表,证件信息集合
必填
certificateNo
string
实名制证件号,示例:610404197603155734
必填
certificateTypeName
string
证件类型说明,示例:身份证
必填
certificateTypeNo
string
证件类型编号,示例:C001
必填
holdTicketName
string
实名制姓名,示例:张三
必填
touristPhone
string
实名制电话,示例:15731445471
必填
ticketBarcodeNo
string
二维码编号,示例:18B9CCA00A893F9D
必填
ticketCount
string
数量,示例:1
必填
ticketTypeNO
string
票种编号,示例:10328
必填
validityEndTime
string
有效开始时间,示例:2020-08-05 18:00:00
必填
validityStartTime
string
有效结束时间,示例:2020-08-05 06:00:00
必填

说明 / 示例

** 请求示例 ** >i{ "api_type":3, "type":"save_order", "order_info":{ "orderGetTicketName":"张三", "orderGetTicketPhone":"15731445471", "certificateTypeNoFlag":"N", "certificateTypeNo":"610404197603155734", "orderStarArrivalDate":"2020-08-05", "orderEndArrivaDate":"2020-08-05", "paymentTypeId":"2", "thirdSideOrigiOrderNo":"202008051535", "ticketInfomationList":[ { "certificateParamList":[ { "holdTicketName":"张三", "certificateTypeId":"1", "certificateNo":"610404197603155734", "touristPhone":"15724864113", } ], "orderTicketSum":"3", "ticketTypeNO":"10328", "activityTimeNo":"2000254", "ticketPrice":"0.01" }, { "certificateParamList":[ { "holdTicketName":"张三", "certificateTypeId":"1", "certificateNo":"610404197603155734" } ], "orderTicketSum":"3", "ticketTypeNO":"10328", "activityTimeNo":"2000254", "ticketPrice":"0.01" } ] } } ** 返回示例 ** >i{"messageCode":"0","messageInfo":"下单成功","orderNo":"11521541540129","orderVoucherNo":"8720442","ticketBarcodeList":[{"orderCertificateList":[{"certificateNo":"610404197603155734","certificateTypeName":"身份证","certificateTypeNo":"C001","holdTicketName":"张三","touristPhone":""}],"ticketBarcodeNo":"18B9CCA00A893F9D","ticketCount":"1","ticketTypeNO":"10328","validityEndTime":"2020-08-05 18:00:00","validityStartTime":"2020-08-05 06:00:00"},{"orderCertificateList":[],"ticketBarcodeNo":"BEC449E7A476B5F7","ticketCount":"1","ticketTypeNO":"10328","validityEndTime":"2020-08-05 18:00:00","validityStartTime":"2020-08-05 06:00:00"},{"orderCertificateList":[],"ticketBarcodeNo":"36B149D58292241C","ticketCount":"1","ticketTypeNO":"10328","validityEndTime":"2020-08-05 18:00:00","validityStartTime":"2020-08-05 06:00:00"}]}