电子价签ESL事件及消息示例

1 事件列表

event 取值说明
4011基站上线消息通知 (暂未开放)
4012基站下线消息通知 (暂未开放)
4100 商品变价通知消息(暂未开放)
4200价签推图状态消息通知
4300基站状态信息定时推送(商户级别 1分钟一次,一页最多100条)
4400价签状态信息定时推送 (商户级别 20分钟一次,一页最多100条)

2 事件消息示例

2.1 价签推图状态消息通知 (event=4200)

消息 payload

{
    "esl_code": "DISLDDMK",
    "result": 1,
    "product_name": "Fish",
    "product_seq_num": "282937287",
    "template_name": "2.13-BW",
    "source": 1,
    "trace_id":  "2938329018273" (可选,如果没有指定,则为"" )
}

字段描述:result

result 取值说明
0事件开始
1成功
2失败

字段描述:source

source取值说明
1 (暂未开放) 商品更新
2绑定商品
3 (暂未开放) 解绑商品
4 (暂未开放) 价签重推
5 (暂未开放) 模板更新

2.2 基站状态信息定时推送 (event=4300)

商户级别,定时推送基站状态信息,每分钟一次推送,推送内容详见如下实例中的payload字段

报文格式: application/x-www-form-urlencoded;param=value;charset=UTF-8

消息体格式:
{ 
  "app_id": 'DT8A77EAD0966',                //唯一标识接入身份,联系商米数字店铺提供
  "event": '4300',                          // 触发消息的类型
  "payload":'{
      "ap_list:[
          {
              "ap_id":"514157283292",      //基站商米ID
              "ap_sn":"APSN01",            //基站序列号
              "ap_mac":"0C25765D9414",     //基站mac地址
              "status":2,                  //基站状态
              "shop_id":""                 //基站所属推送方店铺id, 没有或没有推送方店铺映射者,则为空
          },
          {
               "ap_id":"514157283291",
               "ap_sn":"APSN02",
               "ap_mac":" ",
               "status":2,
               "shop_id":"30316"
           }
      ]
  }',
  random: 'JFMTSU',                           // 随机字符串,由数字和字母组成,长度范围为6-10位
  shop_id: '',                                // 店铺在SaaS软件体系下的唯一标识, 没有或者不需要则为空
  sign: '048C4C4C215531E856FF957E69EBDFCF',   //签名校验
  sunmi_shop_no: '',                          // 商米数字店铺平台门店唯一编号, 没有或者不需要则为空
  timestamp: '1605149745'                     //当前的unix timestamp,精度到秒级,10位数字
}

备注:payload字段对应的值为string类型,解析对此string类型内容进行json解析

字段描述:status

status取值说明
0未注册
1在线
2离线

2.3 基站状态信息定时推送 (event=4400)

商户级别,定时推送价签状态信息,每20分钟一次推送,推送内容详见如下实例中的payload字段

报文格式: application/x-www-form-urlencoded;param=value;charset=UTF-8

消息体格式:
{ 
  "app_id": 'DT8A77EAD0966',                //唯一标识接入身份,联系商米数字店铺提供
  "event": '4400',                          // 触发消息的类型
  "payload":'{
      "esl_list:[
          {
              "esl_id":"514157164491",    //价签id
              "esl_sn":"B101203J00156",   //价签sn
              "esl_mac":"0C25768271CA",   //价签mac地址
              "online_status":0,          //价签在线状态
              "shop_id":"",               //价签所属推送方店铺id, 没有或没有推送方店铺映射者,则为空
              "esl_code":"RN1C41PD",      //价签code
              "screen_size":"2.13寸",     //价签尺寸
              "battery":21,               //价签电量
              "rssi":-55                  //价签信号
          },
          {
              "esl_id":"514157160628",
              "esl_sn":"B101203J00139",
              "esl_mac":"0C25768271AA",
              "online_status":0,
              "shop_id":"30316",
              "esl_code":"RN1C41PS",
              "screen_size":"2.13寸",
              "battery":13,
              "rssi":-51
           }
      ]
  }',
  random: 'JFMTSU',                           // 随机字符串,由数字和字母组成,长度范围为6-10位
  shop_id: '',                                // 店铺在SaaS软件体系下的唯一标识, 没有或者不需要则为空
  sign: '048C4C4C215531E856FF957E69EBDFCF',   //签名校验
  sunmi_shop_no: '',                          // 商米数字店铺平台门店唯一编号, 没有或者不需要则为空
  timestamp: '1605149745'                     //当前的unix timestamp,精度到秒级,10位数字
}

备注:payload字段对应的值为string类型,解析对此string类型内容进行json解析
online_status 取值说明
0离线
1在线