国家物联网标识管理中心(国家物联网标识管理与公共服务平台)

  用户注册

国家物联网标识管理与公共服务平台(以下简称:Ecode服务平台) 首页点击平台登录模块中的进行用户注册。 用户类型共有为“企业用户”、“平台用户”和“条码卡用户”三种类型。点击“注册”按钮,即可开始进行注册流程。
  一、企业用户注册
选择“企业用户注册”选项,并填写用户基本信息
完善企业基本信息
上传企业资质证明
填写编码分类信息,提交注册,Ecode服务平台的管理员将会对提交的信息进行审核, 审核结果以邮件形式通知,将发送到企业基本信息中所填写的“联系人电子邮箱”,请注意查收。
待用户审核通过后,即可在首页平台登录模块中的进行用户登录操作。
登录后,默认进入管理中心,可继续进行编码申请等操作。点击右上角的用户名链接,即可进入会员中心。 在会员中心中可查看企业基本信息和编码统计信息,进行账户管理和子账户管理等操作。其中:企业ID可作为后续接口对接中的clientId使用。
  二、平台用户注册
选择“平台用户注册”选项,并填写用户基本信息
完善平台基本信息
填写编码分类信息,提交注册,Ecode服务平台的管理员将会对提交的信息进行审核, 审核结果以邮件形式通知,将发送到企业基本信息中所填写的“联系人电子邮箱”,请注意查收。
待用户审核通过后,即可在首页平台登录模块中的进行用户登录操作。
登录后,默认进入平台用户中心,可在平台用户中心中查看平台基本信息,账户信息和企业信息,查看该平台用户的编码申请和编码回传信息。 其中:企业ID可作为后续接口对接中的clientId使用。
  三、条码卡用户注册
选择“条码卡导入”选项,并填写条码卡账户信息:用户名和密码来源于条码卡。
完善企业基本信息:部分信息根据条码卡自动导入,需将剩余信息填写完整。
上传企业资质证明
填写编码分类信息,提交注册,Ecode服务平台的管理员将会对提交的信息进行审核, 审核结果以邮件形式通知,将发送到企业基本信息中所填写的“联系人电子邮箱”,请注意查收。
待用户审核通过后,即可在首页平台登录模块中的进行用户登录操作。 条码卡登录操作与企业用户一致。

  在线方式

  一、在线编码申请
企业用户或条码卡用户登录Ecode服务平台后,在“管理中心”中点击“编码申请”。
以申请短追溯码(10096)为例,完善编码申请页面并提交。
申请的编码,可在管理中心中进行查看并进行相关查询操作。
  二、在线编码下载
编码申请审核通过后,状态变为“已通过”,此时可进行编码下载操作。下载后的编码文件可进行解压操作后,以记事本形式打开。
  三、在线编码回传
企业(条码卡)用户点击“编码回传”按钮,可将已使用的Ecode编码回传到Ecode服务平台, Ecode服务平台提供在线方式和上传附件的方式回传编码。企业用户可自定义查询结果模板, 目前平台提供工业类、食品类、空白模板三种选择方式。 编码回传列表默认按时间倒序排列。
选择“编码管理”下的“编码回传”,点击“编码回传”按钮。
选择回传方式,包括“在线回传”和“附件回传”,选择回传方式,进入“回传Ecode编码”步骤。 在线回传方式单次最高可回传1000条Ecode编码,附件回传方式单次最高可回传30万条Ecode编码,请合理选择回传方式。
若选择“在线回传”,请填写回传的Ecode编码。同时回传多条Ecode编码时,请在各条Ecode编码间以逗号或者回车键进行间隔。 点击“下一步”按钮,将提示所填写的编码是否有效;若无效,请正确填写需回传的编码,重新提交。

若选择“附件回传”,请上传相应的txt附件,附件中Ecode编码之间应以“,”分隔。
完成“回传Ecode编码”的步骤后,则进入“选择分类”步骤,共有:“已有模板”,“工业类”,“快销品类”和“空白新建”四种类别,可根据需要进行选择。 下图是产品名称为“工业产品001”的示例。
完成“选择分类”步骤后,进入“分类信息维护”步骤中,可实现创建表格,上传产品图片,上传企业logo等实现对模板进行管理。 下图是“工业产品001”的模板创建,可供参考。 编辑完成后,点击“完成”按钮,弹出提示:成功提交到服务器,即完成了在线方式编码回传。
完成编码回传后,可在“编码管理-编码回传”模块查看到回传信息,待回传状态为“入库”时,可点击“详情”按钮可查看回传详情。
  四、在线编码查询
在 Ecode服务平台 首页的“编码查询”模块中可以实现Ecode编码查询,商品查询和快递查询的功能。 选择“Ecode编码”标签页,输入正确的编码,即可进行查询。

  接口方式

  一、企业接口-编码申请
1.接口描述
编码申请接口用来为企业用户提供编码追加服务,用户可通过编码申请接口申请Ecode编码。 完整的接口说明文档,请前往 附录 进行下载。
2.接口详细定义如下
  二、企业接口-编码下载
1.接口描述
企业用户调用此接口进行Ecode编码的下载。 完整的接口说明文档,请前往 附录 进行下载。
2.接口详细定义如下
  三、企业接口-编码回传
1.接口描述
企业用户调用此接口进行Ecode编码的回传(激活)。 完整的接口说明文档,请前往 附录 进行下载。
2.接口详细定义如下
3.Post JSON格式示例如下
4.返回结果示例

  平台接口

  一、平台接口-企业批量注册
1.接口描述
平台用户可通过企业批量注册接口,将平台下的企业用户信息批量导入到Ecode平台中。 完整的接口说明文档,请前往 附录 进行下载。
2.接口详细定义如下
3.Post JSON格式示例如下:
4.请求参数说明
5.返回结果示例
6.返回参数示例
  二、平台接口-编码申请
1.接口描述
编码申请接口用来为平台用户提供编码申请服务,平台用户可通过编码申请接口申请Ecode编码。 后台可通过接口管理功能控制平台用户访问接口访问次数和编码申请上限, 通过资源管理管理功能控制平台用户接口使用权限。 平台编码申请接口生成的是带有序列号的Ecode编码。 完整的接口说明文档,请前往 附录 进行下载。
2.接口详细定义如下
3.接口返回示例
4.接口返回参数说明
  三、平台接口-编码下载
1.接口描述
平台用户调用“编码申请接口”完成编码申请后, 可根据“编码申请接口”返回的附件ID作为参数,调用“编码下载接口”进行编码下载。 完整的接口说明文档,请前往 附录 进行下载。
2.接口详细定义如下
3.附件文件格式如下:
在原有编码前加入12位顺序码(从000000000000开始到999999999999结束), 其后是相应的10096编码,用TAB分隔,每行一个组。例:
4.接口返回说明
返回成功,直接返回该文件进行下载
5.返回字段说明
  四、平台接口-编码回传
平台编码回传接口共有两种形式:
一、编码序列号形式回传:平台用户将编码序列号写入到接口地址中,进行编码回传。具体说明请前往 编码序列号形式回传 进行查看。
二、Ecode编码形式回传:将回传的Ecode编码写到JSON数据中,通过POST形式回传。具体说明请前往 Ecode编码形式回传 进行查看。
(一)编码序列号形式回传
1.接口描述
平台用户可通过“编码回传接口”以编码序列号的方式进行编码回传。其中,通过“编码下载接口”获得的附件中编码的12位顺序码,取其有效位数即为序列号。 完整的接口说明文档,请前往 附录 进行下载。
2.接口详细定义如下
3.Post JSON格式示例如下
4.请求参数说明
5.返回示例说明
6.返回字段说明
(二)Ecode编码形式回传
1.接口描述
平台用户通将过Ecode编码写入到POST JSON中的形式进行回传操作。
2.接口详细定义如下
3.Post JSON格式示例如下
4.请求参数说明
5.返回示例说明
6.返回字段说明
  五、平台接口-激活回退
平台编码激活回退接口共有两种形式:
一、Ecode编码序列号形式激活回退:平台用户通过“编码激活回退接口”将已激活的Ecode编码进行激活回退,该接口通过编码序列号的方式进行激活回退。 注:编码序列号规则请见 “平台接口-编码回传接口”。 完整的接口说明文档,请前往 附录 进行下载。
       二、Ecode编码形式激活回退:用户通过编码激活回退接口将已激活的Ecode编码进行激活回退,该接口通过传递需回退的编码进行回退。
(一)编码序列号形式激活回退
1.接口描述
平台用户通过“编码激活回退接口”将已激活的Ecode编码进行激活回退,该接口通过编码序列号的方式进行激活回退。 注:编码序列号规则请见 “平台接口-编码回传接口”。 完整的接口说明文档,请前往 附录 进行下载。
2.接口详细定义
3.接口返回示例说明
若请求成功:
4.接口返回字段说明
(二)编码形式激活回退
1.接口描述
用户通过编码激活回退接口将已激活的Ecode编码进行激活回退,该接口通过传递需回退的编码进行回退。
2.接口详细定义如下
3.Post JSON格式示例如下
4.请求参数说明
5.返回示例说明
6.返回字段说明
  六、平台接口-获取企业信息
1.接口描述
平台用户可通过“获取企业信息接口”来获取该平台用户下注册的企业用户信息。 完整的接口说明文档,请前往 附录 进行下载。
2.接口详细定义
3.接口返回示例说明
若请求成功:
4.接口返回字段说明

  产品追溯

企业(条码卡)用户 登录Ecode服务平台后,在管理中心中可通过在线方式实现“产品追溯”的功能。产品追溯系统包含产品追溯过程中“原辅材料”,“产品生产”,“产品仓储”,“产品运输”和“产品交易”五个环节。 待五个环节的信息全部上传成功后,可在Ecode服务平台首页的“编码查询”模块,通过Ecode编码查看追溯信息。 同时,提供“产品信息维护”功能,可实现对产品信息的记录和维护。

  一、在线对接-产品信息维护
在产品信息维护页面,点击“新增产品信息”,进行产品信息的编辑。填写完成后,可在产品信息维护页查看到产品信息,并进行查询等操作。



  二、在线对接-原辅材料
在原辅材料环节,点击“浏览”,进行原辅料信息文件的上传。 请前往 附录-“产品追溯-数据文件” 下载文件,请参照“填表说明”,将“原辅料信息”表格填写完整,即可进行上传。

  三、在线对接-产品生产
在产品生产环节,点击“浏览”,进行生产业务数据据报盘文件的上传。 请前往 附录-“产品追溯-数据文件” 下载文件,请参照“填表说明”,将“产品生产信息”表格填写完整,即可进行上传。

  四、在线对接-产品仓储
在产品仓储环节,点击“浏览”,进行仓储信息数据报盘文件的上传。 请前往 附录-“产品追溯-数据文件” 下载文件,请参照“填表说明”,将“产品仓储信息”表格填写完整,即可进行上传。

  五、在线对接-产品运输
在产品运输环节,点击“浏览”,进行运输信息数据报盘文件的上传。 请前往 附录-“产品追溯-数据文件” 下载文件,请参照“填表说明”,将“产品运输信息”表格填写完整,即可进行上传。

  六、在线对接-产品交易
在产品交易环节,点击“浏览”,进行交易信息数据报盘文件的上传。 请前往 附录-“产品追溯-数据文件” 下载文件,请参照“填表说明”,将“产品交易信息”表格填写完整,即可进行上传。

  接口对接

通过接口方式,实现对“原辅材料”,“产品生产”,“产品仓储”,“产品运输”和“产品交易”五个环节的追溯。 具体接口文档,请前往附录-“产品追溯-接口说明文档”进行下载。

  附录

完整接口文档,请点击下载:
Ecode平台接口说明文档.doc
产品追溯-数据文件.xlsx
产品追溯-接口说明文档.doc

  一、附录1
本接入指南中的图像可以是jpg、png、gif格式, 需要编码成Base64的形式,图像编码简单示例程序如下(JAVA):
static BASE64Encoder encoder = new sun.misc.BASE64Encoder();
    /**
     *将返回的字符串赋值给相应的JSON字段
     **/
static String getImageBinary(String path) {
     File f = new File(path);
     BufferedImage bi;
     try {
         bi = ImageIO.read(f);
         ByteArrayOutputStream baos = new ByteArrayOutputStream();
         ImageIO.write(bi, "jpg", baos);
         byte[] bytes = baos.toByteArray();
         baos.close();
         return  encoder.encodeBuffer(bytes).trim().replaceAll("[\n\r]","");
      } catch (IOException e) {
         e.printStackTrace();
      }
       return null;
   }

  二、附录2
本接口指南中使用的sign(签名)由AES算法生成,AES加密工具类代码(JAVA)如下所示。
AES算法中明文(cleartext)由“clientId+时间戳”组成。秘钥(seed)请联系Ecode平台运维人员。
1.sign(签名)生成方法如下
/**
     * 调用AESUtil工具类生成签名sign,作为参数供接口使用
     */
public String getSign() {
	String clientId = "ad0955cf504b443c8333df2f641f097d";// 用户ID
	Long timeStamp = System.currentTimeMillis();// 当前时间戳
	String cleartext = clientId + timeStamp;// 明文签名
	try {
		String sign = AESUtil.encrypt(****, cleartext);// 签名AES加密
		return sign;
	} catch (Exception e) {
		e.printStackTrace();
	}
}
2.AES加密工具类代码(JAVA)请点击下载 附录-Ecode平台接口说明文档 进行查看。