注意:以下文档只适用于TOP接口,请谨慎使用!

taobao.inventory.plan.front.operate (商品负卖库存增删改)

商品负卖库存增删改

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
front_plan_operate_request FrontPlanOperateRequest 可选 请求体
  • upsert_list
  • UpsertInfo []
  • 可选
  • list
  • 新增、修改负卖库存的列表
  • └ delivery_time
  • String
  • 可选
  • 2025-01-01
  • 负卖发货时间
  • └ adjust_quantity
  • Number
  • 可选
  • 10
  • 负卖库存更新数量;必须大于等于0
  • └ adjust_type
  • String
  • 可选
  • increase
  • 负卖库存更新方向;increase=增加;decrease=减少
  • └ delivery_type
  • String
  • 可选
  • absolute
  • 负卖发货时间类型;absolute=绝对时间;relative=相对时间
  • └ batch_id
  • String
  • 可选
  • null
  • 批次ID;新增负卖库存行时不填;更新负卖库存行时比天
  • └ sku_id
  • Number
  • 可选
  • 12345677
  • SKUID,item无SKU时,skuId会设置为0
  • delete_list
  • DeleteInfo []
  • 可选
  • list
  • 删除负卖库存的列表
  • └ delivery_time
  • String
  • 可选
  • 2025-01-01
  • 负卖发货时间
  • └ delivery_type
  • String
  • 可选
  • absolute
  • 负卖发货时间类型;absolute=绝对时间;relative=相对时间
  • └ batch_id
  • String
  • 可选
  • 99998888
  • 批次ID;必填
  • └ sku_id
  • Number
  • 可选
  • 12345665
  • skuId,必填,商品无SKU时,填0
  • └ item_id
  • Number
  • 必须
  • 123456789
  • 商品ID
  • └ sale_time_range
  • String []
  • 可选
  • []
  • 负卖库存的销售时间,如果商家支持自定义销售时间,则必填;如果商家不支持自定义销售时间,则不传
  • └ template_id
  • Number
  • 可选
  • 12345678
  • 模板ID,有则传,没有则不传。
  • └ operate_code
  • String
  • 可选
  • 748acd8c1e794984a1d26576a5d5b06c
  • UUID,用于幂等

响应参数

名称 类型 示例值 描述
result Result result
  • └ success
  • Boolean
  • false
  • success
  • └ error_message
  • String
  • itemId=960170737812:不能编辑负卖库存值
  • errorMessage
  • └ error_code
  • String
  • IPC_PARAMETER_ERROR
  • errorCode
  • └ idempotence_success
  • Boolean
  • false
  • 本次请求成功时,是否为幂等成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
InventoryPlanFrontOperateRequest req = new InventoryPlanFrontOperateRequest();
InventoryPlanFrontOperateRequest.FrontPlanOperateRequest obj1 = new InventoryPlanFrontOperateRequest.FrontPlanOperateRequest();
List<InventoryPlanFrontOperateRequest.UpsertInfo> list3 = new ArrayList<InventoryPlanFrontOperateRequest.UpsertInfo>();
InventoryPlanFrontOperateRequest.UpsertInfo obj4 = new InventoryPlanFrontOperateRequest.UpsertInfo();
list3.add(obj4);
obj4.setDeliveryTime("2025-01-01");
obj4.setAdjustQuantity(10L);
obj4.setAdjustType("increase");
obj4.setDeliveryType("absolute");
obj4.setBatchId("null");
obj4.setSkuId(12345677L);
obj1.setUpsertList(list3);
List<InventoryPlanFrontOperateRequest.DeleteInfo> list6 = new ArrayList<InventoryPlanFrontOperateRequest.DeleteInfo>();
InventoryPlanFrontOperateRequest.DeleteInfo obj7 = new InventoryPlanFrontOperateRequest.DeleteInfo();
list6.add(obj7);
obj7.setDeliveryTime("2025-01-01");
obj7.setDeliveryType("absolute");
obj7.setBatchId("99998888");
obj7.setSkuId(12345665L);
obj1.setDeleteList(list6);
obj1.setItemId(123456789L);
obj1.setSaleTimeRange("");
obj1.setTemplateId(12345678L);
obj1.setOperateCode("748acd8c1e794984a1d26576a5d5b06c");
req.setFrontPlanOperateRequest(obj1);
InventoryPlanFrontOperateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<inventory_plan_front_operate_response>
    <result>
        <success>false</success>
        <error_message>itemId=960170737812:不能编辑负卖库存值</error_message>
        <error_code>IPC_PARAMETER_ERROR</error_code>
        <idempotence_success>false</idempotence_success>
    </result>
</inventory_plan_front_operate_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部