基于射频识别的中药中成药生产追溯系统第4部分-数据接口规范(T-YNZYC 0099—2023).pdf

《基于射频识别的中药中成药生产追溯系统第4部分-数据接口规范(T-YNZYC 0099—2023).pdf》由会员分享，可在线阅读，更多相关《基于射频识别的中药中成药生产追溯系统第4部分-数据接口规范(T-YNZYC 0099—2023).pdf（20页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、ICS65.020.99CCS B00YNZYC团体标准T/YNZYC 00992023基于射频识别的中药（中成药）生产追溯系统 第 4 部分：数据接口规范Radiofrequency Identified-based Chinese medicine(proprietary Chinesemedicine)production traceability system-Part 4:Data interface specification2023-12-11 发布2023-12-11 实施云南省中药材种植养殖行业协会发 布T/YNZYC 00992023I前言本文件按照 GB/T 1.1202

2、0标准化工作导则第 1 部分：标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本文件由云南省中药材种植养殖行业协会提出并归口。本文件起草单位：昆明高新区生物医药产业促进会、云南省中药材种植养殖行业协会、云南前海高新技术产业研究院有限公司、云南钰津供应链科技有限公司、昆药集团股份有限公司、昆明中药厂有限公司、云南三七科技有限公司本文件主要起草人：徐朝能、苏豹、张自骞、陈晓虹、丁剑、李纳、李艳、李学芬、尹容梅、胡俩剑、张雪、郑辉、田孟齐、唐婉筠、刘辉、江明、孙建宁、孙高飞、杨辉T/YNZYC 009920232基于射频识别的中药（

3、中成药）生产追溯系统 第 4 部分：数据接口规范1范围本文件规定了中成药行业基于射频识别的生产追溯系统的外部数据接口等。本文件适用于中成药行业基于射频识别的生产追溯系统与外部系统之间的数据交互。2规范性引用文件下列文件中的条款通过本文件的引用而成为本文件的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本文件，然而，鼓励根据本文件达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本文件。3术语和定义3.1网络服务 Web Service用于开发分布式的互操作，是一个平台独立的，低耦合的，自包含的、基于可编程的 web 的

4、应用程序，可使用开放的 XML（标准通用标记语言下的一个子集）标准来描述、发布、发现、协调和配置这些应用程序，用于开发分布式的互操作的应用程序。3.2可扩展标记语言 Extensible Markup LanguageXML 英文全称 Extensible Markup Language，称为可扩展标记语言，标准通用标记语言的子集，是一种用于标记电子文件使其具有结构性的标记语言。可扩展标记语言是一种元标记语言，即定义了用于定义其他特定领域有关语义的、结构化的标记语言，又将文档分成许多部件并对这些部件加以标识。3.3简单对象访问协议 SOAP简单对象访问协议是交换数据的一种协议规范，是一种轻量的

5、、简单的、基于 XML（标准通用标记语言下的一个子集）的协议，它被设计成在 WEB 上交换结构化的和固化的信息。3.4系统数据接口 System Data Interface是软件系统之间的数据交换协议，用来规定系统间信息交互的访问方式、数据格式、数据内容、处理规则、交互机制等通信规范。4技术实现4.1通讯方式T/YNZYC 009920233数据接口以 WebService 方式进行发布，采用 http 通讯协议进行同步通讯，支持 SOAP 1.1、SOAP1.2 访问协议。接口服务程序部署到在应用服务端 IIS 服务器上，通过 Intranet/Internet/专线对外围系统提供查询服务

6、。所有接口均采用报文数据作为 web 服务具体方法的参数完成业务数据交换。4.2报文规范从文档结构，报文分为报文头和报文体两部分；从交互方式，报文分为请求报文和响应报文两类，即输入和输出。报文以 xml 标签形式封装，数据对象及字段英文名即为 xml 报文中标签名。报文头标签名为,报文体标签为，报文范例如下。取样通知通知案例：valuev0.112016/06/01 00:00:004.3报文约定a)各数据类型若无特别需求均为字符型。b)日期数据默认格式为“yyyyMMdd”，例 2016-06-01，报文内容为 2016/06/01。c)时间字段默认格式为“yyyyMMdd HHmmss”，

7、例如 2016-06-01 16:25:16，报文内容为 2016/06/0116:25:16。d)回执包报文头交易流水号（infoid），与请求包报文头交易流水号保持一致。e)报文内容所有字母必须小写。f)报文数据格式具有规则结构，不允许自定义报文格式。4.4消息类型消息类型编码说明通知1消息接收通知、消息变更通知、消息作废通知T/YNZYC 009920234反馈2消息的反馈、状态的反馈回执3接收的回执4.5消息环节工艺环节编码说明原料仓库1原料仓库环节的通知、反馈和回执中药提取2中药提取环节的通知、反馈和回执半成品仓库3半成品仓库环节的通知、反馈和回执中药制剂4中药制剂环节的通知、反馈和

8、回执成品仓库5成品仓库环节的通知、反馈和回执4.6表类型表类型编码说明通知/反馈接收回执0回执与通知/反馈一一对应消息访问通知1其他系统向生产追溯系统发送消息访问申请通知状态变更通知2请求变更已发送通知的通知状态通知状态变更反馈3通知状态变更情况反馈消息数据反馈4反馈消息访问通知需求的数据通知作废反馈5作废已发出通知4.7状态定义类型状态编码说明回执状态失败0消息接收失败成功1消息接收成功可操作状态否0消息不可作废、状态不可变更、数据不可修改等是1消息可作废、状态可变更、数据可修改等反馈状态生成1生成数据反馈2消息数据反馈作废3消息数据作废通知状态生成1生成通知下达2通知已下达处理3正在进行数

9、据处理完成4数据处理完毕，通知处理的结果和完成状态的反馈T/YNZYC 009920235结果状态生成1已生成消息，但未进行提交提交2已提交并反馈消息作废3通知作废的状态确认4通知确认的状态5业务实现5.1业务流程该接口规定了生产追溯系统与其他系统之间的数据交互方式，主要包括消息接收通知、通知接收回执、消息状态变更通知与通知接收回执、消息处理状态反馈与反馈接收回执、结果反馈与反馈接收回执、结果变更通知与通知接收回执、结果作废通知与通知接收回执等主要流程，其业务流程如下图所示。图 1 业务流程5.2消息访问通知的下达与接收回执消息访问通知的下达由交互系统发起，按照其消息需求的时间、频次进行下达。

10、通知的接收回执由生产追溯系统发起，须在通知接收后实时反馈。业务流程如图 2 所示5.2.1消息访问通知下达交互系统向生产追溯系统下达相应的消息访问（状态为下达状态）通知，生产追溯系统收到消息访问通知后，须向交互系统发送通知接收回执的消息。其处理方式分以下三种情况：T/YNZYC 009920236a)交互系统在一定时间内未收到生产追溯系统的通知接收回执，再次发送消息访问通知；b)交互系统收到生产追溯系统的通知接收回执，但回执状态为失败。此时交互系统须进行失败原因检查和处理后，再次发送消息访问通知；c)交互系统收到生产追溯系统的通知接收回执，且回执状态为成功，消息发出系统将更新相应通知的状态为“

11、下达”。图 2 消息访问通知下达流程T/YNZYC 0099202375.2.2消息访问通知接收与回执生产追溯系统收到消息访问通知后，须及时解析相应的数据格式，并及时向消息发出系统反馈通知的接收回执信息。其中，数据格式解析正确则反馈接收成功，否则反馈接收失败。业务流程如下图 3所示：图 3 消息访问通知接收流程5.3通知状态变更与接收回执通知状态变更通知由交互系统发起，须做到实时作废及时通知。通知状态变更通知接收回执由生产追溯系统发起，须在通知状态变更通知接收后及时的反馈。T/YNZYC 0099202385.3.1通知状态变更通知下达交互系统向生产追溯系统下达状态变更通知，生产追溯系统收到通

12、知后，须向交互系统发送通知接收回执的消息。其处理方式分以下四种情况：a)交互系统判断是否收到生产追溯系统通知状态变更通知的接收回执，若在一定时间内未收到接收回执，须再次发送；b)交互系统收到生产追溯系统的通知状态变更通知的接收回执，但回执状态为失败。此时交互系统须进行失败原因检查和处理后，再次发送通知状态变更通知；c)交互系统收到生产追溯系统的通知状态变更通知的接收回执，回执状态为成功，但是否可变更状态为否。交互系统须进行失败原因检查和处理后，再次发送通知状态变更通知；d)交互系统收到生产追溯系统的通知状态变更通知的接收回执，回执状态为成功，且是否可变更状态为是，交互系统将作废相应的消息访问通

13、知。业务处理流程如图4所示：T/YNZYC 009920239图 4 通知状态变更通知下达流程5.3.2通知状态变更通知接收与回执生产追溯系统收到通知状态变更通知后，须及时解析相应的数据格式。其处理方式分以下两种情况：a)数据格式解析异常则须及时向交互系统反馈接收失败回执；b)数据格式解析正常，生产追溯系统须及时判断当前的处理情况是否能状态变更。若能状态变更，须及时向交互系统反馈可状态变更的回执，并及时对相应通知状态变更；若不能状态变更，须及时向交互系统反馈不可状态变更的回执。业务处理流程如图 5 所示：图 5 通知状态变更通知接收流程T/YNZYC 00992023105.4通知处理状态反馈

14、与接收回执通知处理状态的反馈由生产追溯系统发起，须做到通知状态变更的实时反馈。通知处理状态反馈接收回执由交互系统发起，须做到反馈接收后实时回执。5.4.1通知处理状态反馈生产追溯系统向交互系统反馈相应的消息访问通知处理状态，交互系统收到通知处理状态反馈后，须向生产追溯系统发送反馈接收回执的消息。其处理方式分以下四种情况：a)生产追溯系统在一定时间内未收到交互系统的通知状态反馈的接收回执，须再次发送；b)生产追溯系统收到交互系统的通知状态反馈的接收回执，但回执状态为失败。此时生产追溯系统向系统管理员及相关人员发送通知状态反馈发送失败的消息，由系统管理员及相关人员采取相应的处理措施；c)生产追溯系

15、统收到交互系统的通知状态反馈的接收回执，若回执状态为成功，但是否可变更状态为否。此时生产追溯系统向系统管理员及相关人员发送通知状态变更反馈发送失败的消息，由系统管理员及相关人员采取相应的处理措施；d)生产追溯系统收到交互系统的通知状态反馈的接收回执，回执状态为成功，且是否可变更状态为是，生产追溯系统将更新相应通知的状态为“处理”。业务处理流程如图 6 所示：T/YNZYC 0099202311图 6 通知执行状态反馈流程5.4.2通知处理状态接收与回执交互系统接收到生产追溯系统的通知处理状态变更反馈后，须及时解析相应的数据格式，并及时向生产追溯系统反馈通知状态变更的接收回执信息。其处理方式分以

16、下两种情况：a)数据格式解析异常则须及时向生产追溯系统反馈接收失败回执；b)数据格式解析正常，交互系统须及时判断本地相应通知状态是否可变更。若能变更，须及时向交互系统反馈可变更的回执，并及时变更相应通知状态为处理状态；若不能变更，须及时向生产追溯系统反馈不可变更的回执。业务处理流程如图 7 所示：图 7 通知处理状态反馈接收与回执流程T/YNZYC 00992023125.5通知处理结果反馈与接收回执通知处理结果反馈由生产追溯系统发起，须做到每个通知处理完成后实时的结果反馈，其中通知的处理结果需要反馈两套数据，分别为原始数据和校准后数据。通知处理结果反馈接收回执由交互系统发起，须做到反馈接收后

17、实时回执。5.5.1通知处理结果反馈生产追溯系统处理完成某个消息访问通知后，根据相应通知的结果数据格式，向交互系统反馈该结果（包括原始结果和校准后结果）信息（状态为提交）。其处理方式如下所示：a)生产追溯系统在一定时间内未收到交互系统的通知处理结果反馈的接收回执，须再次发送，发送预定次数后仍未收到接收回执。此时生产追溯系统向系统管理员及相关人员发送通知处理结果反馈发送失败的消息，由系统管理员及相关人员采取相应的手工干预措施；b)生产追溯系统收到交互系统的通知处理结果反馈的接收回执，但回执状态为失败。此时生产追溯系统向系统管理员及相关人员发送通知处理结果反馈发送失败的消息，由系统管理员及相关人员

18、采取相应的处理措施；c)生产追溯系统收到交互系统的通知处理结果反馈的接收回执，且回执状态为成功，生产追溯系统将更新相应通知结果的状态为“提交”。业务处理流程如图 8 所示：T/YNZYC 0099202313图图8通知处理结果反馈流程通知处理结果反馈流程5.5.2通知处理结果接收与回执交互系统收到通知处理结果反馈后，须解析相应的数据格式，并向生产追溯系统发送反馈接收回执的消息。其处理方式分为以下三种情况：a)第一，数据格式解析异常，则须及时向生产追溯系统反馈接收失败回执；b)第二，数据格式解析正常，则须及时向生产追溯系统反馈接收成功回执；c)第三，交互系统根据通知处理结果反馈信息存储通知结果，

19、同时更新相应通知状态为“完成”状态。业务处理流程如图 9 所示：图 8 通知处理结果接收与回执T/YNZYC 00992023145.6处理结果作废反馈与接收回执5.6.1处理结果作废反馈生产追溯系统向交互系统反馈相应的通知处理结果作废状态，交互系统收到通知处理结果作废反馈后，须向生产追溯系统发送反馈接收回执的消息。其处理方式分以下四种情况：a)生产追溯系统在一定时间内未收到交互系统的通知处理结果作废反馈的接收回执，须再次发送，发送预定次数后仍未收到接收回执。此时生产追溯系统向系统管理员及相关人员发送通知处理结果作废反馈发送失败的消息，由系统管理员及相关人员采取相应的处理措施；b)生产追溯系统

20、收到交互系统的通知处理结果作废反馈的接收回执，但回执状态为失败。此时生产追溯系统向系统管理员及相关人员发送通知处理结果作废反馈发送失败的消息，由系统管理员及相关人员采取相应的处理措施；c)生产追溯系统收到交互系统的通知处理结果作废反馈的接收回执，若回执状态为成功，但是否可变更状态为否。此时生产追溯系统向系统管理员及相关人员发送通知处理结果作废反馈发送失败的消息，由系统管理员及相关人员采取相应的处理措施；d)生产追溯系统收到交互系统的通知处理结果作废反馈的接收回执，回执状态为成功，且是否可变更状态为是，生产追溯系统将更新相应通知处理结果状态为“作废”。图 9 处理结果作废反馈流程T/YNZYC

21、00992023155.6.2处理结果作废接收与回执交互系统接收到生产追溯系统的通知处理结果作废反馈后，须及时解析相应的数据格式，并及时向生产追溯系统反馈通知处理结果作废的接收回执信息。其处理方式分以下两种情况：a)数据格式解析异常则须及时向生产追溯系统反馈接收失败回执；b)数据格式解析正常，交互系统须及时判断本地相应通知处理结果是否可作废。若能作废，须及时向交互系统反馈可作废的回执，并及时变更相应通知处理结果状态为作废状态；若不能作废，须及时向生产追溯系统反馈不可作废的回执。业务处理流程如图 11 所示：图图1111通知处理结果作废反馈接收与回执流程通知处理结果作废反馈接收与回执流程T/YN

22、ZYC 0099202316AA附录A（资料性）应用接口示例A.1通知、反馈接收回执XML格式valuev0.132016/06/01 00:00:00A.2消息访问通知XML格式valuev0.112016/06/01 00:00:00T/YNZYC 0099202317A.3通知状态变更通知XML格式valuev0.112016/06/01 00:00:00A.4通知处理状态反馈XML格式valuev0.1T/YNZYC 009920231812016/06/01 00:00:00A.5通知处理状态反馈XML格式valuev0.112016/06/01 00:00:00A.6通知处理结果作废反馈XML格式T/YNZYC 0099202319valuev0.112016/06/01 00:00:00