《广东省冷链食品追溯 数据共享与交换接口规范》（送审稿）.docx

ICS35.24099CCS1.67B44广东省地方标准DB44/TXXXXXXXX广东省冷链食品追溯数据共享与交换接口规范Guangdongco1.dchainfoodtraceabiIity-Datasharingandexchangeinterfacespecification（送审稿）XXXX-XX-XX发布XXXX-XX-XX实施广东省市场监督管理局发布本工件按照GBJT1.1-2020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草.请注意本文件的某线内容可能涉及专利，本文件的发布机构不承拒识别专利的责任。本文件由广东省巾场监其管理局提出.本文件由广东省市场监珞管理局归1.木文件起旗单位：广东省市场监督管理局、天河区市场监悻管理局、广州执信网络技术有限公司、广州中科易徵科技有限公司、广州软件应用技术研究院、珠海生旦创新研究院。本文件主要起草人：袁敬夫、李引、施雯雯、林淑英'窿娟、钟百川、谭教珠、杨世峰、何川、何维、王一龙、肖坟贤、刘东成、孙微微、郑翔蔚、王俊宇、施自立、李露露.I1.1.广东省冷链食品追溯数据共享与交换接口规范1黄国本文件规定了广东省冷胜食品追溯中的数据传怆基本要求、数据接口协议以及数据共享与交换要求.本文件适用于企业系统、地市心管系统与广东省冷链食品追溯系统之间数据的对接与传输，2规葩性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条歆,其中,注口期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件,其最新版本(包括所有的修改单适用于本文件。GH/T11457信息技术软件工程术语GB/T35295信息技术大数据术语GB/T36345信息技术通用数据导入接口GB/T38672信息技术大数据接1.1.基本要求GH/T43195进口冷贷食品追溯追溯系统开发指南3术语和定义GWT11457,GB/T35295界定的术语和定义适用于本文件.4缩略语下列缩略泄适用于本文件.JSON：JS对象标记(JavaScriptObjectNotation)HTTPS：安全超文本传购协议(HyperTcx1.TransferProtoco1.Secure)5基本要求5.1 数据安全性数据传隘和认证过程中的采用可被加密方案,宜使用国密系列算法。5.2 数据可靠性传输过程应通过有效的校的机制脸证数据包的完整性和正确性.5.3 数据可拓展性接1.I设计应具备灵活性,能鲂适应数据也与业务衢求的增长，支持横向扩展及兼容未来技术升级.6接口协议数据通信基于TCP/IP协议和IiTTPS协议，并符合GB/T36345的要求.包括以下情况：a）建立连接：采用HTTPS通信方式.进行端11监所,准备接收连接请求.并根据业务需求进行数据传给.传输结束后断开网络：b）超时正发：一条指令发出后，在规定时间内未收到回应，则认为超时：断时后应正发，重发3次后，仍未收到回应，则认为通讯失败,应自动重建连接。超时时间可根据具体情况自行设定：C）通信周期：支持被动传输和主动定时传输两种数据传输模式，主动定时传输周期可从5min到24h灵活配以。62接口防议数据结构6. 2.1数据包组成接口为议数据包的殂成应符合图1的规定。其中实体数据为经过加密的JsQN格式数据，加密后以ASCII码的格式进行传输，其他数据明码传输，图1数娓包的组成62.2数据包的结构数据包的结构见表k表1数盘包的结构9H也说，包头十六进制4字节Is1.定为0x680x680x160x16实体数据总长度十六进刎4字节代表当前敝第包中的实体数据长Iff实体数据字符N字V(MT)实体数如为数纸包的实体内容N含义见表3tt十六进制2字节时实体数据进行循环冗余校验包兄十六进制4字节固定为0x55OxAA0x55OxAA62.3实体数据的结构实体数据的结构见表2.表2实体数据的结构蚓说明敏鼎序列十六进IW4字1，标识/发送者的数据序号.辰答时.本项内容应技照发送并提供的数掂序号进行填充.i据内容字符N字节根据数IB序号,内容不同数据内存座S过加密的JSON格式数据，加密后以ASCII码的格式进行化麻7数据共享和交换要求6.1 数据共享要求数据共享应符合以下要求：a）数据共享以MEB服务方式提供，按照GB/T36345和GB/T38672的要求进行；b）数据共享服务的设计、封装、开发按照GB/T43195的要求进行。6.2 数据交换方式数据交换按照GB/T43195的要求进行，分为以下三个阶段：a）数据使用方通过HTTPS向数据提供方发起数据交换请求；b）数据提供方收到数据交换请求,解析数据报文,进行校验后对合法数据进行发送，非法数据则发送错误代码：c）数据使用方接收数据并存储,返回一个数据报文，数据提供方根据返回数据批文判断本次数据交换是否成功.6.3 数据交换与内容格式数据交换的内容采用JSON作为数据交换的媒介，6.4 数据交换请求7. 4.1数据交换请求JSON格式数据交换请求JSoN格式应包含以卜参数：a） accessTokem调用接口的令牌.登陆成功后.返回-个32位的Hash字符串：b） ti三estanp:接口使用方发出请求的客户次时间（采用东八区系统时间ITC/G!T+08:00）：c） I。IaINUm:表示数据交换所携带的记录致也：d） data：为JSON数组，存放交换数据。7.4.2数据交换请求示例可参见附录A.2 .5数据交换返回7 .5.1数据交换返回JSoN格式数据交换返W1.JSON格式包括以下信息：a) errorCode：为错误代码，表明数据交换失败的原因”当数据交换成功时，该参数为0：当数据交换失败时，该参数为自定义的错误代码；b) CrrorMCSSiJK。：为返回结果信息，描述数据交换出锚的具体情况。当数据交换成功时，该卷数为空值：当数据交换失败时,该参数为自定义的错误原因：C)success：标志此次数据交换是否成功.成功为true,失败为fa1.se：d)data：当数据交换成功时，W1.data参数为空值：当数据交换失败时，data参数存放交换失败的数据。7.5.2数据交换返回示例可参见附录8和附录C.附录A(资料性)效据交换共享请求JSoN示例下面给出数据交换共享请求的JsoN示列，见图AI.示列，https：/SERVER_IP/SYTSTER_KAME)/?accessToken-C7A8F9DAD2F94BB197ADEAFE3F4C1.SresourceCode-0ie401Sti11estip-20171191S395Content-Type:a1.icationjson'tota1.Numw:I9,data*':+OPERATION。：“ADD，“ENT_CRED1.T_COOE”:5CFCSCA0A549CA9OES0A8C0DD1157A,"ENTNAME”：“广州而XXft&fi跟公司”，,ent-1.ega1.h:非XX，mENT-ADDm:0广州市XXKXX路XX号”，“ENTJREAJZODE“：“440106,mENT-TYPEm:F1.mENT-REFRKh：nu1.1.t!)图A1数据交换请求JSON示例附录B资料性）数据交换成功返回JSON示例下面给出数据交换成功返何JSftX示例,见图H.1,示列I'errorcode":W.MerrorHessageM:*,success',:true",MdataM:)图B1数据交换成功返回JSoN示例附录C（资料性）数据交涣失败返回JSON示例下面给出数据交换失败返回JSON示例.见图C1.示克，“errorcode":"000803",-errorMessage":"JSON数据if失败，"success":'fa1.se","data":1-pioi-jyi446411443",(Z7YT"r4001.0')图C.1数据交换失败返回JSON示例GBZT431952023GB/T432682023GB/T360882018叁考文献进1.1.冷槌食品追溯追溯系统开发指南进口冷SI食品追溯追溯体系通则冷琏物流信息管理要求DB4103/T249-2022进口冷於食品追溯数据接口燃范DB13/T582023冷链优品协同追溯技术规范