医院接入文档 - Powered by MinDoc

1、CRM套餐同步至HIS

请求URL
https://api.mytijian.com/open-api/V2/ws/meal/syncmeal?accessToken=ACCESS_TOKEN
请求协议：HTTPS
请求方式：POST
需要签名: 否
URL参数:

参数名	是否必须	类型	说明
accessToken	是	string	当前有效的accessToken

POST参数示例

无

正确返回示例:

{
    "data":[
        {
            "myMealGender":0,
            "mediatorExamItemParams":[
                {
                    "gender":2,
                    "price":1500,
                    "name":"眼科检查2",
                    "description":"",
                    "discount":true,
                    "hisItemId":"000013",
                    "operationType":0,
                    "salePrice":1000,
                    "refundRefusedItem":false,
                    "refundNoExam":false,
                    "material":false,
                    "show":true,
                    "minAge":10,
                    "maxAge":30,
                },
                {
                    "gender":2,
                    "price":700,
                    "name":"眼科检查1",
                    "description":"",
                    "discount":true,
                    "hisItemId":"000012",
                    "operationType":0,
                    "salePrice":100,
                    "refundRefusedItem":false,
                    "refundNoExam":false,
                    "material":false,
                    "show":true,
                    "minAge":10,
                    "maxAge":30,
                },
                {
                    "gender":2,
                    "price":6800,
                    "name":"前列腺B超",
                    "description":"",
                    "discount":true,
                    "hisItemId":"000024",
                    "operationType":0,
                    "salePrice":6000,
                    "refundRefusedItem":false,
                    "refundNoExam":false,
                    "material":false,
                    "show":true,
                    "minAge":10,
                    "maxAge":30,
                }
            ],
            "hisName":"PM黄伟测试套餐",
            "mealId":451175,
            "originalPrice":9000,
            "createTime":1530633600000,
            "hospitalId":197,
            "discountPrice":9000,
            "discount":1,
            "updateTime":1530686759000,
            "status":0,
            "hospitalAreaIds":[1],
            "supportAllHospitalArea":false
        }
    ],
    "msg":"success",
    "success":"T"
}

返回参数说明:

参数名	类型	说明
success	String	T成功，F失败
msg	String	描述消息
errCode	String	错误码，只有失败的时候才有
data	List(SyncMealParam)	单位集合

SyncMealParam对象说明：

参数名	类型	说明
mealId	Integer	套餐ID
name	String	套餐名字
hisName	String	传到his的套餐名称
hisMealId	String	his回传的套餐ID
originalPrice	Integer	原价
discountPrice	Integer	折扣价
discount	Double	折扣
hospitalId	Integer	医院ID
companyId	Integer	单位ID
hisCompanyId	String	医院单位ID
status	Integer	同步状态：0-“未完成” 1-“已完成”
createTime	Date	创建时间
updateTime	Date	更新时间
myMealGender	Integer	套餐性别
mediatorExamItemParams	List（MediatorExamItemParam）	套餐单项集合
mealMultiChoosenList	List	多选一组List
hospitalAreaIds	list	套餐指定可用的多院区id集合
supportAllHospitalArea	boolean	true 全部院区可用，false 指定院区可用

MediatorExamItemParam对象说明

参数名	类型	说明
name	String	项目名称
hisItemId	String	项目Id
gender	String	性别 0:男,1:女,2:男女通用
price	Integer	价格
discount	boolean	是否可打折
description	String	描述
operationType	int	1-新增 2-删除 3-修改
salePrice	Integer	单项分摊后售价
refundRefusedItem	boolean	拒检项目是否退款 true:拒检退款 false：据检不退款
refundNoExam	boolean	未检是否退款, true: 退款， false 不退款
material	boolean	是否是耗材： true 是 false 不是
show	boolean	是否显示, true表示显示 false 不显示
minAge	Integer	使用最小年龄
maxAge	Integer	使用最大年龄

mealMultiChoosenList对象说明

参数名	类型	说明
mealId	int	套餐id
multiChoosenId	String	多选一组id
multiChoosenName	String	多选一组名称
ext	String	扩展字段
defaultSelectItemId	int	默认选中的单项id
hisMultiChoosenId	String	内网多选一组id

2、回写His套餐Code

https://api.mytijian.com/open-api/V2/ws/meal/writeBackMealCode?accessToken=ACCESS_TOKEN&nonce=NONCE&sign=SIGN
请求协议：HTTPS
请求方式：POST
需要签名: 是
URL参数:

参数名	是否必须	类型	说明
accessToken	是	string	当前有效的accessToken
nonce	是	string	当前有效的nonce
sign	是	string	数据sign值

POST参数示例

#Csa ---> 2022.3.24 主要这些数据即可。
  {
    "syncMealParams":[
        {
            "mealId":451175,
            "hisMealId":"hw000",
            "status":1
        },
        {
            "mealId":447025,
            "hisMealId":"hw001",
            "status":1
        }
    ]
}

========================================NoT-Start=================================================

请求参数说明：

参数名	是否必须	类型	说明
syncMealParams	是	List（SyncMealParam）	SyncMealParam集合

SyncMealParam参数说明

参数名	是否必须	类型	说明
mealId	是	Integer	套餐ID
name	否	String	套餐名字
hisName	否	String	传到his的套餐名称
hisMealId	是	String	his回传的套餐ID
originalPrice	否	Integer	原价
discountPrice	否	Integer	折扣价
discount	否	Double	折扣
hospitalId	否	Integer	医院ID
companyId	否	Integer	单位ID
hisCompanyId	否	String	医院单位ID
status	是	Integer	同步状态：0-“未完成” 1-“已完成”
createTime	否	Date	创建时间
updateTime	否	Date	更新时间
myMealGender	否	Integer	套餐性别
mediatorExamItemParams	否	List（MediatorExamItemParam）	套餐单项集合

MediatorExamItemParam对象说明

参数名	类型	说明
name	String	项目名称
hisItemId	String	项目Id
gender	String	性别 0:男,1:女,2:男女通用
price	Integer	价格
discount	boolean	是否可打折
description	String	描述
operationType	int	1-新增 2-删除 3-修改

========================================NoT-End=================================================
正确返回示例:

{
  "msg": "success",
  "success": "T"
}

返回参数说明:

参数名	类型	说明
success	String	T成功，F失败
errCode	String	错误码，只有失败的时候才有
msg	String	描述消息

3、his创建或修改套餐

https://api.mytijian.com/open-api/V2/ws/meal/hisCreateOrUpdateMeal?accessToken=ACCESS_TOKEN&nonce=NONCE&sign=SIGN
请求协议：HTTPS
请求方式：POST
需要签名: 是
URL参数:

参数名	是否必须	类型	说明
accessToken	是	string	当前有效的accessToken
nonce	是	string	当前有效的nonce
sign	是	string	数据sign值

POST参数示例

 {
    "ageLevelId": 0,
    "ageLevelValue": "全年龄段（不限年龄）",
    "allowChangeItem": true,
    "classify": 1,
    "disable": 1,
    "discount": 1,
    "gender": 0,
    "lockPrice": true,
    "marriageId": 0,
    "marriageValue": "通用",
    "mealItemList": [
        {
            "hisItemId": "000012",
            "name": "眼科检查1",
            "price": 700
        }
    ],
    "name": "his创建套餐0228",
    "price": 700,
    "type": 3,
    "vip_level": "vip",
    "vip_strategy": "order_price"
}

请求参数说明：

参数名	是否必须	类型	说明
mealId	否	int	平台套餐id，新增时为空，修改必须传
name	是	string	套餐名称
price	是	int	套餐价格
gender	是	int	性别，套餐在平台的性别0-男，1-女，2-不详
disable	是	int	套餐状态,0:正常,2:删除
type	是	int	套餐类型，1:单位套餐，3：通用套餐
allowChangeItem	是	boolean	允许改项
marriageId	是	int	婚姻状态id 0 通用 1 已婚
marriageValue	是	string	婚姻状态值
ageLevelId	是	int	0, “全年龄段（不限年龄）”, 1, “少年儿童（12岁及以下）”, 2, “青少年（12岁-20岁）”3,”青年（21岁-30岁）”4,”中青年（21岁-40岁）”5,”中年（31岁-50岁）”6,”中老年（41岁-60岁）”7,”老年（61岁及以上）”
ageLevelValue	是	string	年龄段值
classify	是	int	套餐分类套餐分类 1：健康体检、2：入职体检、3：公务员体检、4：驾驶员体检、5：专项体检、6：教师资格证体检、7：入学体检、8：贵宾体检、9：齿科体检
lockPrice	是	boolean	锁定价格
modifyTip	否	string	修改提示
mealWarnText	否	string	套餐警告文本
vip_strategy	是	string	vip策略 “order_price”,” meal”
vip_level	是	string	vip级别当策略为“order_price” vip级别只有vip。当策略级别为” meal” 级别参数如下“vip”,” honor_vip”,
ruleId	否	int	规则id
adjustPrice	否	int	调整价
enableSiteShow	否	boolean	站点能否展示
newCompanyId	否	int	单位id
onlyShowMealItem	否	boolean	是否只显示套餐内项目
mealItemList	是	List(HisExamItemParam)	套餐内项目
mealMultiChoosenList	List	多选一组List

HisExamItemParam对象说明

参数名	是否必须	类型	说明
hisItemId	是	string	单项his编码
name	是	string	单项名称
price	是	int	单项价格
mealId	否	int	平台套餐id，新增时不传
basic	否	boolean	单项是否必选：true必选、false 非比选
show	否	boolean	单项是否显示：true显示、false 不显示

mealMultiChoosenList对象说明

参数名	类型	说明
mealId	int	套餐id
multiChoosenId	String	多选一组id
multiChoosenName	String	多选一组名称
ext	String	扩展字段
ext	String	扩展字段
defaultSelectItemId	int	默认选中的单项id
hisMultiChoosenId	String	内网多选一组id

正确返回示例:

{
    "data": {
        "result": "484758"
    },
    "msg": "success",
    "success": "T"
}

返回参数说明:

参数名	类型	说明
success	String	T成功，F失败
errCode	String	错误码，只有失败的时候才有
msg	String	描述消息
data	int	平台套餐id

4、his获取套餐

https://api.mytijian.com/open-api/V2/ws/meal/getMealInfoById?accessToken=ACCESS_TOKEN&nonce=NONCE&sign=SIGN
请求协议：HTTPS
请求方式：POST
需要签名: 是
URL参数:

参数名	是否必须	类型	说明
accessToken	是	string	当前有效的accessToken
nonce	是	string	当前有效的nonce
sign	是	string	数据sign值

POST参数示例

 {
    "mealId": 1
}

请求参数说明：

参数名	是否必须	类型	说明
mealId	否	int	平台套餐id

正确返回示例:

{
    "data": {
        "classify": 1,
        "mealItemList": [
            {
                "mealId": 32953126,
                "price": 0,
                "name": "从业人员体检结论",
                "show": true,
                "hisItemId": "A5A5FBD3-5427-4BCC-A019-0489A9CFE04F",
                "basic": true
            }
        ],
        "lockPrice": true,
        "mealId": 32953126,
        "mealMultiChoosenList": [],
        "gender": 2,
        "allowChangeItem": true,
        "mealWarnText": "",
        "adjustPrice": 23650,
        "discount": 1.0,
        "type": 3,
        "vip_strategy": "order_price",
        "ageLevelId": 0,
        "disable": 0,
        "marriageId": 0,
        "modifyTip": "点击修改套餐",
        "price": 0,
        "ageLevelValue": "全年龄段（不限年龄）",
        "name": "D类(其他)健康体检",
        "enableSiteShow": false,
        "vip_level": "vip",
        "classifyName": "健康体检"
    },
    "msg": "success",
    "success": "T"
}

参数名	类型	说明
success	String	T成功，F失败
msg	String	描述消息
errCode	String	错误码，只有失败的时候才有
data	HisMealParam	套餐详情

参数说明：

参数名	是否必须	类型	说明
mealId	否	int	平台套餐id，新增时为空，修改必须传
name	是	string	套餐名称
discount	是	double	折扣
price	是	int	套餐价格
gender	是	int	性别，套餐在平台的性别0-男，1-女，2-不详
disable	是	int	套餐状态,0:正常,2:删除
type	是	int	套餐类型，1:单位套餐，3：通用套餐
allowChangeItem	是	boolean	允许改项
marriageId	是	int	婚姻状态id 0 通用 1 已婚
ageLevelId	是	int	0, “全年龄段（不限年龄）”, 1, “少年儿童（12岁及以下）”, 2, “青少年（12岁-20岁）”3,”青年（21岁-30岁）”4,”中青年（21岁-40岁）”5,”中年（31岁-50岁）”6,”中老年（41岁-60岁）”7,”老年（61岁及以上）”
ageLevelValue	是	string	年龄段值
classify	是	int	套餐分类套餐分类 1：健康体检、2：入职体检、3：公务员体检、4：驾驶员体检、5：专项体检、6：教师资格证体检、7：入学体检、8：贵宾体检、9：齿科体检
classifyName	否	string	分类名称
lockPrice	是	boolean	锁定价格
modifyTip	否	string	修改提示
mealWarnText	否	string	套餐警告文本
vip_strategy	是	string	vip策略 “order_price”,” meal”
vip_level	是	string	vip级别当策略为“order_price” vip级别只有vip。当策略级别为” meal” 级别参数如下“vip”,” honor_vip”,
adjustPrice	否	int	调整价
enableSiteShow	否	boolean	站点能否展示
newCompanyId	否	int	单位id
mealItemList	是	List(HisExamItemParam)	套餐内项目
mealMultiChoosenList	List	多选一组List

HisExamItemParam对象说明

参数名	是否必须	类型	说明
hisItemId	是	string	单项his编码
name	是	string	单项名称
price	是	int	单项价格
mealId	否	int	平台套餐id，新增时不传
basic	否	boolean	单项是否必选：true必选、false 非比选
show	否	boolean	单项是否显示：true显示、false 不显示

mealMultiChoosenList对象说明

参数名	类型	说明
mealId	int	套餐id
multiChoosenId	String	多选一组id
multiChoosenName	String	多选一组名称
ext	String	扩展字段
ext	String	扩展字段
defaultSelectItemId	int	默认选中的单项id
hisMultiChoosenId	String	内网多选一组id

文档更新时间: 2025-07-04 17:59

套餐同步服务

1、CRM套餐同步至HIS

POST参数示例

返回参数说明:

SyncMealParam对象说明：

MediatorExamItemParam对象说明

mealMultiChoosenList对象说明

2、回写His套餐Code

POST参数示例

请求参数说明：

SyncMealParam参数说明

MediatorExamItemParam对象说明

返回参数说明:

3、his创建或修改套餐

POST参数示例

请求参数说明：

HisExamItemParam对象说明

mealMultiChoosenList对象说明

返回参数说明:

4、his获取套餐

POST参数示例

请求参数说明：

参数说明：

HisExamItemParam对象说明

mealMultiChoosenList对象说明