基本信息

Item Info
URL /nsc/v1/external/orders/{order_id}
Method GET

参数说明

  • 其他必传参数请参考接口规范
参数名 必选 类型 说明
order_id 是 string 用户订单 id, 全局唯一, 路径参数
channel 是 string 渠道 code
access_token 是 string 访问的 token，生成短链接时一并生成的，用于进行权限校验

section 释义

Section 说明
order 订单信息, 手机号会掩码
staff 订单专员信息, 车辆信息会掩码
vehicle 订单相关车辆信息
parking_info 订单停车信息
payment_info 订单的用户支付信息
resource_info 订单资源信息
event_logs 订单状态进程信息
soc_info 订单车辆 SoC 信息

返回参数说明 -- 基础信息

order section

参数名 类型 说明
order_id string 订单 ID
business string 业务类型
service string 服务类型
sub_service String 子服务类型, 参见 枚举值定义-Sub-Service
status integer 订单状态，参见 枚举值定义-一键加电订单状态
creation_time timestamp 创建时间
update_time timestamp 更新时间
phone string 联系方式
payment_need Boolean 是否需要支付
payment_status Integer 支付状态
pay_due_time timestamp 支付超时时间
original_start_time timestamp 下单时刻，系统计算的预计开始时间，通常为承诺给用户的取车时间
original_end_time timestamp 下单时刻，系统计算的预计完成时间，通常为承诺给用户的还车时间
estimate_start_time timestamp 当前时刻，系统计算的预计开始时间，通常为取车时间
estimate_end_time timestamp 当前时刻，系统计算的预计完成时间，通常为还车时间
actual_serve_start_time timestamp 订单实际的服务开始时间，取值为第一个 task 小哥接单时间
actual_serve_end_time timestamp 订单的实际服务完成时间，取值为最后一个 task 的完成时间，通常为还车时间
resource_schedule_mode integer 调度模式，参见 枚举值定义-resourceScheduleMode

返回参数说明 -- 可选信息

staff section

参数名 类型 说明
staff_id string 专员 ID
avatar_url string 专员头像 url
name string 专员姓名
phone string 专员联系方式

vehicle section

参数名 类型 说明
model_id string 车型 ID
brand string 车辆品牌
model_name string 车型系列名称
plate_number string 车牌号

parking_info section

参数名 类型 说明
type byte 参见 枚举值定义-ParkingInfoType
longitude double 停车经度
latitude double 停车纬度
poi_id string 停车点 POI ID
poi_name string 停车点 POI 名称
poi_area_code string 停车点区级邮编
poi_address string 停车点 POI 地址（不含行政区域）
poi_latitude double POI 纬度
poi_longitude double POI 经度

payment_info section

参数名 类型 说明
status int 1:未支付，2:已支付，3:已退款
amount double 支付总额
need_pay Boolean 是否需要支付

resource_info section

参数名 类型 说明
resource_id string 资源 ID
name string 资源名称
type integer 资源类型，参见 枚举值定义-PowerResourceType
show_name string 资源显示名称
latitude double 资源 GPS 纬度
longitude double 资源 GPS 经度
region_code string 资源区域编码
operator_id string 资源供应商 ID
operator_name string 资源供应商名称

event_logs section

参数名 类型 说明
event string 事件名称
operator string 事件操作人，可能为空
time long 事件发生时间
status integer 任务状态
description string 事件描述
recall_status integer 召回状态
name string 事件名称

soc_info section

参数名 类型 说明
soc double SoC
remaining_range double 电池剩余续航（KM）

返回示例

{
   "result_code":"success",
   "data":{
      "order":{
         "order_id":"820034787833641750",
         "business": "PE",
         "service": "CHARGE",
         "sub_service": "",
         "status":1000,
         "creation_time":1517987834,
         "update_time":1517987834,
         "phone":"17865736543",
         "pay_due_time":1517988434,
         "original_start_time":1517988000,
         "original_end_time":1517988912,
         "estimate_start_time":1517988647,
         "estimate_end_time":1517988659,
         "actual_serve_start_time":1517987840,
         "actual_serve_end_time":1517988902,
         "resource_schedule_mode":0
      },
      "staff":{
         "staff_id":"1234",
         "avatar_url": "",
         "name":"张三",
         "phone":"12345674567"
      },
      "vehicle":{
         "model_id":"model-123",
         "brand":"蔚来",
         "model_name":"ES8",
         "plate_number":"京A12222"
      },
      "parking_info":[
        {
            "type":13,
            "latitude":36.443333,
            "longitude":115.969948,
            "poi_id":"qq:2577301541586800564",
            "poi_name":"聊城市",
            "poi_area_code":"371500",
            "poi_address":"光岳楼",
            "poi_latitude":36.443333,
            "poi_longitude":115.969948
        },
        {
            "type":14,
            "latitude":36.443333,
            "longitude":115.969948,
            "poi_id":"qq:2577301541586800564",
            "poi_name":"聊城市",
            "poi_area_code":"371500",
            "poi_address":"光岳楼",
            "poi_latitude":36.443333,
            "poi_longitude":115.969948
        }
      ]
      "payment_info":{
         "status":1,
         "amount":180
      },
      "resource_info":{
         "resource_id":"CS-TLD-00000001-BJ-00003",
         "name":"天津崇泰响螺湾王相大厦充电站",
         "show_name":"特来电充电站（天津崇泰响螺湾王相大厦充电站）",
         "latitude":36.443333,
         "longitude":115.969948,
         "region_code":"110000",
         "operator_id":"TLD",
         "opeartor_name":"特来电"
      },
      "event_logs":[
         {
            "event":"CREATE",
            "operator":"",
            "time":1562148667,
            "description":"订单创建成功",
            "recall_status":0,
            "status":1000,
            "name":"订单已创建"
         },
         {
            "event":"DISPATCH",
            "operator":"",
            "time":1562148673,
            "description":"专员接单成功",
            "recall_status":0,
            "status":2000,
            "name":"专员已出发"
         },
         {
            "event":"PICKING",
            "operator":"",
            "time":1562148667,
            "description":"专员到达用户指定服务开始地点",
            "recall_status":0,
            "status":2100,
            "name":"到达停车场"
         }
      ],
      "soc_info":{
         "soc":80,
         "remaining_range":400
      }
   }
}

result code

result_code 说明
order_not_accessible_by_user 用户没有权限查看订单

results matching ""

    No results matching ""