POST api/SpecialOta/DouYin/CalendarTicket/Order/Verify
下单前的校验接口,用于消费者预订前的信息校验,包括库存和限购规则等,保障消费者提交订单后不会因为库存不足或其他业务规则被拒单。 V5及V5以前的版本。 对V53版本添加的整团入园和保险赋值设置默认值。
Request Information
URI Parameters
None.
Body Parameters
OrderAddParm| 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 |
| 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
{
"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
<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 not available.
Response Information
Resource Description
下单前的校验接口,用于消费者预订前的信息校验,包括库存和限购规则等,保障消费者提交订单后不会因为库存不足或其他业务规则被拒单。 V5及V5以前的版本。 对V53版本添加的整团入园和保险赋值设置默认值。
CommonOperationResult| Name | Description | Type | Additional information |
|---|---|---|---|
| errcode |
错误代码,通常0表示成功,其他值表示错误。 |
integer |
None. |
| errmsg |
错误描述,当errcode不为零时,此值可以用于呈现给用户。 |
string |
None. |
| tag |
操作同时,服务器端需要返回的其他值。 |
string |
None. |
Response Formats
application/json, text/json
{
"errcode": 1,
"errmsg": "sample string 2",
"tag": "sample string 3"
}
application/xml, text/xml
<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>