# 企业用车
# 1.第三方企业获取用车目的列表
# 1.1 接入说明
商企通首页已为企业用户提供了企业用车等功能。如果企业希望在自己内部系统中直接完成企业用车的目的列表获取以及对应的用车跳转,则可以参考本接口文档完成相应的对接。大概使用流程如下:
- 员工通过企业自身系统进入相关页面。
- 员工点击企业用车相关按钮,返回对应的相关用车目的列表。
- 员工针对自身所需点击对应目的按钮,进行跳转。
- 美团打车使用。
注意: 因接口权限相关控制,三方企业无法直接调用打车对应接口,需通过商企通-免登接口通过验证后进行接口访问后重定向请求打车接口。
# 1.2 接口说明
名称 | 描述 |
---|---|
功能 | 获取当前员工可用的用车目的列表 |
HTTP方法 | POST |
请求方 | 第三方企业 |
响应方 | 商企通平台 |
url | $API_HOST/dache/queryCarUseTypeList |
method | dache.query.car.use.type.list |
# 1.3 业务请求参数
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
entId | Long | 是 | 商企通为企业分配的企业唯一标识号 |
staffUniqCode | Integer | 是 | 第三方员工标识码。取值为:20: 邮箱账号 50: 手机号 |
value | String | 是 | 员工标识码对应的值 |
# 1.4 业务响应
名称 | 类型 | 说明 |
---|---|---|
status | Integer | 0: 调用成功,其他值均为: 调用失败 |
msg | String | 失败时的错误描述 |
data | List<Body> | 请求成功时的响应数据,具体为出差申请单ID映射列表 |
Body 字段说明
名称 | 类型 | 是否非空 | 说明 |
---|---|---|---|
useType | String | 是 | 使用场景。目前只用到这些标识 1:延时用车 4:差旅用车 7:日常公出 |
useTypeName | String | 是 | 使用场景对应的中文描述。可用来做对应页面展示 |
showName | String | 是 | 展示名称,接入方可使用这个名称作为用车目的展示项名称 |
iconUrl | Integer | 是 | 场景对应得展示图标 |
needJump | String | 是 | 点击是否需要跳转。默认都为true |
jumpUrl | String | 是 | 跳转地址 |
# 1.5 示例
# 1.5.1 响应参数示例
{
"status": 0,
"message": "成功",
"data": [
{
"useType": 1,
"useTypeName": "延时用车",
"showName": "延时用车",
"iconUrl": "https://p1.meituan.net/travelcube/4df5c6cef1291290483efc11628c7d6d7630.png",
"needJump": true,
"jumpUrl": "https://c.qcs.test.sankuai.com/ent/dache/home/edit?isQCSTestCity=true&magicCityId=1000000001&mapEngineType=1&enableHotRegion=1&skipClearSqtToken=1&isEntDev=1&channelId=209¶mJson=JTdCJTIycnVsZUlkJTIyJTNBMTAwMDAyOTI2MSUyQyUyMnVzZVR5cGUlMjIlM0ExJTJDJTIydXNlVHlwZU5hbWUlMjIlM0ElMjIlRTUlQkIlQjYlRTYlOTclQjYlRTclOTQlQTglRTglQkQlQTYlMjIlMkMlMjJlbnRJZCUyMiUzQTEwMDc4NSUyQyUyMnN0YWZmSWQlMjIlM0E4MjgyMTElMkMlMjJydWxlUGFja0lkJTIyJTNBJTIyMTAwMDAwMTg0MSUyMiUyQyUyMnJ1bGVQYWNrTmFtZSUyMiUzQSUyMiVFNSVCQiVCNiVFNiU5NyVCNiVFNyU5NCVBOCVFOCVCRCVBNiUyMiU3RA%3D%3D&switchEntTab=0&ucHideList=MainCoupon%2C101%2C112%2C102%2C103%2C104"
},
{
"useType": 7,
"useTypeName": "日常公出",
"showName": "包-车-公出1v",
"iconUrl": "https://p1.meituan.net/travelcube/a25235f3c77fa550183bb56d47d3882b6596.png",
"needJump": true,
"jumpUrl": "https://c.qcs.test.sankuai.com/ent/dache/home/edit?isQCSTestCity=true&magicCityId=1000000001&mapEngineType=1&enableHotRegion=1&skipClearSqtToken=1&isEntDev=1&channelId=209¶mJson=JTdCJTIycnVsZUlkJTIyJTNBMTAwMDAyODMzNyUyQyUyMnVzZVR5cGUlMjIlM0E3JTJDJTIydXNlVHlwZU5hbWUlMjIlM0ElMjIlRTUlOEMlODUtJUU4JUJEJUE2LSVFNSU4NSVBQyVFNSU4NyVCQTF2JTIyJTJDJTIyZW50SWQlMjIlM0ExMDA3ODUlMkMlMjJzdGFmZklkJTIyJTNBODI4MjExJTJDJTIycnVsZVBhY2tJZCUyMiUzQSUyMjEwMDAwMDEwNjIlMjIlMkMlMjJydWxlUGFja05hbWUlMjIlM0ElMjIlRTUlOEMlODUtJUU4JUJEJUE2LSVFNSU4NSVBQyVFNSU4NyVCQTF2JTIyJTdE&switchEntTab=0&ucHideList=MainCoupon%2C101%2C112%2C102%2C103%2C104"
},
{
"useType": 7,
"useTypeName": "日常公出",
"showName": "hx-公出1",
"iconUrl": "https://p1.meituan.net/travelcube/a25235f3c77fa550183bb56d47d3882b6596.png",
"needJump": true,
"jumpUrl": "https://c.qcs.test.sankuai.com/ent/dache/home/edit?isQCSTestCity=true&magicCityId=1000000001&mapEngineType=1&enableHotRegion=1&skipClearSqtToken=1&isEntDev=1&channelId=209¶mJson=JTdCJTIycnVsZUlkJTIyJTNBMTAwMDAyODM5MSUyQyUyMnVzZVR5cGUlMjIlM0E3JTJDJTIydXNlVHlwZU5hbWUlMjIlM0ElMjJoeC0lRTUlODUlQUMlRTUlODclQkExJTIyJTJDJTIyZW50SWQlMjIlM0ExMDA3ODUlMkMlMjJzdGFmZklkJTIyJTNBODI4MjExJTJDJTIycnVsZVBhY2tJZCUyMiUzQSUyMjEwMDAwMDEyMjMlMjIlMkMlMjJydWxlUGFja05hbWUlMjIlM0ElMjJoeC0lRTUlODUlQUMlRTUlODclQkExJTIyJTdE&switchEntTab=0&ucHideList=MainCoupon%2C101%2C112%2C102%2C103%2C104"
},
{
"useType": 4,
"useTypeName": "差旅用车",
"showName": "差旅用车",
"iconUrl": "https://p0.meituan.net/travelcube/7fe335e477c05b866f807615bc60f6ac7733.png",
"needJump": true,
"jumpUrl": "https://test03-awp.hfe.test.sankuai.com/bepfe/slt-i-car/index.html#/trip-list"
}
]
}