订单列表信息(新)
接口地址
https:// <SQYC_DOMAIN>/carapi/partner/order/detail/v2
请求方式
POST
接口说明
- 尽量在低峰时间段内调用
- 调用方需控制好时间段(endDateEnd 与 endDateStart 不可时间跨度过大)
请求参数
| 参数名称 | 类型 | 说明 | 是否必传 |
|---|---|---|---|
| channel | String | 渠道名称 | 是 |
| sign | String | 签名 | 是 |
| companyId | String | 机构ID | 是 |
| endDateStart | String | 结算时间开始(yyyy-MM-dd HH:mm:ss) | 是 |
| endDateEnd | String | 结算时间结束(yyyy-MM-dd HH:mm:ss) | 是 |
| pageNum | int | 第几页 | 是 |
| pageSize | int | 条数 默认:100条,最大200条 | 否 |
返回结果
| 返回参数 | 类型 | 说明 |
|---|---|---|
| result | int | 0:成功 :失败 |
| errmsg | string | SUCCESS;ERROR |
| data | object | 返回结果信息参考下文 |
计算公式
费用总计(totalAmount) = (套餐费-basePrice + 里程费-overMileageNumTotal + 时长费-overTimeNumTotal + 等候费-waitingFee + 动调费-dynamicDoublyFee + 远途费-longDistancePrice + 跨城费-crossCityFee + 调度费-ddFees + 指定司机费-designatedDriverFee) +( 高速费-gsFees + 停车费-tcFees + 食宿费-ssFees + 清洁费-cleanFee + 接机员费-pickupFee + 深度清洁费-deepCleanFee + 机场停车费-airportParkFee ) + 取消费-cancelAmount
应付金额 (actualPayAmount) = 费用总计(totalAmount) - 折扣金额(disAmount)
折扣率 = 折扣金额(disAmount) /(套餐费-basePrice + 里程费-overMileageNumTotal + 时长费-overTimeNumTotal + 等候费-waitingFee + 动调费-dynamicDoublyFee + 远途费-longDistancePrice + 跨城费-crossCityFee )
费用总计 = 行程费 + 价外费
行程费 = (套餐费 + 里程费 + 时长费 + 等候费 + 动调费 + 远途费 + 跨城费 + 调度费 + 指定司机费)
价外费 = ( 高速费 + 停车费 + 食宿费 + 清洁费 + 指定司机费 + 接机员费 + 深度清洁费 + 机场停车费 + 调度费 )
返回示例
| 分类 | 字段名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|---|
| 用车 | jobNum | String | 是 | 工号 |
| bookingName | String | 是 | 下单人姓名 | |
| bookingPhone | String | 是 | 预定人手机号 | |
| riderName | String | 是 | 乘车人姓名 | |
| riderPhone | String | 是 | 乘车人手机号 | |
| applyId | Integer | 否 | 审批单id | |
| postAuditStatus | int | 否 | 审批单状态null:不是审批单;0:待审核;10:审核通过;20:审核不通过,待个人支付;21:个人支付完成 | |
| conditionId | Integer | 否 | 用车条件ID | |
| conditionName | String | 否 | 用车条件名称 | |
| purposeName | String | 否 | 用车备注 | |
| projectCode | String | 否 | 项目编码 | |
| projectName | String | 否 | 项目名称 | |
| explain | String | 否 | 备注 | |
| 订单 | orderNo | String | 是 | 订单号 |
| status | String | 是 | 订单状态 已完成/已取消/已结算 等 | |
| createDate | int | 是 | 下单时间(毫秒级时间戳) | |
| bookingDate | int | 是 | 预约用车时间(毫秒级时间戳) | |
| bookingStartCityName | String | 是 | 预约上车城市 | |
| bookingStartCityId | String | 是 | 预约上车城市ID | |
| bookingStartAddr | String | 是 | 预约上车地址 | |
| bookingEndAddr | String | 是 | 预约下车地址 | |
| factDate | int | 否 | 实际上车时间(毫秒级时间戳) | |
| factEndDate | int | 否 | 实际下车时间(毫秒级时间戳) | |
| factStartPoint | String | 否 | 实际上车地址经纬度 | |
| factStartAddr | String | 否 | 实际上车地址 | |
| factEndPoint | String | 否 | 实际下车地址经纬度 | |
| factEndAddr | String | 否 | 实际下车地址 | |
| airportId | String | 是 | 是否拼车:是/否 | |
| selfUpgrade | int | 是 | 自费升舱 1:是; 0:否 | |
| serviceTypeId | int | 是 | 服务类型ID | |
| serviceTypeName | String | 是 | 服务类型名称 | |
| isAirPort | int | 是 | 上下车地址是否是机场 0-不是、1-上车地是机场、2-下车地是机场 | |
| bookingGroupName | String | 是 | 预约车型名称 | |
| carGroupId | int | 是 | 车型ID | |
| carGroupName | String | 是 | 车型名称 | |
| licensePlates | String | 是 | 司机车牌号 | |
| 费用 | estimatedAmount | double | 是 | 预估原价(元) |
| basePrice | double | 是 | 套餐费/起步价(元) | |
| overMileageNumTotal | double | 是 | 里程费(元) | |
| overMileageNum | double | 是 | 总里程数(米) | |
| overTimeNumTotal | double | 是 | 时长费(元) | |
| overTimeNum | double | 是 | 总时长数(分钟) | |
| waitingFee | double | 是 | 等候费(元) | |
| waitingTime | double | 是 | 等候时间(分钟) | |
| dynamicDoublyFee | double | 是 | 动态加价(元) | |
| longDistancePrice | double | 是 | 远途费(元) | |
| longDistanceNum | double | 否 | 远途里程(km) | |
| crossCityFee | double | 是 | 跨城费(元) | |
| ddFees | double | 是 | 调度费(元) | |
| designatedDriverFee | double | 是 | 指定司机费(元) | |
| gsFees | double | 是 | 高速费(元) | |
| tcFees | double | 是 | 停车费(元) | |
| airportParkFee | double | 是 | 机场停车费(元) | |
| ssFees | double | 是 | 食宿费(元) | |
| cleanFee | double | 是 | 清洁费(元) | |
| deepCleanFee | double | 是 | 深度清洁费(元) | |
| pickupFee | double | 是 | 接机员费(元) | |
| totalAmount | double | 是 | 原价(元) | |
| disAmount | double | 是 | 折扣金额(包括动态折扣+企业折扣+限时优惠)(元) | |
| actualPayAmount | double | 是 | 乘客应付金额(元) | |
| cancelAmount | double | 否 | 取消费(元) | |
| refundPay | double | 否 | 异议减免金额(元) | |
| 支付 | finishTime | int | 是 | 结算时间(订单支付时间)(毫秒级时间戳) |
| businessPay | double | 是 | 企业支付金额(元) | |
| personalPay | double | 是 | 个人支付金额(元) | |
| 其他 | invoiceAmount | double | 是 | 可开发票金额(元) |
| isSensitiveOrder | int | 是 | 是否敏感订单:0:否;1:是 | |
| sensitiveRemark | String | 是 | 敏感订单说明(没有的情况下返回空) |