请求地址: /v2/common/applyTrip
服务协议: HTTP/POST
请求参数:
参数名称 | 类型 | 必选 | 说明 |
---|---|---|---|
client_id | string | Y | 申请时的client_id |
timestamp | long | Y | 时间戳 |
sign | string | Y | 签名 |
type | int | Y | 审批类型 1: 审批单 2:差旅单 |
rule_id | long | Y | 规则ID(规则需要完成与员工的关联,否则无法创建成功) |
phone | String | N | 用户手机号(与ext_user_id必传其一,如果都传以ext_user_id为主) |
ext_user_id | String | N | 第三方用户ID(phone 必传其一,如果都传以ext_user_id为主) |
reason | string | N | 申请原因 (400 字符限制) |
ext_info | String | N | 额外信息自定义字段,订单详情内可查(100字或200字符以内) |
travel_info | String | N | 差旅单信息(json字符串),差旅单类型时,此字段必填 |
approval_info | String | N | 行前审批信息(json字符串),审批单类型时,此字段必填 |
差旅单信息(travel_info)参数
参数名称 | 类型 | 必选 | 说明 |
---|---|---|---|
departureCity | string | Y | 出发城市cityCode |
backCity | string | N | 返回城市cityCode |
destinationCity | string | Y | 目的城市cityCode,多个城市使用英文,分隔,如:"0571,021" |
startTime | long | Y | 开始时间(毫秒级时间戳) |
endTime | long | Y | 结束时间(毫秒级时间戳) |
行前审批单信息(approval_info)参数
参数名称 | 类型 | 必选 | 说明 |
---|---|---|---|
startTime | long | Y | 开始时间(毫秒级时间戳) |
endTime | long | Y | 结束时间(毫秒级时间戳) |
roundTrip | int | N | 是否往返,不往返=0,往返=1,默认为0(规则中如果需要员工指定用车次数时必传,其他情形不传) |
useCount | int | N | 用车次数,当往返时,次数必须为偶数(规则中如果需要员工指定,则必传,其他情形不传) |
amount | int | N | 用车金额限制(单位为分),如果需要填写次数,则限制为单次限额,如果无需填写次数,则为总限额(规则中如果需要员工指定,则必传,其他情形不传) |
startLocation | object | N | 出发地信息(json字符串)(规则中如果需要员工指定用车线路,则必传;不传则为任意起点),限制用车路线时起终点不能同时为任意,至少要有一个 |
startLocation.longitude | double | N | 起点经度(限制起点时必传) |
startLocation.latitude | double | N | 起点纬度(限制起点时必传) |
startLocation.loc | string | N | 起点地址名称(限制起点时必传) |
startLocation.cityCode | string | N | 起点城市代码(限制起点时必传) |
startLocation.cityName | string | N | 起点城市名称 |
startLocation.district | string | N | 起点位置区域 |
startLocation.poiId | string | N | 起点OI标识 |
endLocation | object | N | 目的地信息(json字符串)(规则中如果需要员工指定用车线路,则必传;不传则为任意终点) |
endLocation.longitude | double | N | 目的地经度(限制目的地时必传) |
endLocation.latitude | double | N | 目的地纬度(限制目的地时必传) |
endLocation.loc | string | N | 目的地地址名称(限制目的地时必传) |
endLocation.cityCode | string | N | 目的地城市代码(限制目的地时必传) |
endLocation.cityName | string | N | 目的地城市名称 |
endLocation.district | string | N | 目的地位置区域 |
endLocation.poiId | string | N | 目的地POI标识 |
响应data参数:
参数名称 | 类型 | 必有 | 说明 |
---|---|---|---|
travelRecords | list | N | 差旅单行程信息 |
travelRecords .id | long | N | 差旅单行程id |
travelRecords.cityCode | string | N | 差旅单行程城市 |
travelRecords.travelTypeName | string | N | 差旅单行程服务类型(接站服务,送站服务,市内用车) |
approvalId | string | Y | 审批、差旅单编号 |
结果示例:
{
"code": 200,
"success": true,
"data": {
"approvalId":1234,
"travelRecords":[{
"id":134,
"cityCode":"0571",
"travelTypeName":"市内用车"
}]
}
}