跟团游下单

RouteOrder(v2.0)跟团游下单

接口说明

http请求方式:POST

url:http://www.cd917.com/OpenApi/RouteOrderV2

使用调试工具调试该接口
参数说明
参数 类型 长度 可空 描述
apiKey string 32 由官方平台提供的apiKey
productCode string 4-32 产品码

是双方在对接过程中,约定好的。通过产品码,可以在我方找到唯一对应的一个产品。

expendSolidStartDate date 预订参团日期

格式:2017-01-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,通过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为错误原因),