自助综合服务系统接口方案(按需缴费).doc

自助综合服务系统接口方案 长沙. 2012.6 V1.0 版本日期 2012年6月3日 创 建 者 长城医疗 创建日期 2011年9月25日 版本修订历史 版本号 变更时间 变更内容 拟稿人 审批人 目 录 1 服务测试 4 2 办卡 5 2.1 建卡病人身份校验 5 2.2建诊疗卡 6 3卡信息查询 8 4卡预交金充值 9 5 挂号 11 5.1可挂科室查询 11 5.2医生号查询 12 5.3挂号 14 6 缴费 17 6.1查询缴费项 17 6.2缴费 19 7 预约挂号 20 7.1 有卡预约病人可取号列表 20 7.2有卡预约病人取号 22 8 打印门诊费用清单 24 9 预交金对账 27 10 验证密码 28 11 预交金账户变更明细查询 29 1 服务测试 接口说明：服务测试 接口地址 接口方法 NetTest 接口描述 测试Web服务是否连接正常 接口协议 Web Service+XML 主要使用者 自动发卡机系统 输入消息说明 示例 以Request为根节点的XML串.子节点定义详见下方的说明. Request UserId/ UserId /Request 应答消息： 应答消息说明 示例 以Response 为根节点的XML串. 子节点: Result, ErrorMsg 如返回错误值，需要重新请求，3次为上限 Response ResultCode/ ResultCode ErrorMsg/ErrorMsg/Response 名称 说明 数据类型 标签名 长度（字节） Result 交易结果： 0：成功 1：错误 ResultCode ErrorMsg 错误信息描述 ErrorMsg 2 办卡 2.1 建卡病人身份校验 接口说明：对身份证是否存在有效的卡进行校验 接口地址 接口方法 IDCardCheck 接口描述 对身份证是否存在有效卡进行校验 接口协议 Web Service+XML 主要使用者 自动发卡机系统 说明 示例 以Request为根节点的XML串.子节点定义详见下方的说明. Request IDCardNo/IDCardNo /Request 身份证号 String IDCardNo 应答消息： 说明 示例 以Response 为根节点的XML串. 子节点: Result 如返回错误值，需要重新请求，3次为上限 Response ResultCode / ResultCode Status/Status /Response 名称 说明 数据类型 标签名 长度（字节） Result 交易结果： 0:成功 1:失败 Int ResultCode 状态 0：可以现金办卡 1:该身份证在银行申请过绑定卡 2：该身份证已建诊疗卡 Status 2.2建诊疗卡 接口说明：向HIS发送病人建卡信息 接口定义： 接口地址 接口方法 CreateCardPatInfo 接口描述 将建卡信息插入到HIS数据库 接口协议 Web Service+XML 主要使用者 自动发卡机系统 请求消息： 说明 示例 以Response为根节点的XML串.子节点定义详见下方的说明. Request CardNo/CardNo PatientName/PatientName Sex/Sex Birthday/Birthday Age/Age IDCardNo/IDCardNo SecrityNo/SecrityNo CardSerNo/CardSerNo Amt/Amt Address/Address Tel/Tel UserId/UserId ActDate/ActDate ActTime/ActTime PassWord/ PassWord /Request 名称 说明 数据类型 标签名 长度 卡号 String CardNo 16 病人姓名 String PatientName 性别 String Sex 出生日期 YYYY-MM-DD Date Birthday 年龄 String Age 身份证号 String IDCardNo 卡校验码 String SecrityNo 10 卡序列号 String CardSerNo 32 联系地址 String Address 联系电话 String Tel 预交金 Number Amt 操作员 String