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

cainiao.bms.order.create (创建菜鸟BMS订单)

通过接口,在菜鸟商家工作台创建订单,并通过商家工作台进行发货管理。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
shop_code String 必须 XXX旗舰店 店铺信息
trade_id String 必须 423623243513 交易单号
created Date 必须 2016-10-15 13:30:00 创建时间
pay_time Date 必须 2016-11-29 13:30:00 支付时间
buyer_nick String 可选 张小三儿 买家名称"
receiver_country String 可选 中国
  • 默认值:中国
  • 收货人国籍
    receiver_state String 必须 浙江省 收货省
    receiver_city String 必须 杭州市 收货市
    receiver_district String 可选 余杭区 收货区
    receiver_town String 可选 仓前镇 街道
    receiver_address String 必须 文一路969号 收货地址
    receiver_phone String 可选 0571-888888 收货人电话,手机与电话不可同时为空
    receiver_mobile String 可选 13800138000 收货人手机,手机与电话不可同时为空
    receiver_name String 必须 张三 收货人名称
    receiver_zip String 必须 300000 收货邮编
    is_invoice Boolean 可选 false
  • 默认值:false
  • 是否打印发票
    invoice_type Number 可选 1 发票类型(1 电子、2 纸质)
    invoice_title String 可选 个人 发票抬头
    invoice_amount Number 可选 24000
  • 默认值:0
  • 发票金额,单位分
    is_cod Boolean 可选 false
  • 默认值:false
  • 是否COD
    order_amount Number 必须 24000 订单总金额,单位分
    paied_amount Number 必须 20000 支付金额,单位分
    wait_pay_amount Number 必须 3000 应收金额,单位分
    discount_fee Number 可选 0
  • 默认值:0
  • 优惠金额,单位分
    post_fee Number 可选 0
  • 默认值:0
  • 快递费,单位分
    cod_fee Number 可选 0
  • 默认值:0
  • COD服务费
    buyer_message String 可选 发正品 买家留言
    items Items [] 可选
  • 最大列表长度:20
  • demo
    • item
    • Item
    • 可选
    • demo
    • └ sub_trade_id
    • String
    • 可选
    • 453245135
    • 子交易单号
    • └ item_code
    • String
    • 可选
    • XXX宝贝
    • 宝贝名称
    • └ item_name
    • String
    • 可选
    • 49813751
    • 货品编码
    • └ num
    • String
    • 可选
    • 2
    • 数量
    • └ price
    • String
    • 可选
    • 12000
    • "商品单价,单位分
    • └ total_fee
    • String
    • 可选
    • 24000
    • 子单总金额,单位分
    • └ discount_fee
    • String
    • 可选
    • 0
    • 子单优惠金额,单位分
    seller_memo String 可选 有赠品 卖家备注
    order_type String 可选 0
  • 默认值:0
  • 订单类型,默认0,普通销售订单,3:B2B单

    响应参数

    名称 类型 示例值 描述

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    CainiaoBmsOrderCreateRequest req = new CainiaoBmsOrderCreateRequest();
    req.setShopCode("XXX旗舰店");
    req.setTradeId("423623243513");
    req.setCreated(StringUtils.parseDateTime("2016-10-15 13:30:00"));
    req.setPayTime(StringUtils.parseDateTime("2016-11-29 13:30:00"));
    req.setBuyerNick("张小三儿");
    req.setReceiverCountry("中国");
    req.setReceiverState("浙江省");
    req.setReceiverCity("杭州市");
    req.setReceiverDistrict("余杭区");
    req.setReceiverTown("仓前镇");
    req.setReceiverAddress("文一路969号");
    req.setReceiverPhone("0571-888888");
    req.setReceiverMobile("13800138000");
    req.setReceiverName("张三");
    req.setReceiverZip("300000");
    req.setIsInvoice(false);
    req.setInvoiceType(1L);
    req.setInvoiceTitle("个人");
    req.setInvoiceAmount(24000L);
    req.setIsCod(false);
    req.setOrderAmount(24000L);
    req.setPaiedAmount(20000L);
    req.setWaitPayAmount(3000L);
    req.setDiscountFee(0L);
    req.setPostFee(0L);
    req.setCodFee(0L);
    req.setBuyerMessage("发正品");
    List<CainiaoBmsOrderCreateRequest.Items> list2 = new ArrayList<CainiaoBmsOrderCreateRequest.Items>();
    CainiaoBmsOrderCreateRequest.Items obj3 = new CainiaoBmsOrderCreateRequest.Items();
    list2.add(obj3);
    CainiaoBmsOrderCreateRequest.Item obj5 = new CainiaoBmsOrderCreateRequest.Item();
    obj5.setSubTradeId("453245135");
    obj5.setItemCode("XXX宝贝");
    obj5.setItemName("49813751");
    obj5.setNum("2");
    obj5.setPrice("12000");
    obj5.setTotalFee("24000");
    obj5.setDiscountFee("0");
    list4.setItem(obj5);
    req.setItems(list2);
    req.setSellerMemo("有赠品");
    req.setOrderType("0");
    CainiaoBmsOrderCreateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <cainiao_bms_order_create_response>
    </cainiao_bms_order_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>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部