第1章接口报文格式.docx
《第1章接口报文格式.docx》由会员分享,可在线阅读,更多相关《第1章接口报文格式.docx(36页珍藏版)》请在第一文库网上搜索。
1、第1章接口报文格式1.1接口输入报文格式定义报文采用JSoN格式,交易参数定义如下:表1交易输入参数定义序号数据元标识数据元名称类型长度代码标识是否必填备注1infno交易编号字符型4Y交易编号详见接口列表2msgid发送方报文ID字符型30Y定点医药机构编号(12)+时间(14)+顺序号(4)时间格式:YyyyMMddHHnunss3mdtrtarea_admvs就医地医保区划字符型6Y4insup1c_admdvs参保地医保区划字符型6如果交易输入中含有人员编号,此项必填,可通过1101人员信息获取交易取得5recer_sys_code接收方系统代码字符型10Y用于多套系统接入,区分不同系
2、统使用6devno设备编号字符型1007dev_safe_info设备安全信息字符型20008cainfo数字签名信息字符型10249signtype签名类型字符型10建议使用SM2、SM310infver接口版本号字符型6Y例如:“VI.0”,版本号由医保下发通知。11opter_type经办人类别3YY1-经办人;2-自助终端:3-移动终端12opter经办人字符型30Y按地方要求传入经办人/终端编号13optername经办人姓名字符型50Y按地方要求传入经办人姓名/终端名称14inf_time交易时间日期时间型19Y15fixmedins_code定点医药机构编号字符型12Y16fix
3、medins_name定点医药机构名称字符型20Y17sign-no交易签到流水号字符型30通过签到【9001】交易获取18input交易输入字符型40000Y12接口输出报文格式定义报文采用JSON格式,交易参数定义如下:表2交易输出参数定义序号数据元标识数据元名称类型长度代码标识是否非空备注1infcode交易状态码数值型4Y详见下节2infJefmsgid接收方报文ID字符型30Y接收方返回,接收方医保区划代码(6)+时间(M)+流水号(10)时间格式:yyyyMMddHHmmss3refmsg_time接收报文时间字符型17格式:yyyyMMddHHmmssSSS4respondjim
4、。响应报文时间字符型17格式:yyyyMMddHHmmssSSS5err_msg错误信息字符型200交易失败状态下,业务返回的错误信息6output交易输出字符型400001. 3交易状态码说明交易状态码(infcode)规格如下:表3报文状态说明序号STATUS值值说明备注10成功2-1失败14重点说明 调用交易时INPUT、OUTPUT节点应按照接口安全相关要求进行签名。 时间格式代码说明:yyyy(年,4位)、MM(月,2位)、dd(日,2位)、HH(24小时制,2位)、Inm(分钟,2位)、SS(秒,2位)、SSS(毫秒,3位)。 日期时间型的数据元(例如开始时间)格式为:yyyy-M
5、M-ddHH:mm:ss;日期型的数据元(例如开始日期)格式为:yyyy-MM-ddo 查询中输入开始结束时间,格式为yyyy-MM-dd,时间范围默认开始于00:00:00,结束于23:59:59o例如时间2023-01-01-2023-01-02则匹配时间2023-01-0100:00:00-2023-01-0223:59:59的数据。 报文中的输入/输出项的字符型串中的根节点和各个子节点一律小写。 类型为数值的参数,如果为空,必须传“0”,其他为空串(“),TXT文件中空值使用“mi11”o TXT文件使用字符集为UTF-8o 接口说明中声明的输入为输入报文中INPUT属性内容,输出为输
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 接口 报文 格式
