GET api/WebInterface/Order/YearCard/Query/Main?dwlx={dwlx}&dwid={dwid}&orderid={orderid}&sendid={sendid}&personalid={personalid}
依据订单号或接口方业务单据号查询一个订单的主记录(返回参数中的明细记录的集合均为空)。
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| dwlx |
客户类型 |
string |
Required |
| dwid |
客户iD |
string |
Required |
| 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
依据订单号或接口方业务单据号查询一个订单的主记录(返回参数中的明细记录的集合均为空)。
YearCardOrder| Name | Description | Type | Additional information |
|---|---|---|---|
| orderid |
订单号,在订单下单时,产生于电子门票系统的订单号。 |
string |
None. |
| senderid |
被接口方的业务单据ID,示例:同程网接口调用,此值表示同程网业务系统内对应的订单的单据号,此值在接口方系统内应为唯一值。不提供此参数时,系统将不会执行回调通知。提供这个参数还可以防止订单的重复提交。 |
string |
None. |
| productid |
订购的产品的ID(门票类型的ID) |
string |
None. |
| amount |
订购产品的数量 |
integer |
None. |
| productname |
产品名称(票型名称) |
string |
None. |
| price |
价格 |
decimal number |
None. |
| ticketinnernumber |
订单支付之后,明细记录对应的票的唯一序列号。 |
string |
None. |
| status |
票的状态,1-正常,2已退票,3已列印(取票),4已过闸 |
string |
None. |
| customerid |
客户ID,电子门票系统中唯一地标识每一个代理商的ID号 |
string |
None. |
| customername |
客户名称,如“上海万程网络科技有限公司”。 |
string |
None. |
| customertypecode |
客户类型代码(1,2,3,4,5,6,7,8) |
string |
None. |
| customertypename |
客户类型名称,如地接社、组团社、协议单位,地接社部门、组团社部门、协议单位部门、导游员、官方网络,对应customertypecode的值为1,2,3,4,5,7,8 |
string |
None. |
| ordertime |
发起预订的日期时间,格式:yyyymmddHHmmss。 |
string |
None. |
| effectdate |
生效日期,格式:yyyyMMdd,门票从此日开始起效(可以使用门票的第一日)。 |
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. |
| statuscode |
订单状态,预定中 0 已交割 3 已关闭 4 第三方付款已支付待核准 5 第三方支付退款申请中 7 第三方付款退款办理中 B 已前台现付取票 X 已交割(返款) D |
string |
None. |
| statusname |
状态名称 |
string |
None. |
| fullname |
姓名 |
string |
None. |
| identificationtype |
证件类型('1'身份证,‘2’ 军官证(士兵证),‘3’护照,‘4’其他) |
string |
None. |
| identificationnumber |
证件证号,如果订单内的门票均是非实名的且需要取票的,客人可以使用这个证件号到前台或自助机上取票。 |
string |
None. |
| mobile |
手机号码,如果系统有依据订单的通知(如退款完成,订单取票等),将发送到这个手机上。 |
string |
None. |
| feeitem |
订单的手续费扣除清单 |
Collection of YearCardOrderFeeItem |
None. |
| logs |
订单的日志信息。 |
Collection of YearCardOrderLog |
None. |
Response Formats
application/json, text/json
{
"orderid": "sample string 1",
"senderid": "sample string 2",
"productid": "sample string 3",
"amount": 4,
"productname": "sample string 5",
"price": 6.0,
"ticketinnernumber": "sample string 7",
"status": "sample string 8",
"customerid": "sample string 9",
"customername": "sample string 10",
"customertypecode": "sample string 11",
"customertypename": "sample string 12",
"ordertime": "sample string 13",
"effectdate": "sample string 14",
"paymenttype": "sample string 15",
"paytimeout": "sample string 16",
"invoicecode": "sample string 17",
"invoicetitle": "sample string 18",
"needinvoice": "sample string 19",
"sellbillid": "sample string 20",
"deliverytime": "sample string 21",
"statuscode": "sample string 22",
"statusname": "sample string 23",
"fullname": "sample string 24",
"identificationtype": "sample string 25",
"identificationnumber": "sample string 26",
"mobile": "sample string 27",
"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,
"paychannelid": "sample string 10",
"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,
"paychannelid": "sample string 10",
"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"
}
]
}
application/xml, text/xml
<YearCardOrder xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Tour.V5.Result.WebInterface">
<amount>4</amount>
<customerid>sample string 9</customerid>
<customername>sample string 10</customername>
<customertypecode>sample string 11</customertypecode>
<customertypename>sample string 12</customertypename>
<deliverytime>sample string 21</deliverytime>
<effectdate>sample string 14</effectdate>
<feeitem>
<YearCardOrderFeeItem>
<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>
<needrefundsummary>12</needrefundsummary>
<paychannelid>sample string 10</paychannelid>
<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>
</YearCardOrderFeeItem>
<YearCardOrderFeeItem>
<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>
<needrefundsummary>12</needrefundsummary>
<paychannelid>sample string 10</paychannelid>
<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>
</YearCardOrderFeeItem>
</feeitem>
<fullname>sample string 24</fullname>
<identificationnumber>sample string 26</identificationnumber>
<identificationtype>sample string 25</identificationtype>
<invoicecode>sample string 17</invoicecode>
<invoicetitle>sample string 18</invoicetitle>
<logs>
<YearCardOrderLog>
<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>
</YearCardOrderLog>
<YearCardOrderLog>
<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>
</YearCardOrderLog>
</logs>
<mobile>sample string 27</mobile>
<needinvoice>sample string 19</needinvoice>
<orderid>sample string 1</orderid>
<ordertime>sample string 13</ordertime>
<paymenttype>sample string 15</paymenttype>
<paytimeout>sample string 16</paytimeout>
<price>6</price>
<productid>sample string 3</productid>
<productname>sample string 5</productname>
<sellbillid>sample string 20</sellbillid>
<senderid>sample string 2</senderid>
<status>sample string 8</status>
<statuscode>sample string 22</statuscode>
<statusname>sample string 23</statusname>
<ticketinnernumber>sample string 7</ticketinnernumber>
</YearCardOrder>
application/bson
Binary JSON content. See http://bsonspec.org for details.