使用说明:注意在微信内的使用
1、企业H5若涉及个人支付、则不支持在微信小程序中使用(不支持微信小程序支付);全额企业付则可在小程序中使用
2、微信公众号中可以使用
获取方式见 1.1 接入流程
特别注意:
创建应用的接入模式选择:H5
创建应用的所需API选择:H5免登接口、企业用车接口、企业管理接口
1.使用绿色公务企业管理员账号登录绿色公务后台:http://www.vipcaocao.com/login
2.登录后,用车管控-用车规则管理,创建用车规则
用车规则创建参考 创建用车规则
3.为企业员工匹配规则
使用企业H5需要设置全员默认规则:企业员工——全员用车详情——规则设置
注:员工用车规则设置参考 为员工分配用车制度
H5接入域名
沙箱环境:sandbox-mobile.caocaokeji.cn
正式环境:mobile.caocaokeji.cn
企业H5请求方式
正式环境请求,即使用正式环境域名、client_id 和 sign_key 即可
需要注意的是,企业H5的url路径为 enterprise-travel ,区别于个人H5的 pay-travel
链接生成使用get方式带入对应参数,并通过跳转链接传递给WebApp,测试环境请求示例见下:
签名方式:对下表标注了“参与签名”的参数组成参数对(未标注的不参与签名),并进行升序排序,组装成字符串,然后进行sha1签名得到结果。 签名具体方法见 1.3 签名认证
参数名 | 是否必填 | 说明 |
---|---|---|
client_id | Y | 开放平台管理中心创建应用获取(参与签名) |
timestamp | Y | 时间戳(毫秒)(参与签名) |
ext_user_id | Y | 第三方用户ID,第三方唯一标识,ID由第三方生成(参与签名) |
ext_user_phone | N | 实际叫车人手机号(如果url中传递,则参与签名) |
ext_user_name | N | 实际叫车人用户名(如果url中传递,则参与签名) |
user_type | Y | 传入1,表示企业用户(参与签名) |
sign | Y | 免登签名(签名方式参考下方示例) |
canSecondCall | N | 该字段控制订单结束或订单取消后是否可以在H5页面继续用车 建议接入的场景:需要严控每次下单必须从接入方入口进曹操H5用车页(比如每笔订单都需带入callback_info、用车规则参数) true 可以继续叫车(默认true)、继续叫车场景初始进入页面带入的callback_info会丢失; false 不可继续叫车,订单结束/取消后跳转至用车结束页,如需继续用车,需要用户关闭H5用车页,再重新进入 |
callback_info | N | 备注字段,订单事件变化回调通知会推送该备注 |
situationId | N | ⽤车场景ID,7=审批 8=差旅 |
approveId | N | 当为审批场景时(situationId=7),传入该字段直接进入对应审批用车页面,不传入则进入审批列表页;当为差旅场景时(situationId=8),传入该字段直接进入对应差旅行程列表页面,和travelCityDetailId至少传入一个 |
travelCityDetailId | N | 差旅单行程id(travelRecords. id),当 situationId=8 时传入 travelCityDetailId 直接进入对应行程的用车页面,和approveId至少传入一个 |