位置

智选后台：【平台】->【下载中心】->【电子价签工具】

对接市面上所有电子价签品牌：电子价签按照接口文档，即可调用。

温馨提示
提供开放式的接口，第三方电子价签的均可通过我们的开放接口方式，进行调用对接。
功能说明：智选后台做了价格变更或者调价后，会自动更新到电子价签。
使用场景：商场使用的思迅商云智选系统，商家接入了电子价签系统（包括电子显示价格的硬件，可能后台还有一套软件系统），在这我们叫第三方电子价签系统。这个时候第三方电子价签系统想从思迅系统得到商品的价格显示在电子屏上。

一、对接流程图

  • 流程讲解
    思迅会通过思迅标电子价签工具→同步数据到工具目录下→第三方电子价签（例如：汉朔电子价签、小飞电子价签、思飞电子价签、杭州智控电子价签等），→他们直接调用工具目录的文件即可。

二、电子价签工具安装说明

（2.1）可以在任何一台机器上安装电子价签工具
（2.2）安装电子价签工具配置好后，第三方电子价签就可以通过开发自己的请求程序(POST)，指向电子价签服务得到相应的商品价格程序（详见电子价签服务帮助文档中的开发指南，开发人员可关注）

三、第三方电子价签-调用思迅API接口

第三方系统通过Http调用（POST方式）思迅电子价签接口程序提供的Web API，思迅电子价签接口程序收到请求后，处理对应业务逻辑，并将处理结果也通过Json格式返回给第三方系统。

四、报文协议说明（访问讲解）

商家在思迅电子价签接口程序上设置，用户号(Operid)[如：200133]，
思迅电子价签接口程序自动生成（key）报文信息[如: ImX49OBeXroHH6crU+0YQ==]，
外部程序每次调用接口，需要将用户号(Operid)，报文信息（签名），请求数据（Request），(Timestamp)时间戳到秒级（10位）[如：1503471583] ，经过MD5加密后提交，思迅电子价签接口校验。

例如：

商品查询Data数据

Request：{“Data”:{“PageIndex”:1,”PageSize”:20,”QueryParams”:[{“DataType”:0,”DecData”:0,”IntData”:0,”Name”:”searchText”,”StrData”:”01”}],”ReportName”:”SingleItemInfo”},”Timestamp”:”1503471583”}

中间过程

生成MD5字节密钥(MD5KEY)：“key=”+“ImX49OBeXroHH6crU+0YQ==”+Request 共16位（生成的MD5值请转换为大写）

最终数据（Body）:MD5KEY + 字节数据（Request）

五、查询类调用接口地址

查询类调用接口地址 http:+iP+端口+ pos/call/+ Operid +/GeneralQuery/Request

以下举例中：IP地址为：128.0.16.0 （思迅代理商在客户安装【思迅电子价签工具服务】所在的电脑IP）

默认端口：16961

编码字符集UTF-8。java 示例见文档最后

第三方系统→思迅电子价签接口程序

【思迅电子价签】对接 - 字段说明
特别注意： 每次开启服务后，如果全量查询(不带任何查询条件)最后一页后，下次再全量查询时，自动根据最近的查询时间进行商品变化查询。
Timestamp: --发起方时间戳[以下时间戳以当时服务器时间为准]
操作类型： 商品查询：根据商品编码和类别编码进行查询
调用地址： http://128.0.16.0:16960/pos/call/200133/GeneralQuery/Request
操作类型 字段说明 字段名称 字段类型 说明
第三方系统
→
（调用）思迅电子价签接口程序
PageIndex int 页码数
PageSize int 记录数
searchText--StrData string 查询条件（商品编码）
clsnos--StrData string 查询条件（商品类别,多个类别用|分隔）
operId string 操作员
ReportName string 查询标识
Json串： { 
"Data": {
    "PageIndex": 1,
    "PageSize": 20,
    "QueryParams": [
        {
            "DataType": 0,
            "DecData": 0,
            "IntData": 0,
            "Name": "searchText",
            "StrData": "1100"
        }，

{

            "DataType": 0,
            "DecData": 0,
            "IntData": 0,
            "Name": "clsnos",
            "StrData": "10|12"
        }
    ],
    "ReportName": "SingleItemInfo"
},

"Timestamp": "1503471583"

}
备注 查询编码含有1100和类别10|12的商品信息，结果返回第一页的前20行商品信息数据

思迅电子价签接口程序→第三方系统

【思迅电子价签】对接 - 字段说明
Timestamp: --发起方时间戳[以下时间戳以当时服务器时间为准]
特别注意： 每次开启服务后，如果全量查询(不带任何查询条件)最后一页后，下次再全量查询时，自动根据最近的查询时间进行商品变化查询。
操作类型： 商品查询：根据商品编码和类别编码进行查询
调用地址： http://128.0.16.0:16960/pos/call/200133/GeneralQuery/Request
操作类型 字段说明 字段名称 字段类型 说明
思迅电子价签接口程序
→（传输给）
第三方系统
返回字段说明 base_price decimal 批发价
change_price string 前台议价（1/0）
color_code string 花色码（暂未用）
combine_sta string 商品类型(暂未用)
enable_discount string 前台打折（1/0）
item_barcode string 花色条码（暂未用）
item_clsname string 类别名称
item_clsno string 类别编码
item_name string 商品名称
item_pricetype decimal 计价方式(0 普通,1 记重,2计数)
item_size string 规格
item_stock string 是否管库存（暂未用）
item_subno string 自编码
main_supcust string 主供应商
memo string 备注
price decimal 进价
purchase_spec decimal 进货规格
sale_price decimal 零售价
Sale_min_price decimal 档案最低零售价
size_code string 尺寸码（暂未用）
stock_qty decimal 商品库存
trans_price decimal 配送价格
unit_no string 单位
vip_price decimal 会员价
Spec_price decimal 特价
Start_date datetime 特价开始日期
End_date datetime 特价结束日期
Begin_time string 特价开始时间
End_time string 特价结束时间
Spec_type string 特价类型
disc_rate decimal 直接折扣率(如0.9)
disc_desc string 折扣日期时段描述
valid_days decimal 保质期
limit_qty decimal 特价限量数量
product_area string 产地
Code Int 1 错误异常，0 正常
Message string 错误时提示信息
RowCount Int 查询后的商品总条数
备注 返回商品信息
Json串：

{

"Code": 0, 
"Data": [
    {
        "base_price": 36.3, 
        "change_price": "1", 
        "color_code": null, 
        "combine_sta": null, 
        "enable_discount": "1", 
        "item_barcode": null, 
        "item_clsname": "女式运动鞋", 
        "item_clsno": "3411        ", 
        "item_name": "上海回力", 
        "item_no": "32511003            ", 
        "item_pricetype": 0, 
        "item_size": "", 
        "item_stock": null, 
        "item_subno": "41112003", 
        "main_supcust": "[37832]石家庄市丽华制鞋总厂", 
        "memo": null, 
        "price": 33, 
        "purchase_spec": 1, 
        "sale_min_price": 0, 
        "sale_price": 41.3, 
        "size_code": null, 
        "stock_qty": 0, 
        "trans_price": 0, 
        "unit_no": "双  ", 
        "vip_price": 41.3,
       "valid_days": 180.00,
       "limit_qty": 100.00,
       "spec_price":36.3000,
       "start_date":2021-01-01 08:00:00,
       "end_date":2021-01-31:22:00:00,
       "begin_time":08:00:00,
       "end_time":22:00:00,
       "spec_type":"时段特价单",
       "disc_rate":0.9,
       "disc_desc":"折扣日期:2023-08-23至2023-09-22,星期二三四六,时段:00:00:00-23:55:50"
    } 
], 
       "RowCount": 1, 
       "Message": null

}
最后编辑: 商云|智选  文档更新时间: 2025-04-02 15:56   作者：商云|智选