文档中心 > API类目 > 菜鸟仓配API

taobao.wlb.wms.stock.in.order.notify (入库通知单)

入库通知单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_code String 必须 PO0000123 入库单据编码
store_code String 必须 STORE_666110 仓库编码
order_type Number 必须 601 单据类型 601普通入库单、501销退入库单、302 调拨入库单、904其他入库单、306 B2B入库
inbound_type_desc String 可选 加工归还 可选择性文本透传至WMS,比如加工归还、委外归还、借出归还、内部归还等
order_flag String 可选 9 订单标记以逗号分隔: 9:上门退货入库 13: 退货时是否收取发票,默认不收取(即没13为多选项,如1,2,8,9)
order_create_time Date 必须 2015-03-16 17:13:16 单据创建时间
supplier_code String 可选 demo 供应商编码,往来单位编码
supplier_name String 可选 xx有限公司 供应商名称 ,往来单位名称
tms_service_code String 可选 demo 配送公司编码,拒收(非妥投)的销退订单,由ERP填充原单配送公司编码
tms_service_name String 可选 德邦物流 快递公司名称
tms_order_code String 可选 292934291 运单号&托运单号 1) 入库单支持多运单号录入 2) 销退场景下如果是拒收(非妥投运单)由ERP填充原运单号
prev_order_code String 可选 EC000003 来源单据号,如销售退货时填充原销售订单号
return_reason String 可选 消费者7天无理由退货 销退时请提供退货的原因
expect_start_time String 可选 20150331 预期送达开始时间
expect_end_time String 可选 20150331 预期送达结束时间
extend_fields String 可选 a:1;b:2 扩展属性, key-value结构,格式要求: 以英文分号“;”分隔每组key-value,以英文冒号“:”分隔key与value。如果value中带有分号,需要转成下划线“_”,如果带有冒号,需要转成中划线“-”
remark String 可选 xxxx 备注,销退入库订单需要留言备注填充到此字段
sender_info Senderinfowlbwmsstockinordernotifywl 可选 系统自动生成
  • └ sender_phone
  • String
  • 可选
  • 0571-234567
  • 发件方电话
  • └ sender_mobile
  • String
  • 可选
  • 1551234123
  • 发件方手机
  • └ sender_name
  • String
  • 可选
  • demo
  • 发件方名称,销退场景下填写买家名称; 调拨场景下填写调拨出仓库名称;
  • └ sender_code
  • String
  • 可选
  • demo
  • 发件方编码,销退场景下填写买家nick,旺旺号等; 调拨场景下填写调拨出仓库编码;
  • └ sender_address
  • String
  • 可选
  • xx路xx号xx室
  • 发件方地址
  • └ sender_town
  • String
  • 可选
  • xx镇
  • 发件方镇
  • └ sender_area
  • String
  • 可选
  • 余杭区
  • 发件方区县
  • └ sender_city
  • String
  • 可选
  • 杭州市
  • 发件方城市
  • └ sender_province
  • String
  • 可选
  • 浙江省
  • 发件方省份
  • └ sender_zip_code
  • String
  • 可选
  • 293123
  • 发件方邮编
receiver_info Receiverinfowlbwmsstockinordernotifywl 可选 系统自动生成
  • └ receiver_phone
  • String
  • 可选
  • 0571-234567
  • 收件人手机
  • └ receiver_mobile
  • String
  • 可选
  • 1551234123
  • 收件人手机
  • └ receiver_name
  • String
  • 可选
  • 张三
  • 收件人名称
  • └ receiver_address
  • String
  • 可选
  • xx路xx号xx室
  • 收件方地址
  • └ receiver_area
  • String
  • 可选
  • 余杭区
  • 收件人区县
  • └ receiver_city
  • String
  • 可选
  • 杭州市
  • 收件人城市
  • └ receiver_province
  • String
  • 可选
  • 浙江省
  • 收件人省份
  • └ receiver_zip_code
  • String
  • 可选
  • 293123
  • 收件人邮编
  • └ receiver_town
  • String
  • 可选
  • xx镇
  • 收件人镇
order_item_list Orderitemlistwlbwmsstockinordernotifywl [] 必须
  • 最大列表长度:5000
  • 系统自动生成
    • order_item
    • Orderitemwlbwmsstockinordernotifywl
    • 必须
    • 系统自动生成
    • └ extend_fields
    • String
    • 可选
    • demo
    • 订单商品拓展属性
    • └ produce_code
    • String
    • 可选
    • p20120626
    • 生产批号
    • └ due_date
    • Date
    • 可选
    • 2015-03-16 17:13:16
    • 失效日期
    • └ produce_date
    • Date
    • 可选
    • 2015-03-16 23:40:49
    • 生产日期
    • └ batch_code
    • String
    • 可选
    • wh20150309
    • 批次编号
    • └ purchase_price
    • Number
    • 可选
    • 99
    • 采购价格
    • └ item_quantity
    • Number
    • 必须
    • 999
    • 商品数量
    • └ inventory_type
    • Number
    • 必须
    • 1
    • 库存类型 1 正品 101 残次 102 机损 103 箱损 201 冻结库存 301 在途库存
    • └ item_id
    • String
    • 必须
    • 123456
    • 后端商品ID
    • └ order_item_id
    • String
    • 必须
    • 000001
    • ERP单据明细ID

    响应参数

    名称 类型 示例值 描述
    wl_error_msg String 系统异常 错误详细
    wl_error_code String S07 错误编码
    wl_success Boolean false 是否成功
    order_code String 系统自动生成

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    WlbWmsStockInOrderNotifyRequest req = new WlbWmsStockInOrderNotifyRequest();
    req.setOrderCode("PO0000123");
    req.setStoreCode("STORE_666110");
    req.setOrderType(601L);
    req.setInboundTypeDesc("加工归还");
    req.setOrderFlag("9");
    req.setOrderCreateTime(StringUtils.parseDateTime("2015-03-16 17:13:16"));
    req.setSupplierCode("demo");
    req.setSupplierName("xx有限公司");
    req.setTmsServiceCode("demo");
    req.setTmsServiceName("德邦物流");
    req.setTmsOrderCode("292934291");
    req.setPrevOrderCode("EC000003");
    req.setReturnReason("消费者7天无理由退货");
    req.setExpectStartTime("20150331");
    req.setExpectEndTime("20150331");
    req.setExtendFields("a:1;b:2");
    req.setRemark("xxxx");
    WlbWmsStockInOrderNotifyRequest.Senderinfowlbwmsstockinordernotifywl obj1 = new WlbWmsStockInOrderNotifyRequest.Senderinfowlbwmsstockinordernotifywl();
    obj1.setSenderPhone("0571-234567");
    obj1.setSenderMobile("1551234123");
    obj1.setSenderName("demo");
    obj1.setSenderCode("demo");
    obj1.setSenderAddress("xx路xx号xx室");
    obj1.setSenderTown("xx镇");
    obj1.setSenderArea("余杭区");
    obj1.setSenderCity("杭州市");
    obj1.setSenderProvince("浙江省");
    obj1.setSenderZipCode("293123");
    req.setSenderInfo(obj1);
    WlbWmsStockInOrderNotifyRequest.Receiverinfowlbwmsstockinordernotifywl obj2 = new WlbWmsStockInOrderNotifyRequest.Receiverinfowlbwmsstockinordernotifywl();
    obj2.setReceiverPhone("0571-234567");
    obj2.setReceiverMobile("1551234123");
    obj2.setReceiverName("张三");
    obj2.setReceiverAddress("xx路xx号xx室");
    obj2.setReceiverArea("余杭区");
    obj2.setReceiverCity("杭州市");
    obj2.setReceiverProvince("浙江省");
    obj2.setReceiverZipCode("293123");
    obj2.setReceiverTown("xx镇");
    req.setReceiverInfo(obj2);
    List<WlbWmsStockInOrderNotifyRequest.Orderitemlistwlbwmsstockinordernotifywl> list4 = new ArrayList<WlbWmsStockInOrderNotifyRequest.Orderitemlistwlbwmsstockinordernotifywl>();
    WlbWmsStockInOrderNotifyRequest.Orderitemlistwlbwmsstockinordernotifywl obj5 = new WlbWmsStockInOrderNotifyRequest.Orderitemlistwlbwmsstockinordernotifywl();
    list4.add(obj5);
    WlbWmsStockInOrderNotifyRequest.Orderitemwlbwmsstockinordernotifywl obj7 = new WlbWmsStockInOrderNotifyRequest.Orderitemwlbwmsstockinordernotifywl();
    obj7.setExtendFields("demo");
    obj7.setProduceCode("p20120626");
    obj7.setDueDate(StringUtils.parseDateTime("2015-03-16 17:13:16"));
    obj7.setProduceDate(StringUtils.parseDateTime("2015-03-16 23:40:49"));
    obj7.setBatchCode("wh20150309");
    obj7.setPurchasePrice(99L);
    obj7.setItemQuantity(999L);
    obj7.setInventoryType(1L);
    obj7.setItemId("123456");
    obj7.setOrderItemId("000001");
    list6.setOrderItem(obj7);
    req.setOrderItemList(list4);
    WlbWmsStockInOrderNotifyResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <wlb_wms_stock_in_order_notify_response>
        <wl_error_msg>系统异常</wl_error_msg>
        <wl_error_code>S07</wl_error_code>
        <wl_success>false</wl_success>
        <order_code></order_code>
    </wlb_wms_stock_in_order_notify_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

    返回
    顶部