POST api/Order/AddOrder2

对演艺类供应商发起预订的接口。为向下兼容,同功能的WebForms接口访问地址为~/Source/OrderProducts2.aspx

Request Information

URI Parameters

None.

Body Parameters

预订参数。接口方可以在orderparm.senderid中指定接口方系统中的唯一订单号，电子门票系统会判断该业务单据是否被提交过，如果提交过，此过程会返回单据的最新状态（注意，系统仅会检查parm.orderinfo.senderid是否已在系统中存在，而不会比对新传入的参数的其他内容与系统中已持有的单据是否相同）。

Order2AddParm

Name	Description	Type	Additional information
orderdetails	订单明细信息，指明定购产品及数量，此少需要包含一个明细。	Collection of OrderAddItemParm	Required
mobile	手机号码,如果系统有依据订单的通知（如退款完成，订单取票等），将发送到这个手机上。如果订单整没有提供证件号，所有门票都是前台取票的，取票凭证会发送到这个手机上。	string	Required Max length: 11
otheruserid	其他用户ID号，指用户在第三方系统的用户账号，主要用于官方网站和官方微信的对接，第三方OTA不能使用。	integer	None.
identificationnumber	身份证号，如果订单内的门票均是非实名的且需要取票的，客人可以使用这个证件号到前台或自助机上取票	string	Max length: 20
effectdate	生效日期，格式：yyyyMMdd。	string	Required Max length: 8
sceneid	场次ID	string	Required Max length: 36
needinvoice	是否需要发票，“1”表示需要，“0”表示不需要。	string	Max length: 1
invoicetitle	发票上打印的购货人单位名称	string	Max length: 100
invoicecode	购货人统一社会信用代码，当需要发票为“1”，但此项为空时，则发票将开“个人”。	string	Max length: 30
autoselseats	选座模式，"NN"表示自主选座，此值为默认值，则必须在seatinfo参数中传入选中的座位；"L"系统根据产品所分配的座位区域，自动从左往右选座；"F","R","B","LF","LB","RF","RB"，“D”，“M”，“A”同"L"含义类似，分别表示“从前往后”，“从右往左”，“从后往前”，“从左前往右”，“从左后往右”，“从右前往左”，“从右后往左”，“居中优先选座”和“最优观演位置优先”。“默认”自主选座。	string	None.
seatareaid	座位区域ID，在autoselseats不为”NN”时有效,指定特定自动选座作用的座位区域.如果不指定此参数,则在产品对应的可选座位区域中,自动选择其中一个座位区域.（因为一个票种可能有好几个区，提供这个参数是为了在自动选座时，客人还能获得某一个区域的选择权）。	string	None.
tripbillcode	行程单编号，此值只能对应张家界的全域通和一诚通行程单。	string	None.
senderid	被接口方的业务单据ID，示例：同程网接口调用，此值表示同程网业务系统内对应的订单的单据号，此值在接口方系统内应为唯一值。不提供此参数时，系统将不会执行回调通知。提供这个参数还可以防止订单的重复提交。	string	Max length: 50
guidernumber	导游证号	string	Max length: 20
marketareaid	市场区划的代码	string	Max length: 8

Request Formats

application/json, text/json

Sample:

{
  "orderdetails": [
    {
      "productid": "sample string 1",
      "amount": 2,
      "identificationnumber": "sample string 3",
      "fullname": "sample string 4",
      "identificationtype": "sample string 5",
      "mobile": "sample string 6",
      "gateinmode": "sample string 7",
      "seatitems": [
        {
          "seatid": "sample string 1"
        },
        {
          "seatid": "sample string 1"
        }
      ]
    },
    {
      "productid": "sample string 1",
      "amount": 2,
      "identificationnumber": "sample string 3",
      "fullname": "sample string 4",
      "identificationtype": "sample string 5",
      "mobile": "sample string 6",
      "gateinmode": "sample string 7",
      "seatitems": [
        {
          "seatid": "sample string 1"
        },
        {
          "seatid": "sample string 1"
        }
      ]
    }
  ],
  "mobile": "sample string 1",
  "otheruserid": 2,
  "identificationnumber": "sample string 3",
  "effectdate": "sample string 4",
  "sceneid": "sample string 5",
  "needinvoice": "sample string 6",
  "invoicetitle": "sample string 7",
  "invoicecode": "sample string 8",
  "autoselseats": "sample string 9",
  "seatareaid": "sample string 10",
  "tripbillcode": "sample string 11",
  "senderid": "sample string 12",
  "guidernumber": "sample string 13",
  "marketareaid": "sample string 14"
}

application/xml, text/xml

Sample:

<Order2AddParm xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Tour.V5.Parm.WebInterface">
  <autoselseats>sample string 9</autoselseats>
  <effectdate>sample string 4</effectdate>
  <guidernumber>sample string 13</guidernumber>
  <identificationnumber>sample string 3</identificationnumber>
  <invoicecode>sample string 8</invoicecode>
  <invoicetitle>sample string 7</invoicetitle>
  <marketareaid>sample string 14</marketareaid>
  <mobile>sample string 1</mobile>
  <needinvoice>sample string 6</needinvoice>
  <orderdetails>
    <OrderAddItemParm>
      <amount>2</amount>
      <fullname>sample string 4</fullname>
      <gateinmode>sample string 7</gateinmode>
      <identificationnumber>sample string 3</identificationnumber>
      <identificationtype>sample string 5</identificationtype>
      <mobile>sample string 6</mobile>
      <productid>sample string 1</productid>
      <seatitems>
        <Order2SeatItem>
          <seatid>sample string 1</seatid>
        </Order2SeatItem>
        <Order2SeatItem>
          <seatid>sample string 1</seatid>
        </Order2SeatItem>
      </seatitems>
    </OrderAddItemParm>
    <OrderAddItemParm>
      <amount>2</amount>
      <fullname>sample string 4</fullname>
      <gateinmode>sample string 7</gateinmode>
      <identificationnumber>sample string 3</identificationnumber>
      <identificationtype>sample string 5</identificationtype>
      <mobile>sample string 6</mobile>
      <productid>sample string 1</productid>
      <seatitems>
        <Order2SeatItem>
          <seatid>sample string 1</seatid>
        </Order2SeatItem>
        <Order2SeatItem>
          <seatid>sample string 1</seatid>
        </Order2SeatItem>
      </seatitems>
    </OrderAddItemParm>
  </orderdetails>
  <otheruserid>2</otheruserid>
  <sceneid>sample string 5</sceneid>
  <seatareaid>sample string 10</seatareaid>
  <senderid>sample string 12</senderid>
  <tripbillcode>sample string 11</tripbillcode>
</Order2AddParm>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

对演艺类供应商发起预订的接口。为向下兼容,同功能的WebForms接口访问地址为~/Source/OrderProducts2.aspx

OrderOperatorResult

Name	Description	Type	Additional information
orderid	操作对应（或产生）的电子门票系统订单号。	string	None.
sendid	操作对应的第三方系统的订单号（如同程网发送过来的订单的编号），此编号由接口方提供，在提口方系统中应为唯一值。	string	None.
orderstatus	订单当前所处的状态	string	None.
resultcode	操作返回代码，0表示成功，其他值表示错误。	integer	None.
returnmessgage	从接口返回的提示消息，用于告知成功的结果或出错的原因。	string	None.

Response Formats

application/json, text/json

Sample:

{
  "orderid": "sample string 1",
  "sendid": "sample string 2",
  "orderstatus": "sample string 3",
  "resultcode": 4,
  "returnmessgage": "sample string 5"
}

application/xml, text/xml

Sample:

<OrderOperatorResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Tour.V5.Result.WebInterface">
  <orderid>sample string 1</orderid>
  <orderstatus>sample string 3</orderstatus>
  <resultcode>4</resultcode>
  <returnmessgage>sample string 5</returnmessgage>
  <sendid>sample string 2</sendid>
</OrderOperatorResult>