文档中心 > API类目 > 奇门中心API

tmall.qimendc.inventory.sync (库存同步)

提供给WMS补充历史库存数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
cp_code String 可选 HN123 仓配商编码
date String 可选 2018-03-01 日期,格式yyyy-MM-dd
customer_id String 可选 23423647 货主ID
biz_register_num String 可选 310114002150000 工商注册码
items InventoryItemDo [] 可选
  • 最大列表长度:100
  • 商品
    • └ warehouse_code
    • String
    • 可选
    • SZ001
    • 仓库编码
    • └ item_name
    • String
    • 可选
    • 天猫精灵
    • 商品名
    • └ produce_code
    • String
    • 可选
    • 1
    • 生产批号
    • └ batch_code
    • String
    • 可选
    • 1
    • 批次编码
    • └ lock_quantity
    • Number
    • 可选
    • 100
    • 未冻结库存数量
    • └ inventory_type
    • String
    • 可选
    • ZP
    • 库存类型(ZP=正品;CC=残次;JS=机损;XS= 箱损;ZT=在途库存)
    • └ expire_date
    • String
    • 可选
    • 2019-11-11
    • 商品过期日期(YYYY-MM-DD)
    • └ quantity
    • Number
    • 可选
    • 12
    • 未冻结库存数量
    • └ item_id
    • String
    • 可选
    • sn1234
    • 仓储系统商品ID
    • └ product_date
    • String
    • 可选
    • 2017-11-11
    • 商品生产日期(YYYY-MM-DD)
    • └ item_code
    • String
    • 可选
    • ABC123
    • 商品编码
    req_id String 可选 8374523s 请求id

    响应参数

    名称 类型 示例值 描述
    qimendc_code Number 200 topCode
    qimendc_request_id String isvnenv93 requestId
    qimendc_message String 请求成功 topMessage
    qimendc_success Boolean false success

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallQimendcInventorySyncRequest req = new TmallQimendcInventorySyncRequest();
    req.setCpCode("HN123");
    req.setDate("2018-03-01");
    req.setCustomerId("23423647");
    req.setBizRegisterNum("310114002150000");
    List<TmallQimendcInventorySyncRequest.InventoryItemDo> list2 = new ArrayList<TmallQimendcInventorySyncRequest.InventoryItemDo>();
    TmallQimendcInventorySyncRequest.InventoryItemDo obj3 = new TmallQimendcInventorySyncRequest.InventoryItemDo();
    list2.add(obj3);
    obj3.setWarehouseCode("SZ001");
    obj3.setItemName("天猫精灵");
    obj3.setProduceCode("1");
    obj3.setBatchCode("1");
    obj3.setLockQuantity(100L);
    obj3.setInventoryType("ZP");
    obj3.setExpireDate("2019-11-11");
    obj3.setQuantity(12L);
    obj3.setItemId("sn1234");
    obj3.setProductDate("2017-11-11");
    obj3.setItemCode("ABC123");
    req.setItems(list2);
    req.setReqId("8374523s");
    TmallQimendcInventorySyncResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_qimendc_inventory_sync_response>
        <qimendc_code>200</qimendc_code>
        <qimendc_request_id>isvnenv93</qimendc_request_id>
        <qimendc_message>请求成功</qimendc_message>
        <qimendc_success>false</qimendc_success>
    </tmall_qimendc_inventory_sync_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

    返回
    顶部