价签管理接口

4.1 接口描述

设备管理接口用来管理电子价签设备本身，包括价签与门店的绑定解绑等。

4.2 接口列表

接口名称接口
添加价签到门店/device/esl/bind
从门店删除价签/device/esl/unbind
获取价签列表/device/esl/getList
获取价签详情/device/esl/getInfo
对价签推特定图片/device/esl/pushImage
获取统计信息/device/getOverview
获取商铺下所有价签信息/device/esl/getListByCompany

4.3 接口详情

4.3.1 添加价签到门店

接口描述：通过本接口调用，用户可以绑定价签到指定门店。这一步操作不是必须，在执行商品绑定价签的时候，如果对应价签没有被任何门店绑定，也会执行绑定价签到门店的动作。

请求链接：/device/esl/bind

接口参数：

参数名称是否必须类型说明
sunmi_shop_no否string商米数字店铺平台中门店的唯一编号（v2.0之后为必填项）
shop_id否string第三方对接软件中门店的唯一编号
（此参数为后向兼容v2.0之前版本的字段，在v2.0及以后版本使用sunmi_shop_no替代，作为门店唯一标识即可）
esl_code否（esl_code和esl_sn至少提供一个）string电子价签8位ID （价签正面的条码）
esl_sn否（esl_code和esl_sn至少提供一个）string电子价签SN

返回值： 

{
    code：0，       /* 其他错误参考错误列表 */
    msg: "succeed"，
    data: {
        "esl_id": “129200”,
    }
}

错误码：

错误码说明
5000数据库错误
5301非法价签
5338价签已被店铺绑定
5041非法对接软件店铺

4.3.2 从门店删除价签

接口描述：通过本接口调用，用户可以从指定店铺上解绑价签，价签删除后会显示出厂图，可以再次被其他门店使用。

请求链接：/device/esl/unbind

接口参数：

参数名称是否必须类型说明
sunmi_shop_no否string商米数字店铺平台中门店的唯一编号（v2.0之后为必填项）
shop_id否string第三方对接软件中门店的唯一编号
（此参数为后向兼容v2.0之前版本的字段，在v2.0及以后版本使用sunmi_shop_no替代，作为门店唯一标识即可）
esl_id是string电子价签数据库ID转码

返回值： 

{
    code：0，       /* 其他错误参考错误列表 */
    msg: "succeed"，
    data: { }
}

错误码：

错误码说明
5000数据库错误
5301非法价签
5041非法对接软件店铺

4.3.3 获取价签列表

接口描述：通过本接口调用，用户可以获取价签列表，列表中包含价签状态。

请求链接：/device/esl/getList

接口参数：

参数名称是否必须类型说明
sunmi_shop_no否string商米数字店铺平台中门店的唯一编号（v2.0之后为必填项）
shop_id否string第三方对接软件中门店的唯一编号
（此参数为后向兼容v2.0之前版本的字段，在v2.0及以后版本使用sunmi_shop_no替代，作为门店唯一标识即可）
page_num否（默认1）int当前页码
page_size否  (默认10)int当前页条目数量

返回值： 

{
    code：0，       /* 其他错误参考错误列表 */
    msg: "succeed"，
    data: {
         "total_count": 100,
        "esl_list": [{
               "esl_id": “1000”,
                "esl_code": "SKDI39DN",
                "esl_sn": "B101194N00002",
                "model_name": "SL121+"，
                "status": 2
             },
             ... ...
       ] }

返回字段描述：status

status 取值说明
0未激活
1未绑定
2待推送
3推送成功
4推送失败

错误码：

错误码说明
5000数据库错误
5020非法参数
5041非法对接软件店铺

4.3.4 获取价签详情

接口描述：通过本接口调用，用户可以获取价签详情(包含MAC地址，电量，信号强度等)。

请求链接：/device/esl/getInfo

接口参数：

参数名称是否必须类型说明
sunmi_shop_no否string商米数字店铺平台中门店的唯一编号（v2.0之后为必填项）
shop_id否string第三方对接软件中门店的唯一编号（此参数为后向兼容v2.0之前版本的字段，在v2.0及以后版本使用sunmi_shop_no替代，作为门店唯一标识即可）
esl_code否（esl_code和esl_id至少输入一个）string电子价签8位ID （价签正面的条码）
esl_id否  (esl_code和esl_id至少输入一个)string电子价签数据库ID转码

返回值： 

{
    code：0，       /* 其他错误参考错误列表 */
    msg: "succeed"，
    data: {
            "esl_id": "1000",
            "esl_code": "SKDI39DN",
            "esl_sn": "B101194N00002",
            "model_name": "SL121+",
            "status": 2,
            "screen_size_name": "2.13寸",
            "software_version": "1.0.1",
            "battery": 90,
            "rssi": -37,
            "connect_time": 15683920394,
            "ap_id":  "10200",
            "ap_sn": "B201E95D00001",
            "ap_name": "",
      }
}

返回字段描述：status

status 取值说明
0未激活
1未绑定
2待推送
3推送成功
4推送失败

错误码

错误码说明
5000数据库错误
5023缺少参数
5502非法设备机型
5041非法对接软件店铺

4.3.5 对价签推特定图片

接口描述：通过本接口调用，用户可以指定价签推图。

请求链接：/device/esl/pushImage

接口参数：

参数名称是否必须类型说明
sunmi_shop_no否string商米数字店铺平台中门店的唯一编号（v2.0之后为必填项）
shop_id否string第三方对接软件中门店的唯一编号
（此参数为后向兼容v2.0之前版本的字段，在v2.0及以后版本使用sunmi_shop_no替代，作为门店唯一标识即可）
esl_id是string电子价签数据库ID转码
pic是file上传的刷图文件

图片分辨率：

上传图片的颜色和大小尺寸需要符合要求，否则无法成功下发显示到电子价签屏幕上，相关参数参考下表。

电子价签型号支持颜色支持图片分辨率（px）
SL115黑白、黑白红152 * 152
SL121黑白、黑白红212 * 104
SL126黑白、黑白红296 * 152
SL126+黑白296 * 152
SL142黑白、黑白红400 * 300
SL142+黑白、黑白红400 * 300
SL175黑白、黑白红640 * 384

返回值： 

{
    code：0，       /* 其他错误参考错误列表 */
    msg: "succeed"，
    data: { }
}

错误码：

错误码说明
5004系统错误
5005非法文件
5020非法参数
5300非法基站
5301非法价签
5041非法对接软件店铺

4.3.6 获取统计信息

接口描述： 通过本接口调用，用户可以获取价签和基站的统计概览信息。

请求链接：/device/getOverview

接口参数：

参数名称是否必须类型说明
sunmi_shop_no否string商米数字店铺平台中门店的唯一编号（v2.0之后为必填项）
shop_id否string第三方对接软件中门店的唯一编号
（此参数为后向兼容v2.0之前版本的字段，在v2.0及以后版本使用sunmi_shop_no替代，作为门店唯一标识即可）

返回值：

{
    "code":0,
    "data":{
            "ap_total_count":24,
            "esl_total_count":55,
            "esl_pending_count":54,
            "esl_failed_count":3
        },
    "msg":""
}
错误码说明
5041非法对接软件店铺

4.3.7 获取商铺下所有价签信息

接口描述：通过本接口调用，用户可以分页获取指定商铺下的价签信息。

请求链接： /device/esl/getListByCompany

接口参数：

参数名称是否必须类型说明
sunmi_company_no 是 string 商米数字店铺平台中商户的唯一编号（仅限通过接口创建的店铺查询）
page_num 否(默认1） int页码
page_size 否（默认10） int每页记录数
{
    "data": {
        "total_count": 1,
        "esl_list": [
            {
                "id": "314159282628",
                "esl_code": "HRBAGJAY",
                "sn": "B101194N00006",
                "mac": "00:01:01:02:02:02",
                "bin_version": "0.6.6",
                "battery": 4,
                "rssi": 0,
                "status": 1,
                "ap_sn": "tongyutestsn",
                "ap_id": "314159333800",
                "model_name": "SL121"
            }
        ]
    },
    "code": 0, /* 其他错误参考错误列表 */ 
    "msg": "succeed"
}

返回字段描述：status

status取值说明
0未激活
1未绑定
2待推送
3推送成功
4推送失败

错误码：

错误码说明
5000 数据库错误
5041 非法对接软件店铺
5903 该商铺不是当前 saas 创建，无权查看