全国食盐电子防伪追溯服务平台接口规范

全国食盐电子防伪追溯服务平台接口规范（生产企业接口规范）第一章总则 1 1 11.4解释权与修订权 第二章接口定义 1 2.2接口规则说明 22.3追溯码数据导出接口 2.3.1描述 2.3.2追溯码文件名称定义 2.3.3接口标准 2.4产品数据导出接口 42.4.1描述 42.4.2接口标准 42.4.3XMLSchema规范 52.4.4接口示例 2.5产品批次激活接口 2.5.1描述 2.5.2接口标准 2.5.3XMLSchema规范 122.5.4接口示例 2.6批发企业导出接口 2.6.1描述 2.6.2接口标准 2.6.3XMLSchema规范 182.6.4接口示例 202.7终端客户导出接口 212.7.1描述 212.7.2接口标准 212.7.3接口示例 242.8工厂出库接口 242.8.1描述 252.8.2接口标准 252.8.3XMLSchema规范 262.8.4接口示例 292.9文件传输规范 302.9.1文件大小 302.9.2文件拆分 302.10关联数据校验 302.10.1描述 302.10.2追溯码（20位）编码结构 31第一章总则本文主要规定了全国食盐电子防伪追溯服务平台与生产线客1.4解释权与修订权第二章接口定义指定的文本文件格式外，其他的接口均采用XML1.0的国际标准●追溯码数据导出接口●产品数据导出接口●产品批次激活接口●批发企业导出接口●终端客户导出接口—2—食盐企业：食盐企业包含食盐定点生产企业准号、产品类别、生产日期、保质期、产地、产品核注核销：食盐企业产品质量追溯系统产品的出入库流向信息，企业追溯系统：食盐定点生产企业的产品质量追溯系统。做到对食盐产品从原材料到生产、仓库、流通等环节全程追溯。辅料：指生产食用盐所需的配料，包括氯化钾2.2接口规则说明接口定义参考xmlschema的格式进行定义,但不同于xmlschema的语法规则,元素节点规则如下:<节点1名称属性1名称（中文名称属性1类型可选/必选）,属性2名称（中文名称属性2类型可选/必选）,…><节点2名称属性定义…>…..</节点2名称><节点n名称…/></节点1名称>每个节点都可以包含多个属性,也可以包含下级节点2.3追溯码数据导出接口型_是否加碘_标签规格_数量_生成时间”8001101999_XX制盐_一级码_未加碘_大标_1000000个_2018111715125二级码：二级码不区分是否加碘，不区分标签规格8001101999_XX制_20181117151350.txt企业代码：4位：食盐安全信息追溯体系规范分配；食盐定单位包装；1代表有碘最小销售单位包装；年份顺序号：追溯元,2016年代号01，2017年代号02，2018年代—4—）：）：2.4产品数据导出接口保证产品列表中的产品编码与全国食盐电子防伪追接口定义<productproductCode(产品编码，processNode(生产过程关键工序控><Ingredientingredien>referenceValue(营养素参考>......产品数据导出业务数据XML文件的Schema规范选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="卤水→加料→蒸发→kindlyReminder="甲状腺机"Ingredient="精制盐、碘钾"storageCondition="密>netContent="≤25mg/kg">>netContent="0.5g"referenceVal>2.5产品批次激活接口该接口为生产线端已经将各级包装上的追溯码建立好关联后，将关联关系数据导出成xml格式的文件，用于中心客户端进行上传到全国食盐电子防伪追溯服务平台。不同包装比例，不同产品单独导出文件。日期格式：yyyy-MM-dd文件中不同级别的码的排列前后顺序：二级码(即大箱码)，一级码(即标码)，即先写2级码，再写1级码，不同包装层次的以此原则类推。产品批次激活文件最终以zip压缩包的格式通过平台客户端上传至全国食盐电子防伪追溯服务平台，内容包含批次激活XML文件，产品质检报告JPG格式文件，产品质检报告文件最多不超过3张JPG格式文件，多个文件在xml文档中以逗号进行分割，产品质检报告文件jpg文件总文件大小不超过4M。<Documentxmlns:xsi="/2001/XMLScxsi:noNamespaceSchemaLocation<RelationproductCode(产品编码字符型必选唯一10位)，>validityDate(有效日期datetime必选格式:yyyy-MM-dd)，productionBase(生产基地字checkReport(产品质检报告，质检报号分隔，可选)，checkUser(检>packLayer(当前码层次:1-一级包装,……选Events子节点，区分多种事件产型选定义具体的追溯选选<?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="产品批次激活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="测试生产线"manager="李井平"checkReport="产品检验报告.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批发企业导出接口注册流程等有更新，涉及到新旧数据兼容，某些字段进行了载批发企业数据文件进行企业生产线系统中批发接口定义provCode(省字符型必选)，cityCode(市字符型必选)，areaCode(县字符型必选)，......批发企业数据导出业务数据XML文件的Schema规范，各节节点名称节点含义节点属性下级节点举例：选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终端客户导出接口新的功能，以保证终端客户信息的正确性与一致性，生产企业在平台进行数据下载终端客户数据文件进行企业生产线系统中终端接口定义—22—终端客户数据导出业务数据XML文件的Schema节点名称节点含义节点属性下级节点举例：文档根节点<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—该接口为生产企业销售出库后，将工厂出库数据导出成xml格式的文件，用于中心客户端进行上传到全国食盐电子防伪追溯服务平台。不同包装比例，不同产品单独导出文件。日期格式：yyyy-MM-dd<Documentxmlns:xsi="/2001/XMLSchema-instance"xsi:noNamespaceSchemaLocation="工厂出库FactorySales.xsd"License="License"><RelationtoCompanyCode(去向企业编码字符型必选去向企业类型：批>>……—26—从生产线导入业务数据XML文件必须符合我方提供的Schema规范，各节点注释如下表：节点名称节点含义节点属性下级节点举例：选—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