医院 HIS 系统与新农合系统做接口说明接口地址：111.75.188.199 医院接口测试端口：123452、接口用户名：360xxxxxxxxx 密 码：123321授权码：534245接口协议1 接口方式通讯方式：采用 TCP 的 Socket 通讯、短连接同步方式。农合作为服务端，医院作为客户端。报文格式：由农合系统返回的 XML 数据一律采用 GB2312 编码方式；由医院系统发送的XML 数据也一律采用 GB2312 编码方式。在 XML 实例中出现的注释项在双方传送中无需给出。2 接口报文2.1 XML 报文公共部分说明2.1.1 公共请求部分（request ）Xml 名称 名称 类型长度 说明 输入项msgid 消息代码 varchar(4) 必须username 用户名 varchar(20) 必须userpwd 密码 varchar(32) BASE64（MD5（密码时间戳） ） 必须code 授权码 varchar(32) BASE64（MD5（授权码时间戳） ） 必须timestamp 时间戳 varchar(10) MMddhhmmss 必须例：密码：123456 时间戳：0608122241 加密后字符：IcQg1PZAtTGZ1RFttXHTpg=2.1.2 公共应答部分（response）Xml 名称 名称 类型长度 说明 输入项msgid 消息代码 varchar(4) 必须returncode 返回码 varchar(4) 1 成功 0 失败 必须returnmsg 返回消息 varchar(100)2.2 XML 报文消息说明2.2.1 根据农合证号获取家庭信息请求部分（request）Xml 名称 名称 类型长度 说明 输入项cardsn 农合证号 varchar(16) 必须应答部分（response）Xml 名称 名称 类型长度 说明 输入项name 姓名 varchar(20) 必须pid 人员编码 varchar(32) 必须请求实例：应答实例：2.2.2 根据人员编码获取人员信息请求部分（request）Xml 名称 名称 类型长度 说明 输入项pid 人员编码 varchar(32) 必须应答部分（response）Xml 名称 名称 类型长度 说明 输入项accmoney 帐户余额 varchar(20) 必须address 地址 varchar(32) 必须age 年龄 varchar(3) 必须climoney 门诊补偿金额varchar(20) 必须extmoney 大病补偿金额varchar(20) 必须hspmoney 住院补偿金额varchar(20) 必须name 姓名 varchar(20) 必须pid 人员编码 varchar(32) 必须sex 性别 varchar(1) 必须请求实例：应答实例：2.2.3 门诊预算请求部分（request）Xml 名称 名称 类型长度 说明 输入项pid 人员编码 varchar(32) 必须date 就诊时间 varchar(8) yyyyMMdd 必须diagnosis 诊断编码 varchar(20) 必须doctor 经治医生 varchar(20) 非必须account 使用家庭帐户varchar(1) 1 使用 2 不使用 必须id 收费项目编码varchar(20) 必须amount 收费项目数量varchar(20) 必须price 收费项目单价varchar(20) 必须content 收费项目描述varchar(100) 名称单位规格剂型 必须应答部分（response）Xml 名称 名称 类型长度 说明 输入项start 起付线 varchar(20) 必须rate 补偿比例 varchar(20) 必须totle 总费用 varchar(20) 必须treatment 治疗费 varchar(20) 必须examination 检查费 varchar(20) 必须wmedicine 西药费 varchar(20) 必须cmedicine 中药费 varchar(20) 必须other 其他费用 varchar(20) 必须canmedmoney 可报药费 varchar(20) 必须cancuremoney 可报医疗费 varchar(20) 必须commoney 统筹补偿金额varchar(20) 必须accountmoney 家庭帐户补偿金额varchar(20) 必须id 收费项目编码varchar(20) 必须status 操作结果 varchar(4) 1 成功 0 失败 必须msg 操作消息 varchar(100)请求实例：yyyymmdd应答实例：2.2.4 门诊补偿请求部分（request）Xml 名称 名称 类型长度 说明 输入项pid 人员编码 varchar(32) 必须date 就诊时间 varchar(8) yyyyMMdd 必须diagnosis 诊断编码 varchar(20) 必须doctor 经治医生 varchar(20) 非必须account 使用家庭帐户varchar(1) 1 使用 2 不使用 必须id 收费项目编码varchar(20) 必须amount 收费项目数量varchar(20) 必须price 收费项目单价varchar(20) 必须content 收费项目描述varchar(100) 名称单位规格剂型 必须应答部分（response）Xml 名称 名称 类型长度 说明 输入项comid 补偿编号 varchar(32) 必须start 起付线 varchar(20) 必须rate 补偿比例 varchar(20) 必须totle 总费用 varchar(20) 必须treatment 治疗费 varchar(20) 必须examination 检查费 varchar(20) 必须wmedicine 西药费 varchar(20) 必须cmedicine 中药费 varchar(20) 必须other 其他费用 varchar(20) 必须canmedmoney 可报药费 varchar(20) 必须cancuremoney 可报医疗费 varchar(20) 必须commoney 统筹补偿金额varchar(20) 必须accountmoney 家庭帐户补偿金额varchar(20) 必须id 收费项目编码varchar(20) 必须status 操作结果 varchar(4) 1 成功 0 失败 必须msg 操作消息 varchar(100)请求实例：yyyymmdd应答实例：如果需要在上传的明细中传入冲退的明细(即负数的数量),必须保证在传入该冲退明细之前有对应的正数的收费明细,且数量必须大于或等于冲退的数量.2.2.5 门诊作废请求部分（request）Xml 名称 名称 类型长度 说明 输入项comid 补偿编号 varchar(32) 必须请求实例：123应答实例：2.2.6 入院登记请求部分（request）Xml 名称 名称 类型长度 说明 输入项pid 人员编码 varchar(32) 必须date 就诊时间 varchar(8) yyyyMMdd 必须diagnosis 诊断编码 varchar(20) 必须hspsn 住院登记号 varchar(20)doctor 经治医生 varchar(20) 非必须accidentharm 意外伤害 varchar(1) 1 是 2 否 必须notreferral 未办转院 varchar(1) 1 是 2 否 必须outcheck 外出检查 varchar(1) 1 是 2 否 必须instat 入院状态 varchar(1) 1 危急重 3 一般病人 8 手术 必须应答部分（response）Xml 名称 名称 类型长度 说明 输入项comid 登记编号 varchar(32) 必须请求实例：yyyymmdd3应答实例：