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

门诊退费

设计中
POST
/api/anon/openapi/his/outpt/refund
最后修改时间:2024-07-13 11:45:37
责任人:肖工
患者结算时会使用多种支付方式(付款方式)组合结算,如:预交金账户支付,现金支付,微信支付,支付宝支付,银行卡支付,代金券支付,积分抵扣支付,欠款等等,我们把现金支付,微信支付,支付宝支付,银行卡支付等统称之为实收或付现。
退费时系统依据医院利益优先原则,能不退款则不退款,基于本次退费总额,按患者原先的付款方式,优先退非实收的部分,非实收的部分大于本次退费总额,就不需要给患者退款,否则才需要给患者退款(非实收的部分退费遵从:从哪来回哪去。比如:预交金支付自动退回到预交金账户,积分返回积分账户,代金券原路返回,欠款就冲抵)。shouldRefund属性对应本次应退款(退现金额),refundMethod属性传入具体的退款方式,是退现金、退微信,退支付宝还是退银行卡。因此如果本次不需要给患者退款,shouldRefund传0,refundMethod列表为空。

请求参数

Body 参数application/json
patientID
integer 
患者Id
必需
settleRecID
integer 
门诊结账记录流水号
必需
refundAmount
number 
退费金额
必需
本次明细退费总额。需要等于明细退费金额之和
shouldRefund
number 
应退款金额
必需
可退实收、可退现部分。是对refundMethod列表中退款金额的汇总。由于结算时可能存在多支付方式,如:现金支付,其他实收类支付,预交金支付,代金券支付,积分抵扣支付,欠款等等。退款时系统遵从医院利益最大化,患者要退费,系统根据患者原先的支付方式,先退非实收的部分,非实收部分大于本次退费总额,就不需要给患者退款,否则才给患者退款。因此仅当需要给患者退款时,才需要传入refundMethod列表属性
refundMethod
object (支付方式、付款方式BO) 
退款方式
必需
可退实收的部分。由于结算时存在多支付方式,如:现金支付,其他实收类支付,预交金支付,代金券支付,欠款等等。退款时系统遵从医院利益最大化,优先退非实收部分,非实收部分退完,最后才退实收部分。因此仅当非实收部分退完,才允许退款,才需要传入退款方式
contractCorpID
integer 
合约机构id
可选
主要用于欠款、应收账款。三方挂账。合约机构id。合约单位、三方平台
payMethod
string 
支付方式编号
必需
对应字典支付方式编号
payAmount
number 
支付金额
必需
相应支付方式付款金额
setlRefCode
string 
结算号码
必需
结算参考码、支付凭证码。支付类别为优惠券时传优惠券编码,支付类别为储值卡时传储值卡卡号、如果是三方平台欠款也可用于存核销码
refundDetails
array [object {5}] 
退费明细
必需
实际需要退费的明细。不需要退费的明细不需要传入
lsh
integer 
费用明细流水号
必需
对应门诊费用明细记录查询返回的illSerialNumber属性
itemType
integer 
项目类型
必需
1、药品,2、收费项目,3、材料
tfsl
number 
退费数量
必需
tfje
number 
退费金额
必需
tfzy
string 
退费摘要
必需
明细退费摘要
memo
string 
退款备注
必需
示例
{
    "patientID": 0,
    "settleRecID": 0,
    "refundAmount": 0,
    "shouldRefund": 0,
    "refundMethod": {
        "contractCorpID": 0,
        "payMethod": "string",
        "payAmount": 0,
        "setlRefCode": "string"
    },
    "refundDetails": [
        {
            "lsh": 0,
            "itemType": 0,
            "tfsl": 0,
            "tfje": 0,
            "tfzy": "string"
        }
    ],
    "memo": "string"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/anon/openapi/his/outpt/refund' \
--header 'Content-Type: application/json' \
--data-raw '{
    "patientID": 0,
    "settleRecID": 0,
    "refundAmount": 0,
    "shouldRefund": 0,
    "refundMethod": {
        "contractCorpID": 0,
        "payMethod": "string",
        "payAmount": 0,
        "setlRefCode": "string"
    },
    "refundDetails": [
        {
            "lsh": 0,
            "itemType": 0,
            "tfsl": 0,
            "tfje": 0,
            "tfzy": "string"
        }
    ],
    "memo": "string"
}'

返回响应

🟢200成功
application/json
Body
object {0}
示例
{}
修改于 2024-07-13 11:45:37
上一页
门诊收银结算
下一页
分诊登记接口
Built with