会员充值 - 方软OpenApi-机构版

请求参数

Query 参数

accType

integer

必需

账户类型。3、基本账户，4、赠送账户，5、定金账户。

Header 参数

FRHis-Open-Timestamp

string

必需

示例值:

{% mock 'timestamp' %}

FRHis-Open-App-Id

string

必需

示例值:

FRHis-Open-Token

string

必需

示例值:

Body 参数application/json

patientID

integer

患者id

必需

amount

integer

充值金额

必需

充值金额传正数、退款退充值金额传负数

deptID

integer

预交款核算科室

必需

可不传。如果医院预交款需要按科室核算才需要传入

salesID

string

业绩核算人员

必需

如果不传则默认核算为本次上门咨询师

payMethodList

array[object (支付方式、付款方式BO) {4}]

支付方式列表

必需

患者充值付款方式。充值赠送账户可以不传付款方式，充值基本账户或定金账户付款方式只能是现金、银行卡等实收类型，不支持用赠券、积分，欠款充值预交金

contractCorpID

integer

合约机构id

可选

主要用于欠款、应收账款。三方挂账。合约机构id。合约单位、三方平台

payMethod

string

支付方式编号

必需

对应字典支付方式编号

payAmount

number

支付金额

必需

相应支付方式付款金额

setlRefCode

string

结算号码

必需

结算参考码、支付凭证码。支付类别为优惠券时传优惠券编码，支付类别为储值卡时传储值卡卡号、如果是三方平台欠款也可用于存核销码

memo

string

备注说明

必需

operatorID

integer

操作员id

必需

操作员id、收费员id

示例

{
    "patientID": 0,
    "amount": 0,
    "deptID": 0,
    "salesID": "string",
    "payMethodList": [
        {
            "contractCorpID": 0,
            "payMethod": "string",
            "payAmount": 0,
            "setlRefCode": "string"
        }
    ],
    "memo": "string",
    "operatorID": 0
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/api/anon/openapi/vip/recharge?accType' \
--header 'FRHis-Open-Timestamp: {% mock '\''timestamp'\'' %}' \
--header 'FRHis-Open-App-Id: {{appid}}' \
--header 'FRHis-Open-Token: {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "patientID": 0,
    "amount": 0,
    "deptID": 0,
    "salesID": "string",
    "payMethodList": [
        {
            "contractCorpID": 0,
            "payMethod": "string",
            "payAmount": 0,
            "setlRefCode": "string"
        }
    ],
    "memo": "string",
    "operatorID": 0
}'

返回响应

🟢200成功

application/json

Body

errcode

integer

状态码

必需

0正常 1失败

errmsg

string

信息

必需

data

object (会员账户信息VIPAccountVO)

返回结果

必需

会员账户信息

patientID

integer

患者ID

必需

account

number

会员账户余额

必需

会员账户余额、基本账户余额

deposit

number

定金余额

必需

giftAmount

number

赠送金额

必需

赠送金额账户。不同于赠券和优惠券一般有时效性，赠送金额账户余额永久有效

point

number

积分

必需

debtAmount

number

欠款金额

必需

患者欠款，尚未还款的金额

示例

{
    "errcode": 0,
    "errmsg": "string",
    "data": {
        "patientID": 0,
        "account": 0,
        "deposit": 0,
        "giftAmount": 0,
        "point": 0,
        "debtAmount": 0
    }
}