RouteOrder(v2.0)跟团游下单
接口说明 参数说明| 参数 | 类型 | 长度 | 可空 | 描述 |
|---|---|---|---|---|
| apiKey | string | 32 | 否 | 由官方平台提供的apiKey |
| productCode | string | 4-32 | 否 |
产品码
是双方在对接过程中，约定好的。通过产品码，可以在我方找到唯一对应的一个产品。 |
| expendSolidStartDate | date | 否 |
预订参团日期
格式：2021-08-01 |
|
| TouristDetails | string | 2000 | 否 |
游客清单Json格式（每位游客必须提供真实身份证）
注意：身份证必填，第一位游客必须提供手机号码。 |
游客清单Json格式范例(一次最多支持20位游客)：
[
{
"Name": "张三", // 姓名
"Sex": 1, // 性别代码：0(女) / 1(男)
"CellPhone": null, // 手机(第一位游客作为团队代表接收短信、签署电子合同，必须提供)
"IdCardType": 1, // 证件类型：身份证 = 1,士官证 = 2,港澳通行证 = 3,护照 = 4,赴台证 = 5,回乡证 = 6,台胞证 = 7,其他 = 999
"IdCardNo": "532901199509080014", // 证件号码
"PriceIndex": 1, // 价格套餐类型，可选范围1-5 （参考接口获取到的价格日历中的套餐种类）
"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-5 （参考接口获取到的价格日历中的套餐种类）
}
]
|
||||
| number (选填) |
string | 32 | 是 |
对接方订单号
如果提供此参数，将存入我方订单中，方便对接方根据自己的订单号查询下单是否成功。 |
| sign | string | 32 | 否 |
由apiSecret，与参数productCode、quantity、tel、TouristDetails，通过MD5签名运算后的值。 注意：选填参数不参与签名运算 签名规则 |
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为错误原因）， |
|