文档中心 > API类目 > 银泰开放平台

alibaba.mos.stockout.create (出库单创建)

出库单创建——专柜出库单创建,在专柜货品返厂、该专柜调往其他专柜等出库场景时使用。不适用于商家仓的出库。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
create_request StockOutCreateRequest 必须 出库单入参对象
  • delivery_order
  • StockOutDeliveryOrderCreateDto
  • 必须
  • 出库单信息
  • └ create_time
  • Date
  • 必须
  • 2016-09-09 12:00:00
  • 出库单创建时间(YYYY-MM-DD HH:MM:SS),指对接供应商自己系统单据的创建时间。
  • └ delivery_order_code
  • String
  • 必须
  • TB1234
  • 出库单号
  • └ logistics_code
  • String
  • 可选
  • SF
  • 物流公司编码(SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通 、ZTO=中通(ZTO)、HTKY=百世汇通、UC=优速、STO=申通、TTKDEX=天天快递、QFKD=全峰、FAST=快捷、POSTB=邮政小包、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、AMAZON=亚马逊物流、OTHER=其他;只传英文编码)
  • └ logistics_name
  • String
  • 可选
  • 顺丰
  • 物流公司名称(包括干线物流公司等)
  • └ operate_time
  • Date
  • 可选
  • 2016-09-09 12:00:00
  • 操作时间
  • └ operator_code
  • String
  • 可选
  • 4584
  • 操作人编码
  • └ operator_name
  • String
  • 可选
  • 张三
  • 操作人姓名
  • └ order_source_type
  • String
  • 可选
  • VIP
  • 出库单渠道类型,VIP=唯品会,FX=分销 ,SHOP=门店
  • └ order_type
  • String
  • 必须
  • PTCK
  • 出库单类型(PTCK=普通出库单;DBCK=调拨出库;B2BCK=B2B出库;QTCK=其他出库;CGTH=采购退货出库单;XNCK=虚拟出库单, JITCK=唯品出库)。目前仅支持普通出库单。
  • └ owner_code
  • String
  • 必须
  • HZ01-00092
  • 货主编码(银泰专柜号)
  • picker_info
  • StockOutPickerCreateInfo
  • 可选
  • 提货人信息
  • └ car_no
  • String
  • 可选
  • XA1234
  • 车牌号
  • └ company
  • String
  • 可选
  • 天猫
  • 公司名称
  • └ id
  • String
  • 可选
  • 1232344322
  • 证件号
  • └ mobile
  • String
  • 可选
  • 123421234
  • 移动电话
  • └ name
  • String
  • 可选
  • 老王
  • 姓名
  • └ tel
  • String
  • 可选
  • 897765
  • 固定电话
  • └ plan_delivery_date
  • Date
  • 可选
  • 2016-09-09 12:00:00
  • 计划出库时间
  • receiver_info
  • StockOutReceiverCreateInfo
  • 可选
  • 收件人信息
  • └ area
  • String
  • 可选
  • 余杭
  • 区域
  • └ city
  • String
  • 可选
  • 杭州
  • 城市
  • └ company
  • String
  • 可选
  • 淘宝
  • 公司名称
  • └ country_code
  • String
  • 可选
  • CN
  • 国家二字码
  • └ detail_address
  • String
  • 可选
  • 杭州市余杭区989号
  • 详细地址
  • └ email
  • String
  • 可选
  • 878987654@qq.com
  • 电子邮箱
  • └ id
  • String
  • 可选
  • 4713242536
  • 证件号
  • └ id_number
  • String
  • 可选
  • 1234567
  • 收件人证件号码
  • └ id_type
  • String
  • 可选
  • 1
  • 收件人证件类型(1-身份证、2-军官证、3-护照、4-其他)
  • └ mobile
  • String
  • 可选
  • 13423456785
  • 移动电话
  • └ name
  • String
  • 可选
  • 老王
  • 姓名
  • └ province
  • String
  • 可选
  • 浙江省
  • 省份
  • └ tel
  • String
  • 可选
  • 808786543
  • 固定电话
  • └ town
  • String
  • 可选
  • 横加桥
  • 村镇
  • └ zip_code
  • String
  • 可选
  • 043300
  • 邮编
  • └ receiving_time
  • Date
  • 可选
  • 2016-09-09 12:00:00
  • 到货时间(YYYY-MM-DD HH:MM:SS)
  • related_orders
  • RelatedOrderDto []
  • 可选
  • 关联单据信息
  • └ order_code
  • String
  • 可选
  • CG
  • 关联的订单类型(CG=采购单;DB=调拨单;CK=出库单;RK=入库单;只传英文编码)
  • └ order_type
  • String
  • 可选
  • GL1234
  • 关联的订单编号
  • └ remark
  • String
  • 可选
  • 备注信息
  • 备注
  • └ schedule_date
  • Date
  • 可选
  • 2016-09-09 12:00:00
  • 要求出库时间(YYYY-MM-DD HH:MM:SS)
  • sender_info
  • StockOutSenderCreateInfo
  • 可选
  • 发件人信息
  • └ area
  • String
  • 可选
  • 余杭
  • 区域
  • └ city
  • String
  • 可选
  • 杭州
  • 城市
  • └ company
  • String
  • 可选
  • 淘宝
  • 公司名称
  • └ country_code
  • String
  • 可选
  • CN
  • 国家二字码
  • └ detail_address
  • String
  • 可选
  • 杭州市余杭区989号
  • 详细地址
  • └ email
  • String
  • 可选
  • 345@gmail.com
  • 电子邮箱
  • └ id
  • String
  • 可选
  • 476543213245733
  • 证件号
  • └ mobile
  • String
  • 可选
  • 13214567869
  • 移动电话
  • └ name
  • String
  • 可选
  • 老王
  • 姓名
  • └ province
  • String
  • 可选
  • 浙江省
  • 省份
  • └ tel
  • String
  • 可选
  • 81020340
  • 固定电话
  • └ town
  • String
  • 可选
  • 横加桥
  • 村镇
  • └ zip_code
  • String
  • 可选
  • 043300
  • 邮编
  • └ shipping_time
  • Date
  • 可选
  • 2016-09-09 12:00:00
  • 送货时间(YYYY-MM-DD HH:MM:SS)
  • └ supplier_code
  • String
  • 可选
  • TB
  • 供应商编码
  • └ supplier_name
  • String
  • 可选
  • 淘宝
  • 供应商名称
  • └ target_entry_order_code
  • String
  • 可选
  • 5sd4564
  • 关联的入库单号(ERP分配)
  • └ target_warehouse_code
  • String
  • 可选
  • 564854
  • 入库仓库编码, string (50) ,统仓统配等无需ERP指定仓储编码的情况填OTHER
  • └ target_warehouse_name
  • String
  • 可选
  • 15481
  • 入库仓库名称, string (50)
  • └ total_order_lines
  • Number
  • 必须
  • 12
  • 单据总行数(当单据需要分多个请求发送时;发送方需要将totalOrderLines填入;接收方收到后;根据实际接收到的条数和totalOrderLines进行比对;如果小于;则继续等待接收请求。如果等于;则表示该单据的所有请求发送完成.)
  • └ transport_mode
  • String
  • 可选
  • 自提
  • 提货方式(到仓自提、快递、干线物流)
  • └ warehouse_code
  • String
  • 必须
  • CK1234
  • 仓库编码(银泰仓id)
  • └ warehouse_name
  • String
  • 可选
  • 123
  • 仓库名称
  • └ extend_props
  • String
  • 可选
  • {}
  • 扩展属性
  • order_lines
  • StockOutOrderCreateLine []
  • 必须
  • 单据信息(一次最多20行)
  • └ batch_code
  • String
  • 可选
  • 123
  • 批次编码
  • └ expire_date
  • Date
  • 可选
  • 2016-09-09 12:00:00
  • 过期日期(YYYY-MM-DD HH:MM:SS)
  • └ extend_props
  • String
  • 可选
  • {}
  • 扩展属性
  • └ inventory_type
  • String
  • 必须
  • ZP
  • 库存类型(ZP=正品;CC=残次;JS=机损;XS= 箱损;默认为ZP,当前仅支持正品)
  • └ item_code
  • String
  • 必须
  • I1234
  • 商品唯一id(即单品信息录入或整款数字化(整款)信息录入接口的 outerId)
  • └ item_id
  • String
  • 可选
  • W1234
  • 仓储系统商品编码
  • └ item_name
  • String
  • 可选
  • 淘公仔
  • 商品名称
  • └ order_line_no
  • String
  • 必须
  • 11
  • 单据行号
  • └ out_biz_code
  • String
  • 必须
  • OB1234
  • 外部业务编码(消息ID;用于去重;当单据需要分批次发送时使用)
  • └ owner_code
  • String
  • 可选
  • HZ01-00092
  • 货主编码(银泰专柜号)
  • └ plan_qty
  • BigDecimal
  • 必须
  • 11
  • 应发商品数量(即商品的入库数量)
  • └ platform_code
  • String
  • 可选
  • 123456789
  • 交易平台商品编码
  • └ produce_code
  • String
  • 可选
  • P11233
  • 生产批号
  • └ product_date
  • Date
  • 可选
  • 2016-09-09 00:00:00
  • 生产日期(YYYY-MM-DD HH:MM:SS)
  • └ unit
  • String
  • 可选
  • 个/箱/盒等
  • 单位

响应参数

名称 类型 示例值 描述
result ResultDo {} 返回结果
  • data
  • OrderCreateResult
  • {}
  • 数据
  • └ order_number
  • String
  • 123456
  • 银泰出库单号
  • └ result_message
  • String
  • 返回信息
  • 返回信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaMosStockoutCreateRequest req = new AlibabaMosStockoutCreateRequest();
AlibabaMosStockoutCreateRequest.StockOutCreateRequest obj1 = new AlibabaMosStockoutCreateRequest.StockOutCreateRequest();
AlibabaMosStockoutCreateRequest.StockOutDeliveryOrderCreateDto obj2 = new AlibabaMosStockoutCreateRequest.StockOutDeliveryOrderCreateDto();
obj2.setCreateTime(StringUtils.parseDateTime("2016-09-09 12:00:00"));
obj2.setDeliveryOrderCode("TB1234");
obj2.setLogisticsCode("SF");
obj2.setLogisticsName("顺丰");
obj2.setOperateTime(StringUtils.parseDateTime("2016-09-09 12:00:00"));
obj2.setOperatorCode("4584");
obj2.setOperatorName("张三");
obj2.setOrderSourceType("VIP");
obj2.setOrderType("PTCK");
obj2.setOwnerCode("HZ01-00092");
AlibabaMosStockoutCreateRequest.StockOutPickerCreateInfo obj3 = new AlibabaMosStockoutCreateRequest.StockOutPickerCreateInfo();
obj3.setCarNo("XA1234");
obj3.setCompany("天猫");
obj3.setId("1232344322");
obj3.setMobile("123421234");
obj3.setName("老王");
obj3.setTel("897765");
obj2.setPickerInfo(obj3);
obj2.setPlanDeliveryDate(StringUtils.parseDateTime("2016-09-09 12:00:00"));
AlibabaMosStockoutCreateRequest.StockOutReceiverCreateInfo obj4 = new AlibabaMosStockoutCreateRequest.StockOutReceiverCreateInfo();
obj4.setArea("余杭");
obj4.setCity("杭州");
obj4.setCompany("淘宝");
obj4.setCountryCode("CN");
obj4.setDetailAddress("杭州市余杭区989号");
obj4.setEmail("878987654@qq.com");
obj4.setId("4713242536");
obj4.setIdNumber("1234567");
obj4.setIdType("1");
obj4.setMobile("13423456785");
obj4.setName("老王");
obj4.setProvince("浙江省");
obj4.setTel("808786543");
obj4.setTown("横加桥");
obj4.setZipCode("043300");
obj2.setReceiverInfo(obj4);
obj2.setReceivingTime(StringUtils.parseDateTime("2016-09-09 12:00:00"));
List<AlibabaMosStockoutCreateRequest.RelatedOrderDto> list6 = new ArrayList<AlibabaMosStockoutCreateRequest.RelatedOrderDto>();
AlibabaMosStockoutCreateRequest.RelatedOrderDto obj7 = new AlibabaMosStockoutCreateRequest.RelatedOrderDto();
list6.add(obj7);
obj7.setOrderCode("CG");
obj7.setOrderType("GL1234");
obj2.setRelatedOrders(list6);
obj2.setRemark("备注信息");
obj2.setScheduleDate(StringUtils.parseDateTime("2016-09-09 12:00:00"));
AlibabaMosStockoutCreateRequest.StockOutSenderCreateInfo obj8 = new AlibabaMosStockoutCreateRequest.StockOutSenderCreateInfo();
obj8.setArea("余杭");
obj8.setCity("杭州");
obj8.setCompany("淘宝");
obj8.setCountryCode("CN");
obj8.setDetailAddress("杭州市余杭区989号");
obj8.setEmail("345@gmail.com");
obj8.setId("476543213245733");
obj8.setMobile("13214567869");
obj8.setName("老王");
obj8.setProvince("浙江省");
obj8.setTel("81020340");
obj8.setTown("横加桥");
obj8.setZipCode("043300");
obj2.setSenderInfo(obj8);
obj2.setShippingTime(StringUtils.parseDateTime("2016-09-09 12:00:00"));
obj2.setSupplierCode("TB");
obj2.setSupplierName("淘宝");
obj2.setTargetEntryOrderCode("5sd4564");
obj2.setTargetWarehouseCode("564854");
obj2.setTargetWarehouseName("15481");
obj2.setTotalOrderLines(12L);
obj2.setTransportMode("自提");
obj2.setWarehouseCode("CK1234");
obj2.setWarehouseName("123");
obj1.setDeliveryOrder(obj2);
obj1.setExtendProps("{}");
List<AlibabaMosStockoutCreateRequest.StockOutOrderCreateLine> list10 = new ArrayList<AlibabaMosStockoutCreateRequest.StockOutOrderCreateLine>();
AlibabaMosStockoutCreateRequest.StockOutOrderCreateLine obj11 = new AlibabaMosStockoutCreateRequest.StockOutOrderCreateLine();
list10.add(obj11);
obj11.setBatchCode("123");
obj11.setExpireDate(StringUtils.parseDateTime("2016-09-09 12:00:00"));
obj11.setExtendProps("{}");
obj11.setInventoryType("ZP");
obj11.setItemCode("I1234");
obj11.setItemId("W1234");
obj11.setItemName("淘公仔");
obj11.setOrderLineNo("11");
obj11.setOutBizCode("OB1234");
obj11.setOwnerCode("HZ01-00092");
obj11.setPlanQty("11");
obj11.setPlatformCode("123456789");
obj11.setProduceCode("P11233");
obj11.setProductDate(StringUtils.parseDateTime("2016-09-09 00:00:00"));
obj11.setUnit("个/箱/盒等");
obj1.setOrderLines(list10);
req.setCreateRequest(obj1);
AlibabaMosStockoutCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_mos_stockout_create_response>
    <result>
        <data>
            <order_number>123456</order_number>
            <result_message>返回信息</result_message>
        </data>
    </result>
</alibaba_mos_stockout_create_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>

错误码解释

错误码 错误描述 解决方案
isv.goods-error 传入的商品有问题 检查商品outId是否正确,或者商品是否入过库
isv.auth-error 权限验证出错 请检查是否有权限操作当前专柜的数据

API工具

如何获得此API

FAQ

返回
顶部