DB4403∕T 249-2022 进口冷链食品追溯数据接口规范(深圳市)

《DB4403∕T 249-2022 进口冷链食品追溯数据接口规范(深圳市)》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

ICS35.240.01CCSL78DB4403深圳市地方标准DB4403/T249—2022进口冷链食品追溯数据接口规范Datainterfacespecificationofimportedcold-chainfoodtraceability2022-07-29发布2022-08-01实施深圳市市场监督管理局发布

1

2DB4403/T249—2022目次前言.....................................................................................................................................................................II1范围.................................................................................................................................................................12规范性引用文件............................................................................................................................................13术语和定义....................................................................................................................................................14缩略语.............................................................................................................................................................15基本要求........................................................................................................................................................26接口类型........................................................................................................................................................27接口关系........................................................................................................................................................28接口描述........................................................................................................................................................2附录A（资料性）接口响应码说明.............................................................................................................11附录B（资料性）追溯数据对接实例.........................................................................................................12附录C（资料性）企业类型及编码说明.....................................................................................................13附录D（资料性）资质证照类型及编码.....................................................................................................14附录E（资料性）产品分类及编码.............................................................................................................15参考文献.............................................................................................................................................................17I

3DB4403/T249—2022前言本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由深圳市市场监督管理局提出并归口。本文件起草单位：深圳市市场监督管理局、深圳市标准技术研究院。本文件主要起草人：李颖、徐立峰、练晓、吕恺文、王恒、苏巍、陈瑜、周哲、陈炜霖、陈利平、施伟、林智明。II

4DB4403/T249—2022进口冷链食品追溯数据接口规范1范围本文件规定了进口冷链食品追溯系统数据接口的基本要求、接口类型、接口关系、接口描述。本文件适用于企业、技术机构、监管部门在进口冷链食品追溯系统间的数据对接。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T7408数据元和交换格式信息交换日期和时间表示法GB12904商品条码零售商品编码与条码表示GB32100法人和其他组织统一社会信用代码编码规则DB4403/T191—2021食用农产品追溯码编码技术规范IETFRFC2818TLS上的HTTP（HTTPoverTLS）IETFRFC3548Base16，Base32，Base64数据编码（TheBase16，Base32，andBase64dataencodings）IETFRFC3629UTF-8，ISO10646转换格式（UTF-8，atransformationformatofISO10646）3术语和定义下列术语和定义适用于本文件。3.1冷链食品cold-chainfood通过冷链实现物流过程运输的果蔬类、水产类、肉制品类、禽蛋类、乳制品、粮食类等易腐食品及其加工制品等食品。注：包括冷冻食品和冷藏食品。3.2追溯系统traceabilitysystem基于追溯码、文件记录、相关软硬件设备和通信网络，实现现代信息化管理并可获取产品追溯过程中相关数据的集成。[来源：GB/T38155—2019，2.6]3.3集中监管仓centralizedsupervisionwarehouse具备进口冷链食品（3.1）相关疫情集中排查、集中管控、集中处置和产品外包装预防性消毒功能的场所。4缩略语下列缩略语适用于本文件。GS1：国际物品编码协会（GlobalStandards1）HTTPS：以安全为目标的HTTP通道（HyperTextTransferProtocoloverSecureSocketLayer）JSON：一种轻量级的数据交换格式（JavaScriptObjectNotation）UTF-8：一种可变长度字符编码（8-bitUnicodeTransformationFormat）1

5DB4403/T249—20225基本要求接口通过服务调用实现信息交换，应符合下列要求：——采用IETFRFC2818规定的HTTPS协议作为底层承载协议；——采用IETFRFC3629规定的UTF-8字符集；——采用GB/T7408规定的日期类型；——采用IETFRFC3548规定的Base64编码规则将图片文件转换为字符串；——接口请求与接口响应均采用JSON数据格式；——建立接口日志记录，能识别数据异常或追溯交换数据情况；——发生错误时，通过接口将详细的错误信息返回至相关平台和节点系统，由相应平台和节点系统对错误进行记录分析和整改。6接口类型进口冷链食品追溯系统数据接口主要包括下列类型：——主体信息类，包括但不限于主体信息类参数；——产品信息类，包括但不限于产品品类信息、产品批次信息、入境货物检验检疫证明信息、海关进口货物报关单信息、消毒证明信息、核酸检测证明信息、集中监管仓出库证明信息；——冷库信息类，包括但不限于冷库信息类参数；——追溯信息类，包括但不限于集中监管仓信息、收发货信息、出入库信息、运输信息。7接口关系进口冷链食品追溯系统数据接口关系如图1所示。图1数据接口关系8接口描述8.1接口请求2

6DB4403/T249—2022接口请求参数说明见表1。表1接口请求参数头部参数含义类型说明接口调用方唯一标识，每个调用方会分配一个appid和一个appid调用编码字符型appsecrettimestamp请求时间日期时间型时间戳nonce随机字符串字符型随机串（不少于10位）signature请求签名字符型接口调用授权密钥，SHA-256加密8.2接口响应接口响应参数说明见表2。表2接口响应参数参数名含义类型说明Success响应结果字符型是否成功Message响应信息字符型提示信息Code响应编码数字型接口响应码，见附录ATimestamp响应时间日期时间型时间戳Result响应数据参数字符型接口以JSON格式返回参数值，见附录B8.3业务接口说明8.3.1主体信息类接口说明主体信息类参数见表3。表3主体信息类参数字段名含义类型说明通过统一社会信用代码获取企业注册Ent_name企业名称字符型名称18位统一社会信用代码，按照GBUnif_soci_cred_code统一社会信用代码字符型32100确定的编码规则Contact联系人字符型—Contact_phone联系电话字符型—Legal_person法人代表字符型—Office_address地址字符型—Addr_districts所属区划字符型具体到省、市、区、街道Ent_type_code企业类型字符型企业类型及编码说明见附录C将图片转为Base64编码格式存储，具Ent_img资质证照字符型体的资质证照类型见附录D8.3.2产品信息类接口说明3

7DB4403/T249—20228.3.2.1产品品类信息接口产品品类信息参数见表4。表4产品品类信息参数字段名含义类型说明商品条码采用GS1编码，应符合GB12904中商品条码的编码规则；产品编Product_library_id商品条码/产品编码字符型码为系统自动生成的产品品类编码，编码规则应按照DB4403/T191—2021中第6章规定的编码方案Product_name产品名称字符型实物产品标签上的产品名称追溯系统二级分类代码，产品分类及Product_category产品类型字符型编码见附录ECountry原产国字符型产品输出国家Life_number保质期限数字型—Life_unit保质期单位字符型保质期以年、月或日为单位Specification规格数字型—Specification_unit规格单位字符型单位为千克（kg）、克（g）Registration_number生产企业注册号字符型产品原产国生产企业注册号Manufacturer生产企业名称字符型产品原产国生产企业名称Product_label产品标签图片字符型将图片转为Base64编码格式存储Product_img产品图片字符型将图片转为Base64编码格式存储8.3.2.2产品批次信息接口产品批次信息参数说明见表5，产品批次对应的入境货物检验检疫证明信息说明、海关进口货物报关单信息说明、消毒证明信息说明、核酸检测证明信息说明、集中监管仓出库证明信息说明分别见表6、表7、表8、表9、表10。表5产品批次信息参数字段名含义类型说明商品条码采用GS1编码，应符合GB12904中商品条码的编码规则；产品编Product_library_id商品条码/产品编码字符型码为系统自动生成的产品品类编码，编码规则应按照DB4403/T191—2021中第6章规定的编码方案Product_name产品名称字符型实物产品标签上的产品名称Container_number货柜编号字符型装载该批货物的货柜编号编码规则应按照DB4403/T191—2021Trace_code批次追溯码字符型中第6章规定的追溯码编码方案Batch实际批次字符型实物产品标签上的生产批号Number_of_pieces首次入库件数数字型—Weight首次入库重量字符型单位为千克（kg）Inventory_pieces库存件数数字型可发货件数Production_date生产日期日期时间型格式为YYYY-MM-DD4

8DB4403/T249—2022表5产品批次信息参数（续）字段名含义类型说明可发货件数重量总和，单位为千克Inventory_weight库存重量字符型（kg）Storage_name存放冷库名称字符型—表6入境货物检验检疫证明信息字段名含义类型说明Batch批次字符型入境货物检验检疫证明生产批号进口冷链食品国际贸易中从境外发货Consignee收货人字符型人处接收货物并承担相应责任的组织进口冷链食品国际贸易中向国内收货Consignor发货人字符型方提供产品的境外组织Date_ofentry入境日期日期时间型格式为YYYY-MM-DDPort_of_entry入境口岸字符型—Quarantine_number入境货物检验检疫证明编号数字型15、18或21位数字编码Quarantine_img入境货物检验检疫证明图片字符型将图片转为Base64编码格式存储表7海关进口货物报关单信息字段名含义类型说明消费使用单位为已知的进口货物在境Consumer_enterprises消费使用单位字符型内的最终消费、使用单位的名称或委托进出口企业进口货物的单位Customs_number海关编号数字型报关单上的海关编号Waybill_number提运单号字符型进出口货物提单或运单的编号Consumer_img报关单图片字符型将图片转为Base64编码格式存储表8消毒证明信息字段名含义类型说明Disinfect_date消毒日期日期时间型格式为YYYY-MM-DDPlace_of_disinfection消毒实施地字符型分为市场、冷库、海关口岸和其他Disinfect_number消毒编号字符型消毒证明唯一标识消毒状态为已消毒和未消毒，1代表已Disinfect_state消毒状态字符型消毒，0代表未消毒Disinfect_img消毒证明图片字符型将图片转为Base64编码格式存储表9核酸检测证明信息字段名含义类型说明Na_result核酸检测结果字符型阴性或阳性5

9DB4403/T249—2022表9核酸检测证明信息（续）字段名含义类型说明Na_date核酸检测日期日期时间型格式为YYYY-MM-DDNa_unit核酸检测单位字符型实施核酸检测的单位名称Verify_mode检验模式字符型核酸检测覆盖或企业自行委托Na_img核酸检测证明图片字符型将图片转为Base64编码格式存储表10集中监管仓出库证明信息字段名含义类型说明Certificate_number集中监管仓出库证明编号数字型数字编码Certificate_date出库证明日期日期时间型格式为YYYY-MM-DDCertificate_img集中监管仓出库证明图片字符型将图片转为Base64编码格式存储8.3.3冷库信息类接口说明冷库信息类参数见表11。表11冷库信息类参数字段名含义类型说明18位统一社会信用代码，按照GBUnif_soci_cred_code统一社会信用代码字符型32100确定的编码规则该冷库在本市唯一备案编号，外地冷Code编号字符型库可以为空Name名称字符型—Address地址字符型—Addr_districts所属区划字符型具体到省、市、区、街道Usablearea可用面积字符型单位为平方米Storage_variety贮存种类字符型—Inventory库存量字符型单位为吨Contact联系人字符型—Contact_phone联系电话字符型—冷库类型分为自营自用、第三方、集Type类型字符型中仓三种类型8.3.4追溯信息类接口说明8.3.4.1集中监管仓信息接口集中监管仓信息参数见表12。表12集中监管仓信息参数字段名含义类型说明Container_number货柜编号字符型装载该批货物的货柜编号6

10DB4403/T249—2022表12集中监管仓信息参数（续）字段名含义类型说明Customs_img报关单图片地址字符型图片以URL形式展示Customs_number海关编号字符型也称报关单号，报关单上的海关编号Nucleic_result抽样核酸检测结果字符型阴性Specification规格数字型—Specification_unit规格单位字符型单位为千克（kg）、克（g）Pieces件数数字型—Dataid推送数据编码字符型对推送数据分配的唯一标识Nucleic_number核酸编号字符型—Cold_name冷库名称字符型—Production_batch生产批号字符型—18位统一社会信用代码，按照GBUnif_soci_cred_code统一社会信用代码字符型32100确定的编码规则Brand品名字符型—Nucleic_item核酸项目字符型外包装、内包装、物品表面Certificate_date出库证明日期日期时间型格式为YYYY-MM-DDDisinfect_data消毒日期日期时间型格式为YYYY-MM-DDPlaceorigin原产国字符型产品输出国家Instockno入库单号字符型—Disinfect_result消毒结果字符型已消毒或未消毒Shipper_name货主名称字符型—Product_number商品编号数字型—Certificate_number出库证明编号数字型—Gross_weight毛重字符型单位为千克（kg）Nucleic_data核酸检测日期日期时间型格式为YYYY-MM-DDGoods_flow商品流向字符型—Certificate_img监管仓出库证明图片字符型将图片转为Base64编码格式存储8.3.4.2发货信息接口说明发货信息参数见表13。同一个发货单号可对应多个发货产品，发货产品详情见表14。表13发货信息参数字段名含义类型说明Send_number发货单号字符型系统自动分配的唯一标识Send_time发货日期日期时间型格式为YYYY-MM-DDReceiver_ent_name客户名称字符型—Receive_contact收货方联系人字符型—Receive_contact_phone收货方联系电话字符型—Receive_address收货地址字符型—7

11DB4403/T249—2022表13发货信息参数（续）字段名含义类型说明Product_list发货产品详情数组型发货产品信息，可为多个产品，见表14表14发货产品详情字段名含义类型说明该冷库在本市唯一备案编号，外地冷库storage_number冷库编号字符型可以为空storage_name冷库名称字符型—商品条码采用GS1编码，应符合GB12904中商品条码的编码规则；产品编product_library_id商品条码/商品编码字符型码为系统自动生成的产品品类编码，编码规则应按照DB4403/T191—2021中第6章规定的编码方案product_name产品名称字符型实物产品标签上的产品名称batch实际批次字符型实物产品标签上的生产批号production_date生产日期日期时间型格式为YYYY-MM-DDnumber_of_pieces件数数字型—specification规格数字型—Specification_unit规格单位字符型单位为千克（kg）、克（g）weight净重字符型单位为千克（kg）container_number货柜编号字符型装载该批货物的货柜编号8.3.4.3收货信息接口说明收货信息参数见表15。表15收货信息参数字段名含义类型说明Receiver_number收货单号字符型系统自动分配的唯一标识Send_time发货日期日期时间型格式为YYYY-MM-DDReceive_time收货日期日期时间型格式为YYYY-MM-DDSend_ent_name发货方名称字符型—Send_contact发货方联系人字符型—Send_contact_phone发货方联系电话字符型—收货产品信息，可为多个产品，与上游Product_list收货产品详情数组型发货产品信息一致，见表148.3.4.4入库信息接口说明冷库入库信息参数见表16。同一个入库单号可对应多个入库产品，入库产品详情见表17。8

12DB4403/T249—2022表16入库信息参数字段名含义类型说明In_stock_code入库码字符型系统自动分配的唯一标识In_stock_date入库时间日期时间型格式为YYYY-MM-DDSend_contact货主联系人字符型—Send_ent_name货主名称字符型—Send_contact_phone货主联系电话字符型—Product_list入库产品详情数组型入库产品信息，见表17表17入库产品详情字段名含义类型说明商品条码采用GS1编码，应符合GB12904中商品条码的编码规则；产品product_library_id商品条码/商品编码字符型编码为系统自动生成的产品品类编码，编码规则应按照DB4403/T191—2021中第6章规定的编码方案product_name产品名称字符型实物产品标签上产品名称batch实际批次字符型实物产品标签上的生产批号production_date生产日期日期时间型格式为YYYY-MM-DDnumber_of_pieces实际入库件数数字型—specification规格数字型—Specification_unit规格单位字符型单位为千克（kg）、克（g）weight净重字符型单位为千克（kg）container_number货柜编号字符型装载该批货物的货柜编号8.3.4.5出库信息接口说明冷库出库信息参数见表18。同一个出库单号可对应多个出库产品，出库产品详情见表19。表18出库信息参数字段名含义类型说明Outstock_code出库码字符型系统自动分配的唯一标识Out_stock_date出库时间日期时间型格式为YYYY-MM-DDSend_ent_name货主名称字符型—Send_contact货主联系人字符型—Send_contact_phone货主联系电话字符型—Receiver_ent_name收货方名称字符型—Receive_contact收货方联系人字符型—该冷库在本市唯一备案编号，外地冷Out_stock_storage_number出库存冷库编号字符型库可以为空Receive_contact_phone收货方联系电话字符型—Out_stock_storage_name出库存冷库名称字符型—9

13DB4403/T249—2022表18出库信息参数（续）字段名含义类型说明Product_list出库产品详情数组型出库产品信息，见表19表19出库产品详情字段名含义类型说明商品条码采用GS1编码，应符合GB12904中商品条码的编码规则；产品编product_library_id商品条码/商品编码字符型码为系统自动生成的产品品类编码，编码规则应按照DB4403/T191—2021中第6章规定的编码方案product_name产品名称字符型实物产品标签上产品名称batch实际批次字符型实物产品标签上的生产批号production_date生产日期日期时间型格式为YYYY-MM-DDnumber_of_pieces实际出库件数数字型—specification规格数字型—Specification_unit规格单位字符型单位为千克（kg）、克（g）weight净重字符型单位为千克（kg）8.3.4.6运输车辆信息接口说明运输车辆信息参数见表20。表20运输车辆信息参数字段名含义类型说明Licenseplate车牌字符型—Driver_name司机姓名字符型—Driver_contact_phone司机联系电话字符型—10

14DB4403/T249—2022附录A（资料性）接口响应码说明接口响应码见表A.1。表A.1接口响应码及状态说明状态码状态说明200服务器已成功处理请求401未获得登录授权或令牌失效403服务器拒绝请求404服务器找不到请求的接口或页面500服务器遇到错误，无法完成请求502服务器作为网关或代理，从上游服务器收到无效响应503服务器目前无法使用（由于超载或停机维护）504服务器作为网关或代理，但是没有及时从上游服务器收到请求11

15DB4403/T249—2022附录B（资料性）追溯数据对接实例下面以产品批次信息接口为例演示接口JSON实例。{"success":true,"message":"","code":200,"result":{"productLibraryId":"17896448006462","productName":"冷冻鸡两节翅","containerNo":"MNBU3167382","parentTraceCode":"0117896448006462101138885683196","traceCode":"0117896448006462101138896901150","batch":"L1","weight":13500.00,"productionDate":"2021-02-08","inventory":501,"inventoryWeight":7515.00,"StorageName":深圳市龙岗区同城食品配送行,"quarantineInfo":{"batch":"BY9066","consignee":"深圳业俊贸易有限公司","consignor":"COOPAVELCOOPERATTVAAGROINDUSTRIAL","dateOfentry":"2021-07-16","portOfEntry":"盐田","quarantineNumber":"531620211160071009001","Quarantineimg":"data:image/jpg;Base64+Base64转换码",}"customsInfo":{"consumerEnterprises":"深圳市业俊贸易有限公司","customsNo":"531620211160071009","waybillNumber":"608370090","Consumerimg":"data:image/jpg;Base64+Base64转换码",}"disinfectInfo":{"disinfectDate":"2021-07-18","placeOfDisinfection":"CustomsPort","disinfectNumber":"HL20210718YL1","disinfectState":1,"Disinfectimg":"data:image/jpg;Base64+Base64转换码",}"nucleicInfo":{"naResult":"阴性","naDate":"2021-07-18","naUnit":"广州市赛泰特医学检验实验室","verifyMode":"SelfCheck","Disinfectimg":"data:image/jpg;Base64+Base64转换码",}}12

16DB4403/T249—2022附录C（资料性）企业类型及编码说明企业类型及编码见表C.1。表C.1企业类型及编码编码企业分类01食品生产企业06农批市场07贸易公司09农贸市场11零售商超14餐饮服务单位19冷库29其他13

17DB4403/T249—2022附录D（资料性）资质证照类型及编码资质证照类型及编码见表D.1。表D.1资质证照类型及编码类型编码类型名称01营业执照02事业单位法人证书03中华人民共和国民办学校办学许可证04民办非企业单位登记证书20食品经营许可证21食品生产许可证39其他资质证照14

18DB4403/T249—2022附录E（资料性）产品分类及编码产品分类及编码见表E.1。表E.1产品分类及编码编码产品大类产品中类0401肉制品热加工熟肉制品0402肉制品发酵肉制品0403肉制品预制调理肉制品0404肉制品腌腊肉制品0501乳制品液体乳0502乳制品乳粉0503乳制品其他乳制品0601饮料包装饮用水0602饮料碳酸饮料（汽水）0603饮料茶类饮料0604饮料果蔬汁类及其饮料0605饮料蛋白饮料0606饮料固体饮料0607饮料其他饮料1001冷冻饮品冷冻饮品1101速冻食品速冻面米制品1102速冻食品速冻调制食品1103速冻食品速冻其他食品2201水产制品干制水产品2202水产制品盐渍水产品2203水产制品鱼糜及鱼糜制品2204水产制品冷冻水产制品2205水产制品熟制水产品2206水产制品生食水产品2207水产制品其他水产品4101蔬菜叶菜类蔬菜4102蔬菜根茎类蔬菜4103蔬菜瓜豆茄类蔬菜4104蔬菜食用菌4105蔬菜其他蔬菜4201水果热带和亚热带水果4202水果浆果和其他小型水果4203水果瓜果类水果4204水果柑橘类水果4205水果核果类水果4206水果仁果类水果4207水果其他水果4301猪肉及其副产品鲜肉4302猪肉及其副产品冷鲜肉4303猪肉及其副产品冻肉15

19DB4403/T249—2022表E.1产品分类及编码（续）编码产品大类产品中类4304猪肉及其副产品猪副产品4401禽肉及其副产品鸡肉4402禽肉及其副产品鸭肉4403禽肉及其副产品其他禽肉4404禽肉及其副产品鸡蛋4405禽肉及其副产品其他禽蛋4406禽肉及其副产品其他禽副产品4501其他畜肉及其副产品牛肉4502其他畜肉及其副产品羊肉4503其他畜肉及其副产品兔肉4504其他畜肉及其副产品驴肉4505其他畜肉及其副产品马肉4506其他畜肉及其副产品其他畜肉4507其他畜肉及其副产品其他畜副产品4601水产品海水鱼4602水产品海水虾4603水产品海水蟹4604水产品淡水鱼4605水产品淡水虾4606水产品淡水蟹4607水产品贝类4608水产品其他水产品16

20DB4403/T249—2022参考文献[1]GB/T18391.1—2009信息技术元数据注册系统（MDR）第1部分：框架[2]GB/T38155—2019重要产品追溯追溯术语[3]IETFRFC1421Internet电子邮件的隐私增强：第1部分：邮件加密和身份验证过程（PrivacyEnhancementforInternetElectronicMail:PartI:MessageEncryptionandAuthenticationProcedures）[4]广东省农贸市场疫情防控专班.广东省农贸市场疫情防控专班关于推进进口冷链食品冷库新冠病毒疫情防控“十必须”的通知：粤市监[2020]96号[5]深圳市新型冠状病毒肺炎疫情防控指挥部办公室.深圳市进口冷冻肉制品和水产品集中监管仓工作方案：深防疫指办[2020]80号━━━━━━A━━━━━17