开发者中心

国内/国际用车

国内/国际用车

打车订单详情查询

通过该接口查询打车订单详情。

接口URL

/car/order_detail/query

请求参数定义

参数名参数说明必填参数类型长度值举例备注
corpCode企业账号YString1000系统提供的企业账号
timestamp时间戳YString1420180811113019服务方仅允许20分钟内的时间误差。
version版本号YString3.0固定为3.0。
loginName操作人帐号YStringHW_0000011、如本次操作为系统相关，则该字段为固定字符串值："sysadmin";2、如操作为指定普通员工信息维护或修改，则该字符串为:“<员工登录账户名称>"。
msgId唯一标识YString1000020150511190411000001企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
orderId订单IDYStringU1234567打车订单号
needLocation是否需要地点坐标NBooleantrue默认不传

响应参数定义

参数名参数说明必填参数类型长度值举例备注
orderId订单idYStringU1234567系统侧的订单主键id
travelType出行类型YString0:因公出行,1:个人出行默认返回因公出行订单
orderStatus订单状态YString订单状态枚举
orderStatusShow订单状态YStringIN_QUEUE:派单中,DRIVER_RECEIVED:司机已接单,TRIP_START:行程已开始,WAIT_PAY:待支付,WAIT_CONFIRM:待确认,QUEUE_FAILED:派单失败,DRIVER_DEPART:司机已出发,DRIVER_ARRIVE:司机已到达,CANCEL_WAIT_PAY:取消待支付,CANCEL_WAIT_CONFIRM:取消待确认,COMPLETE:已完成,CANCELED:已取消,CHANGING_QUEUE:改派中订单状态中文枚举
createTime预定时间NString2022-10-01 10:01yyyy-MM-dd HH:mm
travelNoTRNStringTR-202210001差旅审批单号
saleApp订单来源NStringH5订单来源
saleChannel预定渠道NStringandroid预定渠道
carUseScene用车场景YStringPERSONAL:个人用车,COMMON:普通打车,OVERTIME:加班打车,BUSINESS_TRIP:差旅用车预定用车的场景
entId企业主键YString1企业id
entName企业名称NString华为技术有限公司企业的名称
belongDept预定人所属部门NStringXXX部门预定人所属部门
staffNo预定人工号NString123456
userName预定人姓名NString张三
memberId预定人memberIdYStringID123456789
loginName登录人账号YString18012345678
payType支付方式NString0:员工电子流,5:关联月结,10:外部月结,3:现金,4:POS,11:转账,1:在线支付,2:IVR,6:因公欠款,7:VIP欠款,8:担保欠款,10:外部月结,11:转帐,12:互抵,13:预收帐款,14:到店付款
totalPrice订单总价NString123.01
serviceFee服务费NString123.01
supplierOrderId供应商IdNStringSL2017122100029
supplierType供应商类型NStringCAOCAO
supplierName供应商名称NString曹操
bizType业务类型NString业务类型 CAR:国内用车 ICAR:国际用车
contactList联系人列表NList<OpenApiContact>
travelerList乘车人列表NList<OpenApiTraveler>
virtualTripInfo预估行程信息NOpenApiTripInfo
actualTripInfo实际行程信息NOpenApiTripInfo

OpenApiContact联系人

参数名参数说明必填参数类型长度值举例备注
contactId联系人IdNString123456
contactName联系人姓名NString张三
contactMobile联系人手机号NString18012345678
mobileCountryCode手机号国家码NString86
virtualMobile联系人虚拟手机号NString78946123
virtualMobileValid虚拟号码有效性NString0:无效,1:有效

OpenApiTraveler乘车人

参数名参数说明必填参数类型长度值举例备注
passgId乘客idNString123456
memberId会员IdNStringID123465
travelerName乘客姓名NString张三
travelerMobile乘客手机号NString18012345678
mobileCountryCode手机号国家码NString86

OpenApiTripInfo行程信息

参数名参数说明必填参数类型长度值举例备注
serviceType服务类型NString实时单,预约单,接送机用车服务类型
departAddr出发地点NString南京市雨花台区华为云楼
departureLongitude出发地点经度NString118.771705百度坐标系
departureLatitude出发地点纬度NString31.991354百度坐标系
departCityId出发城市idNString156320100城市id
arrivalCityId到达城市idNString156320100城市id
departTime出发时间NLocalDateTimeyyyyMMddHHmmss
departCityName出发城市名称NString南京
arrivalAddr到达地点NString南京大学鼓楼校区
arrivalLongitude到达地点经度NString118.771705百度坐标系
arrivalLatitude到达地点纬度NString31.991354百度坐标系
arrivalTime到达时间NLocalDateTimeyyyyMMddHHmmss
arrivalCityName到达城市名称NString南京
countryId国家/地区idNString156国家/地区id
countryName国家/地区名NString中国国家/地区名
driverName司机姓名NString李师傅
driverMobile司机手机号NString13012345678
licensePlate车牌号NString苏AD8888
carType车辆型号NString天籁
carColor车辆颜色NString黑色
ActualsupplierName实际供应商名称NString首约出行
mileage总里程展示(千米)NBigDecimal15
duration总时长展示（分钟）NBigDecimal30
rideType运力类型NString经济型,舒适型,商务型,豪华型
totalPrice总金额NBigDecimal35.59
carUseType用车类型NStringNORMAL:普通打车,AIRPORT_PICKUP:接机,AIRPORT_DROP_OFF:送机
chargeItemList费用明细集合NList<OpenApiChargeItemInfo>
tripAttachInfo附加信息jsonNString
flightDepartureAirport3code航班出发机场3字码NStringNKG
flightArrivalAirport3code航班到达机场3字码NStringSZX
flightDepartureDate航班出发日期NLocalDateyyyyMMdd
flightNo航班号NStringMU1234

费用项信息OpenApiChargeItemInfo

参数名参数说明必填参数类型长度值举例备注
type费用类型名称NString起步费
amount费用项金额(元)NString10

样例

请求示例

{
  "corpCode": "1000",
  "timestamp": "20110811113019",
  "version": "2.0",
  "loginName": "HW_000001",
  "msgId": "1000020150511190411000001",
  "orderId": "U123456789"
}

响应示例

{
  "entId": "1",
  "entName": "华为技术有限公司",
  "belongDept": "部门",
  "staffNo": "001234",
  "userName": "张三",
  "memberId": "ID777777",
  "loginName": "8888",
  "orderId": "U123456789",
  "travelType": "0",
  "orderStatus": "COMPLETE",
  "orderStatusShow": "已完成",
  "createTime": "2022-10-01 14:00",
  "travelNo": "TA20221001",
  "saleApp": "H5",
  "saleChannel": "ios",
  "carUseScene": "PERSONAL",
  "resultCode": "0",
  "description": "success",
  "payType": "0",
  "totalPrice": "13.01",
  "serviceFee": "5.01",
  "supplierOrderId": "T12121111",
  "supplierType": "AMAP",
  "supplierName": "高德打车",
  "bizType": "CAR",
  "contactList": [
    {
      "contactId": "799756",
      "contactName": "张三",
      "contactMobile": "13012345678",
      "mobileCountryCode": "86",
      "virtualMobile": "05682245",
      "virtualMobileValid": "0:无效"
    }
  ],
  "travelerList": [
    {
      "passgId": "799256",
      "TrpassgId": "963258",
      "travelerName": "张三",
      "memberId": "ID123456",
      "travelerMobile": "13012345678",
      "mobileCountryCode": "86"
    }
  ],
  "virtualTripInfo": {
    "serviceType": "实时单",
    "departAddr": "华为南京研究所A区",
    "departureLongitude": null,
    "departureLatitude": null
    "departCityId": "156320100",
    "arrivalCityId": "156320100",
    "departTime": "20221028070640",
    "departCityName": "南京",
    "arrivalAddr": "南京大学鼓楼校区",
    "arrivalLongitude": null,
    "arrivalLatitude": null,
    "arrivalTime": "20221028070640",
    "arrivalCityName": "南京",
    "countryId": "156",
    "countryName": "中国"，
    "driverName": "李师傅",
    "driverMobile": "15012345678",
    "licensePlate": "苏AD8888",
    "carType": "天籁",
    "carColor": "黑色",
    "ActualsupplierName": "曹操",
    "mileage": 11,
    "duration": 30,
    "rideType": "舒适型",
    "totalPrice": 10,
    "carUseType": "NORMAL",
    "chargeItemList": [
      {
        "type": "起步费",
        "amount": "10"
      }
    ],
    "tripAttachInfo": "string",
    "flightDepartureAirport3code": "NKG",
    "flightArrivalAirport3code": "SZX",
    "flightDepartureDate": "2022-10-28",
    "flightNo": "MU1234"
  },
  "actualTripInfo": {
    "serviceType": "实时单",
    "departAddr": "华为南京研究所A区",
    "departCityId": "156320100",
    "arrivalCityId": "156320100",
    "departTime": "20221028070640",
    "departCityName": "南京",
    "arrivalAddr": "南京大学鼓楼校区",
    "arrivalTime": "20221028070640",
    "arrivalCityName": "南京",
    "countryId": "156",
    "countryName": "中国"，
    "driverName": "李师傅",
    "driverMobile": "15012345678",
    "licensePlate": "苏AD8888",
    "carType": "天籁",
    "carColor": "黑色",
    "ActualsupplierName": "曹操",
    "mileage": 11,
    "duration": 30,
    "rideType": "舒适型",
    "totalPrice": 10,
    "carUseType": "NORMAL",
    "chargeItemList": [
      {
        "type": "起步费",
        "amount": "10"
      }
    ],
    "tripAttachInfo": "string",
    "flightDepartureAirport3code": "NKG",
    "flightArrivalAirport3code": "SZX",
    "flightDepartureDate": "20221028",
    "flightNo": "MU1234"
  }
}

打车订单增量查询

企业可调用此接口获取打车订单增量数据。

遵循GDPR要求，默认只返回因公出行的订单。

订单相关数据的任何变更，都会将订单输出至增量列表中，不仅仅是订单状态变化。

如果收到相同状态的更新，可以是状态的内部变化或者订单其他数据发生了变化，通过调用订单详情接口获取详细变更信息。

接口URL

/car/increment_order/list

请求参数定义

参数名参数说明必填参数类型长度值举例备注
corpCode企业账号YString1000系统提供的企业账号
timestamp时间戳YString1420180811113019服务方仅允许20分钟内的时间误差。
version版本号YString3.3固定为3.3。
msgId唯一标识YString1000020150511190411000001企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
loginName操作人帐号YStringzhangsan@huawei.com1、如果是系统维护，写“sysadmin”查询企业下全量数据，用此账号2、 如果是普通员工维护，写员工登录名。查询员工名下订单，用此账号
orderId打车订单号NString根据订单号查询，有orderId的前提下不考虑startTime和endTime
startTime开始更新时间NString20180811113019yyyyMMddHHmmss包含当前时间
endTime截止更新时间NString20180811113019yyyyMMddHHmmss不包含当前时间查询跨度不超过24小时
bizType业务类型NStringCARICAR:国际用车 CAR:国内用车 不传默认国内用车
pageIndex查询的页码YString
size每页条数YString建议20，上限50

响应参数定义

参数名参数说明必填参数类型长度值举例备注
resultCode返回码YString00表示成功，其他值为失败。
description描述YStringSuccess描述信息，出错时为错误信息即错误原因。
pageIndex当前的页码NString
size每页条数NString
total总记录数NString
orderList打车订单集合NList<OpenApiIncreOrderInfo>

增量打车单信息OpenApiIncreOrderInfo

参数名参数说明必填参数类型长度值举例备注
changeTime变更时间NStringyyyy-MM-dd HH:mm
orderId订单IdNStringU123456789系统订单id
supplierOrderId供应商订单号NStringB20221001用车供应商订单号
createTime订单创建时间NStringyyyy-MM-dd HH:mm
entName企业名称NString
travelType出行类型NString0:因公出行,1:个人出行
serviceType服务类型NString实时单,预约单,接送机
orderStatus订单状态NStringIN_QUEUE:派单中,DRIVER_RECEIVED:司机已接单,TRIP_START:行程已开始,WAIT_PAY:待支付,WAIT_CONFIRM:待确认,QUEUE_FAILED:派单失败,DRIVER_DEPART:司机已出发,DRIVER_ARRIVE:司机已到达,CANCEL_WAIT_PAY:取消待支付,CANCEL_WAIT_CONFIRM:取消待确认,COMPLETE:已完成,CANCELED:已取消,CHANGING_QUEUE:改派中
totalPrice总价NString123.01
departAddr出发地址NString南京市雨花台区华为云楼
arrivalAddr到达地址NString南京大学鼓楼校区
rideType运气类型NString经济型,舒适型,商务型,豪华型
mileage总里程(千米)NString15
duration总时长(分钟)NString30

样例

请求示例

{
  "corpCode": "1000",
  "timestamp": "20110811113019",
  "version": "2.0",
  "loginName": "HW_000001",
  "msgId": "1000020150511190411000001",
  "startTime": "yyyyMMddHHmmss",
  "endTime": "yyyyMMddHHmmss",
  "pageIndex": "1",
  "size": "20",
  "orderId": "",
  "bizType": "CAR"
}

响应示例

{
  "resultCode": "0",
  "description": "success",
  "pageIndex": "1",
  "size": "1",
  "total": "1",
  "orderList": [
    {
      "departAddr": "南京市雨花台区华为云楼",
      "arrivalAddr": "南京大学鼓楼校区",
      "rideType": "舒适型",
      "mileage": "11",
      "duration": "30",
      "orderId": "U1234567789",
      "supplierOrderId": "LS20221001",
      "createTime": "2022-10-01 14:00",
      "entName": "华为技术有限公司",
      "travelType": "0",
      "serviceType": "实时单",
      "orderStatus": "已完成",
      "totalPrice": "30.00",
      "changeTime": "2022-10-01 14:00"
    }
  ]
}

错误码

错误码错误描述解决方案
3003未知错误，请稍后重试联系技术支持人
3010用户不存在检查账号或者联系技术支持人员
3404时间戳信息错误，请确认后重试检查入参
3401企业账号不存在，请确认后重试检查账号或者联系技术支持人员
400参数错误根据描述信息检查入参
4000系统繁忙，请稍后重试未知错误，联系技术支持人员
4001系统繁忙，请稍后重试数据库错误，联系技术支持人员
4002参数错误根据描述信息检查入参
10002无访问权限根据描述信息检查入参或联系技术支持人员
10011公司编号不能为空检查入参
10012操作人帐号不能为空检查入参
10013操作人帐号不合法检查账号或者联系技术支持人员
10109页码设置错误，请确认后重试检查入参
10110每页条数需要在1~50之间检查入参
10511开始时间不能为空检查入参
10512结束时间不能为空检查入参
10513开始时间格式错误检查入参
10514结束时间格式错误检查入参
10515结束时间不能大于当前时间检查入参
10516结束时间距离开始时间不能超过24小时检查入参
10518该集团下无对应公司检查是否集团查询
10519集团编号不存在，请确认后重试检查账号或者联系技术支持人员
432000100未知错误，请稍后重试联系技术支持人