1、获取体检中心在CRM中的所有单项
请求URL
https://api.mytijian.com/open-api/V2/ws/examitem/allitem?accessToken=ACCESS_TOKEN
请求协议:HTTPS
请求方式:POST
需要签名: 否
URL参数:
| 参数名 |
是否必须 |
类型 |
说明 |
| accessToken |
是 |
string |
当前有效的accessToken |
POST参数示例
无
正确返回示例:
{ "msg":"success", "success":"T", "data":[ { "gender":2, "price":12300, "name":"身高、体重", "description":"", "discount":true, "hisItemId":"000001", "operationType":0, "itemType":1, "supportAllHospitalArea":false, "hospitalAreaIds":[1,2] }, { "gender":2, "price":23400, "name":"血压", "description":"", "discount":true, "hisItemId":"000004", "operationType":0, "itemType":1, "supportAllHospitalArea":false, "hospitalAreaIds":[1,2] }, { "gender":2, "price":11100, "name":"内科检查", "description":"", "discount":true, "hisItemId":"000005", "operationType":0, "itemType":1, "supportAllHospitalArea":false, "hospitalAreaIds":[1,2] } ] }
返回参数说明:
| 参数名 |
类型 |
说明 |
| success |
String |
T成功,F失败 |
| msg |
String |
描述消息 |
| errCode |
String |
错误码,只有失败的时候才有 |
| data |
List(MediatorExamItemParam) |
单项集合 |
| 参数名 |
类型 |
说明 |
| name |
String |
项目名称 |
| hisItemId |
String |
项目Id |
| gender |
String |
性别 0:男,1:女,2:男女通用 |
| price |
Integer |
价格 |
| discount |
boolean |
是否可打折 |
| description |
String |
描述 |
| operationType |
int |
1-新增 2-删除 3-修改 |
| salePrice |
int |
单项分摊后售价 —-Add 2022.3.24 |
| itemType |
int |
1-体检中心项目 6-废除项目 |
| supportAllHospitalArea |
boolean |
是否支持所有院区:true 全部 院区,false 指定院区。当为false的时候需要传指定院区id集合 |
| hospitalAreaIds |
array |
指定院区id |
2、同步体检中心修改过的单项
请求URL
https://api.mytijian.com/open-api/V2/ws/examitem/changeitem?accessToken=ACCESS_TOKEN&nonce=NONCE&sign=SIGN
请求协议:HTTPS
请求方式:POST
需要签名: 是
URL参数:
| 参数名 |
是否必须 |
类型 |
说明 |
| accessToken |
是 |
string |
当前有效的accessToken |
| nonce |
是 |
string |
当前有效的nonce |
| sign |
是 |
string |
数据sign值 |
POST参数示例
{ "hisItemList":[ { "name":"身高、体重", "hisItemId":"000001", "price":11100, "operationType":3, "supportAllHospitalArea":false, "hospitalAreaIds":[1,2] } ]}
修改时候只能改变如下属性:
姓名、价格、拼音、拒检项目是否退款、未检是否退款。
新增属性说明如下:
名字、内网单项id、性别、价格、折扣、描述、操作类型、拒检项目是否退款、未检是否退款
请求参数说明:
| 参数名 |
是否必须 |
类型 |
说明 |
| hisItemList |
是 |
List(MediatorExamItemParam) |
单项集合 |
| 参数名 |
是否必须 |
类型 |
说明 |
| name |
是 |
String |
项目名称 |
| hisItemId |
是 |
String |
项目Id |
| gender |
否 |
String |
性别 0:男,1:女,2:男女通用 |
| price |
是 |
Integer |
价格 |
| discount |
否 |
boolean |
是否可打折 |
| description |
否 |
String |
描述 |
| operationType |
是 |
int |
1-新增 2-删除 3-修改 |
| refundRefusedItem |
否 |
Boolean |
拒检项目是否退款 true:拒检退款 false:据检不退款 |
| refundNoExam |
否 |
Boolean |
未检是否退款, true: 退款, false 不退款 |
| supportAllHospitalArea |
boolean |
是否支持所有院区:true 全部 院区,false 指定院区。当为false的时候需要传指定院区id集合 |
| hospitalAreaIds |
array |
指定院区id |
正确返回示例:
{ "msg": "success", "success": "T"}
返回参数说明:
| 参数名 |
类型 |
说明 |
| success |
String |
T成功,F失败 |
| errCode |
String |
错误码,只有失败的时候才有 |
| msg |
String |
描述消息 |
3、体检项目转耗材项
请求URL
https://api.mytijian.com/open-api/V2/ws/examitem/examItem2Material?accessToken=ACCESS_TOKEN&nonce=NONCE&sign=SIGN
请求协议:HTTPS
请求方式:POST
需要签名: 是
URL参数:
| 参数名 |
是否必须 |
类型 |
说明 |
| accessToken |
是 |
string |
当前有效的accessToken |
| nonce |
是 |
string |
当前有效的nonce |
| sign |
是 |
string |
数据sign值 |
POST参数示例
{ "hisItemIds":["000049"]}
请求参数说明:
| 参数名 |
是否必须 |
类型 |
说明 |
| hisItemIds |
是 |
List |
内网单项id集合 |
正确返回示例:
{ "data": [ { "result": "单项内网编码为:000049单项名称为:胸部正侧位片(DR)存在项目关系,无法转换为耗材项目", "code": -1, "hisItemId": "000049" } ], "msg": "success", "success": "T"}
返回参数说明:
| 参数名 |
类型 |
说明 |
| success |
String |
T成功,F失败 |
| errCode |
String |
错误码,只有失败的时候才有 |
| msg |
String |
描述消息 |
data数据结构
| 参数名 |
类型 |
说明 |
| result |
String |
结果 |
| code |
Integer |
编码:1.转换成功 -1失败 |
| hisItemId |
String |
内网单项id |
4、耗材项转体检项目
请求URL
https://api.mytijian.com/open-api/V2/ws/examitem/material2ExamItem?accessToken=ACCESS_TOKEN&nonce=NONCE&sign=SIGN
请求协议:HTTPS
请求方式:POST
需要签名: 是
URL参数:
| 参数名 |
是否必须 |
类型 |
说明 |
| accessToken |
是 |
string |
当前有效的accessToken |
| nonce |
是 |
string |
当前有效的nonce |
| sign |
是 |
string |
数据sign值 |
POST参数示例
{ "hisItemIds":["000049"]}
请求参数说明:
| 参数名 |
是否必须 |
类型 |
说明 |
| hisItemIds |
是 |
List |
内网单项id集合 |
正确返回示例:
{ "data": [ { "result": "单项内网编码为:000049单项名称为:胸部正侧位片(DR)存在项目关系,无法转换为耗材项目", "code": -1, "hisItemId": "000049" } ], "msg": "success", "success": "T"}
返回参数说明:
| 参数名 |
类型 |
说明 |
| success |
String |
T成功,F失败 |
| errCode |
String |
错误码,只有失败的时候才有 |
| msg |
String |
描述消息 |
data数据结构
| 参数名 |
类型 |
说明 |
| result |
String |
结果 |
| code |
Integer |
编码:1.转换成功 -1失败 |
| hisItemId |
String |
内网单项id |
文档更新时间: 2025-07-04 17:59