DB4403T 249-2022 进口冷链食品追溯数据接口规范.pdf

ICS 35.240.01CCS L 78DB4403深圳市地方标准DB4403/T 2492022进口冷链食品追溯数据接口规范Data interface specification of imported cold-chain food traceability2022-07-29 发布2022-08-01 实施深圳市市场监督管理局发 布DB4403/T 2492022I目次前言.II1范围.12规范性引用文件.13术语和定义.14缩略语.15基本要求.26接口类型.27接口关系.28接口描述.2附录 A（资料性）接口响应码说明.11附录 B（资料性）追溯数据对接实例.12附录 C（资料性）企业类型及编码说明.13附录 D（资料性）资质证照类型及编码.14附录 E（资料性）产品分类及编码.15参考文献.17DB4403/T 2492022II前言本文件按照 GB/T 1.12020标准化工作导则第 1 部分：标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由深圳市市场监督管理局提出并归口。本文件起草单位：深圳市市场监督管理局、深圳市标准技术研究院。本文件主要起草人：李颖、徐立峰、练晓、吕恺文、王恒、苏巍、陈瑜、周哲、陈炜霖、陈利平、施伟、林智明。DB4403/T 24920221进口冷链食品追溯数据接口规范1范围本文件规定了进口冷链食品追溯系统数据接口的基本要求、接口类型、接口关系、接口描述。本文件适用于企业、技术机构、监管部门在进口冷链食品追溯系统间的数据对接。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 7408数据元和交换格式信息交换日期和时间表示法GB 12904商品条码零售商品编码与条码表示GB 32100法人和其他组织统一社会信用代码编码规则DB4403/T 1912021食用农产品追溯码编码技术规范IETF RFC 2818TLS 上的 HTTP（HTTP over TLS）IETF RFC 3548Base16，Base32，Base64 数据编码（The Base16，Base32，and Base64 dataencodings）IETF RFC 3629UTF-8，ISO 10646 转换格式（UTF-8，a transformation format of ISO 10646）3术语和定义下列术语和定义适用于本文件。3.1冷链食品cold-chain food通过冷链实现物流过程运输的果蔬类、水产类、肉制品类、禽蛋类、乳制品、粮食类等易腐食品及其加工制品等食品。注：包括冷冻食品和冷藏食品。3.2追溯系统traceability system基于追溯码、文件记录、相关软硬件设备和通信网络，实现现代信息化管理并可获取产品追溯过程中相关数据的集成。来源：GB/T 381552019，2.63.3集中监管仓centralized supervision warehouse具备进口冷链食品（3.1）相关疫情集中排查、集中管控、集中处置和产品外包装预防性消毒功能的场所。4缩略语下列缩略语适用于本文件。GS1：国际物品编码协会（Global Standards 1）HTTPS：以安全为目标的HTTP通道（HyperText Transfer Protocol over Secure Socket Layer）JSON：一种轻量级的数据交换格式（JavaScript Object Notation）UTF-8：一种可变长度字符编码（8-bit Unicode Transformation Format）DB4403/T 249202225基本要求接口通过服务调用实现信息交换，应符合下列要求：采用IETF RFC 2818规定的HTTPS协议作为底层承载协议；采用IETF RFC 3629规定的UTF-8字符集；采用GB/T 7408规定的日期类型；采用IETF RFC 3548规定的Base64编码规则将图片文件转换为字符串；接口请求与接口响应均采用JSON数据格式；建立接口日志记录，能识别数据异常或追溯交换数据情况；发生错误时，通过接口将详细的错误信息返回至相关平台和节点系统，由相应平台和节点系统对错误进行记录分析和整改。6接口类型进口冷链食品追溯系统数据接口主要包括下列类型：主体信息类，包括但不限于主体信息类参数；产品信息类，包括但不限于产品品类信息、产品批次信息、入境货物检验检疫证明信息、海关进口货物报关单信息、消毒证明信息、核酸检测证明信息、集中监管仓出库证明信息；冷库信息类，包括但不限于冷库信息类参数；追溯信息类，包括但不限于集中监管仓信息、收发货信息、出入库信息、运输信息。7接口关系进口冷链食品追溯系统数据接口关系如图1所示。图1数据接口关系8接口描述8.1接口请求DB4403/T 24920223接口请求参数说明见表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企业名称字符型通过统一社会信用代码获取企业注册名称Unif_soci_cred_code统一社会信用代码字符型18 位统一社会信用代码，按照 GB32100 确定的编码规则Contact联系人字符型Contact_phone联系电话字符型Legal_person法人代表字符型Office_address地址字符型Addr_districts所属区划字符型具体到省、市、区、街道Ent_type_code企业类型字符型企业类型及编码说明见附录 CEnt_img资质证照字符型将图片转为 Base64 编码格式存储，具体的资质证照类型见附录 D8.3.2产品信息类接口说明DB4403/T 249202248.3.2.1产品品类信息接口产品品类信息参数见表4。表 4产品品类信息参数字段名含义类型说明Product_library_id商品条码/产品编码字符型商品条码采用 GS1 编码，应符合 GB12904 中商品条码的编码规则；产品编码为系统自动生成的产品品类编码，编码规则应按照 DB4403/T 1912021中第 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产品批次信息参数字段名含义类型说明Product_library_id商品条码/产品编码字符型商品条码采用 GS1 编码，应符合 GB12904 中商品条码的编码规则；产品编码为系统自动生成的产品品类编码，编码规则应按照 DB4403/T 1912021中第 6 章规定的编码方案Product_name产品名称字符型实物产品标签上的产品名称Container_number货柜编号字符型装载该批货物的货柜编号Trace_code批次追溯码字符型编码规则应按照 DB4403/T 1912021中第 6 章规定的追溯码编码方案Batch实际批次字符型实物产品标签上的生产批号Number_of_pieces首次入库件数数字型Weight首次入库重量字符型单位为千克（kg）Inventory_pieces库存件数数字型可发货件数Production_date生产日期日期时间型格式为 YYYY-MM-DDDB4403/T 24920225表 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消毒编号字符型消毒证明唯一标识Disinfect_state消毒状态字符型消毒状态为已消毒和未消毒，1 代表已消毒，0 代表未消毒Disinfect_img消毒证明图片字符型将图片转为 Base64 编码格式存储表 9核酸检测证明信息字段名含义类型说明Na_result核酸检测结果字符型阴性或阳性DB4403/T 24920226表 9核酸检测证明信息（续）字段名含义类型说明Na_date核酸检测日期日期时间型格式为 YYYY-MM-DDNa_unit核酸检测单位字符型实施核酸检测的单位名称Verify_mode检验模式字符型核酸检测覆盖或企业自行委托Na_img核酸检测证明图片字符型将图片转为 Base64 编码格式存储表 10集中监管仓出库证明信息字段名含义类型说明Certificate_number集中监管仓出库证明编号数字型数字编码Certificate_date出库证明日期日期时间型格式为 YYYY-MM-DDCertificate_img集中监管仓出库证明图片字符型将图片转为 Base64 编码格式