医院接入文档 - Powered by MinDoc

1、CRM单位同步至HIS

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

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

POST参数示例

无

正确返回示例:

{   "msg":"success",
    "success":"T",
    "data":[
        {
            "creator":"MYTIJIAN",
            "hisCompanyStatus":"WAITTINGADD",
            "hospitalId":197,
            "hisCompanyName":"测试0308",
            "busiType":1,
            "id":93187,
            "myCompanyId":4408867,
            "companyHomepageShotLink":"xxxxx",
            "supportAllHospitalArea":false,
             "hospitalAreaIds":[1,2],
            "managerExamCompanyRelations":[
              {"contactName": "testName",
              "contactTel": "15100004865"}
            ]
        },
        {
            "creator":"MYTIJIAN",
            "hisCompanyStatus":"WAITTINGADD",
            "hospitalId":197,
            "hisCompanyName":"测试单位100",
            "busiType":1,
            "id":93188,
            "myCompanyId":4408868,
            "companyHomepageShotLink":"xxxxx",
            "supportAllHospitalArea":false,
             "hospitalAreaIds":[1,2]
        },
        {
            "creator":"MYTIJIAN",
            "hisCompanyStatus":"WAITTINGADD",
            "hospitalId":197,
            "hisCompanyName":"sqy1000",
            "busiType":1,
            "id":93220,
            "myCompanyId":4409028,
            "companyHomepageShotLink":"xxxxx",
            "supportAllHospitalArea":false,
             "hospitalAreaIds":[1,2]
        }
    ]
}

返回参数说明:

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

HisCompanyParam参数说明：

参数名	类型	说明
id	Integer	主键
myCompanyId	String	平台单位id
hisCompanyCode	String	his单位code
hisCompanyName	String	医院单位名称
hisCompanyStatus	String	单位同步状态
hospitalId	Integer	医院ID
creator	String	创建者
companyHomepageShotLink	String	单位主页短连接地址
busiType	Integer	业务类型:1.普通健康体检, 2.普通职业病体检, 3.放射性职业病体检
supportAllHospitalArea	boolean	是否支持所有院区：true 全部院区，false 指定院区。当为false的时候需要传指定院区id集合
hospitalAreaIds	array	指定院区id
managerExamCompanyRelations	List(HisManagerExamCompanyRelationParam)	单位关联管理员信息

HisManagerExamCompanyRelationParam参数说明：

参数名	类型	说明
contactName	String	联系人
contactTel	String	联系方式

2、回写HIS单位Code

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

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

POST参数示例

{
    "id":93220,
    "hisCompanyCode":"hwcs001",
    "isSuccess":true
}

请求参数说明：

参数名	是否必须	类型	说明
id	是	Integer	CRM同步至HIS时传入的ID
hisCompanyCode	是	string	医院单位唯一标识code
isSuccess	是	boolean	是否成功

正确返回示例:

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

返回参数说明:

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

3、同步HIS所有单位至CRM

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

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

POST参数示例

{
    "hisCompanyParams":[
        {
            "hisCompanyCode":"hwcs110",
            "hisCompanyName":"黄伟测试110",
            "creator":"HIS",
            "supportAllHospitalArea":false,
             "hospitalAreaIds":[1,2]
        },
        {
            "hisCompanyCode":"hwcs111",
            "hisCompanyName":"黄伟测试111",
            "creator":"HIS",
            "supportAllHospitalArea":false,
             "hospitalAreaIds":[1,2]
        }
    ],
    "isLastPage":false
}

请求参数说明：

参数名	是否必须	类型	说明
hisCompanyParams	是	List(HisCompanyParam)	医院单位对象集合
isLastPage	是	boolean	是否为最后一页

HisCompanyParam参数说明：

参数名	是否必须	类型	说明
id	否	Integer	主键
myCompanyId	否	String	平台单位id
hisCompanyCode	是	String	医院单位code
hisCompanyName	是	String	医院单位名称
hisCompanyStatus	否	String	单位同步状态
hospitalId	否	Integer	医院ID
creator	是	String	创建者（HIS）
supportAllHospitalArea	boolean	是否支持所有院区：true 全部院区，false 指定院区。当为false的时候需要传指定院区id集合
hospitalAreaIds	array	指定院区id

正确返回示例:

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

返回参数说明:

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

4、his创建或者修改单位

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

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

POST参数示例

{
    "hisCompanyCode": "123321",
    "hisCompanyName": "his测试单位",
    "myCompanyId": 4416542,
    "operateType":2,
    "supportAllHospitalArea":false,
             "hospitalAreaIds":[1,2]
}

请求参数说明：

参数名	是否必须	类型	说明
hisCompanyCode	是	String	his单位编码
hisCompanyName	是	String	his单位名称
myCompanyId	否	int	平台单位id（新建不传，修改传）
operateType	是	int	操作类型1：新增，2：修改，3：删除
busiType	否	int	业务类型:1.普通健康体检, 2.普通职业病体检, 3.放射性职业病体检
supportAllHospitalArea	否	boolean	是否支持所有院区：true 全部院区，false 指定院区。当为false的时候需要传指定院区id集合
hospitalAreaIds	否	array	指定院区id
managerExamCompanyRelations	否	List(HisManagerExamCompanyRelationParam)	单位关联管理员信息

HisManagerExamCompanyRelationParam参数说明：

参数名	类型	说明
contactName	String	联系人
contactTel	String	联系方式

正确返回示例:

{
    "data": {
        "hisCompanyCode": "123321",
        "hisCompanyName": "his测试单位",
        "myCompanyId": 4416542,
        "operateType":2,
        "companyHomepageShotLink": "http://url.mytijian.cn/UxW",
        "managerExamCompanyRelations":[
          {"contactName": "联系人姓名",
          "contactTel": "15100004865"}
        ]
    },
    "msg": "success",
    "success": "T"
}

返回参数说明:

参数名	类型	说明
success	String	T成功，F失败
errCode	String	错误码，只有失败的时候才有
msg	String	描述消息
data	HisCompanyParam	返回单位参数对象

HisCompanyParam参数说明：

参数名	类型	说明
myCompanyId	int	平台单位id
hisCompanyCode	String	his单位code
hisCompanyName	String	his单位名称
operateType	int	操作类型1：新增，2：修改，3：删除
companyHomepageShotLink	String	单位主页短连接地址

5、绑定单位客户经理关系

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

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

POST参数示例

{
    "userName":"197_9999",
    "companyId":4418157
}

请求参数说明：

参数名	是否必须	类型	说明
userName	是	String	用户名
companyId	否	int	平台单位id,如果不传则绑定体检中心所有单位（除散客单位）

正确返回示例:

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

返回参数说明:

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

5、删除crm单位

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

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

POST参数示例

{"hisCompanyCode": "12332112","myCompanyId":"4452307"}

请求参数说明：

参数名	是否必须	类型	说明
hisCompanyCode	是	String	his单位code
myCompanyId	是	int	平台单位id

正确返回示例:

{
    "data": null,
    "errCode": null,
    "msg": "success",
    "success": "T"
}

返回参数说明:

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

6、查询内网单位关联的crm医院单位

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

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

POST参数示例

{"myCompanyId":4590370,"hisCompanyCode": "15433"}

请求参数说明：

参数名	是否必须	类型	说明
myCompanyId	否	int	平台单位id
hisCompanyCode	否	String	his单位code

正确返回示例:

{
    "data": [
        {
            "hisCompanyCode": "15433",
            "hospitalId": 9220,
            "hisCompanyName": "7313meng-1",
            "myCompanyId": 4590370
        }
    ],
    "msg": "success",
    "success": "T"
}

返回参数说明:

参数名	类型	说明
success	String	T成功，F失败
errCode	String	错误码，只有失败的时候才有
msg	String	描述消息
hisCompanyCode	String	his单位code
hospitalId	int	医院ID
hisCompanyName	String	his单位名称
myCompanyId	int	平台单位id

7、查询crm医院更新的单位

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

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

POST参数示例

{}

请求参数说明：

参数名	是否必须	类型	说明

返回参数说明:

参考接口 1、CRM单位同步至HIS

文档更新时间: 2025-12-25 15:20

单位同步服务

1、CRM单位同步至HIS

POST参数示例

返回参数说明:

HisCompanyParam参数说明：

HisManagerExamCompanyRelationParam参数说明：

2、回写HIS单位Code

POST参数示例

请求参数说明：

返回参数说明:

3、同步HIS所有单位至CRM

POST参数示例

请求参数说明：

HisCompanyParam参数说明：

返回参数说明:

4、his创建或者修改单位

POST参数示例

请求参数说明：

HisManagerExamCompanyRelationParam参数说明：

返回参数说明:

HisCompanyParam参数说明：

5、绑定单位客户经理关系

POST参数示例

请求参数说明：

返回参数说明:

5、删除crm单位

POST参数示例

请求参数说明：

返回参数说明:

6、查询内网单位关联的crm医院单位

POST参数示例

请求参数说明：

返回参数说明:

7、查询crm医院更新的单位

POST参数示例

请求参数说明：

返回参数说明: