申请差旅单/审批单

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