调用ComposePlanogramPositions操作陈列位置。

调试

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

请求参数

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

系统规定参数。取值:ComposePlanogramPositions。

ActionType String ADD_POSITION

操作类型,可选值:

  • ADD_POSITION:新增单个陈列货位,必填参数:StoreId,BeAutoRefresh,Shelf,Layer,ShelfPositionInfo.Column;
  • DELETE_POSITION:删除单个陈列货位,必填参数:StoreId,BeAutoRefresh,Shelf,Layer,ShelfPositionInfo.Column;
  • INSERT_POSITION:新增或修改单个陈列货位,,必填参数:StoreId,BeAutoRefresh,Shelf,Layer,ShelfPositionInfo.Column;
  • ADD_LAYER:新增整层上的陈列货位,,必填参数:StoreId,BeAutoRefresh,Shelf,Layer,ShelfPositionInfo.Column;
  • REPLACE_LAYER:替换整层上的所有货位,,必填参数:StoreId,BeAutoRefresh,Shelf,Layer,ShelfPositionInfo.Column;
  • DELETE_LAYER:删除整层的所有货位(包含层号),,必填参数:StoreId,BeAutoRefresh,Shelf,Layer;

ActionType的类型是货位级时,ShelfPositionInfos集合的size只能为1。

BeAutoRefresh Boolean false

是否自动刷新价签,为true时,新增或修改陈列信息会同步刷新陈列货位上的价签,如果ItemBarCode为空,则解绑并删除该货位上的价签,删除陈列信息会解绑并删除该货位上的价签;为false时,不会解绑价签和删除该位置上的价签。

Shelf String 20200201

陈列系统的货架号。

StoreId String s-dxsxx****

门店ID或商家自定义门店ID。

LayerOrigin String TOP_LEFT

陈列货位中层的起始点,可选值:

  • TOP_LEFT:左上角
  • BOTTOM_LEFT:左下角

默认值:TOP_LEFT。

Layer Integer 1

陈列系统的层号。

ShelfPositionInfo.N.OffsetTo Float 100

陈列系统货位的右偏移距离,单位cm。

ShelfPositionInfo.N.Facing Integer 1

商品的牌面数。

ShelfPositionInfo.N.Column String 1

陈列系统的逻辑列。

ShelfPositionInfo.N.ItemBarCode String 690560583****

商品条码,不填表示占用一个货位(空货位)。

ShelfPositionInfo.N.Depth Float 50

陈列系统货位的深度,单位cm。

ShelfPositionInfo.N.OffsetFrom Float 0

陈列系统货位的左偏移距离,单位cm。

返回数据

名称 类型 示例值 描述
Code String -1001

内部错误码。

DynamicCode String PlatformResponseError.%s

动态错误码。

DynamicMessage String The specified store %s does not exist

动态消息。

ErrorCode String MandatoryParameters

错误码。

ErrorMessage String The specified resource type is invalid.

错误消息。

Message String success

消息。

RequestId String E69C8998-1787-4999-8C75-D663FF1173CF

请求ID

Success Boolean true

请求成功与否标识。

示例

请求示例

http(s)://cloudesl.cn-hangzhou.aliyuncs.com/?Action=ComposePlanogramPositions
&ActionType=ADD_POSITION
&BeAutoRefresh=false
&Shelf=20200201
&StoreId=s-dxsxx****
&<公共请求参数>

正常返回示例

XML 格式

<ComposePlanogramPositions>
      <code>200</code>
      <data>
            <RequestId>8F124625-DF0A-4B08-B205-2CF538FAF713</RequestId>
            <Success>true</Success>
      </data>
      <requestId>8F124625-DF0A-4B08-B205-2CF538FAF713</requestId>
      <successResponse>true</successResponse>
</ComposePlanogramPositions>

JSON 格式

{
    "code": 200,
    "data": {
        "RequestId": "8F124625-DF0A-4B08-B205-2CF538FAF713",
        "Success": true
    },
    "requestId": "8F124625-DF0A-4B08-B205-2CF538FAF713",
    "successResponse": true
}

错误码

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