互联网医院外联平台接口文档

1金蝶医疗移动互联网医院外联平台接口文档金蝶医疗软件科技有限公司2015-09-162修改记录日期版本描述修改人2015-09-161.0草稿刘皓中341文档说明本接口文档是第三方服务提供商接入金蝶医疗移动互联网医院外联平台的开发文档。1)全部接口采取http协议以Post的方式将数据提交到指定url上进行交互，数据格式使用xml。2)如果示例报文中的参数与表格中声明的不一致，以表格中声明的为准，示例报文仅供开发时参考。3)本接口文档将院内使用的诊疗卡，健康卡等各种卡片统称为健康卡（healthCard）2接口定义请求xml格式：?xmlversion=”1.0”encoding=”UTF-8”?reqdeptId00011/deptId/reqReq里的具体内容见下面的请求参数，根据不同的服务而不同。响应xml格式：?xmlversion=”1.0”encoding=”UTF-8”resresultCode0/resultCoderesultDesc0/resultDesc/resRes里的具体内容见下面的响应参数，根据不同的服务而不同。2.1基础支持接口2.1.1获取token接口代码base.token说明可以使用channelCode以及secert来调用本接口获取调用其他接口时必须的token。本接口的调用方式为=base.token52.2公共信息接口接口调用方式示例：=getDeptInfo&token=xxxx&version=3.0&channelCode=001其中service的值为下面接口定义里的接口代码,区分大小写；token为调用接口时必须的全局唯一票据，可以通过调用2.1.1获取token接口来获取；version为接口版本号，固定取值3.0，channelCode为分配给第三方的渠道代码，可以在后台查看。2.2.1医院信息2.2.1.1获取医生信息接口接口代码hospital.getDoctorInfo说明通过调用该接口获取指定条件的医生信息。节点名称父节点名称数据类型必填说明请求参数reqhospitalIdreqString是医院代码deptIdreqString否科室代码doctorIdreqString否医生代码节点名称父节点名称数据类型必填说明响应参数resresultCoderesString是处理结果代码：0-成功resultDescresString否处理结果描述doctorInforesListdoctorInfo否医生信息的集合doctorIddoctorInfoString是医生IDdoctorNamedoctorInfoString是医生名称doctotLevelCodedoctorInfoString是医生职称代码doctorLeveldoctorInfoString是医生职称deptIddoctorInfoString是科室代码deptNamedoctorInfoString是科室名称imageUrldoctorInfoString否医生头像路径descriptiondoctorInfoString否医生简介实例：请求报文：?xmlversion=1.0encoding=UTF-8?reqhospitalId1001/hospitalIddeptId145/deptIddoctorId4509/doctorId/req返回报文：6?xmlversion=1.0encoding=UTF-8?resresultCode0/resultCoderesultDesc成功/resultDescdoctorInfodoctorId4509/doctorIddoctorName林勇/doctorNamedoctorTitle主治中医师/doctorTitledeptId0412/deptIddeptName眼科/deptNamedescription/description/doctorInfo/res2.2.2患者基本信息2.2.2.1门诊患者基本信息查询接口代码baseInfo.getOutpatientInfo说明可以通过本接口查询患者在院内登记的门诊个人基本信息。idCardNo、healthCardNo、patientId不能同时为空。节点名称父节点名称数据类型必填说明请求参数reqidCardNoreqString否身份证号码healthCardNoreqString否健康卡号码patientIdreqString否患者唯一IDpatientNamereqString否姓名phonereqString否手机号码节点名称父节点名称数据类型必填说明响应参数resresultCoderesString是处理结果代码：0-成功resultDescresString是处理结果描述patientIdresString是患者IDpatientNameresString是患者姓名genderresString是用户性别：M-男性F-女性healthCardNoresString是健康卡号码idCardNoresString否身份证birthdayresString否出生日期oppatNoresString否患者病历号phoneresString否联系电话medicareCardNoresString否医保卡号7实例：请求报文：?xmlversion=1.0encoding=UTF-8?reqhospitalId100201/hospitalIdidCardNo/idCardNopatentId/patientIdhealthCardNoM32456667/healthCardNo/req返回报文：?xmlversion=1.0encoding=UTF-8?resresultCode0/resultCoderesultDesc成功/resultDescpatientId23425/patientIdname张三/namegenderM/genderhealthCardNoM32456667/healthCardNoidCardNo421554112215123134154/idCardNobirthday/birthdayoppatNo321345/oppatNomedicareCardNo/medicareCardNophone18912345678/phone/res2.2.2.2住院患者信息查询接口baseInfo.getInpatientInfo说明通过本接口查询患者历次住院基本信息。节点名称父节点名称数据类型必填说明请求参数reqhealthCardNoreqString是健康卡号idCardNoreqString否身份证号码patientIdreqString否住院患者唯一IDinpatientIdreqString否住院号，患者每次住院都会生成的流水号节点名称父节点名称数据类型必填说明响应参数resresultCoderesString是处理结果代码：0-成功resultDescresString否处理结果描述recordInforesListrecordInfo否8patientIdrecordInfoString是住院患者唯一IDhospitalIdrecordInfoString是院区代码patientNamerecordInfoString是姓名inTimerecordInfoString是入院日期outTimerecordInfoString是出院日期(未出院，为空)inDaysrecordInfoString是住院天数patientFlagrecordInfoString是患者状态在院/预出院/结账/出院/清账totalAmoutrecordInfoString是总费用（单位分）prepayAmoutrecordInfoString是预交金额（单位分）balancerecordInfoString是预交金余额（单位分）settledrecordInfoString否已结算总额（单位分）inpatientIdrecordInfoString是住院号idCardNorecordInfoString否患者身份证件号码deptIdrecordInfoString是病区代码deptNamerecordInfoString是病区bedNorecordInfoString否床位chargeDoctorIdrecordInfoString是主管医生代码chargeDoctorNamerecordInfoString是主管医生姓名chargeNurseIdrecordInfoString是主管护士代码chargeNurseNamerecordInfoString是主管护士姓名genderrecordInfoString否性别（男、女）birthdayrecordInfoString否出生日期addressrecordInfoString否家庭地址connectPhonerecordInfoString否联系电话（患者电话）relatePersonrecordInfoString否联系人relationrecordInfoString否联系人关系（文字）relatePhonerecordInfoString否联系人电话remarkrecordInfoString否备注实例：请求报文：?xmlversion=1.0encoding=UTF-8?reqhealthCardNo1234567890123456/healthCardNoidCardNo/idCardNopatientId15442345/patientIdinpatientId/inpatientId/req返回报文：?xmlversion=1.0encoding=UTF-8?resresultCode0/resultCoderesultDesc成功/resultDesc9recordInfopatientId34555552/patientIdpatientName测试/patientNameinTime2014-12-01/inTimeoutTime/outTimepatientFlag在院/patientFlagtotalAmout153553/totalAmoutidCardNo/idCardNoprepayAmout10000/prepayAmoutintpatientId12345678/inpatientIddeptId412/deptIddeptNmae内科/deptNamebedNo14/bedNobalance500.00/balancesettled200/settledgender男/genderbirthday1990-12-01/birthdayaddress广州市体育西路153号天河大厦新写字楼9楼/addressconnectPhone13588888888/connectPhonerelatePerson李四/relatePersonrelation同事/relationrelatePhone13788888888/relatePhoneremarkremark/recordInfo