方软OpenApi-机构版
  1. 会员
方软OpenApi-机构版
  • 接口变更记录
  • 开发前准备
  • 请求签名鉴权方式
  • OAuth2.0鉴权方式
  • 常见问题速查
  • 接入
    • 获取AccessToken
      GET
    • 刷新AccessToken
      GET
  • 公共数据获取
    • 三大目录(药品/收费项目/材料)
      • 查询三大目录
      • 查询三大目录(分页版)
      • 启用停用收费项目
      • 保存物资材料信息
      • 查询三大目录营销特性
    • 部门
      • 同步部门信息
      • 同步业务相关部门
    • 字典
      • 同步字典
      • 同步开发渠道
    • 员工
      • 同步员工信息
      • 根据岗位同步员工信息
      • 保存员工档案
    • 合作单位
      • 同步合约单位
      • 同步供应商
      • 同步生产商
    • 同步机构信息
      GET
    • 执行sql脚本获取数据
      POST
  • 系统管理接口
    • 三方应用免密登录
      • 获取登录用户信息
      • 获取frtoken
    • 文件管理
      • 文件下载
      • 文件上传
      • 根据key获取资源
    • 消息推送
      • 消息推送
      • 患者信息推送
      • 患者会员等级变动消息
      • 单据删除消息推送
      • 门诊结账
      • 门诊退费
      • 保存三方聊天记录
      • 批量保存三天聊天记录
      • 门诊挂号
    • 系统用户相关(认证鉴权)
      • 用户登录接口
      • 校验用户密码、校验用户身份
      • 三方用户绑定
      • 获取三方用户信息
    • 三方自定义消息通知
      POST
    • 给员工发送通知消息
      POST
    • 自定义字段修改
      POST
  • 患者档案相关
    • 检查患者是否存在
    • 查患者信息
    • 患者信息推送测试
    • 查询患者列表
    • 获取患者标签
    • 给患者打标签
    • 患者建档
    • 更新患者信息
    • 关键字查询客户列表
    • 集团客户机构建档
    • 查询患者家庭成员
    • 绑定患者家庭成员
    • 取消绑定患者家庭成员
    • 查询患者附件
    • 保存患者附件
  • CRM
    • 预约
      • 获取预约列表
      • 获取预约详情
      • 患者预约
      • 取消预约
    • 网络预约
      • 患者网络预约申请
      • 取消网络预约
    • 回访
      • 查询指定客户回访列表
      • 客户回访
      • 作废回访
    • 网电咨询
      • 新增患者咨询
      • 查询指定患者的咨询记录
    • 排班
      • 获取排班班次
      • 获取值班数据
  • 会员
    • 优惠券
      • 获取会员已领取优惠券列表
      • 给会员赠送优惠券
      • 作废优惠券
    • 卡项
      • 获取患者持有卡项(已购卡记录)
      • 获取持有卡项项目
      • 获取卡项使用记录
    • 客户积分操作
      POST
    • 客户项目剩余
      GET
    • 获取会员账户信息
      GET
    • 会员充值
      POST
    • 会员账户变动记录
      GET
    • 更改会员类别/会员等级
      POST
  • HIS
    • 门诊
      • 门诊挂号
        • 获取门诊挂号类别字典
        • 门诊挂号收费接口
      • 门诊结算
        • 获取患者未结账门诊收费单
        • 门诊费用明细记录查询
        • 门诊收银结算
        • 门诊退费
      • 分诊登记接口
      • 分诊登记撤销
      • 门诊登记记录
      • 新增门诊收费单
      • 作废门诊收费单
    • RIS
      • 检查申请单登记
      • 检查申请单撤销
      • 检查报告单
      • 申请单查看
      • 报告单的保存
      • 确认费用
      • 查询检验结果
      • 查询单个检验结果明细
    • 客户照片
      • 创建照片订单
      • 上传照片(照片内容base64编码)
      • 上传照片
      • 获取患者照片列表
    • 财务
      • 应收账款
        • 获取患者的欠费单据
        • 患者还款
      • 客户消费明细
    • 病历
      • 获取患者门诊病历
    • 排队叫号
      • 患者排队叫号列表
      • 患者回诊排队
    • 项目划扣
      • 划扣接单
      • 开始执行
      • 执行完成
      • 撤销项目划扣
      • 请领
      • 客户项目执行记录
      • 房间项目执行情况
  • 外加工
    • 外加工消息通知
  • 进销存
    • 保存采购进货单
    • 作废库房单据
    • 审核库房单据
    • 根据进货单生成出库单
  • OA审批
    • 获取审批单状态
    • 获取审批单列表
    • 保存折扣申请审批单
    • 驳回申请单
  • 渠道管理
    • 查询渠道
    • 保存渠道
    • 批量保存渠道
  1. 会员

会员账户变动记录

GET
/api/anon/openapi/vip/account/consume/{patientID}
最后修改时间:2023-07-26 08:41:18
责任人:孙工
返回字段中主要关注type、consumeType和optionType。

请求参数

Path 参数
patientID
string 
必需
Query 参数
startTime
string 
开始时间
可选
endTime
string 
结束时间
可选
pageNo
integer 
可选
示例值:
1
pageSize
integer 
可选
示例值:
10
queryType
integer 
必需
0: 工本费
1: 会员费账户
2: 押金账户
3: 充值基本账户
4: 充值赠送账户
5: 预交金账户
6: 入会转基本账户
7: 消费卷
8: 积分账户
9: 欠款账户,只能用于还款,不能消费
示例值:
5
Header 参数
FRHis-Open-Timestamp
string 
必需
示例值:
{% mock 'timestamp' %}
FRHis-Open-App-Id
string 
必需
示例值:
{{appid}}
FRHis-Open-Token
string 
必需
示例值:
{{token}}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/api/anon/openapi/vip/account/consume/?startTime=&endTime=&pageNo=1&pageSize=10&queryType=5' \
--header 'FRHis-Open-Timestamp: {% mock '\''timestamp'\'' %}' \
--header 'FRHis-Open-App-Id: {{appid}}' \
--header 'FRHis-Open-Token: {{token}}'

返回响应

🟢200成功
application/json
Body
errcode
integer 
状态码
必需
0正常 1失败
errmsg
string 
信息
必需
data
object 
返回结果
必需
serialNumber
integer 
系统流水号
必需
orderNo
string 
单号
可选
sourceNumber
integer 
原流水号
可选
patientID
integer 
患者ID
必需
dealTime
string 
交易时间
必需
type
integer 
类型
必需
0: 工本费
1: 会员费账户
2: 押金账户
3: 充值基本账户
4: 充值赠送账户
5: 预交金账户
6: 入会转基本账户
7: 消费卷
8: 积分账户
9: 欠款账户,只能用于还款,不能消费
consumeType
integer  | null 
消费类型
可选
该字段是对类型的详细定义,没有值时用类型即可
且只有在optionType=2时才有值
0:购买项目(客户购买项目系统扣减余额)
1:转为营业收入(押金之类的转为业务收入)。
0和1用途固定,从2开始按lx字段区分定义用途
二、基本账户(lx=3)
1、门诊消费
2:初始导入项目退费充值定金账户。初始化退费差额退回账户
3:项目置换。由于项目置换差生差额退回账户
4:还款
10:购买卡项。使用定金购买卡项
三、定金(lx=5)
1、门诊消费
2:初始导入项目退费充值定金账户。初始化退费差额退回账户
3:项目置换。由于项目置换差生差额退回账户
4:还款
10:购买储值卡。使用定金购买卡项
11:购买项目次卡。使用定金购买卡项
12:购买折扣卡。使用定金购买卡项
四、赠送金额(lx=4)
1、门诊消费
4:还款
五、积分(lx=8)
1、门诊消费
2、积分兑换礼品
3:积分过期作废、积分清零
4:还款
status
integer 
状态
必需
5,正常(已收费)6,退费(已退费)7,红冲
会员消费记录,消费金额都是正数,
zt=5是消费记录, zt=7是退费产生的记录
receiptNo
string 
收据号
可选
amount
integer 
金额
必需
balance
integer 
余额
必需
inputEmpID
integer 
操作员姓名
必需
inputEmpName
string 
操作员ID
必需
dealDeptID
integer 
交易科室ID
可选
dealDeptName
null 
交易科室名称
可选
optionType
integer 
记录类型
必需
1-充和退 2-消费
其中为1时,需要多判断一个status字段。
optionType = 1 && status = 5 就是 充值
optionType = 1 && status = 7 就是 退
optionType = 2 就是 消费
示例
{
  "errcode" : 0,
  "errmsg" : "操作成功",
  "data" : [ {
    "dealTime" : "2023-07-26 15:13:59",
    "inputEmpName" : "孙中元",
    "consumeType" : null,
    "dealDeptID" : null,
    "receiptNo" : "",
    "status" : 5,
    "serialNumber" : 23575,
    "patientID" : 181228,
    "type" : 8,
    "amount" : 10000.0000,
    "balance" : 10122.0000,
    "orderNo" : "0000023575",
    "dealDeptName" : null,
    "inputEmpID" : 3104,
    "optionType" : 1
  }, {
    "dealTime" : "2023-07-25 14:14:57",
    "inputEmpName" : "孙中元",
    "consumeType" : 1,
    "dealDeptID" : 0,
    "receiptNo" : "230725141457",
    "status" : 5,
    "serialNumber" : 14461,
    "patientID" : 181228,
    "type" : 8,
    "amount" : 10.0000,
    "balance" : 122.0000,
    "orderNo" : "0000014461",
    "dealDeptName" : null,
    "inputEmpID" : 3104,
    "optionType" : 2
  }, {
    "dealTime" : "2023-07-24 18:11:37",
    "inputEmpName" : null,
    "consumeType" : null,
    "dealDeptID" : null,
    "receiptNo" : "",
    "status" : 5,
    "serialNumber" : 23381,
    "patientID" : 181228,
    "type" : 8,
    "amount" : 132.0000,
    "balance" : 132.0000,
    "orderNo" : "0000023381",
    "dealDeptName" : null,
    "inputEmpID" : 0,
    "optionType" : 1
  } ]
}
上一页
会员充值
下一页
更改会员类别/会员等级
Built with