(高清版)GB∕T 39322-2020 電子商務(wù)交易平臺(tái)追溯數(shù)據(jù)接口技術(shù)要求

L67中華人民共和國(guó)國(guó)家標(biāo)準(zhǔn)電子商務(wù)交易平臺(tái)追溯數(shù)據(jù)接口技術(shù)要求TE-國(guó)家市場(chǎng)監(jiān)督管理總局國(guó)家標(biāo)準(zhǔn)化管理委員會(huì)ⅠGB／T39322—2020 1范圍 2規(guī)范性引用文件 3術(shù)語(yǔ)和定義 4縮略語(yǔ) 5基本要求 6格式定義與數(shù)據(jù)類型 7數(shù)據(jù)結(jié)構(gòu) 8數(shù)據(jù)安全 附錄B（資料性附錄）電子商務(wù)交易平臺(tái)追溯數(shù)據(jù)接口消息響應(yīng)狀態(tài) 參考文獻(xiàn) ⅢGB／T39322—2020本標(biāo)準(zhǔn)按照GB/T1.1—2009給出的規(guī)則起草。本標(biāo)準(zhǔn)由全國(guó)物流信息管理標(biāo)準(zhǔn)化技術(shù)委員會(huì)(SAC/TC267)提出并歸口。本標(biāo)準(zhǔn)起草單位：山東省標(biāo)準(zhǔn)化研究院、中國(guó)物品編碼中心、安徽智?信信息技術(shù)有限公司、黑龍江省標(biāo)準(zhǔn)化研究院、山東百仕達(dá)地標(biāo)產(chǎn)業(yè)有限公司、深圳市標(biāo)準(zhǔn)技術(shù)研究院、江蘇省質(zhì)量和標(biāo)準(zhǔn)化研究院。本標(biāo)準(zhǔn)主要起草人：王玎、梁厚廣、孫小云、方方、陳康康、曹成坤、邵小景、王亞楠、王志恒、李錚、1GB／T39322—2020電子商務(wù)交易平臺(tái)追溯數(shù)據(jù)接口技術(shù)要求本標(biāo)準(zhǔn)規(guī)定了電子商務(wù)交易平臺(tái)與相關(guān)系統(tǒng)交換追溯數(shù)據(jù)的基本要求、格式定義與數(shù)據(jù)類型、數(shù)據(jù)結(jié)構(gòu)、數(shù)據(jù)安全。本標(biāo)準(zhǔn)適用于電子商務(wù)交易平臺(tái)追溯數(shù)據(jù)服務(wù)接口的設(shè)計(jì)、開(kāi)發(fā)和應(yīng)用。2規(guī)范性引用文件下列文件對(duì)于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T7408—2005數(shù)據(jù)元和交換格式信息交換日期和時(shí)間表示法GB/T36061—2018電子商務(wù)交易產(chǎn)品可追溯性通用規(guī)范GB/T36318—2018電子商務(wù)平臺(tái)數(shù)據(jù)開(kāi)放總體要求IETFRFCIETFRFCTLS上的HTTP(HTTPOverTLS)IETFRFCBase16、Base32、Base64數(shù)據(jù)編碼(TheBase16,Base32,andBase64DataEn-IETFRFCUTF-8,ISO10646轉(zhuǎn)換格式(UTF-8,atransformationformatofISO10646)3術(shù)語(yǔ)和定義下列術(shù)語(yǔ)和定義適用于本文件。3.1描述實(shí)體行為的命名操作集。[GB/T25597—2015,定義4.5]3.2在產(chǎn)品供應(yīng)鏈中從事產(chǎn)品生產(chǎn)、加工、包裝、倉(cāng)儲(chǔ)、銷售、配送等相關(guān)業(yè)務(wù)的組織或個(gè)人。[GB/T36061—2018,定義3.3]3.3記錄追溯的信息。[GB/T38155—2019,定義3.4]下列縮略語(yǔ)適用于本文件。GB／T39322—2020URL：統(tǒng)一資源定位符(UniformResourceLocator)5基本要求電子商務(wù)交易平臺(tái)追溯數(shù)據(jù)接口通過(guò)服務(wù)調(diào)用獲取所需的信息，要求如下：—應(yīng)采用符合IETFRFC3629規(guī)定的UTF-8字符集；—應(yīng)采用HTTP或HTTPS協(xié)議作為底層承載協(xié)議，采用HTTP協(xié)議時(shí)應(yīng)符合IETFRFC2616的規(guī)定，采用HTTPS協(xié)議時(shí)應(yīng)符合IETFRFC2818的規(guī)定；—應(yīng)進(jìn)行用戶合法性、數(shù)據(jù)規(guī)范性等校驗(yàn)；—應(yīng)控制交換的追溯數(shù)據(jù)記錄數(shù)量，可采用分頁(yè)傳輸?shù)确绞剑瞬挥绊憯?shù)據(jù)的解析性能；—發(fā)生錯(cuò)誤時(shí)，接口應(yīng)將詳細(xì)的錯(cuò)誤信息返回至相關(guān)業(yè)務(wù)系統(tǒng)，由各業(yè)務(wù)系統(tǒng)對(duì)錯(cuò)誤進(jìn)行記錄分析和整改；—應(yīng)建立接口日志記錄，能識(shí)別數(shù)據(jù)異?；蜃匪萁粨Q數(shù)據(jù)情況。6格式定義與數(shù)據(jù)類型主要包括：主要包括：Datetime表示，應(yīng)符合GB/T7408—2005的規(guī)定；23GB／T39322—20207數(shù)據(jù)結(jié)構(gòu)7.1追溯數(shù)據(jù)的總體數(shù)據(jù)結(jié)構(gòu)應(yīng)對(duì)接口交換的電子商務(wù)交易平臺(tái)追溯數(shù)據(jù)的數(shù)據(jù)集進(jìn)行封裝：；其他信息；第8章的要求。追溯數(shù)據(jù)的總體數(shù)據(jù)結(jié)構(gòu)見(jiàn)圖1。圖1追溯數(shù)據(jù)的總體數(shù)據(jù)結(jié)構(gòu)總體數(shù)據(jù)結(jié)構(gòu)組成元素見(jiàn)表1。表1總體數(shù)據(jù)結(jié)構(gòu)組成元素名稱是否必選類型備注追溯數(shù)據(jù)的數(shù)據(jù)集是追溯數(shù)據(jù)的數(shù)據(jù)集數(shù)組包括一個(gè)或多個(gè)追溯數(shù)據(jù)對(duì)象追溯數(shù)據(jù)是追溯數(shù)據(jù)對(duì)象追溯參與方是追溯參與方數(shù)組包括一個(gè)或多個(gè)追溯參與方對(duì)象追溯單元是追溯單元數(shù)組包括一個(gè)或多個(gè)追溯單元對(duì)象追溯位置是追溯位置數(shù)組包括一個(gè)或多個(gè)追溯位置對(duì)象交易信息是交易信息數(shù)組包括一個(gè)或多個(gè)交易信息對(duì)象其他信息否視需求，可適情擴(kuò)展使用7.2追溯參與方數(shù)據(jù)結(jié)構(gòu)追溯參與方數(shù)據(jù)結(jié)構(gòu)見(jiàn)圖2。4GB／T39322—2020圖2追溯參與方數(shù)據(jù)結(jié)構(gòu)追溯參與方數(shù)據(jù)元素見(jiàn)表2。表2追溯參與方數(shù)據(jù)元素名稱是否必選類型備注參與方類型是String追溯所涉及的關(guān)鍵節(jié)點(diǎn)類型。取值：上游供應(yīng)商、電子商務(wù)平臺(tái)經(jīng)營(yíng)者、平臺(tái)內(nèi)經(jīng)營(yíng)者、電子商務(wù)物流服務(wù)商參與方身份標(biāo)識(shí)是String應(yīng)符合GB/T36061—2018中8.2.1的要求，可采用GLN或統(tǒng)一社會(huì)信用代碼參與方名稱是String與統(tǒng)一社會(huì)信用代碼對(duì)應(yīng)的主體名稱有效聯(lián)系人是String聯(lián)系地址是String聯(lián)系方式是String經(jīng)營(yíng)資質(zhì)否String如營(yíng)業(yè)執(zhí)照等。圖片文件采用BASE64編碼規(guī)則（應(yīng)符合IETFRFC3548的規(guī)定）轉(zhuǎn)換為字符串，或給出其URL鏈接地址字符串格式產(chǎn)品資質(zhì)否String如中國(guó)國(guó)家強(qiáng)制性產(chǎn)品認(rèn)證證書(shū)、綠色食品證書(shū)等，圖片文件采用BASE64編碼規(guī)則轉(zhuǎn)換為字符串，或給出其URL鏈接地址字符串格式其他否String視需求，可適情擴(kuò)展使用7.3追溯單元數(shù)據(jù)結(jié)構(gòu)追溯單元數(shù)據(jù)結(jié)構(gòu)見(jiàn)圖3。5GB／T39322—2020圖3追溯單元數(shù)據(jù)結(jié)構(gòu)追溯單元數(shù)據(jù)元素見(jiàn)表3。表3追溯單元數(shù)據(jù)元素名稱是否必選類型備注追溯單元類型是String追溯單元信息類型，取值與含義：GTIN—追溯貿(mào)易單元；SSCC—追溯物流單元；GSIN—追溯裝運(yùn)單元追溯單元標(biāo)識(shí)是String編碼結(jié)構(gòu)應(yīng)符合GB/T36061—2018中8.2.2的規(guī)定參與方身份標(biāo)識(shí)是String用于關(guān)聯(lián)追溯參與方生產(chǎn)／加工企業(yè)名稱是String產(chǎn)品名稱是StringGB／T39322—2020名稱是否必選類型備注生產(chǎn)批次號(hào)是String序列號(hào)否String當(dāng)追溯到單品時(shí)，必選唯一的序列號(hào)生產(chǎn)日期／包裝日期是Datetime格式為YYYY-MM-DD或YYYY-MM-DDTHH:MM:SS保質(zhì)期／有效期是String產(chǎn)品數(shù)量否Integer重量否Float否String檢驗(yàn)檢測(cè)否String產(chǎn)品圖片否String圖片文件采用BASE64編碼規(guī)則轉(zhuǎn)換為字符串，或給出其URL鏈接地址字符串格式作業(yè)環(huán)節(jié)否String如入庫(kù)、揀貨、驗(yàn)貨、出庫(kù)等作業(yè)時(shí)間否Datetime格式為YYYY-MM-DDTHH:MM:SS責(zé)任人否String其他否String視需求，可適情擴(kuò)展使用7.4追溯位置數(shù)據(jù)結(jié)構(gòu)追溯位置數(shù)據(jù)結(jié)構(gòu)見(jiàn)圖4。圖4追溯位置數(shù)據(jù)結(jié)構(gòu)追溯位置數(shù)據(jù)元素見(jiàn)表4。表4追溯位置數(shù)據(jù)元素名稱是否必選類型備注位置標(biāo)識(shí)是String宜采用GLN,其編碼結(jié)構(gòu)按GB/T36061—2018中A.1.2的規(guī)定參與方身份標(biāo)識(shí)是String用于關(guān)聯(lián)追溯參與方具體地址是String有效聯(lián)系人否String67GB／T39322—2020名稱是否必選類型備注聯(lián)系方式否String其他否String視需求，可適情擴(kuò)展使用7.5交易信息數(shù)據(jù)結(jié)構(gòu)交易信息數(shù)據(jù)結(jié)構(gòu)見(jiàn)圖5。圖5交易信息數(shù)據(jù)結(jié)構(gòu)交易信息數(shù)據(jù)元素見(jiàn)表5。表5交易信息數(shù)據(jù)元素名稱是否必選類型備注交易類型是String交易信息有效憑證和單據(jù)類型。取值：電子訂單、發(fā)貨單、支付單、發(fā)票、物流運(yùn)單交易標(biāo)識(shí)是String交易信息有效憑證和單據(jù)的唯一標(biāo)識(shí)參與方身份標(biāo)識(shí)是String用于關(guān)聯(lián)追溯參與方編號(hào)是String交易單證編號(hào)交易參與方是String交易對(duì)象的參與方名稱交易時(shí)間是Datetime格式為YYYY-MM-DDTHH:MM:SS交易方式否String交易內(nèi)容否String其他否String視需求，可適情擴(kuò)展使用8GB／T39322—20207.6其他信息數(shù)據(jù)結(jié)構(gòu)其他信息數(shù)據(jù)結(jié)構(gòu)見(jiàn)圖6。圖6其他信息數(shù)據(jù)結(jié)構(gòu)其他信息數(shù)據(jù)元素見(jiàn)表6。表6其他信息數(shù)據(jù)元素名稱是否必選類型備注其他否String視需求，可適情擴(kuò)展使用并調(diào)整類型8數(shù)據(jù)安全應(yīng)符合GB/T36318—2018中4.2和5.1.3的規(guī)定。9GB／T39322—2020附錄A（資料性附錄）JONA.1接口地址示例參見(jiàn)表A.1。表A.1接口地址A.2接口原型示例參見(jiàn)表A.2。表A.2接口原型nature)A.3功能說(shuō)明A.4參數(shù)說(shuō)明包括：1)公共參數(shù)：參見(jiàn)表A.3。表A.3公共參數(shù)表參數(shù)項(xiàng)含義是否必選類型備注method指令名稱否String接口指令的名稱version接口版本號(hào)否String默認(rèn)最新版本pageindex請(qǐng)求數(shù)據(jù)內(nèi)容當(dāng)前頁(yè)碼否Integer用于支持?jǐn)?shù)據(jù)集合分頁(yè)，默認(rèn)第1頁(yè)pagesize請(qǐng)求數(shù)據(jù)內(nèi)容每頁(yè)條數(shù)否Integer用于支持?jǐn)?shù)據(jù)集合分頁(yè)，默認(rèn)20條GB／T39322—2020表A.3（續(xù)）參數(shù)項(xiàng)含義是否必選類型備注timestamp請(qǐng)求的時(shí)間是Datetime格式為YYYY-MM-DDTHH:MM:SSnonce隨機(jī)數(shù)是String每一次請(qǐng)求宜使用不同的隨機(jī)數(shù)secretid密鑰編號(hào)是String服務(wù)端分配的安全憑證，用于標(biāo)識(shí)服務(wù)接口調(diào)用者的身份signature請(qǐng)求簽名是String用來(lái)驗(yàn)證此次請(qǐng)求的合法性，由客戶端根據(jù)實(shí)際的輸入?yún)?shù)并憑密匙按約定的簽名算法生成簽名2)業(yè)務(wù)參數(shù)：參見(jiàn)表A.4。表A.4業(yè)務(wù)參數(shù)示例表參數(shù)項(xiàng)含義是否必選類型備注traceabilitycode追溯碼是String表A.5返回參數(shù)表參數(shù)項(xiàng)含義是否必選類型備注status響應(yīng)狀態(tài)代碼否String參見(jiàn)B.1的響應(yīng)狀態(tài)代碼message響應(yīng)狀態(tài)描述是String參見(jiàn)B.1的響應(yīng)狀態(tài)描述data數(shù)據(jù)結(jié)果集是接口返回結(jié)果，各個(gè)接口自定義totalcount返回的數(shù)據(jù)條數(shù)是Integer默認(rèn)為0條resultlist返回業(yè)務(wù)數(shù)據(jù)集是根據(jù)業(yè)務(wù)的不同，返回相應(yīng)的業(yè)務(wù)數(shù)據(jù)集A.5返回說(shuō)明包括：B表A.6返回代碼示例表{"status":"0","data":{"totalcount":1,"resultlist":[{GB／T39322—2020表A.6（續(xù)）"tracesub":[{"name":"參與方名稱1","address":"聯(lián)系地址1","contact":"聯(lián)系方式1",{"name":"參與方名稱2","address":"聯(lián)系地址2","contact":"聯(lián)系方式2"{"name":"參與方名稱3","address":"聯(lián)系地址3","contact":"聯(lián)系方式3"{"name":"參與方名稱4","address":"聯(lián)系地址4","contact":"聯(lián)系方式4"],"traceunit":[{"manufacturername":"企業(yè)名稱1",GB／T39322—2020表A.6（續(xù)）"lotnumber":"批次1","manufacturedate":"生產(chǎn)日期1","shelflife":"保質(zhì)期1",{"manufacturername":"企業(yè)名稱1","lotnumber":"批次1","manufacturedate":"生產(chǎn)日期1","shelflife":"保質(zhì)期1",{"manufacturername":"企業(yè)名稱3","lotnumber":"批次3","manufacturedate":"生產(chǎn)日期3","shelflife":"保質(zhì)期3","worktime":"作業(yè)時(shí)間3"}],"traceloc":[{"contact":"聯(lián)系方式1"{"contact":"聯(lián)系方式2"GB／T39322—2020表A.6（續(xù)）{"contact":"聯(lián)系方式3"}],"tracetra":[{"identifier":"交易標(biāo)識(shí)1","orderid":"編號(hào)1","orderdatetime":"交易時(shí)間1"{"identifier":"交易標(biāo)識(shí)2","orderid":"編號(hào)2","orderdatetime":"交易時(shí)間2"{"identifier":"交易標(biāo)識(shí)3","orderid":"編號(hào)3","orderdatetime":"交易時(shí)間3"{"identifier":"交易標(biāo)識(shí)4","orderid":"編號(hào)4","orderdatetime":"交易時(shí)間4"{"identifier":"交易標(biāo)識(shí)5",GB／T39322—2020表A.6（續(xù)）"orderid":"編號(hào)5","orderdatetime":"交易時(shí)間5"}]}]}}GB／T39322—2020附錄B（資料性附錄）電子商務(wù)交易平臺(tái)追溯數(shù)據(jù)接口消息響應(yīng)狀態(tài)電子商務(wù)交易平臺(tái)追溯數(shù)據(jù)接口消息響應(yīng)狀態(tài)參見(jiàn)表B.1。表B.1電子商務(wù)交易平臺(tái)追溯數(shù)據(jù)接口消息響應(yīng)狀態(tài)響應(yīng)狀態(tài)代碼響應(yīng)狀態(tài)描述響應(yīng)狀態(tài)代碼含義0ok成功1paramerror請(qǐng)求參數(shù)錯(cuò)誤2invalidformatJSON或XML格式錯(cuò)誤3signaturefailure簽名驗(yàn)證失敗4paramlenoverlimit請(qǐng)求長(zhǎng)度／大小超過(guò)限制5requestexpired請(qǐng)求過(guò)期6replayattack重放攻擊7failedtogetdata獲取數(shù)據(jù)失敗8versionerror接口版本錯(cuò)誤9systemerror接口異?！璆B／T39322—2020[1]GB/T18391.1—2009信息技術(shù)元數(shù)據(jù)注冊(cè)系統(tǒng)(MDR)第1部分：框架[2]GB/T19581—2004信息技術(shù)會(huì)計(jì)核算軟件數(shù)據(jù)接口[3]GB/T21062.3—2007政務(wù)信息資源交換體系第3部分：數(shù)據(jù)接口規(guī)范[4]GB/T24662—2009電子商務(wù)產(chǎn)品核心數(shù)據(jù)元[5]GB/Z25320.2—2013電力系統(tǒng)管理及其信息交換數(shù)據(jù)和通信安全第2部分：術(shù)語(yǔ)[6]GB/T25597—2010地理信息萬(wàn)維網(wǎng)地圖服務(wù)接口[7]GB/T26841—2011基于電子商務(wù)活動(dòng)的交易主體企業(yè)信用檔案規(guī)范[8]GB/T29261.4—2012信息技術(shù)自動(dòng)識(shí)別和數(shù)據(jù)采集技術(shù)詞匯第4部分：無(wú)線電通信[9]GB/T29265.205—2017信息技術(shù)信息設(shè)備資源共享協(xié)同服務(wù)第205部分：遠(yuǎn)程訪問(wèn)基礎(chǔ)協(xié)議[10]GB/T29622—2013電子商務(wù)信用賣方交易信用信息披露規(guī)范[11]GB/T30996.1—