说明

5.2 用车H5企业版接入 描述的是免登跳转到曹操 H5 用车页面的接入方式,用车过程(叫单、支付等)都在曹操提供的 H5 页面内完成。

若接入方不使用曹操提供的 H5 页面,而是自行搭建用车页面、只对接了预估价格接口(如 2.6 预估价格带明细),则后续叫单需调用本接口,不能直接调用 2.7 下单叫车 中的通用 orderCar/orderCarV2——本接口内部会校验免登用户、企业用车规则、企业H5一口价等企业H5专属逻辑,通用叫单接口不具备这些校验。

仅支持多车型同时呼叫(不支持传单车型)。该接口对 ext_order_id 幂等,只要创建订单成功就算成功,司机接单会回调接入方(回调状态见《1.5 订单状态及类型》)。派单等待时长120s,如120s后附近无司机接单,则订单会被系统撤销,需要改变ext_order_id重新下单。

接入前提

5.2 用车H5企业版接入

  • 创建应用的接入模式选择:H5
  • 创建应用的所需API选择:H5免登接口、企业用车接口、企业管理接口
  • 上线前需在绿色公务后台配置用车规则并为员工匹配规则

调用本接口前,ext_uid 对应的用户须先完成免登(见开放平台 H5免登接口),否则返回"用户不存在"。

请求参数

请求地址: /v2/common/orderCarH5Use

服务协议: HTTP/POST

Content-Type: application/x-www-form-urlencoded

参数名称 类型 必选 说明
client_id string Y 申请时的client_id
timestamp long Y 时间戳
sign string Y 签名
ext_uid string Y 第三方用户ID,需为已完成免登的用户(对应 5.2 节 URL 中的 ext_user_id),不存在则报"用户不存在"
owner string Y 订单归属,本接口必传,不传会导致下单接口报"系统错误"。 企业H5场景固定传 2(企业订单)。取值:1 个人订单;2 企业订单;3 个人支付需报销;4 混合支付
ext_order_id string Y 外部接入方的订单ID,最长30个字符(外部订单ID唯一,禁止重复),叫单前会加分布式锁
from_longitude string Y 出发地经度
from_latitude string Y 出发地纬度
to_longitude string Y 目的地经度
to_latitude string Y 目的地纬度
caller_phone string Y 用户手机号
city_code string Y 城市编码(与起点对应的citycode保持一致)
order_type string Y 订单类型,请参照《1.5 订单状态及类型》
start_name string Y 出发点名称(最多16个字)
start_address string N 出发点详细地址,展示在司机端(最多100个字),不传则使用 start_name
end_name string Y 目的地名称(最多16个字)
end_address string N 目的地详细地址,展示在司机端(最多100个字),不传则使用 end_name
is_simultaneously_call string Y 固定传 "1"(本接口仅支持多车型同时呼叫)
service_type_price string Y 多车型同时呼叫车型、预估价格和预估key的对应信息,Json格式的list,元素为 serviceType(车型)、estimateKey(预估Key)、estimatePrice(预估价,分),须与预估接口返回的一一对应,否则报错
accept_relay_order string N 是否允许派接力单(0不允许、1允许),默认为允许派接力单
carpool_type int N 是否允许拼车:0 不拼车;1 允许拼车,默认为不拼车
sms_policy string N 短信发送--1:叫车人和乘车人都发送;2:乘车人发送叫车人不发送;3:乘车人不发叫车人发;4:乘车人叫车人都不发
ruleId long N 用车规则ID,传入后会校验规则是否存在及使用场景是否受限

service_type_price例子:

[
  {"serviceType":2, "estimateKey":"867c5a62-b934-4d9d-ac5d-668851b6cffe-2-0", "estimatePrice":1596},
  {"serviceType":3, "estimateKey":"651c4a17-195f-4e6e-8d32-108698f13a9a-3-0", "estimatePrice":1596}
]

请求示例(沙箱环境实测)

{
  "ext_order_id": "Test_1788430937586",
  "sign": "1ad410148a1f1a94abdeb1d7e421cabd1c71ad23",
  "city_code": "027",
  "is_simultaneously_call": "1",
  "from_latitude": "30.480134",
  "client_id": "f7755e27e2658fe5",
  "accept_relay_order": "0",
  "start_name": "光谷总部时代",
  "to_longitude": "114.438553",
  "caller_phone": "18971624656",
  "from_longitude": "114.421809",
  "start_address": "湖北省武汉市江夏区光谷大道35号光谷总部时代1栋1801",
  "ext_uid": "160023420",
  "owner": "2",
  "to_latitude": "30.442948",
  "end_name": "平安光谷春天",
  "end_address": "湖北省武汉市江夏区高新六路15号平安光谷春天",
  "carpool_type": "0",
  "order_type": "1",
  "sms_policy": "1",
  "service_type_price": "[{\"serviceType\":2,\"estimateKey\":\"867c5a62-b934-4d9d-ac5d-668851b6cffe-2-0\",\"estimatePrice\":1737},{\"serviceType\":3,\"estimateKey\":\"651c4a17-195f-4e6e-8d32-108698f13a9a-3-0\",\"estimatePrice\":1737}]",
  "timestamp": "1788430097033"
}

响应data参数:

参数名称 类型 必有 说明
orderNo long Y 订单号

结果示例:

{
  "code": 200,
  "success": true,
  "data": {
    "orderNo": 1331700502790
  }
}

注意事项

  • owner 为必传参数:不传会命中服务端"个人未支付账户风控校验"环节的空指针,直接返回 {"code":1,"msg":"系统错误"},企业H5场景固定传 2。
  • 请求前需保证 ext_uid 对应的用户已完成免登,否则返回"用户不存在"。
  • 企业若设置了"企业H5一口价"配置,会自动叠加一口价标签与路线一口价类型,无需在本接口额外传参。