全國(guó)食鹽電子防偽追溯服務(wù)平臺(tái)接口規(guī)范（生產(chǎn)企業(yè)接口規(guī)范）第一章總則 1 1 11.4解釋權(quán)與修訂權(quán) 第二章接口定義 1 2.2接口規(guī)則說明 22.3追溯碼數(shù)據(jù)導(dǎo)出接口 2.3.1描述 2.3.2追溯碼文件名稱定義 2.3.3接口標(biāo)準(zhǔn) 2.4產(chǎn)品數(shù)據(jù)導(dǎo)出接口 42.4.1描述 42.4.2接口標(biāo)準(zhǔn) 42.4.3XMLSchema規(guī)范 52.4.4接口示例 2.5產(chǎn)品批次激活接口 2.5.1描述 2.5.2接口標(biāo)準(zhǔn) 2.5.3XMLSchema規(guī)范 122.5.4接口示例 2.6批發(fā)企業(yè)導(dǎo)出接口 2.6.1描述 2.6.2接口標(biāo)準(zhǔn) 2.6.3XMLSchema規(guī)范 182.6.4接口示例 202.7終端客戶導(dǎo)出接口 212.7.1描述 212.7.2接口標(biāo)準(zhǔn) 212.7.3接口示例 242.8工廠出庫接口 242.8.1描述 252.8.2接口標(biāo)準(zhǔn) 252.8.3XMLSchema規(guī)范 262.8.4接口示例 292.9文件傳輸規(guī)范 302.9.1文件大小 302.9.2文件拆分 302.10關(guān)聯(lián)數(shù)據(jù)校驗(yàn) 302.10.1描述 302.10.2追溯碼（20位）編碼結(jié)構(gòu) 31第一章總則本文主要規(guī)定了全國(guó)食鹽電子防偽追溯服務(wù)平臺(tái)與生產(chǎn)線客1.4解釋權(quán)與修訂權(quán)第二章接口定義指定的文本文件格式外，其他的接口均采用XML1.0的國(guó)際標(biāo)準(zhǔn)●追溯碼數(shù)據(jù)導(dǎo)出接口●產(chǎn)品數(shù)據(jù)導(dǎo)出接口●產(chǎn)品批次激活接口●批發(fā)企業(yè)導(dǎo)出接口●終端客戶導(dǎo)出接口—2—食鹽企業(yè)：食鹽企業(yè)包含食鹽定點(diǎn)生產(chǎn)企業(yè)準(zhǔn)號(hào)、產(chǎn)品類別、生產(chǎn)日期、保質(zhì)期、產(chǎn)地、產(chǎn)品核注核銷：食鹽企業(yè)產(chǎn)品質(zhì)量追溯系統(tǒng)產(chǎn)品的出入庫流向信息，企業(yè)追溯系統(tǒng)：食鹽定點(diǎn)生產(chǎn)企業(yè)的產(chǎn)品質(zhì)量追溯系統(tǒng)。做到對(duì)食鹽產(chǎn)品從原材料到生產(chǎn)、倉庫、流通等環(huán)節(jié)全程追溯。輔料：指生產(chǎn)食用鹽所需的配料，包括氯化鉀2.2接口規(guī)則說明接口定義參考xmlschema的格式進(jìn)行定義,但不同于xmlschema的語法規(guī)則,元素節(jié)點(diǎn)規(guī)則如下:<節(jié)點(diǎn)1名稱屬性1名稱（中文名稱屬性1類型可選/必選）,屬性2名稱（中文名稱屬性2類型可選/必選）,…><節(jié)點(diǎn)2名稱屬性定義…>…..</節(jié)點(diǎn)2名稱><節(jié)點(diǎn)n名稱…/></節(jié)點(diǎn)1名稱>每個(gè)節(jié)點(diǎn)都可以包含多個(gè)屬性,也可以包含下級(jí)節(jié)點(diǎn)2.3追溯碼數(shù)據(jù)導(dǎo)出接口型_是否加碘_標(biāo)簽規(guī)格_數(shù)量_生成時(shí)間”8001101999_XX制鹽_一級(jí)碼_未加碘_大標(biāo)_1000000個(gè)_2018111715125二級(jí)碼：二級(jí)碼不區(qū)分是否加碘，不區(qū)分標(biāo)簽規(guī)格8001101999_XX制_20181117151350.txt企業(yè)代碼：4位：食鹽安全信息追溯體系規(guī)范分配；食鹽定單位包裝；1代表有碘最小銷售單位包裝；年份順序號(hào)：追溯元,2016年代號(hào)01，2017年代號(hào)02，2018年代—4—）：）：2.4產(chǎn)品數(shù)據(jù)導(dǎo)出接口保證產(chǎn)品列表中的產(chǎn)品編碼與全國(guó)食鹽電子防偽追接口定義<productproductCode(產(chǎn)品編碼，processNode(生產(chǎn)過程關(guān)鍵工序控><Ingredientingredien>referenceValue(營(yíng)養(yǎng)素參考>......產(chǎn)品數(shù)據(jù)導(dǎo)出業(yè)務(wù)數(shù)據(jù)XML文件的Schema規(guī)范選NutrientList選如“袋，瓶，盒”位：月選NutrientListNutrientLis源代碼如下：<?xmlversion="1.0"encoding="<xs:schemaid="NewDataSet"xmlns=""xmlns:xs="/2001/Xxmlns:msdata="urn:schemas-microsoft-com:xml-<xs:elementname="product"minOccurs="0"maxOccurs="unbounded"><<xs:elementname="IminOccurs="0"maxOccurs="unbound<xs:elementname="Ingredient"minOccurs="0"maxOccurs<xs:attributename="ingredientName"type<xs:attributename="netContent"type= <xs:elementname="NutrientList"minOccurs="0"maxOccu<xs:elementname="Nutrient"minOccurs="0"maxOccur<xs:complexType><xs:attributename="project"type=<xs:attributename="netContent"type=<xs:attributename="referenceValue"type <xs:attributename="productCode"type=<xs:attributename="productName"type=<xs:attributename="productBra<xs:attributename="productCategory"type<xs:attributename="productType"type=<xs:attributename="unit"type=<xs:attributename="netWeight"type<xs:attributename="packMethod"type=<xs:attributename="standardCo<xs:attributename="craftWork"type<xs:attributename="processNode"type=<xs:attributename="expiryDate"type=<xs:attributename="isAddIodin"type=<xs:attributename="edibleMethod"typ<xs:attributename="kindlyR<xs:attributename="Ingredient"type=<xs:attributename="storageCondition"type=<xs:attributename="customCode"type=<xs:attributename="remark"typmsdata:IsDataSet="true"msdata:UseCurrentLo<xs:choiceminOccurs="0"maxOcc<productproductCod"unit="g"craftWork="鹵水→加料→蒸發(fā)→kindlyReminder="甲狀腺機(jī)"Ingredient="精制鹽、碘鉀"storageCondition="密>netContent="≤25mg/kg">>netContent="0.5g"referenceVal>2.5產(chǎn)品批次激活接口該接口為生產(chǎn)線端已經(jīng)將各級(jí)包裝上的追溯碼建立好關(guān)聯(lián)后，將關(guān)聯(lián)關(guān)系數(shù)據(jù)導(dǎo)出成xml格式的文件，用于中心客戶端進(jìn)行上傳到全國(guó)食鹽電子防偽追溯服務(wù)平臺(tái)。不同包裝比例，不同產(chǎn)品單獨(dú)導(dǎo)出文件。日期格式：yyyy-MM-dd文件中不同級(jí)別的碼的排列前后順序：二級(jí)碼(即大箱碼)，一級(jí)碼(即標(biāo)碼)，即先寫2級(jí)碼，再寫1級(jí)碼，不同包裝層次的以此原則類推。產(chǎn)品批次激活文件最終以zip壓縮包的格式通過平臺(tái)客戶端上傳至全國(guó)食鹽電子防偽追溯服務(wù)平臺(tái)，內(nèi)容包含批次激活XML文件，產(chǎn)品質(zhì)檢報(bào)告JPG格式文件，產(chǎn)品質(zhì)檢報(bào)告文件最多不超過3張JPG格式文件，多個(gè)文件在xml文檔中以逗號(hào)進(jìn)行分割，產(chǎn)品質(zhì)檢報(bào)告文件jpg文件總文件大小不超過4M。<Documentxmlns:xsi="/2001/XMLScxsi:noNamespaceSchemaLocation<RelationproductCode(產(chǎn)品編碼字符型必選唯一10位)，>validityDate(有效日期datetime必選格式:yyyy-MM-dd)，productionBase(生產(chǎn)基地字checkReport(產(chǎn)品質(zhì)檢報(bào)告，質(zhì)檢報(bào)號(hào)分隔，可選)，checkUser(檢>packLayer(當(dāng)前碼層次:1-一級(jí)包裝,……選Events子節(jié)點(diǎn)，區(qū)分多種事件產(chǎn)型選定義具體的追溯選選<?xmlversion="1.0"encoding="utf-8"?><xs:schemaid="NewDataSet"xmlns=""xmlns:xs="/2001/XMLSchema"xmlns:msdata="urn:schemas-microsoft-com:xml-msdata"><xs:elementname="Document"><xs:complexType><xs:sequence><xs:elementname="Events"minOccurs="0"maxOccurs="unbounded"><xs:complexType><xs:sequence><xs:elementname="Event"minOccurs="0"maxOccurs="unbounded"><xs:complexType><xs:sequence><xs:elementname="Relation"minOccurs="0"maxOccurs="unbounded"><xs:complexType><xs:sequence><xs:elementname="Batch"minOccurs="0"maxOccurs="unbounded"><xs:complexType><xs:sequence><xs:elementname="Codes"minOccurs="0"maxOccurs="unbounded"><xs:complexType><xs:sequence><xs:elementname="Code"minOccurs="0"maxOccurs="unbounded"><xs:complexType><xs:attributename="traceCode"type="xs:string"/><xs:attributename="packLayer"type="xs:string"/><xs:attributename="parentCode"type="xs:string"/></xs:complexType></xs:element></xs:sequence></xs:complexType></xs:element></xs:sequence><xs:attributename="batchCode"type="xs:string"/><xs:attributename="productDate"type="xs:string"/><xs:attributename="validityDate"type="xs:string"/><xs:attributename="productionBase"type="xs:string"/><xs:attributename="workShop"type="xs:string"/><xs:attributename="productLine"type="xs:string"/><xs:attributename="manager"type="xs:string"/><xs:attributename="checkReport"type="xs:string"/><xs:attributename="checkUser"type="xs:string"/></xs:complexType></xs:element></xs:sequence><xs:attributename="productCode"type="xs:string"/><xs:attributename="packRule"type="xs:string"/><xs:attributename="packSpec"type="xs:string"/><xs:attributename="checkReporttype="xs:string"/></xs:complexType></xs:element></xs:sequence><xs:attributename="name"type="xs:string"/></xs:complexType></xs:element></xs:sequence><xs:attributename="version"type="xs:string"/></xs:complexType></xs:element></xs:sequence><xs:attributename="License"type="xs:string"/></xs:complexType></xs:element><xs:elementname="NewDataSet"msdata:IsDataSet="true"msdata:UseCurrentLocale="true"><xs:complexType><xs:choiceminOccurs="0"maxOccurs="unbounded"><xs:elementref="Document"/></xs:choice></xs:complexType></xs:element></xs:schema><?xmlversion="1.0"encoding="utf-8"?><Documentxmlns:xsi="/2001/XMLSchema-instance"xsi:noNamespaceSchemaLocation="產(chǎn)品批次激活BatchActive.xsd"License="License"><Eventsversion="3.0"><Eventname="BatchActive"><RelationproductCode="8001003001"packRule="1:10"packSpec="3<BatchbatchCode="20181202001"productDate="2018-12-02"validityDate="2019-12-01"productionBase="xx制鹽基地"workShop="一班"productLine="測(cè)試生產(chǎn)線"manager="李井平"checkReport="產(chǎn)品檢驗(yàn)報(bào)告.jpg"checkUser="王碩"><Codes><CodetraceCode="80011016580000811667"packLayer="2"/><CodetraceCode="80011016580000457668"packLayer="1"parentCode="80011016580000811667"/><CodetraceCode="80011016580000358669"packLayer="1"parentCode="80011016580000811667"/><CodetraceCode="80011016580000951666"packLayer="1"parentCode="80011016580000811667"/><CodetraceCode="80011016580000158665"packLayer="1"parentCode="80011016580000811667"/><CodetraceCode="80011016580000753663"packLayer="1"parentCode="80011016580000811667"/><CodetraceCode="80011016580000753660"packLayer="1"parentCode="80011016580000811667"/><CodetraceCode="80011016580000365661"packLayer="1"parentCode="80011016580000811667"/><CodetraceCode="80011016580000758664"packLayer="1"parentCode="80011016580000811667"/><CodetraceCode="80011016580000453662"packLayer="1"parentCode="80011016580000811667"/><CodetraceCode="80011016580000895657"packLayer="1"parentCode="80011016580000811667"/></Codes></Batch></Relation></Event></Events></Document>2.6批發(fā)企業(yè)導(dǎo)出接口注冊(cè)流程等有更新，涉及到新舊數(shù)據(jù)兼容，某些字段進(jìn)行了載批發(fā)企業(yè)數(shù)據(jù)文件進(jìn)行企業(yè)生產(chǎn)線系統(tǒng)中批發(fā)接口定義provCode(省字符型必選)，cityCode(市字符型必選)，areaCode(縣字符型必選)，......批發(fā)企業(yè)數(shù)據(jù)導(dǎo)出業(yè)務(wù)數(shù)據(jù)XML文件的Schema規(guī)范，各節(jié)節(jié)點(diǎn)名稱節(jié)點(diǎn)含義節(jié)點(diǎn)屬性下級(jí)節(jié)點(diǎn)舉例：選y<?xmlversion="1.0"enc<xs:schemaid="NewDataSet"xmlns=""xmlns:xs="/2001/Xxmlns:msdata="urn:schemas-microsoft-com:xml-<xs:elementname="sal<xs:elementname="saleCompany"minOccurs="0"maxOccu<xs:attributename="saleCode"type<xs:attributename="saleName"type<xs:attributename="spellName"type<xs:attributename="superCompany"type="<xs:attributename="supervisionCompany"typ<xs:attributename="provCode"type<xs:attributename="cityCode"ty/><xs:attributename="areaCode"type="xs:st<xs:attributename="address"type<xs:attributename="legalor"type<xs:attributename="registFund"type=<xs:attributename="status"typ<xs:attributename="remark"typ—20—msdata:IsDataSet="true"<xs:choiceminOccurs="0"maxOcc<xs:elementref="sale—21—></saleCompanyList>2.7終端客戶導(dǎo)出接口新的功能，以保證終端客戶信息的正確性與一致性，生產(chǎn)企業(yè)在平臺(tái)進(jìn)行數(shù)據(jù)下載終端客戶數(shù)據(jù)文件進(jìn)行企業(yè)生產(chǎn)線系統(tǒng)中終端接口定義—22—終端客戶數(shù)據(jù)導(dǎo)出業(yè)務(wù)數(shù)據(jù)XML文件的Schema節(jié)點(diǎn)名稱節(jié)點(diǎn)含義節(jié)點(diǎn)屬性下級(jí)節(jié)點(diǎn)舉例：文檔根節(jié)點(diǎn)<xs:schemaid="NewDxmlns:xs="/2001/Xxmlns:msdata="urn:schemas-microsoft-com:—23—<xs:elementname="Terminal"minOccurs="0"maxOccur<xs:attributename="terminalCode"typ<xs:attributename="terminalName"typ<xs:attributename="provCode"type<xs:attributename="address"type<xs:attributename="chargePerson"typ<xs:attributename="telephone"type<xs:attributename="mobile"typ<xs:attributename="email"typ<xs:attributename="customCode"ty<xs:attributename="remark"typ<xs:attributename="version"type="xs:string"/>msdata:IsDataSet="trumsdata:UseCurrentLocale="true<xs:choiceminOccurs="0"maxOccurs—24—<TerminalterminalCodeareaCode="370911">—25—該接口為生產(chǎn)企業(yè)銷售出庫后，將工廠出庫數(shù)據(jù)導(dǎo)出成xml格式的文件，用于中心客戶端進(jìn)行上傳到全國(guó)食鹽電子防偽追溯服務(wù)平臺(tái)。不同包裝比例，不同產(chǎn)品單獨(dú)導(dǎo)出文件。日期格式：yyyy-MM-dd<Documentxmlns:xsi="/2001/XMLSchema-instance"xsi:noNamespaceSchemaLocation="工廠出庫FactorySales.xsd"License="License"><RelationtoCompanyCode(去向企業(yè)編碼字符型必選去向企業(yè)類型：批>>……—26—從生產(chǎn)線導(dǎo)入業(yè)務(wù)數(shù)據(jù)XML文件必須符合我方提供的Schema規(guī)范，各節(jié)點(diǎn)注釋如下表：節(jié)點(diǎn)名稱節(jié)點(diǎn)含義節(jié)點(diǎn)屬性下級(jí)節(jié)點(diǎn)舉例：選—27—<xs:schemaid="NewDataSet"xmlns=""xmlns:xs="/2001/Xxmlns:msdata="urn:schemas-microsoft-com:xml-name="Document"><xs:comp<xs:elementname="Events"minOccurs="0"maxOccu<xs:elementname="Event"minOccurs="<xs:elementname="RelatiomaxOccurs="unbounde<xs:elementname="Batch"minOccurs="0"maxOccu<xs:elementname="Codes"minOccurs="0"maxOccu—28—<xs:elementname="Code"minOccurs="0"maxOccurs="unbounded"><xs:attributename="<xs:attributename="<xs:attributename="name"type=—29—<xs:attributename="version"type<xs:attributename="License"type="</xs:element><xs:elementnammsdata:IsDataSet="trumsdata:UseCurrentLocale="true"><xs:complexT><xs:choiceminOccurs="0"maxOccurs<?xmlversion="1.0"encoding="utf-8"?><Document