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为错误原因）， |
|