帮助文档

# 订单列表

# 接口说明

查询当前合作方渠道的包车订单列表，支持按联系人手机号、发车时间、创建时间过滤。

# 接口地址

  • 测试环境：http://apitest.dudubashi.com/api/charter/partner_order_list
  • 生产环境：http://wx.dudubashi.com/api/charter/partner_order_list

# 请求方法

POST

# 请求参数

参数名 类型 必填 说明 示例
contact_phone string 否 联系人手机号（11位） 13800138000
page integer 否 页码，默认 1 1
page_size integer 否 每页数量，默认 20，最大 100 20
start_time_from string 否 发车开始时间 2026-05-01
start_time_to string 否 发车结束时间 2026-05-31
create_time_from string 否 创建订单开始时间 2026-05-01
create_time_to string 否 创建订单结束时间 2026-05-31

# 响应参数

参数名 类型 说明
data.list array 订单列表
data.total integer 总数
data.page integer 当前页码
data.page_size integer 每页数量

# 订单字段

参数名 类型 说明
id integer 订单ID
order_num string 订单号
status string 订单状态文字
status_code integer 订单状态码
charter_type string 包车类型文字
charter_type_code integer 包车类型码：0单程 1往返 2包天
start_time string 出发时间
from_place string 起点
to_place string 终点
car_type string 车型描述
person_num integer 用车人数
bus_num integer 车辆数
contact_name string 联系人
contact_phone string 联系电话
price number 订单报价
real_pay number 实付金额
extra_fee_amount number 额外费用金额
extra_fee_status integer 额外费用状态：0待支付 1已支付
can_cancel boolean 是否可取消
cancel_charge number 当前取消扣费金额
cancel_refund_amount number 当前预计退款金额
create_time string 下单时间

# 响应示例

{
  "result": "0000",
  "info": "成功",
  "data": {
    "list": [
      {
        "id": 12345,
        "order_num": "BC202605200001",
        "status": "待完成",
        "status_code": 5,
        "charter_type": "单程",
        "charter_type_code": 0,
        "start_time": "2026-05-20 09:00:00",
        "from_place": "深圳北站",
        "to_place": "深圳宝安国际机场",
        "car_type": "7座商务车×1",
        "person_num": 4,
        "bus_num": 1,
        "contact_name": "张三",
        "contact_phone": "13800138000",
        "price": 500,
        "real_pay": 500,
        "extra_fee_amount": 0,
        "extra_fee_status": 0,
        "can_cancel": true,
        "cancel_charge": 50,
        "cancel_refund_amount": 450,
        "create_time": "2026-05-14 10:00:00"
      }
    ],
    "total": 1,
    "page": 1,
    "page_size": 20
  }
}

# 注意事项

  1. 默认查询当前合作方渠道（os）的所有订单
  2. 两个时间范围都不传时，默认查询创建时间最近一个月内的订单
  3. 时间格式支持 YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss

← 订单详情 →