GET api/WebInterface/Order/YearCard/Query/Main?dwlx={dwlx}&dwid={dwid}&orderid={orderid}&sendid={sendid}&personalid={personalid}

依据订单号或接口方业务单据号查询一个订单的主记录(返回参数中的明细记录的集合均为空)。

Request Information

URI Parameters

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

Sample:
{
  "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

Sample:
<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

Sample:
Binary JSON content. See http://bsonspec.org for details.