云南省定点医药机构接口规范（2026新V1.47完整版）

云南省定点医药机构接口规范（2026最新V1.47完整版）发布单位：云南省医疗保障局最新版本：V1.47（2026年7月20日更新）配套文件：接口字典表V2.20、电子处方接入规范、机构接入指引、验收标准全套适用范围：云南省全省定点医疗机构、定点零售药店，所有医保联网结算、处方流转、事前审核、招采对接、医保电子凭证应用、医保移动支付业务执行说明：本规范为云南省医保信息平台统一对接标准，所有存量机构改造、新增机构入网必须遵照执行，旧版规范同步废止第一章总则1.1规范目的统一云南省定点医药机构与省级医保信息平台的数据交互标准、接口调用规则、报文格式、安全机制与业务流程，实现全省医保业务统一联网、统一结算、统一监管，支撑医保实时结算、智能审核、处方流转、线上服务、招采协同等全场景医保数字化应用。1.2编制依据依据国家医疗保障信息平台统一技术规范、医保电子凭证技术标准、全国统一医保结算规范，结合云南省医保业务实际制定，为全省唯一官方对接标准。1.3适用对象云南省辖区内所有定点医院、定点诊所、定点零售药店；负责医保系统开发、运维、改造的第三方软件厂商；各级医保经办机构业务对接工作。1.4核心业务覆盖医保参保校验、就医登记、处方上传、智能事前审核、诊疗项目结算、药品结算、医保退费、对账查询、医保电子凭证核验、电子处方流转、医保招采数据同步、业务日志上报、异常反馈等全流程医保业务。第二章总体技术架构2.1架构模式采用省级平台集中式对接架构，所有定点医药机构统一对接云南省医保信息平台，不再分州市独立接口，实现全省统一入口、统一规则、统一数据标准。2.2对接方式支持两种官方对接模式，机构可按需选择：1.HTTP/HTTPS标准接口调用：主流对接方式，适用于HIS系统、药店进销存系统、第三方平台对接，支持POST标准报文交互。2.动态库接口调用：适配老旧医保系统平滑升级，兼容传统医保对接模式，保障存量业务平稳过渡。2.3数据传输原则1.所有交互数据统一采用UTF-8编码，杜绝乱码、格式异常。2.交易报文标准化、参数固定化，严格匹配官方字典表V2.20。3.所有业务交互留痕，全程日志可追溯、可稽核。第三章通用接口规范（全局统一规则）3.1通用报文结构所有医保接口请求、响应报文统一分为两大模块：报文头（公共参数）+报文体（业务参数）。3.1.1请求报文头必填参数包含：接口交易码、定点机构编码、终端编号、操作员编号、交易时间、签名信息、版本号、设备唯一标识。3.1.2响应报文统一字段包含：返回码、返回信息、交易流水号、平台处理时间、业务结果数据体。3.2交易码规则全省统一固定交易码，分类管理：参保查询类、登记类、处方类、审核类、结算类、退费类、对账类、处方流转类、电子凭证类。所有交易码严格遵循V1.47规范，禁止自定义编码。3.3数据字典标准统一使用《云南省医疗保障信息平台定点医药机构接口字典表2.20》，涵盖：参保状态、人员类别、诊疗项目类型、药品剂型、结算类型、报销类别、异常错误码等全部枚举值，所有字段取值必须与字典完全一致。3.4超时与重试机制1.接口默认超时时间：30秒；2.网络超时、平台响应异常可重试，重复交易需携带唯一流水号，防止重复结算、重复上传；3.失败交易必须本地日志留存，人工核对后重新发起。第四章安全接入规范4.1身份认证要求1.机构入网必须完成定点医药机构备案、终端绑定、白名单准入；2.所有接口请求必须携带合法机构编码、终端标识、操作员权限信息；3.禁止跨终端、跨机构盗用接口权限。4.2数据加密与签名1.传输链路强制HTTPS加密；2.核心业务报文必须进行数字签名，防止报文篡改、伪造交易；3.敏感信息（参保人证件、手机号、医保编号）脱敏传输、本地加密存储。4.3安全红线要求1.严禁私自篡改医保结算参数、伪造处方、伪造就医记录；2.严禁越权调用非本机构接口；3.严禁批量爬取、泄露医保参保数据与就医数据；4.违规接入、违规调用将取消医保联网资格并依规追责。第五章核心业务接口分类规范5.1参保人员核验类接口实现参保状态查询、医保待遇查询、参保信息实时校验，用于就医前置校验，杜绝无参保、断缴、待遇冻结人员违规结算。5.2就医登记类接口包含门诊登记、住院登记、撤销登记，规范就医建档流程，所有医保结算必须先登记、后执业、后结算，实现业务全溯源。5.3处方与诊疗上传接口医师处方、检查项目、诊疗记录、用药信息实时上传省平台，支持医保智能事前、事中审核，拦截违规处方、超量用药、重复诊疗、违规项目收费。5.4智能审核接口实时返回医保审核结果，包含合规通过、预警提示、禁止结算三类结果，机构必须严格按照审核结果执行，禁止强制结算违规项目。5.5医保结算与退费接口门诊即时结算、住院分段结算、出院汇总结算、医保全额/部分退费，统一费用拆分规则、统筹支付、个人账户支付、大病补助、自费金额计算标准。5.6对账查询接口提供日对账、月对账、单笔交易查询、异常交易查询，支撑机构财务对账、医保稽核、业务纠错。5.7医保电子处方专项接口依据云南省医保电子处方中心接入规范，实现处方预核验、处方上传、处方流转、药店核验、凭方发药、处方核销全流程接口对接，适配线上复诊、网售药品、处方流转便民场景。5.8医保电子凭证核验接口支持医保码扫码核验、身份认证、免证就医、移动支付绑定，适配全省医保便民服务场景。第六章电子处方中心专项接入规范本章节依据2023年5月最新电子处方接入规范制定，适用于所有开展处方流转、线上购药的定点医疗机构、定点药店。6.1核心流程医师开方→处方预核验（平台校验合规性）→院内药师审核→处方上传备案→流转至药店/患者→扫码核验取药→处方核销归档6.2关键必填参数电子处方二维码码值、定点医药机构编号、医师编码、药师审核标识、用药天数、药品单价、药品总金额、处方有效期、疾病诊断编码等，参数长度、类型、必填规则严格匹配官方标准。6.3发药核销规则必须凭有效流转处方核验发药，禁止无方发药、超量发药、改方发药，发药完成后实时调用核销接口，完成处方闭环管理。第七章接入实施与改造要求7.1新接入机构要求新增定点医药机构入网，必须按照V1.47版接口规范、V2.20字典表完成系统开发、联调、测试、验收，验收通过后方可开通医保结算权限。7.2存量机构改造要求原有旧版本接口机构需完成版本升级，适配最新报文格式、签名规则、审核规则、字典标准，确保与省级平台完全兼容，未完成改造的机构将限制医保联网结算功能。7.3软硬件基础要求机构系统需稳定支持7×24小时联网交互，具备日志留存、数据备份、异常告警、断点续传能力，保障医保业务不间断运行。第八章测试、验收与上线流程8.1对接流程资料备案→开通测试环境→接口联调→全业务场景测试→提交验收申请→现场核验→正式生产环境上线8.2验收材料清单定点医药机构接入信息表、接口对接测试报告、电子处方接入验收申请表、系统安全自查报告、业务全流程演示记录。8.3验收标准所有核心接口调用正常、报文格式合规、数据字典匹配、审核结算准确、处方流转闭环、日志完整、安全合规，无重大对接缺陷。第九章异常处理与运维规范9.1常见异常类型参数错误、字典不匹配、签名失败、权限不足、平台超时、审核驳回、重复交易、数据不一致等。9.2异常处置原则1.交易失败不允许私自补录、篡改数据；2.结算异常第一时间核对平台流水，人工订正；3.批量异常、系统故障及时报备属地医保部门，统一处置。9.3日常运维要求机构需常态化自查接口连通性、数据准确性、日志完整性，定期完成版本同步、字典更新，跟随省平台迭代升级。第十章附则1.本规范依据云南省医保局2026年7月20日官方发布文件编制，为当前全省定点医药机构接口对接唯一有效标准。2.此前发布的旧版接口规范与本V1.47版不一致的，以本规范为准。3.规范释义、业务答疑由云南省医疗保障局及属地医保经办部门负责。4.所有定点医药机构须严格遵照本规范完成系统对接、改造、运维与验收工作。附件清单（官方全套配套