蝉印

主题

渠道报单（网电咨询）API ​

渠道报单模块用于渠道部或网电咨询人员录入客户意向，并将其转派给对应的科室或人员跟进。

1. 报单列表 ​

获取历史报单记录列表。

GET /api/reservation/index ​

请求参数

  • rows : 分页大小（默认 10）
  • sort : 排序字段
  • order : 排序方向

2. 报单详情 ​

获取指定报单的详细信息，包括关联的咨询项目和科室数据。

GET /api/reservation/info ​

请求参数

  • id : 报单记录 ID

3. 创建报单 ​

支持 [已有客户报单] 或 [新客户建档并报单] 的一键操作。

POST /api/reservation/create ​

请求体结构（JSON）

该接口采用嵌套结构：

参数类型必填描述
customer_idinteger否如果提供，则为已有客户报单
customer.*object否如果不传 customer_id，则必填此对象以创建新客
customer.namestring是 *顾客姓名
customer.sexint是 *性别（1：男，2：女）
customer.phonearray是 *手机号数组
customer.address_idint是 *地址 ID
customer.medium_idint是 *来源 ID
reservation.*object是报单业务数据
reservation.department_idint是咨询科室 ID
reservation.typeint是受理类型 ID（通过接口获取）
reservation.datestring是受理日期（YYYY-MM-DD）
reservation.itemsarray是咨询项目 ID 数组
reservation.remarkstring是咨询备注

请求示例（为新客报单）

json
{
  "customer": {
    "name": "王小五",
    "sex": 1,
    "phone": ["13911112222"],
    "address_id": 1,
    "medium_id": 5
  },
  "reservation": {
    "department_id": 2,
    "type": 3,
    "date": "2026-01-27",
    "items": [10, 15],
    "remark": "客户对激光祛斑非常感兴趣"
  }
}

响应示例 成功后会返回创建成功的 Reservation 对象及其关联的 customer_id 。

相关资源 ​