BusTicketOrder(v2.0)直通车下单
接口说明 参数说明| 参数 | 类型 | 长度 | 可空 | 描述 |
|---|---|---|---|---|
| apiKey | string | 32 | 否 | 由官方平台提供的apiKey |
| productCode | string | 4-32 | 否 |
产品码
是双方在对接过程中，约定好的。通过产品码，可以在我方找到唯一对应的一个直通车产品，其去回程、线路、套餐均已确定好。 |
| date | datetime | 否 | 出行日期，格式：2020-08-19 | |
| schedule | string | 5 | 否 | 乘坐班次，例如：08:30 |
| backschedule | string | 5 | 是 | [可选] 返程班次 *含返程产品需提供此参数 |
| quantity | decimal | 18(2) | 否 | 数量 |
| tel | string | 30 | 否 | 客人电话 |
| collectedIDNumber (选填) |
string | 20 | 是 |
身份证号码（部分产品需要填写） 是否必填请参看产品码列表返回值中的IsNeedIdCard |
| collectedContact (选填) |
string | 20 | 是 |
取票人姓名（部分产品需要填写） 是否必填请参看产品码列表返回值中的IsNeedName |
| number (选填) |
string | 32 | 是 |
对接方订单号
如果提供此参数，将存入我方订单中，方便对接方根据自己的订单号查询下单是否成功。 |
| TouristDetails (选填) |
string | 2000 | 是 |
根据<获取产品清单接口>拉取的信息确认是否需要提供
游客清单Json格式（每位游客必须提供真实身份证） 注意：身份证必填，第一位游客必须提供手机号码。 |
| sign | string | 32 | 否 |
由apiSecret，与参数productCode、date、schedule、quantity、tel，通过MD5签名运算后的值。 注意：选填参数不参与签名运算 签名规则 |
游客清单Json格式范例(一次最多支持10位游客)：
[
{
"Name": "张三", // 姓名
"Sex": 1, // 性别代码：0(女) / 1(男)
"CellPhone": null, // 手机(第一位游客必须提供)
"IdCardType": 1, // 证件类型：身份证 = 1,士官证 = 2,港澳通行证 = 3,护照 = 4,赴台证 = 5,回乡证 = 6,台胞证 = 7,其他 = 999
"IdCardNo": "532901199509080014", // 证件号码
"PriceIndex": 1, // 固定为1
"EMail": "888@qq.com" // 邮箱，可不提供
},
{
"Name": "游客2", // 姓名
"Sex": 0, // 性别代码：0(女) / 1(男)
"IdCardType": 1, // 证件类型：身份证 = 1,士官证 = 2,港澳通行证 = 3,护照 = 4,赴台证 = 5,回乡证 = 6,台胞证 = 7,其他 = 999
"IdCardNo": "532901199509080014", // 证件号码
"PriceIndex": 1 // 固定为1
}
]
|
||||
Json格式的Result对象
{
"ErrorCode": 0,
"Success": true,
"Message": null,
"HasException": false,
"Value": 123123222,
"Tag": 3423321,
"HasETicket": true
}
| 返回值 | 描述 |
|---|---|
| Success | 本次调用是否成功 |
| ErrorCode | 错误代码 |
| Message | 失败时为异常信息，成功时为null |
| Value | Number：订单号 |
| Tag | 客人消费码（验证码） |
| HasETicket |
是否包含电子票
电子票为异步下单，如果包含电子票，对接方应在下单成功后从获取订单状态接口中查询入园码 |
|
支持下单重试，但number参数必填（为对接方的订单号）,如果没有填写number参数，视为新下单。 在带有number参数的情况下，我方会对此number进行判重检查，如果发现已经下过单，会将之前的订单返回 （Value为订单号，Tag为验证码，Success为False，Message为错误原因）， |
|