医疗保障信息平台
医保钱包指令中心接口规范
修订记录
序号 日期 更改内容 版次 修订人1 2024-07-26 1、结合钱包冻结、注销场景，医保钱包管理 文档新建 1.0.0（1001）接口，“中请类型*增加字典值人参增加“钱包编号”：接口出参“开通状态（openStas）”调整为“处理状态（dspoStas）”、(abninfo)*.2、结合钱包换开、清退场景，医保钱包记账 （1002）接口，原钱包业务类型（witBizType）调整为“记账业务类型2024-10-30 （bkkpBizType)”，对应字典值增加“钱包换 1.1.03、结合钱包交易冲正场景，医保钱包交易 开”、“钱包清退”（1101）接口，支持钱包交易冲正，人参增加“交易业务类型”，交易冲正时必填，接口出参交易状态增加“3处理中”4、增加医保钱包交易冲正确认（1004）接口， 用于交易冲正后，发送至交易冲正收款方运营机构进行确认，
目录
第一章接口规则1.1.协议规则.. 1.2.数据类型.1.3.安全规范.1.3.1.签名算法（SM2） .5 51.3.2.加密算法（SM4） 1.3.3.报文公共参数 5第二章接口说明 52.1.医保钱包指令中心 6 62.1.2.医保钱包记账（1002） 2.1.1.医保钱包管理（1001） 62.1.3.医保钱包记账冲正（1003） ..92.1.4.医保钱包交易（1101） 102.1.6.医保钱包余额查询（1301） 2.1.5.医保钱包交易冲正确认（1004） .12第三章字典表 14 153.1.接收机构（recins) 15第四章错误码 3.2.证件类型（certType） 1718
第一章接口规则
1.1.协议规则
规则 规则描述传输方式 采用HTP传输提交方式 采用POST方法提交数据格式 提交和返回数据都为ISON格式字符编码 统一采用UTF-8字符编码签名算法 SM2加密算法 SM4签名要求 待定加密要求 先判断协议字段返回，再判断业务返同，最后判新交易状态 待定判断逻辑
1.2.数据类型
序号 类型 类型名称 说明String 字符串 标准XML字符串类型（xstring），长度分为定长和变长两 种，例如：长度“8"表示字符申长度固定为8.长度1.100”表示字符串长度在1到100之间2 NString 数字中 表示由数字0-9组成的字符串，如：0123456789Integer 整数 标准XML整数类型（xs-integr）3 标准XML实数类型（xs-decimal）4 Decimal 实数5 Base64Binary Base64编码字符 串 标准XMLBase64编码字符串类型（xsbase64Binary）6 Date 日期 表示日期，格式为yy-MM-dd（年月日），长度为8位表示时间，格式为HHmmiss（时分秒），长度为8位，如： 如：2016-06-137 Time 时间 09:29:53表示日期时间，格式为yy-MM-dd Hmm:ss（年月日时8 DateTime 日期时间 分秒），长度为17位，如：2016-06-1309-29:53表示UTC目期时间，格式为ddMMyy HHimmssz（日UTCDateTime UTC日期时间 月年时分秒时区），长度为24位，如：13Jun2016 09:29-53 GMT10 Boolean 布尔 tne或false
1.3.安全规范
待定
1.3.3.报文公共参数
1.3.3.1.请求地址htp://ip:增口号/pccOrder
参数 参数名称 类型 长度 可空 参数说明orderld 指令id Suring 50 Nsendins recins 接收机构 发送机构 Suring Suring 6 6 N N 详见字典表admds 医保统筹区 String 6 N 国家1000001001钱包开立bizMsgNo 业务报文编号 String 1002钱包记账4 N 1101钱包交易 1003钱包冲正bizYear version 业务年度 版本号 Sring Sring 4 Ntimestamp 当前时间 String 32 6 N N 时间截 1.0.0data 指令参数体 Object N 具体参数看下方接String 口人参encData encType 加密方式 加密数据 Sring 6 N N SM4signType 签名方式 String 6 N SM2signData 签名串 String 200 N
1.3.3.3. 返回报文
参数 参数名称 类型 长度 可空 参数说明orderld 指令id String 50 N 请求参数的指令ID
