# 1001 打车服务动态

# content_json 定义

参数 是否必填 类型 说明 格式要求
cur_status int32 当前状态id
wxa_path_query string 卡片点击跳转路径与query
car_kind_count 参考状态要求 uint32 选择车型数,若传入为0则不展示该信息
license_plate 参考状态要求 string 车牌号 会进行车牌号格式校验
arrival_time 参考状态要求 uint32 预计到达上车点时间(cur_status为2时)、预计到达目的地时间(cur_status为6时) 秒级时间戳,展示为HH:mm格式
car_color 参考状态要求 string 车辆颜色 最多两个可见字符,如“白色”、“灰色”
pay_amount 参考状态要求 uint32 支付金额 单位为分
distance_to_passenger 参考状态要求 uint32 距乘客上车点距离 单位为m
distance_to_destination 参考状态要求 uint32 距目的地距离 单位为m

车牌号格式校验

  1. 最少7个可见字符,最多8个可见字符
  2. 第一个汉字需要命中"京津沪渝苏浙豫粤川陕冀辽吉皖闽鄂湘鲁晋黑赣贵甘桂琼云青蒙藏宁新使领"
  3. 除第一个汉字和最后一个汉字/字符外,其他字符需要命中[A-Z][0-9]
  4. 最后一个汉字/字符需要命中[A-Z][0-9]"学港澳挂"
  5. 支持传入空值("")

示例:"粤A12345"、"粤A123456"、"粤A1234学"、"粤A12345学"

# cur_status传入状态id的含义,与不同状态id下的字段要求

id 激活时是否可为此状态 可变更自上一状态* 状态描述 此状态下必填字段 此状态下选填字段 content_json示例
1 1 呼叫车辆中 car_kind_count
wxa_path_query
"{\"cur_status\":1,\"car_kind_count\":3,\"wxa_path_query\":\"pages/index/index\"}"
2 1, 2, 4 司机前往上车点中 license_plate
arrival_time
wxa_path_query
distance_to_passenger "{\"cur_status\":2,\"license_plate\":\"粤A1245A\",\"arrival_time\":1696157643,\"distance_to_passenger\": 1500,\"wxa_path_query\":\"pages/index/index\"}"
3 1, 2, 4, 5, 6 订单已取消 wxa_path_query "{\"cur_status\":3,\"wxa_path_query\":\"pages/index/index\"}"
4 2, 4, 5 重新呼叫车辆中 car_kind_count
wxa_path_query
"{\"cur_status\":4,\"car_kind_count\":3,\"wxa_path_query\":\"pages/index/index\"}"
5 1, 2, 4 司机到达上车点 license_platecar_color
wxa_path_query
"{\"cur_status\":5,\"license_plate\":\"粤A1245A\",\"car_color\":\"白色\",\"wxa_path_query\":\"pages/index/index\"}"
6 5, 6 前往目的地中 arrival_time
wxa_path_query
distance_to_destination "{\"cur_status\":6,\"arrival_time\":1696157643,\"arrival_time\":1696157643, \"distance_to_destination\":1000, \"wxa_path_query\":\"pages/index/index\"}"
7 6 行程结束待支付 pay_amount
wxa_path_query
"{\"cur_status\":7,\"pay_amount\":10000,\"wxa_path_query\":\"pages/index/index\"}"
8 6, 7 行程结束已支付 pay_amount
wxa_path_query
"{\"cur_status\":8,\"pay_amount\":9000,\"wxa_path_query\":\"pages/index/index\"}"

「可变更自上一状态」说明

  1. 此列中的数字表示当前状态只能由这些状态变更(激活时无此要求)
  2. 需要注意的是当前状态变更为当前状态,也要求状态id在此列中:如当前为状态为1,只有当1也在此列中,才允许下一次更新时状态传入1
  3. 在此列中不存在的状态id,意为结束态,后续不再可更新服务状态

# ext_json 定义

参数 是否必填 类型 说明 格式要求
pay_info object 支付信息

pay_info 定义

参数 是否必填 类型 说明 格式要求
transaction_id string 微信支付订单号对于合单支付场景,目前仅支持使用传入第一个子单的订单号
pay_amount unit32 订单实际支付金额,若订单有优惠,需传入优惠后金额
若为合单支付的第一个子订单,需传入合单支付的总实际支付金额
单位为分
pay_time uint32 支付时间 秒级时间戳