使用说明:注意在微信内的使用

1、企业H5若涉及个人支付、则不支持在微信小程序中使用(不支持微信小程序支付);全额企业付则可在小程序中使用

2、微信公众号中可以使用

一.client_id和sign_key获取方式

获取方式见 1.1 接入流程

特别注意:

创建应用的接入模式选择:H5

创建应用的所需API选择:H5免登接口、企业用车接口、企业管理接口

输入图片说明

二.配置公务企业用车规则(测试阶段不用配置,上线前需要配置)

1.使用绿色公务企业管理员账号登录绿色公务后台:http://www.vipcaocao.com/login

2.登录后,用车管控-用车规则管理,创建用车规则

用车规则创建参考 创建用车规则

输入图片说明

3.为企业员工匹配规则

使用企业H5需要设置全员默认规则:企业员工——全员用车详情——规则设置

输入图片说明

注:员工用车规则设置参考 为员工分配用车制度

三.使用client_id组装url跳转到h5页面

H5接入域名

沙箱环境:sandbox-mobile.caocaokeji.cn

正式环境:mobile.caocaokeji.cn

企业H5请求方式

正式环境请求,即使用正式环境域名、client_id 和 sign_key 即可

需要注意的是,企业H5的url路径为 enterprise-travel ,区别于个人H5的 pay-travel

链接生成使用get方式带入对应参数,并通过跳转链接传递给WebApp,测试环境请求示例见下:

https://sandbox-mobile.caocaokeji.cn/enterprise-travel/home?client_id=38095b5484aa0576&user_type=1&ext_user_id=777777&ext_user_name=name&ext_user_phone=18143474301&sign=1f2c544fc0d65fbd9c0e7e22ae72dd1c89ba46f4&timestamp=1535003260000&startLg=116.711279&startLt=40.213257&endLg=116.611279&endLt=40.113257

四. 请求参数

签名方式:对下表标注了“参与签名”的参数组成参数对(未标注的不参与签名),并进行升序排序,组装成字符串,然后进行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至少传入一个