查询商品和价签的绑定信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeBinders

系统规定参数。取值：DescribeBinders。
ItemBarCode String 否 690560583****

商品条码
EslBarCode String 否 18bc5a63****

价签条码，使用门店ID+价签条码查询时，不用填写货架号和层号。
StoreId String 是 s-dxsxx****

门店ID或商家自定义门店ID。
PageNumber Integer 否 1

分页参数：当前页码，默认值1。
ItemTitle String 否 纯牛奶

商品名称。
PageSize Integer 否 10

分页参数：每页显示条数，默认值10。
ExtraParams String 否 {}

系统保留字段，请忽略；

返回数据

名称 类型 示例值 描述
RequestId String 6E0FF7FA-3F89-598F-9BF2-57DF480FE111

请求ID。
ErrorMessage String The specified resource type is invalid.

错误消息。
Success Boolean true

是否成功
ErrorCode String MandatoryParameters

错误码。取值说明如下：请求成功：不返回ErrorCode字段。 请求失败：返回ErrorCode字段。具体信息，请参见本文的错误码目录。
Code String -1001

后端错误码。
Message String null

返回信息。
DynamicMessage String The specified store %s does not exist.

动态错误信息，用于替换返回参数ErrMessage错误信息中的%s。
PageNumber Integer 1

分页参数：当前页码。
PageSize Integer 20

分页参数：每页显示条数。
TotalCount Integer 24

总数。
DynamicCode String PlatformResponseError.%s

错误代码
EslItemBindInfos Array of EslItemBindInfo

绑定信息列表。
EslBarCode String 18bc5a63****

价签条码，使用门店ID+价签条码查询时，不用填写货架号和层号。
TemplateSceneId String 123456

自定义模板ID
ActionPrice String 690

实际销售价格（单位：分）。
ItemTitle String 麦麸吐司

商品名称。
PromotionStart String 2020-03-16T07:05:34Z

促销开始时间 UTC格式 "yyyy-MM-dd'T'HH:mm:ss'Z'"。
PriceUnit String 187

计价单位，最长64个字符；
OriginalPrice String 500

原价（单位：分）。
ItemId String 1234567

自定义商品条码。
GmtModified String 1656469716000

修改时间。
EslPic String kUzlfuzgayDo5uTXW3D66Q

价签显示图片，请使用Base64解码工具解码成图片。
StoreId String s-pdwrrnkufn

门店ID。
ItemShortTitle String 牛奶

商品简称，不输入则从商品全称中截取，最长64字符；
BindId String b4adf048-f36d-4da5-a8bb-ab4adbd5eb04

绑定ID。
PromotionText String 买一送一

促销文案，最长64个字符；
EslModel String AESL0213

价签型号。
BePromotion Boolean true

是否匹配促销模板显示，默认值为false；
SkuId String 124

商品ID(SKU)。
EslConnectAp String 11:22:33:44:55:66

价签链接基站Mac。
EslStatus String ESL_STATUS_ONLINE

价签状态，返回值对应关系：

  • ESL_STATUS_ONLINE：在线，已绑定
  • ESL_STATUS_OFFLINE：离线，已绑定
  • ESL_STATUS_UNBIND：未绑定。
TemplateId String 123456

模板ID
PromotionEnd String 2020-03-17T07:05:34Z

促销结束时间 UTC格式 "yyyy-MM-dd'T'HH:mm:ss'Z'"。
ItemBarCode String 690560583****

商品条码。
ContainerName String 2

绑定的模板区域名称

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeBinders
&ItemBarCode=690560583****
&EslBarCode=18bc5a63****
&StoreId=s-dxsxx****
&PageNumber=1
&ItemTitle=纯牛奶
&PageSize=10
&ExtraParams={}
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeBindersResponse>
    <RequestId>6E0FF7FA-3F89-598F-9BF2-57DF480FE111</RequestId>
    <ErrorMessage>The specified resource type is invalid.</ErrorMessage>
    <Success>true</Success>
    <ErrorCode>MandatoryParameters</ErrorCode>
    <Code>-1001</Code>
    <Message>null</Message>
    <DynamicMessage>The specified store %s does not exist.</DynamicMessage>
    <PageNumber>1</PageNumber>
    <PageSize>20</PageSize>
    <TotalCount>24</TotalCount>
    <DynamicCode>PlatformResponseError.%s</DynamicCode>
    <EslItemBindInfos>
        <EslBarCode>18bc5a63****</EslBarCode>
        <TemplateSceneId>123456</TemplateSceneId>
        <ActionPrice>690</ActionPrice>
        <ItemTitle>麦麸吐司</ItemTitle>
        <PromotionStart>2020-03-16T07:05:34Z</PromotionStart>
        <PriceUnit>187</PriceUnit>
        <OriginalPrice>500</OriginalPrice>
        <ItemId>1234567</ItemId>
        <GmtModified>1656469716000</GmtModified>
        <EslPic>kUzlfuzgayDo5uTXW3D66Q</EslPic>
        <StoreId>s-pdwrrnkufn</StoreId>
        <ItemShortTitle>牛奶</ItemShortTitle>
        <BindId>b4adf048-f36d-4da5-a8bb-ab4adbd5eb04</BindId>
        <PromotionText>买一送一</PromotionText>
        <EslModel>AESL0213</EslModel>
        <BePromotion>true</BePromotion>
        <SkuId>124</SkuId>
        <EslConnectAp>11:22:33:44:55:66</EslConnectAp>
        <EslStatus>ESL_STATUS_ONLINE</EslStatus>
        <TemplateId>123456</TemplateId>
        <PromotionEnd>2020-03-17T07:05:34Z</PromotionEnd>
        <ItemBarCode>690560583****</ItemBarCode>
        <ContainerName>2</ContainerName>
    </EslItemBindInfos>
</DescribeBindersResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "6E0FF7FA-3F89-598F-9BF2-57DF480FE111",
  "ErrorMessage" : "The specified resource type is invalid.",
  "Success" : true,
  "ErrorCode" : "MandatoryParameters",
  "Code" : -1001,
  "Message" : "null",
  "DynamicMessage" : "The specified store %s does not exist.",
  "PageNumber" : 1,
  "PageSize" : 20,
  "TotalCount" : 24,
  "DynamicCode" : "PlatformResponseError.%s",
  "EslItemBindInfos" : {
    "EslBarCode" : "18bc5a63****",
    "TemplateSceneId" : 123456,
    "ActionPrice" : 690,
    "ItemTitle" : "麦麸吐司",
    "PromotionStart" : "2020-03-16T07:05:34Z",
    "PriceUnit" : 187,
    "OriginalPrice" : 500,
    "ItemId" : 1234567,
    "GmtModified" : 1656469716000,
    "EslPic" : "kUzlfuzgayDo5uTXW3D66Q",
    "StoreId" : "s-pdwrrnkufn",
    "ItemShortTitle" : "牛奶",
    "BindId" : "b4adf048-f36d-4da5-a8bb-ab4adbd5eb04",
    "PromotionText" : "买一送一",
    "EslModel" : "AESL0213",
    "BePromotion" : true,
    "SkuId" : 124,
    "EslConnectAp" : "11:22:33:44:55:66",
    "EslStatus" : "ESL_STATUS_ONLINE",
    "TemplateId" : 123456,
    "PromotionEnd" : "2020-03-17T07:05:34Z",
    "ItemBarCode" : "690560583****",
    "ContainerName" : 2
  }
}

错误码

访问错误中心查看更多错误码。