请求地址: /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":"市内用车"
}]
}
}