GET api/Order/Query/Main/{orderid}?personalid={personalid}

依据订单号查询一个订单的主记录(返回参数中的明细记录的集合均为空)。 仅当这个订单是您发起预订的,才会有数据返回。 认证方式:HAWK,密钥:KEY+UPPER(MD5(密码))。

Request Information

URI Parameters

NameDescriptionTypeAdditional information
orderid

电子门票系统订单编号

string

Required

personalid

个人会员ID,当个人会员通过官方渠道发起操作时这个参数必须,代理商可以不提供这个参数。

integer

Default value is 0

Body Parameters

None.

Response Information

Resource Description

依据订单号查询一个订单的主记录(返回参数中的明细记录的集合均为空)。 仅当这个订单是您发起预订的,才会有数据返回。 认证方式:HAWK,密钥:KEY+UPPER(MD5(密码))。

Order
NameDescriptionTypeAdditional 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

Sample:
{
  "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:13:33.3429041+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:13:33.3429041+08:00",
  "endchkenalbetime": "2025-12-06T12:13:33.3429041+08:00",
  "totalfreecount": 1,
  "needactivatormanaual": "sample string 35",
  "verifyaftermanaualactivator": "sample string 36",
  "manualactivatortime": "2025-12-06T12:13:33.3429041+08:00"
}

application/xml, text/xml

Sample:
<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:13:33.3429041+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:13:33.3429041+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:13:33.3429041+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:13:33.3429041+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>