单用户积分查询

接口：common/point/balance
Method：POST
数据格式：JSON
实现：PointController.getPointBalance → PointServiceImpl.getPointBalance
接口说明：按用户名或员工号查询当前租户下该用户的积分余额与冻结积分。
入参：
- user_name 或 employee_number 至少填写一种；若两者都填，查询条件优先使用 user_name（与 UserQueryCondition 设置顺序一致）。

请求参数

bizId 格式与生成方式

格式：标准 UUID 字符串（RFC 4122），36 个字符，形如 0255bda8-ae0f-44c2-84e4-f16821854fc9（8 段十六进制 + 连字符）。
用途：单次请求/幂等追踪，建议每次调用生成新的唯一值；不传时服务端会自行生成。

body

字段名称	字段类型	字段描述	是否必填	长度限制(字节)
bizId	String	当前次接口同步的唯一标识	FALSE	36
timestamp	Long	当前次接口同步的时间戳	FALSE	13
data	Object	请求数据体	TRUE	无
data.user_name	String	用户名	`ONE-OF`	无
data.employee_number	String	员工号	`ONE-OF`	无

返回参数

字段名称	字段类型	字段描述
bizId	String	当前次接口同步的唯一标识
resCode	Integer	响应状态码（见附录）
resMsg	String	返回信息描述
data	Object	请求数据体
data.user_name	String	用户名同入参
data.employee_number	String	员工号同入参
data.point_balance	BigDecimal	该员工的积分余额
data.point_frozen	BigDecimal	该员工的已冻结积分

示例:

请求数据

{
  "bizId": "6ab844e4-2757-11f1-9125-0291a5151a24",
  "timestamp": 1702521344000,
  "data": {
    "employee_number": "CAN000193"
  }
}

返回报文

查询成功

{
  "resCode": 200000,
  "resMsg": "查询用户积分成功",
  "bizId": "6ab844e4-2757-11f1-9125-0291a5151a24",
  "data": {
    "user_id": 10001,
    "point_balance": 200.00,
    "point_frozen": 0.00
  }
}

查询失败

{
    "resCode": 400000,
    "resMsg": "该用户不存在",
    "bizId": "6deb2fcf-e4fa-41e8-9599-a01a7167c109"
}

results matching ""

No results matching ""