GET api/Order/Query/Main?orderid={orderid}&sendid={sendid}&personalid={personalid}
依据订单号或接口方业务单据号查询一个订单的主记录(返回参数中的明细记录的集合均为空)。 仅当这个订单是您发起预订的,才会有数据返回。 认证方式:HAWK,密钥:KEY+UPPER(MD5(密码))。
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| orderid |
电子门票系统订单编号 |
string |
Default value is |
| sendid |
第三方系统的订单编号,只有当您在发起预订的环节指定了sendid参数,此时才可能通过这个API检索,可以为空,但不能同时和orderid为空。 |
string |
Default value is |
| personalid |
个人会员ID,当个人会员通过官方渠道发起操作时这个参数必须,代理商可以不提供这个参数。 |
integer |
Default value is 0 |
Body Parameters
None.
Response Information
Resource Description
依据订单号或接口方业务单据号查询一个订单的主记录(返回参数中的明细记录的集合均为空)。 仅当这个订单是您发起预订的,才会有数据返回。 认证方式:HAWK,密钥:KEY+UPPER(MD5(密码))。
Order| Name | Description | Type | Additional information |
|---|---|---|---|
| senderid |
被接口方的业务单据ID,示例:同程网接口调用,此值表示同程网业务系统内对应的订单的单据号,此值在接口方系统内应为唯一值。不提供此参数时,系统将不会执行回调通知。提供这个参数还可以防止订单的重复提交。 |
string |
None. |
| orderdescription |
订单的简述,如“XXX票XX张,XXXB票XXXB张......” |
string |
None. |
| summary |
合计整个订单的预订金额。 |
decimal number |
None. |
| theatrial |
剧目名称,在演艺类供应商,影院类供应商此值有含义 |
string |
None. |
| totalcount |
合计整个订单的预订数量。 |
integer |
None. |
| ticketchecktimespan |
预计的检票时间,分时段售检票或演艺剧场均会返回这个值。 |
string |
None. |
| timespanindex |
时段序号,此值仅在分时段景区中有含义。 |
integer |
None. |
| servicename |
服务名称(线路名称),此值仅在分时段景区中有含义。如“A线票”、“B线票”。 |
string |
None. |
| servicecode |
服务ID(线路ID),此值仅在分时段景区中有含义。 |
string |
None. |
| customername |
客户名称,如“上海万程网络科技有限公司”。 |
string |
None. |
| customerid |
客户ID,电子门票系统中唯一地标识每一个代理商的ID号 |
string |
None. |
| customertypename |
客户类型名称,如地接社、组团社、协议单位,地接社部门、组团社部门、协议单位部门、导游员、官方网络,对应customertypecode的值为1,2,3,4,5,7,8 |
string |
None. |
| customertypecode |
客户类型代码(1,2,3,4,5,6,7,8) |
string |
None. |
| ordertime |
发起预订的日期时间,格式:yyyymmddHHmmss。 |
string |
None. |
| effectdate |
生效日期,格式:yyyyMMdd,门票从此日开始起效(可以使用门票的第一日)。 |
string |
None. |
| scenename |
场次名称,此值仅在演艺剧场中有效,指明当前订单订的是哪一场的门票。 |
string |
None. |
| scenetime |
场次(场次演出或放映)的开始时间和结束时间,此值在演艺类供应商和影院类供应商有意义。 |
string |
None. |
| paymenttype |
付款方式的名称,如“支付宝即时到账”,“预订金支付”。 |
string |
None. |
| paytimeout |
支付时效限制,整型值,单位分钟. 若您的WEB账户带有”允许前台现付”属性,则不需要理会该参数,若您的WEB账户不带有”允许前台现付”属性,则系统将在预定单提交后,此值所指示的分钟数到达时,自动关闭当前定单 |
string |
None. |
| invoicecode |
购货人统一社会信用代码,当需要发票为“1”,但此项为空时,则发票将开“个人”。 |
string |
None. |
| invoicetitle |
发票上打印的购货人单位名称 |
string |
None. |
| needinvoice |
是否需要发票,“1”表示需要,“0”表示不需要。 |
string |
None. |
| sellbillid |
售票单单据号,在电子门票系统中,售票单是唯一表达成交交易的单据,当订单在支付成功之后、前台取票之后会成一个售票单,此值为对应的售票单的单据号。 |
string |
None. |
| deliverytime |
交割日期时间,以字符串表示YYYYMMDDHHMMSS,指订单转换为“已交割”/“已前台现付取票”/“已交割(返款)”这三种状态时的系统时刻。 当前订单在此时刻生成的门票列表。 |
string |
None. |
| seatlist |
在演艺剧场的订单中,此值有意义,返回当前订单所分配的座位表。如“B区11排1,2,3,4,5座”。 |
string |
None. |
| statuscode |
订单状态,预定中 0 已交割 3 已关闭 4 第三方付款已支付待核准 5 第三方支付退款申请中 7 第三方付款退款办理中 B 已前台现付取票 X 已交割(返款) D |
string |
None. |
| statusname |
状态名称 |
string |
None. |
| mobile |
手机号码,如果系统有依据订单的通知(如退款完成,订单取票等),将发送到这个手机上。 |
string |
None. |
| identificationnumber |
身份证号,如果订单内的门票均是非实名的且需要取票的,客人可以使用这个证件号到前台或自助机上取票。 |
string |
None. |
| guestname |
预订人姓名 |
string |
None. |
| orderid |
订单号,在订单下单时,产生于电子门票系统的订单号。 |
string |
None. |
| orderdetail |
订单明细记录 |
Collection of OrderItem |
None. |
| feeitem |
订单的手续费扣除清单 |
Collection of OrderFeeItem |
None. |
| logs |
订单的日志信息。 |
Collection of OrderLog |
None. |
| reserve1 |
订单下单的备注1信息(保留一信息)对应到数据库的备注字段。 |
string |
None. |
| reserve2 |
订单下单的(保留二信息) |
string |
None. |
| delayactbill |
是否是延迟激活单据,‘1’是,‘0’否。 延迟激活/选座单据的意思是购票并支付后,订单下的票处理”未激活“状态,不能使用,需要根据短信引导到一个H5站点,激活之后才可以有使用。 这个H5站点可以激活,选座,录入人脸等。 |
string |
None. |
| paymentendtime |
订单的支付时限,未支付的订单在此时间前可以支付。 |
date |
None. |
| totaldealsummary |
合计的成交金额,这个合计不包括未成交,已退票的。 |
decimal number |
None. |
| totaldelacount |
合计的成交数量,这个合计不包括未成交的,已退票的。 |
decimal number |
None. |
| couponreduction |
单据参与”优惠活动“共减免的金额(如满100减10),所有参与的优惠活动汇总至此字段。 |
decimal number |
None. |
| coupondeduction |
单据使用优惠券进行支付时,合计使用的优惠券的金额。 |
decimal number |
None. |
| actualpayamount |
订单的支付金额(除优惠活动,优惠券以外)其他各种支付活动的合计。 |
decimal number |
None. |
| insurancesummary |
保险金额。 |
decimal number |
None. |
| holeteamchktimespan |
如果当前订单需要整团入园,此值表示当订单下的门票第一次检票时,确定的整团入园时间容差,单位为分钟。 |
integer |
None. |
| firstchktime |
如果订单需要整团入园时,此值表示系统登记到的订单下门票的第一个检票的发生时间。 |
date |
None. |
| endchkenalbetime |
如果订单需要整团入园时,此值表示客人必须在此时间范围内入园或退票。 一般由火爆的自然分光景区设置,表示一个订单,不允许分开零售给散客。 订单提交时,这个字段是没有值的,当订单下的任意一个门票首次检票,订单下其他门票的入园时间范围就通过这个字段确定。 |
date |
None. |
| totalfreecount |
当有现返政策(如N免1)时,此值表示现返的人数的数量。现返是不需要支付的,随同订单支付时成交。 |
integer |
None. |
| needactivatormanaual |
是否需要前台激活。1表示是。此值为1时,表示订单支付并成交后,订单下的门票需要到前台出示凭证,由售票会手动激活才可以使用。 未激活的订单是可以整单关闭的。 此功能主要用于部分自然分光型景区,要求旅行社代导游订的票必须持导游证到前台激活。 |
string |
None. |
| verifyaftermanaualactivator |
前台激活是否视同核销:对于需要手动激活的订单,前台激活后是否视同核销(发送回调,阻止退票,仍然可以过闸)。 |
string |
None. |
| manualactivatortime |
前台激活的时间。 |
date |
None. |
Response Formats
application/json, text/json
{
"senderid": "sample string 1",
"orderdescription": "sample string 2",
"summary": 3.0,
"theatrial": "sample string 4",
"totalcount": 5,
"ticketchecktimespan": "sample string 6",
"timespanindex": 7,
"servicename": "sample string 8",
"servicecode": "sample string 9",
"customername": "sample string 10",
"customerid": "sample string 11",
"customertypename": "sample string 12",
"customertypecode": "sample string 13",
"ordertime": "sample string 14",
"effectdate": "sample string 15",
"scenename": "sample string 16",
"scenetime": "sample string 17",
"paymenttype": "sample string 18",
"paytimeout": "sample string 19",
"invoicecode": "sample string 20",
"invoicetitle": "sample string 21",
"needinvoice": "sample string 22",
"sellbillid": "sample string 23",
"deliverytime": "sample string 24",
"seatlist": "sample string 25",
"statuscode": "sample string 26",
"statusname": "sample string 27",
"mobile": "sample string 28",
"identificationnumber": "sample string 29",
"guestname": "sample string 30",
"orderid": "sample string 31",
"orderdetail": [
{
"autoid": 1,
"productid": "sample string 2",
"amount": 3,
"identificationnumber": "sample string 4",
"fullname": "sample string 5",
"identificationtype": "sample string 6",
"mobile": "sample string 7",
"gateinmode": "sample string 8",
"productname": "sample string 9",
"price": 10.0,
"ticketinnernumber": "sample string 11",
"singlemode": "sample string 12",
"timespanusetype": "sample string 13",
"status": "sample string 14",
"seatsdescription": "sample string 15",
"HasInsurance": "sample string 16",
"InsuranceCount": 17,
"InsurancePrice": 18.0
},
{
"autoid": 1,
"productid": "sample string 2",
"amount": 3,
"identificationnumber": "sample string 4",
"fullname": "sample string 5",
"identificationtype": "sample string 6",
"mobile": "sample string 7",
"gateinmode": "sample string 8",
"productname": "sample string 9",
"price": 10.0,
"ticketinnernumber": "sample string 11",
"singlemode": "sample string 12",
"timespanusetype": "sample string 13",
"status": "sample string 14",
"seatsdescription": "sample string 15",
"HasInsurance": "sample string 16",
"InsuranceCount": 17,
"InsurancePrice": 18.0
}
],
"feeitem": [
{
"autoid": 1,
"productid": "sample string 2",
"productname": "sample string 3",
"price": 4.0,
"amount": 5.0,
"description": "sample string 6",
"calculatetype": "sample string 7",
"perticketfee": 8.0,
"feeamount": 9,
"isautoreturn": true,
"paychannelname": "sample string 11",
"needrefundsummary": 12.0,
"startdatetime": "sample string 13",
"completedatetime": "sample string 14",
"status": "sample string 15",
"statusname": "sample string 16",
"batchno": "sample string 17"
},
{
"autoid": 1,
"productid": "sample string 2",
"productname": "sample string 3",
"price": 4.0,
"amount": 5.0,
"description": "sample string 6",
"calculatetype": "sample string 7",
"perticketfee": 8.0,
"feeamount": 9,
"isautoreturn": true,
"paychannelname": "sample string 11",
"needrefundsummary": 12.0,
"startdatetime": "sample string 13",
"completedatetime": "sample string 14",
"status": "sample string 15",
"statusname": "sample string 16",
"batchno": "sample string 17"
}
],
"logs": [
{
"serialid": 1,
"eventtypecode": "sample string 2",
"eventtypename": "sample string 3",
"orderid": "sample string 4",
"sellbillid": "sample string 5",
"ticketid": "sample string 6",
"datetime": "sample string 7",
"content": "sample string 8",
"replaytime": "sample string 9",
"replayresult": "sample string 10",
"replaystatuscode": "sample string 11",
"replaystatus": "sample string 12"
},
{
"serialid": 1,
"eventtypecode": "sample string 2",
"eventtypename": "sample string 3",
"orderid": "sample string 4",
"sellbillid": "sample string 5",
"ticketid": "sample string 6",
"datetime": "sample string 7",
"content": "sample string 8",
"replaytime": "sample string 9",
"replayresult": "sample string 10",
"replaystatuscode": "sample string 11",
"replaystatus": "sample string 12"
}
],
"reserve1": "sample string 32",
"reserve2": "sample string 33",
"delayactbill": "sample string 34",
"paymentendtime": "2025-12-06T12:14:51.2035478+08:00",
"totaldealsummary": 1.0,
"totaldelacount": 1.0,
"couponreduction": 1.0,
"coupondeduction": 1.0,
"actualpayamount": 1.0,
"insurancesummary": 1.0,
"holeteamchktimespan": 1,
"firstchktime": "2025-12-06T12:14:51.2035478+08:00",
"endchkenalbetime": "2025-12-06T12:14:51.2035478+08:00",
"totalfreecount": 1,
"needactivatormanaual": "sample string 35",
"verifyaftermanaualactivator": "sample string 36",
"manualactivatortime": "2025-12-06T12:14:51.2035478+08:00"
}
application/xml, text/xml
<Order xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Tour.V5.Result.WebInterface">
<actualpayamount>1</actualpayamount>
<coupondeduction>1</coupondeduction>
<couponreduction>1</couponreduction>
<customerid>sample string 11</customerid>
<customername>sample string 10</customername>
<customertypecode>sample string 13</customertypecode>
<customertypename>sample string 12</customertypename>
<delayactbill>sample string 34</delayactbill>
<deliverytime>sample string 24</deliverytime>
<effectdate>sample string 15</effectdate>
<endchkenalbetime>2025-12-06T12:14:51.2035478+08:00</endchkenalbetime>
<feeitem>
<OrderFeeItem>
<amount>5</amount>
<autoid>1</autoid>
<batchno>sample string 17</batchno>
<calculatetype>sample string 7</calculatetype>
<completedatetime>sample string 14</completedatetime>
<description>sample string 6</description>
<feeamount>9</feeamount>
<isautoreturn>true</isautoreturn>
<needrefundsummary>12</needrefundsummary>
<paychannelname>sample string 11</paychannelname>
<perticketfee>8</perticketfee>
<price>4</price>
<productid>sample string 2</productid>
<productname>sample string 3</productname>
<startdatetime>sample string 13</startdatetime>
<status>sample string 15</status>
<statusname>sample string 16</statusname>
</OrderFeeItem>
<OrderFeeItem>
<amount>5</amount>
<autoid>1</autoid>
<batchno>sample string 17</batchno>
<calculatetype>sample string 7</calculatetype>
<completedatetime>sample string 14</completedatetime>
<description>sample string 6</description>
<feeamount>9</feeamount>
<isautoreturn>true</isautoreturn>
<needrefundsummary>12</needrefundsummary>
<paychannelname>sample string 11</paychannelname>
<perticketfee>8</perticketfee>
<price>4</price>
<productid>sample string 2</productid>
<productname>sample string 3</productname>
<startdatetime>sample string 13</startdatetime>
<status>sample string 15</status>
<statusname>sample string 16</statusname>
</OrderFeeItem>
</feeitem>
<firstchktime>2025-12-06T12:14:51.2035478+08:00</firstchktime>
<guestname>sample string 30</guestname>
<holeteamchktimespan>1</holeteamchktimespan>
<identificationnumber>sample string 29</identificationnumber>
<insurancesummary>1</insurancesummary>
<invoicecode>sample string 20</invoicecode>
<invoicetitle>sample string 21</invoicetitle>
<logs>
<OrderLog>
<content>sample string 8</content>
<datetime>sample string 7</datetime>
<eventtypecode>sample string 2</eventtypecode>
<eventtypename>sample string 3</eventtypename>
<orderid>sample string 4</orderid>
<replayresult>sample string 10</replayresult>
<replaystatus>sample string 12</replaystatus>
<replaystatuscode>sample string 11</replaystatuscode>
<replaytime>sample string 9</replaytime>
<sellbillid>sample string 5</sellbillid>
<serialid>1</serialid>
<ticketid>sample string 6</ticketid>
</OrderLog>
<OrderLog>
<content>sample string 8</content>
<datetime>sample string 7</datetime>
<eventtypecode>sample string 2</eventtypecode>
<eventtypename>sample string 3</eventtypename>
<orderid>sample string 4</orderid>
<replayresult>sample string 10</replayresult>
<replaystatus>sample string 12</replaystatus>
<replaystatuscode>sample string 11</replaystatuscode>
<replaytime>sample string 9</replaytime>
<sellbillid>sample string 5</sellbillid>
<serialid>1</serialid>
<ticketid>sample string 6</ticketid>
</OrderLog>
</logs>
<manualactivatortime>2025-12-06T12:14:51.2035478+08:00</manualactivatortime>
<mobile>sample string 28</mobile>
<needactivatormanaual>sample string 35</needactivatormanaual>
<needinvoice>sample string 22</needinvoice>
<orderdescription>sample string 2</orderdescription>
<orderdetail>
<OrderItem>
<HasInsurance>sample string 16</HasInsurance>
<InsuranceCount>17</InsuranceCount>
<InsurancePrice>18</InsurancePrice>
<amount>3</amount>
<autoid>1</autoid>
<fullname>sample string 5</fullname>
<gateinmode>sample string 8</gateinmode>
<identificationnumber>sample string 4</identificationnumber>
<identificationtype>sample string 6</identificationtype>
<mobile>sample string 7</mobile>
<price>10</price>
<productid>sample string 2</productid>
<productname>sample string 9</productname>
<seatsdescription>sample string 15</seatsdescription>
<singlemode>sample string 12</singlemode>
<status>sample string 14</status>
<ticketinnernumber>sample string 11</ticketinnernumber>
<timespanusetype>sample string 13</timespanusetype>
</OrderItem>
<OrderItem>
<HasInsurance>sample string 16</HasInsurance>
<InsuranceCount>17</InsuranceCount>
<InsurancePrice>18</InsurancePrice>
<amount>3</amount>
<autoid>1</autoid>
<fullname>sample string 5</fullname>
<gateinmode>sample string 8</gateinmode>
<identificationnumber>sample string 4</identificationnumber>
<identificationtype>sample string 6</identificationtype>
<mobile>sample string 7</mobile>
<price>10</price>
<productid>sample string 2</productid>
<productname>sample string 9</productname>
<seatsdescription>sample string 15</seatsdescription>
<singlemode>sample string 12</singlemode>
<status>sample string 14</status>
<ticketinnernumber>sample string 11</ticketinnernumber>
<timespanusetype>sample string 13</timespanusetype>
</OrderItem>
</orderdetail>
<orderid>sample string 31</orderid>
<ordertime>sample string 14</ordertime>
<paymentendtime>2025-12-06T12:14:51.2035478+08:00</paymentendtime>
<paymenttype>sample string 18</paymenttype>
<paytimeout>sample string 19</paytimeout>
<reserve1>sample string 32</reserve1>
<reserve2>sample string 33</reserve2>
<scenename>sample string 16</scenename>
<scenetime>sample string 17</scenetime>
<seatlist>sample string 25</seatlist>
<sellbillid>sample string 23</sellbillid>
<senderid>sample string 1</senderid>
<servicecode>sample string 9</servicecode>
<servicename>sample string 8</servicename>
<statuscode>sample string 26</statuscode>
<statusname>sample string 27</statusname>
<summary>3</summary>
<theatrial>sample string 4</theatrial>
<ticketchecktimespan>sample string 6</ticketchecktimespan>
<timespanindex>7</timespanindex>
<totalcount>5</totalcount>
<totaldealsummary>1</totaldealsummary>
<totaldelacount>1</totaldelacount>
<totalfreecount>1</totalfreecount>
<verifyaftermanaualactivator>sample string 36</verifyaftermanaualactivator>
</Order>