sales sales

模块 sales：共 6 个接口 —— 0 个被前端调用（在用），6 个未被调用（含 0 个开放/回调/内部）。用下方筛选可只看“在用/未使用”，或在右栏目录按名称过滤。

SalesController 0/6 在用

POST /sales/addSales 未使用管理后台 #
Sales-新增 · SalesController
基本信息
控制器com.jxxx.dscp.api.controller.sales.SalesController#addSales
所属模块sales sales
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表sales
ControllerSalesController#addSales
转换BeanUtils.map → Sales ⇒ 表 sales
ServiceSalesService#add （SalesServiceImpl）
MapperSalesMapper#insert ⇒ 表 sales

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/sales/addSales
uathttps://dscp-uat.hn12301.net/manage-api/sales/addSales
prohttps://dscp-uat.hn12301.net/manage-api/sales/addSales （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SalesAddRequest
字段类型必填取值/校验表 / 列说明
nameString是必填sales.name机构名称
deptIdLong是必填sales.dept_id所属部门ID，关联部门表merchant_dept的id
phoneStringsales.phone手机号码
inviteCodeStringsales.invite_code邀请码
qrcodeStringsales.qrcode分销二维码
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构　SalesResponse　（object）
字段类型必填取值/校验表 / 列说明
idLongsales.id主键，分销机构ID
nameStringsales.name机构名称
deptIdLongsales.dept_id所属部门ID，关联部门表merchant_dept的id
phoneStringsales.phone手机号码
inviteCodeStringsales.invite_code邀请码
qrcodeStringsales.qrcode分销二维码
示例
请求示例 （自动生成，仅结构参考）
POST /sales/addSales
{
  "body": {
    "name": "",
    "deptId": 1,
    "phone": "13800000000",
    "inviteCode": "",
    "qrcode": ""
  }
}
响应示例
{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "name": "",
    "deptId": 1,
    "phone": "13800000000",
    "inviteCode": "",
    "qrcode": ""
  }
}
处理逻辑
操作日志sales / 新增销售渠道
逻辑摘要新增（salesService.add）；入参与返回值经 BeanUtils 做对象/分页映射
前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /sales/deleteSales 未使用管理后台 #
Sales-删除 · SalesController
基本信息
控制器com.jxxx.dscp.api.controller.sales.SalesController#deleteSales
所属模块sales sales
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表sales
ControllerSalesController#deleteSales
ServiceSalesService#delete （SalesServiceImpl）
MapperSalesMapper#deleteById ⇒ 表 sales

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/sales/deleteSales
uathttps://dscp-uat.hn12301.net/manage-api/sales/deleteSales
prohttps://dscp-uat.hn12301.net/manage-api/sales/deleteSales （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest
字段类型必填取值/校验表 / 列说明
idLong是必填sales.idid
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构

void —— 无返回数据

示例
请求示例 （自动生成，仅结构参考）
POST /sales/deleteSales
{
  "body": {
    "id": 1
  }
}
响应示例
（void，无响应体）
处理逻辑
操作日志sales / 删除销售渠道
逻辑摘要删除（salesService.delete）
前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /sales/getSales 未使用管理后台 #
Sales-详情 · SalesController
基本信息
控制器com.jxxx.dscp.api.controller.sales.SalesController#getSales
所属模块sales sales
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表sales
ControllerSalesController#getSales
ServiceSalesService#get （SalesServiceImpl）
MapperSalesMapper#selectById ⇒ 表 sales

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/sales/getSales
uathttps://dscp-uat.hn12301.net/manage-api/sales/getSales
prohttps://dscp-uat.hn12301.net/manage-api/sales/getSales （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest
字段类型必填取值/校验表 / 列说明
idLong是必填sales.idid
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构　SalesResponse　（object）
字段类型必填取值/校验表 / 列说明
idLongsales.id主键，分销机构ID
nameStringsales.name机构名称
deptIdLongsales.dept_id所属部门ID，关联部门表merchant_dept的id
phoneStringsales.phone手机号码
inviteCodeStringsales.invite_code邀请码
qrcodeStringsales.qrcode分销二维码
示例
请求示例 （自动生成，仅结构参考）
POST /sales/getSales
{
  "body": {
    "id": 1
  }
}
响应示例
{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "name": "",
    "deptId": 1,
    "phone": "13800000000",
    "inviteCode": "",
    "qrcode": ""
  }
}
处理逻辑
逻辑摘要查询详情（salesService.get）；入参与返回值经 BeanUtils 做对象/分页映射
前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /sales/querySalesList 未使用管理后台 #
Sales-列表查询 · SalesController
基本信息
控制器com.jxxx.dscp.api.controller.sales.SalesController#querySalesList
所属模块sales sales
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表sales
ControllerSalesController#querySalesList
转换BeanUtils.map → SalesQuery
ServiceSalesService#queryList （SalesServiceImpl）
MapperSalesMapper#selectList ⇒ 表 sales

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/sales/querySalesList
uathttps://dscp-uat.hn12301.net/manage-api/sales/querySalesList
prohttps://dscp-uat.hn12301.net/manage-api/sales/querySalesList （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SalesListRequest
字段类型必填取值/校验表 / 列说明
nameString否可选(@MvcOptional)sales.name机构名称
deptIdLong否可选(@MvcOptional)sales.dept_id所属部门ID，关联部门表merchant_dept的id
phoneString否可选(@MvcOptional)sales.phone手机号码
inviteCodeString否可选(@MvcOptional)sales.invite_code邀请码
qrcodeString否可选(@MvcOptional)sales.qrcode分销二维码
idListList<Long>否可选(@MvcOptional)—id列表
keywordsString否可选(@MvcOptional)—关键字
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构　List<SalesResponse>　（list）
字段类型必填取值/校验表 / 列说明
[ ]array—列表，元素结构见下
idLongsales.id主键，分销机构ID
nameStringsales.name机构名称
deptIdLongsales.dept_id所属部门ID，关联部门表merchant_dept的id
phoneStringsales.phone手机号码
inviteCodeStringsales.invite_code邀请码
qrcodeStringsales.qrcode分销二维码
示例
请求示例 （自动生成，仅结构参考）
POST /sales/querySalesList
{
  "body": {
    "name": "",
    "deptId": 1,
    "phone": "13800000000",
    "inviteCode": "",
    "qrcode": "",
    "idList": "",
    "keywords": ""
  }
}
响应示例
{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "name": "",
      "deptId": 1,
      "phone": "13800000000",
      "inviteCode": "",
      "qrcode": ""
    }
  ]
}
处理逻辑
逻辑摘要列表查询（salesService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射
前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /sales/querySalesPage 未使用管理后台 #
Sales-分页查询 · SalesController
基本信息
控制器com.jxxx.dscp.api.controller.sales.SalesController#querySalesPage
所属模块sales sales
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表sales
ControllerSalesController#querySalesPage
转换BeanUtils.map → SalesQuery
ServiceSalesService#queryPage （SalesServiceImpl）
MapperSalesMapper#selectPage ⇒ 表 sales

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/sales/querySalesPage
uathttps://dscp-uat.hn12301.net/manage-api/sales/querySalesPage
prohttps://dscp-uat.hn12301.net/manage-api/sales/querySalesPage （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SalesPageRequest
字段类型必填取值/校验表 / 列说明
pageNumInteger否—页码（继承自框架分页基类 AbstractPageRequest）
pageSizeInteger否—每页条数（继承自框架分页基类 AbstractPageRequest）
nameString否可选(@MvcOptional)sales.name机构名称
deptIdLong否可选(@MvcOptional)sales.dept_id所属部门ID，关联部门表merchant_dept的id
phoneString否可选(@MvcOptional)sales.phone手机号码
inviteCodeString否可选(@MvcOptional)sales.invite_code邀请码
qrcodeString否可选(@MvcOptional)sales.qrcode分销二维码
idListList<Long>否可选(@MvcOptional)—id列表
keywordsString否可选(@MvcOptional)—关键字
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构　PageInfo<SalesResponse>　（page）
字段类型必填取值/校验表 / 列说明
list / recordsarray—分页列表，元素结构见下
totallong—总条数（PageInfo）
idLongsales.id主键，分销机构ID
nameStringsales.name机构名称
deptIdLongsales.dept_id所属部门ID，关联部门表merchant_dept的id
phoneStringsales.phone手机号码
inviteCodeStringsales.invite_code邀请码
qrcodeStringsales.qrcode分销二维码
示例
请求示例 （自动生成，仅结构参考）
POST /sales/querySalesPage
{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "name": "",
    "deptId": 1,
    "phone": "13800000000",
    "inviteCode": "",
    "qrcode": "",
    "idList": "",
    "keywords": ""
  }
}
响应示例
{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "name": "",
        "deptId": 1,
        "phone": "13800000000",
        "inviteCode": "",
        "qrcode": ""
      }
    ],
    "total": 0
  }
}
处理逻辑
逻辑摘要分页查询（salesService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射
前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /sales/updateSales 未使用管理后台 #
Sales-更新 · SalesController
基本信息
控制器com.jxxx.dscp.api.controller.sales.SalesController#updateSales
所属模块sales sales
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表sales
ControllerSalesController#updateSales
转换BeanUtils.map → Sales ⇒ 表 sales
ServiceSalesService#update （SalesServiceImpl）
MapperSalesMapper#updateById ⇒ 表 sales

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/sales/updateSales
uathttps://dscp-uat.hn12301.net/manage-api/sales/updateSales
prohttps://dscp-uat.hn12301.net/manage-api/sales/updateSales （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SalesUpdateRequest
字段类型必填取值/校验表 / 列说明
idLong是必填sales.id主键，分销机构ID
nameString是必填sales.name机构名称
deptIdLong是必填sales.dept_id所属部门ID，关联部门表merchant_dept的id
phoneStringsales.phone手机号码
inviteCodeStringsales.invite_code邀请码
qrcodeStringsales.qrcode分销二维码
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构

void —— 无返回数据

示例
请求示例 （自动生成，仅结构参考）
POST /sales/updateSales
{
  "body": {
    "id": 1,
    "name": "",
    "deptId": 1,
    "phone": "13800000000",
    "inviteCode": "",
    "qrcode": ""
  }
}
响应示例
（void，无响应体）
处理逻辑
操作日志sales / 更新销售渠道
逻辑摘要更新（salesService.update）；入参与返回值经 BeanUtils 做对象/分页映射
前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）