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

tmall.qimendc.stockchange.report (库存变动通知接口)

wms通过库存变动接口通知奇门中心更新库存,只要有变动,不管是库存异动还是正常出库都需要调用该接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
items StockchangeReportItemDto [] 可选
  • 最大列表长度:999
  • 变更内容
    • └ warehouse_code
    • String
    • 可选
    • sz001
    • 仓库编码
    • └ change_time
    • String
    • 可选
    • '2018-03-31'
    • 异动时间
    • └ order_type
    • String
    • 可选
    • JYCK
    • 单据类型。JYCK= 一般交易出库单,HHCK= 换货出库 ,BFCK= 补发出库 PTCK=普通出库单,DBCK=调拨出库 ,QTCK=其他出库, SCRK=生产入库,LYRK=领用入库,CCRK=残次品入库,CGRK=采购入库 ,DBRK= 调拨入库 ,QTRK= 其他入库 ,XTRK= 销退入库 HHRK= 换货入库 CNJG= 仓内加工单 ZTTZ=状态调整单
    • └ order_code
    • String
    • 可选
    • 123456
    • 引起异动的单据编码
    • └ inventory_type
    • String
    • 可选
    • ZP
    • 库存类型。ZP=正品, CC=残次
    • └ quantity
    • Number
    • 可选
    • 123
    • 商品变化量
    • └ out_biz_code
    • String
    • 可选
    • 123
    • 外部业务编码, 消息ID, 用于去重,用来保证因为网络等原因导致重复传输,请求不会被重复处理
    • └ item_id
    • String
    • 可选
    • 123
    • 仓储系统商品ID
    • └ total_qty
    • Number
    • 可选
    • 123
    • 变动后的未冻结商品总量
    • └ total_lock_qty
    • Number
    • 可选
    • 123
    • 变动后的冻结商品总量
    • └ owner_code
    • String
    • 可选
    • 985336
    • 货主编码
    • └ item_code
    • String
    • 可选
    • ipx256
    • 商品编码
    • └ changed_lock_qty
    • Number
    • 可选
    • 123
    • 冻结商品变动数量,可以为负数,与total_lock_qty有且只有一个有值
    • └ changed_qty
    • Number
    • 可选
    • 123
    • 未冻结商品变动量,可以为负数。与total_qty有且只有一个有值
    customerid String 可选 customerid customerid

    响应参数

    名称 类型 示例值 描述
    qimendc_code Number 200 状态码
    qimendc_request_id String 9essd131. 本次请求的id
    qimendc_message String 请求成功 信息
    qimendc_success Boolean false 是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallQimendcStockchangeReportRequest req = new TmallQimendcStockchangeReportRequest();
    List<TmallQimendcStockchangeReportRequest.StockchangeReportItemDto> list2 = new ArrayList<TmallQimendcStockchangeReportRequest.StockchangeReportItemDto>();
    TmallQimendcStockchangeReportRequest.StockchangeReportItemDto obj3 = new TmallQimendcStockchangeReportRequest.StockchangeReportItemDto();
    list2.add(obj3);
    obj3.setWarehouseCode("sz001");
    obj3.setChangeTime("'2018-03-31'");
    obj3.setOrderType("JYCK");
    obj3.setOrderCode("123456");
    obj3.setInventoryType("ZP");
    obj3.setQuantity(123L);
    obj3.setOutBizCode("123");
    obj3.setItemId("123");
    obj3.setTotalQty(123L);
    obj3.setTotalLockQty(123L);
    obj3.setOwnerCode("985336");
    obj3.setItemCode("ipx256");
    obj3.setChangedLockQty(123L);
    obj3.setChangedQty(123L);
    req.setItems(list2);
    req.setCustomerid("customerid");
    TmallQimendcStockchangeReportResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_qimendc_stockchange_report_response>
        <qimendc_code>200</qimendc_code>
        <qimendc_request_id>9essd131.</qimendc_request_id>
        <qimendc_message>请求成功</qimendc_message>
        <qimendc_success>false</qimendc_success>
    </tmall_qimendc_stockchange_report_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

    返回
    顶部