POST api/SpecialOta/DouYin/CalendarTicket/Order/Verify

下单前的校验接口,用于消费者预订前的信息校验,包括库存和限购规则等,保障消费者提交订单后不会因为库存不足或其他业务规则被拒单。 V5及V5以前的版本。 对V53版本添加的整团入园和保险赋值设置默认值。

Request Information

URI Parameters

None.

Body Parameters

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

needinvoice

是否需要发票,“1”表示需要,“0”表示不需要。

string

Max length: 1

invoicetitle

发票上打印的购货人单位名称

string

Max length: 100

invoicecode

购货人统一社会信用代码,当需要发票为“1”,但此项为空时,则发票将开“个人”。

string

Max length: 30

senderid

被接口方的业务单据ID,示例:同程网接口调用,此值表示同程网业务系统内对应的订单的单据号,此值在接口方系统内应为唯一值。不提供此参数时,系统将不会执行回调通知。提供这个参数还可以防止订单的重复提交。

string

Max length: 50

servicecode

服务项目ID(线路ID),此值仅在分时段景区中必须。

string

Max length: 2

timespanindex

时段序号,当门票系统处于分时段售检票模式时,此值必须;否则此值没有意义。指定时段:取值1,2,3,4,5之类的自然数,此时该时段必须是门票系统中存在的、可用的、有足够余额的,否则会占用失败;-1表示自动时段号,系统会自动检索有足够余量的时段,且时间最前的优先,来占用时段,若当天已无时段可用或没有足够的余额容纳本次占用时,预定会失败。

integer

None.

tripbillcode

行程单编号,在文档编写之时,此值只能对应张家界的全域通和一诚通行程单。

string

None.

guidernumber

导游证号

string

None.

marketareaid

市场区划的代码

string

None.

reserve1

预留一字段(对应T_SP_YD表中的BL2字段 varchar(200)) 原保留2字段用于存储预订明细表中该订单的总人数 2019-11-09 by TangYu 应卧龙要求进行修改

string

None.

reserve2

预留二字段(对应T_SP_YD表中的BZ字段 text) 原备注字段用于存储预订明细表中该订单的实名信息 2019-11-09 by TangYu 应卧龙要求进行修改

string

None.

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",
  "needinvoice": "sample string 5",
  "invoicetitle": "sample string 6",
  "invoicecode": "sample string 7",
  "senderid": "sample string 8",
  "servicecode": "sample string 9",
  "timespanindex": 10,
  "tripbillcode": "sample string 11",
  "guidernumber": "sample string 12",
  "marketareaid": "sample string 13",
  "reserve1": "sample string 14",
  "reserve2": "sample string 15"
}

application/xml, text/xml

Sample:
<OrderAddParm xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer.Tour.V5.Parm.WebInterface">
  <effectdate>sample string 4</effectdate>
  <guidernumber>sample string 12</guidernumber>
  <identificationnumber>sample string 3</identificationnumber>
  <invoicecode>sample string 7</invoicecode>
  <invoicetitle>sample string 6</invoicetitle>
  <marketareaid>sample string 13</marketareaid>
  <mobile>sample string 1</mobile>
  <needinvoice>sample string 5</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>
  <reserve1>sample string 14</reserve1>
  <reserve2>sample string 15</reserve2>
  <senderid>sample string 8</senderid>
  <servicecode>sample string 9</servicecode>
  <timespanindex>10</timespanindex>
  <tripbillcode>sample string 11</tripbillcode>
</OrderAddParm>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

下单前的校验接口,用于消费者预订前的信息校验,包括库存和限购规则等,保障消费者提交订单后不会因为库存不足或其他业务规则被拒单。 V5及V5以前的版本。 对V53版本添加的整团入园和保险赋值设置默认值。

CommonOperationResult
NameDescriptionTypeAdditional information
errcode

错误代码,通常0表示成功,其他值表示错误。

integer

None.

errmsg

错误描述,当errcode不为零时,此值可以用于呈现给用户。

string

None.

tag

操作同时,服务器端需要返回的其他值。

string

None.

Response Formats

application/json, text/json

Sample:
{
  "errcode": 1,
  "errmsg": "sample string 2",
  "tag": "sample string 3"
}

application/xml, text/xml

Sample:
<CommonOperationResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DigitalScience.DataTransfer">
  <errcode>1</errcode>
  <errmsg>sample string 2</errmsg>
  <tag>sample string 3</tag>
</CommonOperationResult>