- 接口变更记录
- 开发前准备
- 请求签名鉴权方式
- OAuth2.0鉴权方式
- 常见问题速查
- 接入
- 公共数据获取
- 系统管理接口
- 患者档案相关
- CRM
- 会员
- HIS
- 外加工
- 进销存
- OA审批
- 渠道管理
获取持有卡项项目
GET
/api/anon/openapi/vip/ecard/ecardItems
最后修改时间:2024-10-11 11:23:16
责任人:孙工
1.itemCategory与itemType的区别
itemCategory是表示该条卡项"项目"为哪一种类目,如,是项目还是优惠券等。(材料、药品几乎不会出现,他只在临时卡中)
itemType进一步区分,如项目类别=2时是收费项目,但是卡项存在固定项目、赠送项目等,此时就需要该字段区分。
对于次卡,限次品类类型。itemCount是0,没有项目id相关信息。
但是在每划扣一次,该字段则增加1,也就是和其他项目类别相反的。
请求参数
Query 参数
ecardID
integer
持有卡项id
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/ecard/ecardItems?ecardID' \
--header 'FRHis-Open-Timestamp: {% mock '\''timestamp'\'' %}' \
--header 'FRHis-Open-App-Id: {{appid}}' \
--header 'FRHis-Open-Token: {{token}}'
返回响应
🟢200成功
application/json
Body
errcode
integer
状态码
errmsg
string
信息
data
array [object {11}]
返回结果
unitPrice
integer
单价
itemID
integer
项目id
项目类别=1:药品id
项目类别=2:收费项目id
项目类别=3:材料id
项目类别=4:会员优惠券id
项目类别=5:会员卡项id
itemName
string
项目名称
itemType
integer
项目类型
1、固定项目
2、N选M项目
3、折扣项目
4、赠送项目
5、限次品类
serialNumber
integer
流水号
totalPrice
integer
项目金额
itemCategory
integer
项目类别
1:药品
2:收费项目
3:材料
4:优惠券
5:卡项。
discount
integer
享有折扣
categoryCode
string
品类编码
1.该字段有值
2.代表该项目为品类,项目相关字段可为空或是0
3.在划卡时,可以任意勾选该编码下的项目划扣
itemCount
integer
数量次数
availableCount
integer
必需
示例
{
"errcode": 0,
"errmsg": "操作成功",
"data": [
{
"unitPrice": 450,
"itemID": 10152,
"availableCount": 0,
"itemName": "奥普",
"itemType": 2,
"serialNumber": 10347,
"totalPrice": 450,
"itemCategory": 2,
"discount": 1,
"categoryCode": "zl20231057",
"itemCount": 1
},
{
"unitPrice": 450,
"itemID": 10154,
"availableCount": 1,
"itemName": "荔浦2000发",
"itemType": 2,
"serialNumber": 10348,
"totalPrice": 450,
"itemCategory": 2,
"discount": 1,
"categoryCode": "zl20231059",
"itemCount": 1
},
{
"unitPrice": 100,
"itemID": 9712,
"availableCount": 0,
"itemName": "测试",
"itemType": 1,
"serialNumber": 10349,
"totalPrice": 100,
"itemCategory": 2,
"discount": 1,
"categoryCode": "zl2023211",
"itemCount": 1
}
]
}