新疆医保支付接口规范(3)

新疆(喀什)医保支付接口应用编程接口规范

参数名称 astr_jybh 参数含义 交易编号 参数类型 参数类别 String 入口参数 具体的交易代码见〖交易列表，为空时查询所有不确定交易〗 astr_jgxml 交易输出 astr_jgxml格式: 交易流水号 交易编号 aint_appcode 交易标志 long 出口参数 大于等于0时交易成功，其他均为失败。此值数据类型是整数，范围为-2147483648 to +2147483647 astr_appmsg 交易信息 String 出口参数 错误信息描述。aint_appcode小于0时存放错误描述，其他不用关心该参数内容。 ? 函数说明：

交易辅助函数，完成不确定交易的查询处理。

对于处理类交易，HIS调用接口成功后未进行确认/取消（或调用确认/取消失败），及时调用本函数查询未确认或取消的交易数据，并进行HIS数据查询，判断并调用确认或取消方法完成数据校对。 ? 接口调用示例：

参看yh_interface_call调用说明。

String 出口参数 第 11 页 共 88 页

新疆(喀什)医保支付接口应用编程接口规范

§1.4. 交易类型和调用流程

1、 查询类交易：包括一般查询交易和接口内部完成确认、取消的交易；

2、 处理类交易：包括门诊结算（回退）、入院办理（回退）、住院结算（回退）和清算（回

退）等交易，一次完整的处理类交易可以有三种方式：

1） 只有处理流程，符合情况是处理流程执行失败（接口返回错误代码及信息）； 2） 处理流程＋确认流程，符合情况是处理流程执行成功，his处理也成功，调用确认

流程；

3） 处理流程＋取消流程，符合情况是处理流程执行成功，his处理失败，调用取消流

程。

调用交易的处理流程yh_interface_call1、处理流程处理完毕调用处理流程是否成功6、调用失败交易失败2、调用成功HIS进行处理3、HIS处理完毕HIS处理是否成功4、处理失败调用交易的取消流程yh_interface_cancel5、处理成功调用交易的确认流程yh_interface_confirm交易成功 图1-1 处理类交易调用流程

第 12 页 共 88 页

新疆(喀什)医保支付接口应用编程接口规范

在HIS进行处理环节，应该保存返回的交易流水号和验证码，建议HIS增加一张表存放交易流水号和验证码（后面的叙述中该表名称为交易记录表），并且保存的过程在HIS处理的事物内。

§1.5. 处理交易的不同宕机点和相应的处理

1、 处理流程处理完毕 2、 调用成功 3、 HIS处理完毕 4、 处理失败 5、 处理成功

在上面5个点系统宕机，系统重新启动后，都没有办法直接决定调用【取消流程】还是【确认流程】；对于这种情况，应该查询出没有调用【取消流程】或【确认流程】的不确定交易，再根据这些交易出的相关信息，查询HIS系统的交易记录表情况，如果该表存在该交易流水号的信息，则调用【确认流程】,如果该表不存在该交易流水号的信息，则调用【取消流程】。

查询中心的不确定交易yh_interface_getuncertaintytrade根据HIS系统情况HIS系统原处理失败调用交易的取消流程yh_interface_cancelHIS系统原处理成功调用交易的确认流程yh_interface_confirm 第 13 页 共 88 页

新疆(喀什)医保支付接口应用编程接口规范

§1.6.

序号 交易代码 1. 02 2. 03 3. 03a 4. 04 5. 51 6. 21 7. 22 8. 23 9. 25 10. 26 11. 28a 12. 31 13. 32 14. 45 15. 41 16. 43 17. 48 18. 42 19. 44 20. 59 21. 46 22. 71 23. 72 24. 73 25. 74 26. 91 27. 57 28. 58 29. 52 30. 53 31. 54 32. 55 35 36 37 38 39 56 33 60 28b 28c 交易列表

交易名称 修改密码 身份识别 查询个人累计情况 获取医院信息 待遇审批 入院办理 入院办理回退 入院办理信息修改 出院办理 出院办理回退 入出院信息查询 费用明细写入 费用明细退单 费用明细分割信息查询及打印 住院费用结算 住院模拟结算 药店购药、普通门诊及慢性病结算 结算回退 医保结算单打印 住院结算信息查询 结算信息查询 清算申请 清算单打印 清算回退 清算申请查询 服务项目目录获取 编码对照信息获取 特殊慢性病申报 获取医保中心日期 三目录对码信息新增 三目录对码信息修改 三目录对码信息停用 获取三目录对码审核信息 批量删除明细 中心对码数据下载 入出院信息查询 入出院信息查询 交易类型 查询类 查询类 查询类 查询类 查询类 处理类 处理类 查询类 查询类 查询类 查询类 查询类 查询类 查询类 处理类 查询类 处理类 处理类 查询类 查询类 查询类 处理类 查询类 处理类 查询类 查询类 查询类 查询类 查询类 查询类 查询类 查询类 查询类 查询类 查询类 查询类 查询类 第 14 页 共 88 页

HIS是否必须实现 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 是 新疆(喀什)医保支付接口应用编程接口规范

40 41 42 43 44 72 72b 60 61 Q23A 清算汇总单打印 清算清单打印 中心对码数据下载 中心ICD10数据下载 出院病人一览表 查询类 查询类 查询类 查询类 查询类 是 是 是 §1.7.

§1.7.1. 交易名称 交易详细说明部分

修改密码（02） 修改密码 交易类型 查询类交易 接口弹出密码修改界面，提示参保人员刷卡和输入密码，采用密码小键盘获取参保人员密码信息，完成密码校验及修改。 处理描述 本交易为查询交易，有可能出现前端接口调用修改密码返回失败，结果中心修改密码成功的情况，此类特殊情况只能由医保病员自己验证当前使用密码是否是修改的新密码，暂时不作交易控制。 修改的处理结果由接口显示提示，HIS不用对本交易返回结果进行判断和调用说明 用户提示。 输入参数 交易编号 02 交易输入 xml 输出参数 交易流水号 交易输出xml 无 交易标志 小于0表示失败 §1.7.2. 交易名称 身份识别（03） 身份识别 交易类型 第 15 页 共 88 页

查询类交易