医院就诊卡接口规范（业务：031）

业务编号：031
业务说明：医保卡片信息保存
存储过程：无
作者：袁理
日期：2019-07-23

---

一、简要说明

  目前医院的医保患者数据来源主要有两个途径：1. HIS系统自身通过工作站点（门诊登记窗口、门诊收费窗口、入出院办理等）；2、来自客户端软件的医保卡与就诊卡的绑定。为了达到双方数据共用、资源共享的目的，特开发此接口业务，便于HIS系统与其他第三方系统中获取患者医保卡信息。

二、输入参数

<Request>
    <TradeCode>业务编号</TradeCode>
    <PatientId>患者病历编号</PatientId>
    <SiCardMode>医保卡模式（0清除，1本地，2异地）</SiCardMode>
    <SiCardMsg>医保卡片信息</SiCardMsg>
</Request>

三、输出参数

<Response>
    <TradeCode>业务编号</TradeCode>
    <Result>返回值：0 成功，其他失败</Result>
    <Err>错误描述信息</Err>
    <HospitalTransNO>本次交易流水</HospitalTransNO>
</Response>

四、接口图例：

接口输入输出图示

五、调用流程（参考）

调用流程参考图

六、其他说明

1. 患者必须先完成医院内部建档，方可以调用本业务。本业务是后台通过解析医保卡信息，将患者病历编号（PatientId）与医保卡的个人编号（AAC001，详见医保中心相差文档）进行的绑定，先后顺序不能有误，否则会引起接口返回错误；
2. 医保卡模式目前设置：0清除，1本地，2异地三种模式，SiCardMode参数必须在此范围之内，不能自行编码；其中，0清除相当于撤消之前的绑定医保卡内容，1和2分别绑定本地医保卡和异地医保卡。
3. 医保卡信息严格按照医保中心读卡的返回值传入，格式与之前的医保卡类别（SiCardMode）有严格的对应关系。其中本地医保卡信息以字符“|”进行分割，异地医保卡信息以标准XML格式传输。