-
Notifications
You must be signed in to change notification settings - Fork 6
order
一路向北 edited this page Jun 8, 2020
·
145 revisions
获得订单列表(正在改造，暂不可用)- 获得单一订单信息
- 创建订单
- 获取司机列表
- 获取订单司机详细信息
- 选择司机
- 订单行驶轨迹
- 获取司机位置
- 开发票
- 取消订单
- 修改订单
- 异常订单接口
- 查询单一订单费用
按照第三方业务流水号取消订单按照第三方业务流水号修改订单- 订单推送说明
- 获得订单取消费用
- 获取评价标签
- 提交评价
- 提交工单（开发中）
GET /v2/order
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明 |
|---|---|---|
| status | 订单状态 | 默认全部 |
| page | 页数 | 默认第一页 |
| limit | 每页条数 | 默认每页10条，最多20条 |
| map_type | 坐标类型 1：百度，2：火星 3-谷歌 | 默认值：1 |
| passenger_phone | 乘车人手机号 | |
| time_type | 0-start_time 1-end_time | |
| start_time | 开始时间 | |
| end_time | 结束时间 |
订单状态说明
| 状态码 | 含义 |
|---|---|
| 1 | 等待用户付款 |
| 2 | 等待选择车辆 |
| 3 | 等待司机确认 |
| 4 | 司机已确认 |
| 5 | 司机已到达 |
| 6 | 服务开始 |
| 7 | 服务结束 |
| 8 | 取消 |
访问示例
http://sandbox.open.yongche.org/v2/order?access_token=***
返回数据
{
"code":200,
"msg":"OK",
"result":[
{"order_id": 2004268149,
"type": 7,
"city": "北京",
"create_time": 1399431874,
"car_type_id": 1,
"car_type": "经济车型",
"expect_start_time": 1401337800,
"time_length": 3600,
"passenger_name": "111",
"passenger_number": 4,
"passenger_phone": "16811865049",
"total_amount": "0.00",
"start_position": "首都机场T1航站楼",
"start_address": "123",
"end_position": "总部基地",
"end_address": "456",
"flight_number": "CZ5131",
"msg": "111111111111",
"status": 2,
"driver_phone": "",
"vehicle_number": "",
"driver_name": "",
"car_brand": ""},
...
]
}
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 状态 | 200：正确返回 400：发生错误 |
| result | 数组，该用户订单列表（字段释义同【获得单一订单信息】） |
GET /v2/order/:order_id
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明 |
|---|---|---|
| order_id | 订单号 |
访问示例
http://sandbox.open.yongche.org/v2/order/200360167?access_token=***
返回数据
{
code: 200,
msg: "OK",
result: {
order_id: 200300192,
type: 1,
city: "北京",
create_time: 1387529001,
car_type_id: 2,
car_type: "舒适车型",
expect_start_time: 1388291400,
time_length: 3600,
passenger_name: "111",
passenger_number: 4,
passenger_phone: "16811865049",
total_amount: "0.00",
start_position: "首都机场T1航站楼",
start_address: "123",
end_position: "总部基地",
end_address: "456",
flight_number: "",
msg: "111111111111",
status: 2,
driver_id: "",
driver_name: "",
driver_phone: "",
vehicle_number: "",
car_brand: ""
regulatepan_reason: "",
insure_company: "",
insure_number: "",
}
}
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 状态 | 200：正确返回 400：发生错误 |
| result | 数组，该订单信息 | |
| order_id | 订单ID | |
| type | 服务类型 | |
| city | 城市名称 | |
| create_time | 订单创建时间 | |
| car_type_id | 车型ID | |
| car_type | 车型 | |
| expect_start_time | 预期上车时间 | |
| time_length | 租用时长 | |
| passenger_name | 乘车人姓名 | |
| passenger_number | 乘车人数 | |
| passenger_phone | 乘车人电话 | |
| total_amount | 总费用 | 已废弃，费用请参考获取订单费用接口 |
| start_position | 出发地点 | 用户填写的 |
| start_address | 出发详细地址 | 用户填写的 |
| end_position | 下车地点 | 用户填写的 |
| end_address | 下车详细地址 | 用户填写的 |
| start_longitude | 上车地点经度 | 实际的 |
| start_latitude | 上车地点纬度 | 实际的 |
| end_longitude | 下车地点经度 | 实际的 |
| end_latitude | 下车地点纬度 | 实际的 |
| flight_number | 接机航班号 | |
| msg | 客户留言(信息发给司机) | |
| status | 订单当前状态 | |
| driver_id | 司机电话 | |
| driver_phone | 司机电话 | |
| vehicle_number | 车牌号 | 只显示后四位 |
| driver_name | 司机姓名 | 只显示姓（例：李师傅） |
| car_brand | 车辆款型名称 | |
| regulatepan_reason | 调整费用原因 | |
| insure_company | 出保公司名称 | |
| insure_number | 保单号 |
POST /v2/order
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明(*必填) | 举例 | 校验规则 |
|---|---|---|---|---|
| city | 城市简码 | * | bj | 请从服务接口取 |
| type | 产品类型 | * | 2 | 同上 |
| aircode | 机场三字码 | 接送机必填 | PEK | 请从机场接口取 |
| flight_number | 航班号 | 不是必须，只是记录一下 | ca1801 | 2位（数字或者字母） + 2-4位（数字） |
| car_type_id | 车型 | * | 2 | 请从服务价格接口取 |
| start_position | 出发地点 | * | 总部基地 | 最大长度 utf8 100 |
| start_address | 出发详细地点 | 总部基地详细 | 最大长度 utf8 100 | |
| expect_start_longitude | 出发地点经度 | * | 116.458637 | |
| expect_start_latitude | 出发地点纬度 | * | 39.955538 | |
| time | 出发时间 | *，随叫随到可以不填 | 2013-04-19 11:22:33 | 时间格式如前面举例，其他格式会报错 |
| rent_time | 使用时长 | 单位：小时,默认1 | 2 | |
| end_position | 目的地点 | 送机必填 | 总部基地 | 最大长度 utf8 100 |
| end_address | 目的详细地点 | 总部基地详细 | 最大长度 utf8 100 | |
| map_type | 坐标类型 | 1：百度，2：火星 3-谷歌 默认值：1 | ||
| expect_end_longitude | 目的地点经度 | 同end_position | 116.373055 | |
| expect_end_latitude | 目的地点纬度 | 同end_position | 39.911093 | |
| passenger_name | 乘车人姓名 | * | test | 最大长度 utf8 30 |
| passenger_phone | 乘车人电话 | * | 111111111 | 1[345678][\d]{9} |
| passenger_number | 乘车人数 | 默认1 | 2 | |
| 是否需要发票 | 1 | 请调用发票接口，这里准备废弃 | ||
| 发票抬头 | invoice为1必填 | **有限公司 | 同上 | |
| 发票内容 | invoice为1必填 | 打车费 | 同上 | |
| 发票邮寄地址 | invoice为1必填 | 总部基地 | 同上 | |
| 邮政编码 | invoice为1必填 | 100000 | 同上 | |
| 发票接收人姓名 | 同上 | |||
| 发票接收人电话 | 同上 | |||
| msg | 客户留言 | 最大长度 utf8 30 | ||
| is_asap | 是否随叫随到 | 1是随叫随到的订单，0是普通订单 | ||
| is_face_pay | 是否当面付 | 1面付，0或不传为非面付 | ||
| third_party_coupon | 优惠券金额 | 100 | ||
| sms_type | 是否给乘车人短信 | 1：发短信 0：不发短信 | 对于yop企业，特殊处理，把乘车人当做订车人接收短信 | |
| 第三方的额外信息，对账用，json格式 | 可选 | {"wid":1} |
准备废弃 | |
| app_trade_no | 第三方订单号，字符串，不可重复,用于排除重复订单请求，请尽量填写 | 可选 | order_12345 | 用之前重复的app_trade_no，会返回之前的易到订单号 |
| dep_date_local | 飞机起飞日期，接机产品如果传值，司机可收到航班信息 | 可选 | 2014-04-21 | |
| app_user_id | 第三方用户唯一标识，用于判断取消订单 | 必填 | 最大长度 utf8 20 | |
| appoint_price | 新一口价价格，用于校验价格是否一致 | 新一品价日租、半日租必填 |
$params = array(
'city'=>'bj',
'type' => 7,
'aircode'=>'PEK', //接送机必填
'car_type_id' => 2,
'start_position' => '颐和园',
'expect_start_latitude' => '39.955538',
'expect_start_longitude' => '116.458637',
'time' => '2013-04-19 11:22:33',
'rent_time' => 2,
'end_position' => '总部基地',
'expect_end_latitude' => '39.911093',
'expect_end_longitude' => '116.373055',
'passenger_name' => 'test',
'passenger_phone' => '111111111',
'invoice' => 1,
'receipt_title' => '111111111',
'receipt_content' => '22222222',
'address' => '3333333',
'postcode' => '100000',
'sms_type' => 1, //给乘车人发短信
'msg'=>'111111111111',
'app_trade_no' => 'ceshi2013101401811',
''access_token' => '***'
);
访问示例
http://sandbox.open.yongche.org/v2/order
返回数据
{
"code":200,
"msg":"创建成功",
"result":{
'order_id':'11111111'
}
}
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 状态 | 200：正确返回 400：发生错误 511:订单操作超时 512 该app_trade_no对应的订单正在被创建499 帐户异常 （详见错误码说明） |
| order_id | 订单号 |
GET v2/driver/ getSelectDriver
企业帐户中设置为允许用户选司机本接口才可用
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明 |
|---|---|---|
| order_id | *订单号 | |
| driver_ids | 不想获取的司机id列表 | 23，34 |
| map_type | 1：百度，2：火星 3-谷歌 默认值：1 |
访问示例
http://sandbox.open.yongche.org/v2/driver/getSelectDriver
{
code: 200,
msg: "OK",
result:
{
carlist:
[
{
driver_id: 890,
name: "测师傅",
score: 5,
good_comment_rate: 98,
unittime_complete_count: 112,
is_served: 1,
latitude: 39.983928630676,
longitude: 116.30762686587,
brand: "宝马7",
car_type: "经济车型",
car_type_id: 1,
is_default: 0,
photo: "http://sanbox.yongche.org/media/get_image.php?media_id=***"
}
],
wait_driver_time_length: 117,
wait_user_time_length: 177
}
}
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 状态 | 200：正确返回 400：发生错误 |
| msg | 描述信息 | success |
| driver_id | 司机id | 890 |
| name | 司机姓名 | 测师傅 |
| score | 星级 | 5 |
| good_comment_rate | 司机好评率百度比 | 98 |
| unittime_complete_count | 月完成订单数 | 112 |
| is_served | 是否熟司机 | 1 |
| latitude | 纬度 | 39.983928630676 |
| longitude | 经度 | 116.30762686587 |
| brand | 车辆品牌 | 宝马7 |
| car_type | 车型 | 经济车型 |
| car_type_id | 车型id | 1 |
| is_default | 头像不否默认 | 1：默认，0非默认 |
| photo | 司机头像url | |
| wait_driver_time_length | 司机接单剩余时间 | 0表示派单完成，-1表示超过司机接单时间了 |
| wait_user_time_length | 用户选择司机剩余时间 | -1 表示用户/系统已经决策过了 |
GET v2/driver/info
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明 |
|---|---|---|
| order_id | *订单号 |
访问示例
http://sandbox.open.yongche.org/v2/driver/info?order_id=***&access_token=***
{
code: 200,
msg: "success",
result: {
name: "易师傅",
gender: "男",
driving_years: 14,
star_level: 5,
brand: "奥迪A4L",
vehicle_number: "京***654",
car_setup: "",
unittime_complete_count：112,
car_company_name: "深圳市麟通汽车租赁有限公司",
driver_company_name: "北京易快行技术服务有限责任公司",
is_default_photo: 0,
photo_url: "http://i1.renxinchang.yongche.org/media/g1%2FM00%2F00%2F00%2FCgAL61P9c2eIW4kaAACVg8JNEfgAAAAAQBgvrcAAJWb013.png?1414476840",
cellphone: "16801010103"
}
}
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 状态 | 200：正确返回 400：发生错误 |
| msg | 描述信息 | success |
| name | 司机姓名 | 测师傅 |
| cellphone | 司机电话 | 136666666 |
| gender | 司机性别 | 男 |
| star_level | 星级 | 5 |
| driving_years | 司机驾龄 | 5 |
| brand | 车型&品牌 | 丰田RAV4 |
| vehicle_number | 汽车牌照 | 京***690 |
| car_setup | 车内设施 | 宝马7 |
| unittime_complete_count | 月完成订单数 | 112 |
| car_company_name | 公司所属 | 北京威旺宝汽车租赁有限公司 |
| driver_company_name | 司机所属 | 北京易快行技术服务有限责任公司 |
| is_default_photo | 头像不否默认 | 1：默认，0非默认 |
| photo_url | 司机头像 | url |
POST v2/driver/decisionDriver
企业帐户中设置为允许用户选司机本接口才可用
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明 |
|---|---|---|
| order_id | *订单号 | test |
| driver_id | *司机id | 34 |
| third_party_coupon | 优惠券金额 | 100 |
访问示例
http://sandbox.open.yongche.org/v2/driver/decisionDriver
{
“code” : 200,
"msg":"success",
}
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 错误码 | 200：正确返回 400：发生错误 |
| msg | 描述信息 | success |
GET v2/driver/orderTrack
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明 |
|---|---|---|
| order_id | *订单号 | test |
| map_type | 1：百度，2：火星 3-谷歌 默认值：1 | 1 |
访问示例
http://sandbox.open.yongche.org/v2/driver/orderTrack
{
"code":200,
"msg":" success ",
"result":[
{
" lng":"116.30762686587",
"lat":"39.983928630676",
},
…
]
}
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 错误码 | 200：正确返回 400：发生错误 |
| msg | 描述信息 | success |
| lat | 纬度 | 39.983928630676 |
| lng | 经度 | 116.30762686587 |
GET v2/driver/location
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明 |
|---|---|---|
| order_id | * | 订单id 200353654 |
| map_type | 1：百度，2：火星 3-谷歌 默认值：1 |
访问示例
http://sandbox.open.yongche.org/v2/driver/location
{
"code":200,
"msg":" success ",
"result":{
" lng":"116.30762686587",
"lat":"39.983928630676"
}
}
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 错误码 | 200：正确返回 400：发生错误 |
| msg | 描述信息 | success |
| Lat | 纬度 | 39.983928630676 |
| Lng | 经度 | 116.30762686587 |
POST v2/receipt/create
是否需要用户授权？
是
输入参数
| 名称 | 是否必传 | 说明 |
|---|---|---|
| order_id | 已废弃 | test |
| receipt_title | * | 发票抬头 **有限公司 |
| receipt_content | * | 发票内容 打车费 |
| province | 省 | |
| city | 城市 | |
| county | 区、县 | |
| address | * | 如果传了province、city、county参数，address为省、市、区县后的详细地址 如 XX路XX号。否则应该传完整地址 |
| postcode | * | 邮政编码 |
| receipt_user | * | 发票接收人姓名 |
| receipt_phone | * | 发票接收人电话 |
| amount | * | 发票金额不能小于50 |
访问示例
http://sandbox.open.yongche.org/v2/receipt/create
{
"code":200,
"msg":" success ",
}
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 错误码 | 200：正确返回 400：发生错误 |
| msg | 描述信息 | success |
DELETE /v2/order/:order_id
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明 |
|---|---|---|
| order_id | 订单号 | |
| reason_id | 取消理由id | 必填 |
| other_reason | 其他理由 | 非必填 |
取消原因reason_id说明
| 取消原因代码 | 含义 |
|---|---|
| 59 | 没有信用卡无法验证 |
| 60 | 没有网银无法充值 |
| 61 | 变更信息重新下单 |
| 54 | 车辆未在预定时间到达 |
| 58 | 其它 |
访问示例
http://sandbox.open.yongche.org/v2/order/200312999
{
"code":200,
"msg":"OK",
"result":{
'info':'可以取消订单',
'fee':1
}
}
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 状态 | 200：正确返回 400：发生错误 |
| result | info:提示语句; fee:是否收取取消费用，1需收取费用,2无需收费 |
PUT /v2/order/:order_id
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明 |
|---|---|---|
| passenger_name | 乘车人姓名 | test 最大长度utf8 30 |
| passenger_phone | 乘车人电话 | 111111111 |
| passenger_number | 乘车人数 | |
| coupon_name | 优惠券标签 | 例‘易到百度xxx优惠券’ |
访问示例
http://sandbox.open.yongche.org/v2/order/200312999
{
"code":200,
"msg":"OK",
"result":{
'info':'修改成功'
}
}
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 状态 | 200：正确返回 400：发生错误 |
| result | info:错误信息 |
POST /v2/order/abnormal/:order_id
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明 | 举例 |
|---|---|---|---|
| abnormal_mark | 订单异常状态 | 2： 客户设置的异常 | 2 |
| abnormal_msg | 异常原因 | 空驶公里数异常(最大长度utf8 200) |
访问示例
http://sandbox.open.yongche.org/v2/order/abnormal/200296887
{
"code":200,
"msg":"OK",
}
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 状态 | 200：正确返回 400：发生错误 |
| msg | 结果信息 | 失败了返回错误原因 |
GET /v2/order/calculate/:order_id
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明 |
|---|---|---|
| order_id | 订单号 |
访问示例
http://sandbox.open.yongche.org/v2/order/calculate/200269157?access_token=***
返回数据
{
"code":200,
"msg":"OK",
"result":
{"order_id":200129059,
"city":"北京",
"fixed_fee":"15.8",
"parking_amount":"1"
"highway_amount": "1.00"
"kongshi_distance":"15"
"kongshi_distance_danjia": "0.4"
"kongshi_fee": "6"
"origin_amount": "23.8"
"coupon_facevalue": "-0.2"
"order_amount": "24"
"deposit":16
"pay_amount": "8.30"
...
}
}
数据说明
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 状态 | 200：正确返回 400：发生错误 |
| result | 数组，该订单信息 | |
| time_length | 计费时长 | 单位:小时 |
| actual_time_length | 实际行驶时长 | 单位:秒 注意：不是小时，因为需要精确的时间 |
| kilo_length | 实际公里数 | 单位:公里 |
| fee_per_hour | 时租单价 | 单位:元/小时(时租产品专用) |
| time_fee | 时租总费用 | 单位:元(时租产品专用) |
| fee_per_kilo | 公里单价 | 单位:元/公里(时租产品专用) |
| kilo_fee | 公里总费用 | 单位:元(时租产品专用) |
| fixed_fee | 固定价格产品服务费 | 单位:元(固定价格产品专用) |
| extra_distance | 超公里数 | 单位:公里 |
| extra_distance_danjia | 超公里单价 | 单位:元/公里 |
| extra_distance_fee | 超公里费 | 单位:元 |
| extra_time | 超小时 | 单位:小时 |
| extra_time_danjia | 超时长单价 | 单位:元/小时 |
| extra_time_fee | 超小时总费用 | 单位:元 |
| parking_amount | 停车费 | |
| highway_amount | 高速费 | |
| airport_service_amount | 机场服务费 | |
| night_amount | 夜间服务费费 | |
| kongshi_distance | 空驶距离 | 单位:公里 |
| kongshi_distance_danjia | 空驶单价 | 单位:元/公里 |
| kongshi_fee | 空驶费 | |
| origin_amount | 订单原始金额 | |
| coupon_facevalue | 优惠金额 | |
| order_amount | 应付金额 | |
| deposit | 已付金额 | 已废弃 |
| pay_amount | 未付金额 | 已废弃 |
| adjust_fee | 调整金额 | 取值可以为正，也可为负 |
| other_fee | 其他费用金额 | |
| other_fee_msg | 其他费用描述 | |
| actual_board_time | 实际开始时间 | 2014-01-02 23:50:34 |
| actual_off_time | 实际结束时间 | 2014-01-03 00:58:24 |
| actual_car_type | 车辆品牌 | GL8 |
| time_length_minute | 实际计费分钟 | （单位：分钟）新增 |
| extra_time_minute | 实际超出分钟 | （单位：分钟）新增 |
| fee_per_minute | 分钟单价 | （单位：元）新增 |
返回数据
{
code: 200,
msg: "OK",
result: {
order_id: "200134273",
city: "北京",
cancel_order_amount: "0",
cancel_deposit: 0,
cancel_pay_amount: "0.00",
cancel_change_amount: 0
}
}
数据说明
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 状态 | 200：正确返回 400：发生错误 |
| result | 数组，该订单信息 | |
| cancel_order_amount | 取消订单应付金额 | |
| cancel_deposit | 已付金额 | 已废弃 |
| cancel_pay_amount | 未付金额 | 已废弃 |
| cancel_change_amount | 退款金额 | 已废弃 |
DELETE /v2/order/app/:app_trade_no
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明 |
|---|---|---|
| app_trade_no | 第三方业务流水号 | required |
其它参数和取消订单接口相同
PUT /v2/order/app/:app_trade_no
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明 |
|---|---|---|
| app_trade_no | 第三方业务流水号 | required |
其它参数和修改订单接口相同
格式：{第三方推送url} + yongche_order_id=易到订单号&yongche_order_status=订单状态
易到会在订单状态发生变化的时候，给第三方推送相关信息,推送是从4开始推送，即 “司机确认” 开始的
对于状态是7，即服务结束的特殊说明（注意：以下说明的订单状态都是7）：
服务结束之后，在大概5分钟之后，会推送状态7，加上一个异常状态，见下表1)
结束之后，如果有异议或者是其他原因，客服调整金额，调整金额后，会推3）
正常确认账单之后，或者是异议订单处理之后，实际扣款时，相对于企业账户，就是扣企业的信用额度，会推4）
以下状态会在上面的基础上，加推一些信息：
| id | 订单状态 | 加推字段 | 说明 |
|---|---|---|---|
| 1) | 服务结束 | abnormal | 异常状态 详见“异常状态说明” 表 |
| 2) | 取消 | reason_id | 合作方取消全部是100，易到取消为实际原因id |
| 3) | 调整金额 | adjust_flag = 1 & abnormal | |
| 4) | 扣款 | withdraw_flag = 1 |
异常状态说明
| 状态id | 含义 | 说明 |
|---|---|---|
| 1 | 系统设置的异常 | |
| 2 | 客户设置的异常 | |
| 3 | 后台操作人员设置的异常 | |
| -1 | 异常已经处理完成 | |
| 0 | 没有异常 |
取消原因状态码说明
| 状态码 | 含义 | 说明 |
|---|---|---|
| 63001 | 无车可派 | |
| 63002 | 有车无人接单(无有效司机接单) | |
| 63003 | 有司机接单，用户未选车，系统自动取消 | |
| 63004 | 有司机接单，用户未选车，客户端自动取消 | |
| 100 | 合作方取消 |
合作方返回数据格式
例子：{"code":200,"msg":"OK"}
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 状态 | 200：正确返回 400：发生错误 |
| msg | 结果信息 | 失败了返回错误原因 |
GET /v2/cost/penalty
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明 |
|---|---|---|
| order_id | 订单号 |
访问示例
http://sandbox.open.yongche.org/v2/cost/penalty?order_id=order_id&access_token=***
作用说明
用于实际取消之前，查询当时取消订单是否需要付费，以及费用多少。取消后的订单实际费用请参考“获得订单计费信息”接口
返回数据
{
"code":200,
"msg":"OK",
"result":{
"allow_cancel":1,
"cancel_order_amount":159,
"state":"对罚金的说明"
}
}
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 状态 | 200：正确返回 400：发生错误 |
| msg | 提示信息 | |
| result | 数组，该订单信息 | |
| allow_cancel | 是否允许取消 0：不允许、1：允许 | |
| cancel_order_amount | 取消订单罚金金额 | |
| state | 罚金的说明 |
GET /v2/commentTag
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明 |
|---|
访问示例
http://sandbox.open.yongche.org/v2/commentTags&access_token=***
作用说明
获得评价标签
返回数据
{
“code” : 200,
"msg":"success",
“result”: {
"1":{"comment_tag_id":1,"conflict_tag_id":2,"tag_text":准时到达,"type":1,"rank":1},
"2":{"comment_tag_id":2,"package_fee":1,"tag_text":迟到,"type":-1,"rank":10},
}
}
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 状态 | 200：正确返回 400：发生错误 |
| msg | 提示信息 | |
| result | 数组 | |
| comment_tag_id | 标签id | |
| conflict_tag_id | 与comment_tag_id互斥 | 与comment_tag_id不能同时选中 |
| tag_text | 标签文字 | |
| type | 标签性质 | 1 正面，-1 负面 |
| rank | 排序 |
POST /v2/comment
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明 |
|---|---|---|
| order_id | 订单号 | 必填 |
| content | 评价文本内容 | utf8最大300，非必填 |
| comment_tag_id | 一个或多个标签id（逗号分割） | 例如:1,3 |
| score | 评分（１－５） | score,comment_tag_id必有其一 |
| 访问示例 |
http://sandbox.open.yongche.org/v2/comment
作用说明
提交评价结果
返回数据
{
“code” : 200,
"msg":"success",
}
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 状态 | 200：正确返回 400：发生错误 |
| msg | 提示信息 |
POST /v2/workorder/order
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明 |
|---|---|---|
| order_id | 易到订单号 | 必填 |
| user_name | 客户姓名 | 必填 |
| user_phone | 手机号 | 必填 |
| order_amount | 订单总金额 | 必填 |
| level | 紧急程度 | 0：正常，1：紧急，2：加急 |
| work_order_type_id | 工单类型ID,对应classify接口中的classify_id，例：1 | 必填 |
| work_order_type_detail_id | 工单详情ID,对应classify接口中的detail_list中的ID，例：3 | 必填 |
| content | 投诉内容 | 必填 |
| msgid | 第三方工单号 |
访问示例
http://sandbox.open.yongche.org/v2/workorder/order
作用说明
提交工单
返回数据
{
“code” : 200,
"msg":"success",
"result":{
'workorder_id':'111'
}
}
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 状态 | 200：正确返回 400：发生错误 |
| msg | 提示信息 | |
| result | 返回内容 | |
| workorder_id | 工单ID |
GET /v2/workorder/order
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明 |
|---|---|---|
| workorder_id | 工单ID |
访问示例
http://sandbox.open.yongche.org/v2/workorder/order
作用说明
查询工单
返回数据
{
“code” : 200,
"msg":"success",
"result":{
'workorder_id':'111',
'status':1,
'reply':'退一赔一',
......
}
}
| 名称 | 含义 | 说明 |
|---|---|---|
| code | 状态 | 200：正确返回 400：发生错误 |
| msg | 提示信息 | |
| result | 返回内容 | |
| workorder_id | 易到工单号 | |
| status | 处理状态，0：未处理，1：已处理 | |
| reply | 回复内容 | |
| order_id | 易到订单号 | |
| user_name | 客户姓名 | |
| user_phone | 手机号 | |
| order_amount | 订单总金额 | |
| complained_time | 投诉时间 | |
| level | 紧急程度 | 0：正常，1：紧急，2：加急 |
| work_order_type_id | 工单类型ID,对应classify接口中的classify_id，例：1 | |
| work_order_type_detail_id | 工单详情ID,对应classify接口中的detail_list中的ID，例：3 | |
| content | 投诉内容 | |
| msgid | 第三方工单号 |
GET /v2/workorder/classify
是否需要用户授权？
是
访问示例
http://sandbox.open.yongche.org/v2/workorder/classify
作用说明
获取工单分类
返回数据
{
“code” : 200,
"msg":"success",
"result":{
'1': {
classify_id:1,
classify_name:'费用争议',
detail_list:{
'1':'附加费用，长途长途费',
'2':'额外费用请客户联系司机支付',
'3':'时间里程疑义',
},
'2': {
classify_id:2,
classify_name:'发票类问题',
detail_list:{
'1':'查询发票信息',
'2':'开具发票',
},
......
}
| 字段 | 含义 | 说明 |
|---|---|---|
| code | 状态 | 200：正确返回 400：发生错误 |
| msg | 提示信息 | |
| result | 返回内容 | |
| classify_id | 一级分类ID | |
| classify_name | 一级分类名称 | |
| detail_list | 二级分类列表 |
GET /v2/workorder/urge
是否需要用户授权？
是
输入参数
| 名称 | 含义 | 说明 |
|---|---|---|
| workorder_id | 工单ID |
访问示例
http://sandbox.open.yongche.org/v2/workorder/urge
作用说明
催单
返回数据
{
“code” : 200,
"msg":"success"
}