国内/国际用车

打车订单详情查询

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

接口URL

/car/order_detail/query

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
CorpCode	企业账号	Y	String		1000	系统提供的企业账号
Timestamp	时间戳	Y	String	14	20180811113019	服务方仅允许20分钟内的时间误差。
Version	版本号	Y	String		3.0	固定为3.0。
LoginName	操作人帐号	Y	String		HW_000001	1、如本次操作为系统相关，则该字段为固定字符串值："sysadmin";2、如操作为指定普通员工信息维护或修改，则该字符串为:“<员工登录账户名称>"。
MsgID	唯一标识	Y	String		1000020150511190411000001	企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
OrderId	订单ID	Y	String		U1234567	打车订单号
NeedLocation	是否需要地点坐标	N	Boolean		true	默认不传

响应参数定义

参数名	参数说明	必填	参数类型	值举例	备注
OrderId	订单id	Y	String	U1234567	系统侧的订单主键id
TravelType	出行类型	Y	String	0:因公出行,1:个人出行	默认返回因公出行订单
OrderStatus	订单状态	Y	String		订单状态枚举
OrderStatusShow	订单状态	Y	String	IN_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	预定时间	N	String	2022-10-01 10:01	yyyy-MM-dd HH:mm
TravelNo	TR	N	String	TR-202210001	差旅审批单号
SaleApp	订单来源	N	String	H5	订单来源
SaleChannel	预定渠道	N	String	android	预定渠道
CarUseScene	用车场景	Y	String	PERSONAL:个人用车,COMMON:普通打车,OVERTIME:加班打车,BUSINESS_TRIP:差旅用车	预定用车的场景
EntId	企业主键	Y	String	1	企业id
EntName	企业名称	N	String	华为技术有限公司	企业的名称
BelongDept	预定人所属部门	N	String	XXX部门	预定人所属部门
StaffNo	预定人工号	N	String	123456
UserName	预定人姓名	N	String	张三
MemberId	预定人MemberId	Y	String	ID123456789
LoginName	登录人账号	Y	String	18012345678
PayType	支付方式	N	String	0:员工电子流,5:关联月结,10:外部月结,3:现金,4:POS,11:转账,1:在线支付,2:IVR,6:因公欠款,7:VIP欠款,8:担保欠款,10:外部月结,11:转帐,12:互抵,13:预收帐款,14:到店付款
TotalPrice	订单总价	N	String	123.01
ServiceFee	服务费	N	String	123.01
SupplierOrderId	供应商Id	N	String	SL2017122100029
SupplierType	供应商类型	N	String	CAOCAO
SupplierName	供应商名称	N	String	曹操
BizType	业务类型	N	String	业务类型 CAR:国内用车 ICAR:国际用车
ContactList	联系人列表	N	List<OpenApiContact>
TravelerList	乘车人列表	N	List<OpenApiTraveler>
VirtualTripInfo	预估行程信息	N	OpenApiTripInfo
ActualTripInfo	实际行程信息	N	OpenApiTripInfo

OpenApiContact联系人

参数名	参数说明	必填	参数类型	值举例
ContactID	联系人Id	N	String	123456
ContactName	联系人姓名	N	String	张三
ContactMobile	联系人手机号	N	String	18012345678
MobileCountryCode	手机号国家码	N	String	86
VirtualMobile	联系人虚拟手机号	N	String	78946123
VirtualMobileValid	虚拟号码有效性	N	String	0:无效,1:有效

OpenApiTraveler乘车人

参数名	参数说明	必填	参数类型	值举例
PassgID	乘客id	N	String	123456
MemberID	会员Id	N	String	ID123465
TravelerName	乘客姓名	N	String	张三
TravelerMobile	乘客手机号	N	String	18012345678
MobileCountryCode	手机号国家码	N	String	86

OpenApiTripInfo行程信息

参数名	参数说明	必填	参数类型	值举例	备注
ServiceType	服务类型	N	String	实时单,预约单,接送机	用车服务类型
DepartAddr	出发地点	N	String	南京市雨花台区华为云楼
DepartureLongitude	出发地点经度	N	String	118.771705	百度坐标系
DepartureLatitude	出发地点纬度	N	String	31.991354	百度坐标系
DepartCityId	出发城市id	N	String	156320100	城市id
ArrivalCityId	到达城市id	N	String	156320100	城市id
DepartTime	出发时间	N	LocalDateTime	yyyyMMddHHmmss
DepartCityName	出发城市名称	N	String	南京
ArrivalAddr	到达地点	N	String	南京大学鼓楼校区
ArrivalLongitude	到达地点经度	N	String	118.771705	百度坐标系
ArrivalLatitude	到达地点纬度	N	String	31.991354	百度坐标系
ArrivalTime	到达时间	N	LocalDateTime	yyyyMMddHHmmss
ArrivalCityName	到达城市名称	N	String	南京
CountryId	国家/地区id	N	String	156	国家/地区id
CountryName	国家/地区名	N	String	中国	国家/地区名
DriverName	司机姓名	N	String	李师傅
DriverMobile	司机手机号	N	String	13012345678
LicensePlate	车牌号	N	String	苏AD8888
CarType	车辆型号	N	String	天籁
CarColor	车辆颜色	N	String	黑色
ActualSupplierName	实际供应商名称	N	String	首约出行
Mileage	总里程展示(千米)	N	BigDecimal	15
Duration	总时长展示（分钟）	N	BigDecimal	30
RideType	运力类型	N	String	经济型,舒适型,商务型,豪华型
TotalPrice	总金额	N	BigDecimal	35.59
CarUseType	用车类型	N	String	NORMAL:普通打车,AIRPORT_PICKUP:接机,AIRPORT_DROP_OFF:送机
ChargeItemList	费用明细集合	N	List<OpenApiChargeItemInfo>
TripAttachInfo	附加信息json	N	String
FlightDepartureAirport3code	航班出发机场3字码	N	String	NKG
FlightArrivalAirport3code	航班到达机场3字码	N	String	SZX
FlightDepartureDate	航班出发日期	N	LocalDate	yyyyMMdd
FlightNo	航班号	N	String	MU1234

费用项信息OpenApiChargeItemInfo

参数名	参数说明	必填	参数类型	长度	值举例	备注
Type	费用类型名称	N	String		起步费
Amount	费用项金额(元)	N	String		10

样例

请求示例

{
  "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	企业账号	Y	String		1000	系统提供的企业账号
Timestamp	时间戳	Y	String	14	20180811113019	服务方仅允许20分钟内的时间误差。
Version	版本号	Y	String		3.3	固定为3.3。
MsgID	唯一标识	Y	String		1000020150511190411000001	企业账号+消息方向+YYYYMMDDHHMMSS+NNNNNN
LoginName	操作人帐号	Y	String		zhangsan@huawei.com	1、如果是系统维护，写“sysadmin”查询企业下全量数据，用此账号2、如果是普通员工维护，写员工登录名。查询员工名下订单，用此账号
OrderId	打车订单号	N	String			根据订单号查询，有OrderId的前提下不考虑StartTime和EndTime
StartTime	开始更新时间	N	String		20180811113019	yyyyMMddHHmmss包含当前时间
EndTime	截止更新时间	N	String		20180811113019	yyyyMMddHHmmss不包含当前时间查询跨度不超过24小时
BizType	业务类型	N	String		CAR	ICAR:国际用车 CAR:国内用车不传默认国内用车
PageIndex	查询的页码	Y	String
Size	每页条数	Y	String			建议20，上限50

响应参数定义

参数名	参数说明	必填	参数类型	值举例	备注
ResultCode	返回码	Y	String	0	0表示成功，其他值为失败。
Description	描述	Y	String	Success	描述信息，出错时为错误信息即错误原因。
PageIndex	当前的页码	N	String
Size	每页条数	N	String
Total	总记录数	N	String
OrderList	打车订单集合	N	List<OpenApiIncreOrderInfo>

增量打车单信息OpenApiIncreOrderInfo

参数名	参数说明	必填	参数类型	值举例	备注
ChangeTime	变更时间	N	String	yyyy-MM-dd HH:mm
OrderId	订单Id	N	String	U123456789	系统订单id
SupplierOrderId	供应商订单号	N	String	B20221001	用车供应商订单号
CreateTime	订单创建时间	N	String	yyyy-MM-dd HH:mm
EntName	企业名称	N	String
TravelType	出行类型	N	String	0:因公出行,1:个人出行
ServiceType	服务类型	N	String	实时单,预约单,接送机
OrderStatus	订单状态	N	String	IN_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	总价	N	String	123.01
DepartAddr	出发地址	N	String	南京市雨花台区华为云楼
ArrivalAddr	到达地址	N	String	南京大学鼓楼校区
RideType	运气类型	N	String	经济型,舒适型,商务型,豪华型
Mileage	总里程(千米)	N	String	15
Duration	总时长(分钟)	N	String	30

样例

请求示例

{
  "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"
    }
  ]
}

打车订单列表查询

通过该接口查询打车订单列表。

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

接口URL

/querycarorderlist

请求参数定义

参数名	参数说明	必填	参数类型	长度	值举例	备注
CorpCode	企业账号	Y	String		1000	系统提供的企业账号
Timestamp	时间戳	Y	String	14	20180811113019	服务方仅允许20分钟内的时间误差。
Version	版本号	Y	String		3.0	固定为3.0。
LoginName	操作人帐号	Y	String		sysadmin	如果是系统维护，写“sysadmin”查询企业下全量数据，用此账号
StartCreateDate	订单生成起始日期	N	String		20130423	yyyyMMdd。查询时从00:00开始
EndCreateDate	订单生成截止时间	N	String		20130424	yyyyMMdd。查询时以23:59结束, 开始结束时间有一个为空时，根据另外一个值查询3天数据，都为空时查最近3天数据
EnterpriseTrID	企业客户系统审批单编号	N	String		TA0315012116281300028	如果此字段有值，则不考虑StartCreateDate和EndCreateDate查询条件，仅查询该出差申请单号对应的订单数据
BizType	业务类型	N	String		CAR	ICAR:国际用车 CAR:国内用车不传默认国内用车
PageIndex	查询的页码	Y	String
Size	每页条数	Y	String			建议20，上限50

响应参数定义

参数名	参数说明	必填	参数类型	值举例	备注
ResultCode	返回码	Y	String	0	0表示成功，其他值为失败。
Description	描述	Y	String	Success	描述信息，出错时为错误信息即错误原因。
PageIndex	当前的页码	N	String
Size	每页条数	N	String
Total	总记录数	N	String
OrderList	打车订单集合	N	List<OrderList>

打车订单集合OrderList

参数名	参数说明	必填	参数类型	值举例	备注
OrderId	订单id	Y	String	U1234567	系统侧的订单主键id
BizType	业务类型	Y	String	CAR	ICAR:国际用车 CAR:国内用车
TravelType	出行类型	Y	String	BUSINESS:因公出行,PRIVATE:个人出行	默认返回因公出行订单
OrderStatus	订单状态	Y	String	IN_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	预定时间	N	String	2022-10-01 10:01	yyyy-MM-dd HH:mm
TravelNo	TR	N	String	TR-202210001	差旅审批单号
SaleChannel	预定渠道	N	String	android	预定渠道
CarUseScene	用车场景	Y	String	PERSONAL:个人用车,COMMON:普通打车,OVERTIME:加班打车,BUSINESS_TRIP:差旅用车	预定用车的场景
EntId	企业主键	Y	String	1	企业id
EntName	企业名称	N	String	华为技术有限公司	企业的名称
BelongDept	预定人所属部门	N	String	XXX部门	预定人所属部门
StaffNo	预定人工号	N	String	123456
UserName	预定人姓名	N	String	张三
MemberId	预定人MemberId	Y	String	ID123456789
PayType	支付方式	N	String	结算方式: CASH:现金; TRANSFER:转账; ALIPAY:支付宝; WECHAT:微信; UNION:银联; HUAWEI_PAY:华为支付; EMPLOYEE_FLOW:员工电子流; ASS_MONTHLY_BALANCE:关联月结; EXT_MONTHLY_BALANCE:外部月结; BUSINESS_BALANCE:因公欠款; DEBT:欠款
TotalPrice	订单总价	N	String	123.01

样例

请求示例

{
  "CorpCode": "WELINK_xxx",
  "Timestamp": "20230714142011",
  "Version": "3.0",
  "LoginName": "WE_xxx",
  "PageIndex": "1",
  "Size": "5",
  "BizType": "CAR",
  "StartCreateDate": "20230602",
  "EndCreateDate": "20230702"
}

响应示例

{
  "ResultCode": "0",
  "Description": "success",
  "PageIndex": "1",
  "Size": "1",
  "Total": "1",
  "OrderList": [
    {
      "OrderId": "U118791870",
      "BizType": "CAR",
      "TravelType": "BUSINESS",
      "OrderStatus": "COMPLETE",
      "CreateTime": "2023-06-05T11:39:26",
      "TravelNo": "",
      "SaleChannel": "H5",
      "CarUseScene": "NORMAL",
      "EntId": "E0000",
      "EntName": "南京件有限公司",
      "BelongDept": "加班打车测试专用部门",
      "StaffNo": "0100032",
      "UserName": "程萍",
      "MemberId": "ID2105271010214",
      "PayType": "EXT_MONTHLY_BALANCE",
      "TotalPrice": "31.50"
    }
  ]
}

错误码

错误码	错误描述	解决方案
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	未知错误，请稍后重试	联系技术支持人

国内/国际用车

# 国内/国际用车

# 打车订单详情查询

# 接口URL

# 请求参数定义

# 响应参数定义

# OpenApiContact联系人

# OpenApiTraveler乘车人

# OpenApiTripInfo行程信息

# 费用项信息OpenApiChargeItemInfo

# 样例

# 打车订单增量查询

# 接口URL

# 请求参数定义

# 响应参数定义

# 增量打车单信息OpenApiIncreOrderInfo

# 样例

# 打车订单列表查询

# 接口URL

# 请求参数定义

# 响应参数定义

# 打车订单集合OrderList

# 样例

# 错误码

国内/国际用车

打车订单详情查询

接口URL

请求参数定义

响应参数定义

OpenApiContact联系人

OpenApiTraveler乘车人

OpenApiTripInfo行程信息

费用项信息OpenApiChargeItemInfo

样例

打车订单增量查询

接口URL

请求参数定义

响应参数定义

增量打车单信息OpenApiIncreOrderInfo

样例

打车订单列表查询

接口URL

请求参数定义

响应参数定义

打车订单集合OrderList

样例

错误码