文档中心 > API类目 > 全球速卖通-物流管理

cainiao.global.logistic.order.create (创建物流订单)

创建物流订单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_param OpenOrderParam 必须 订单参数
  • trade_order_param
  • OpenTradeOrderParam
  • 必须
  • 交易单参数
  • └ trade_order_id
  • Number
  • 必须
  • 12423
  • 主交易单ID
  • solution_param
  • OpenSolutionParam
  • 必须
  • 解决方案参数
  • └ solution_code
  • String
  • 必须
  • CAINIAO_STANDARD
  • 解决方案code
  • service_params
  • OpenServiceParam []
  • 必须
  • 物流服务列表
  • └ code
  • String
  • 必须
  • DOOR_PICKUP
  • DOOR_PICKUP:上门揽收;SELF_POST:自寄;SELF_SEND:自送;UNREACHABLE_RETURN:不可达退回;
  • features
  • Features
  • 必须
  • 不同物流服务的扩展信息
  • └ warehouse_code
  • String
  • 可选
  • TRAN_STORE_30228135
  • 自送仓资源编码
  • └ service_resource_code
  • String
  • 可选
  • CAINIAO_STANDARD_30228135
  • 自送仓资源所对应的schemeCode
  • └ express_mail_no
  • String
  • 可选
  • LBxxxx001
  • 自寄时快递公司运单号
  • └ express_company_id
  • String
  • 可选
  • 100
  • 自寄时快递公司的ID
  • └ express_company_name
  • String
  • 可选
  • 顺丰快递
  • 自寄时快递公司的名称
  • package_params
  • OpenPackageParam []
  • 必须
  • 包裹参数
  • └ length
  • Number
  • 可选
  • 12
  • 包裹长度
  • └ width
  • Number
  • 可选
  • 324
  • 包裹宽度
  • └ height
  • Number
  • 可选
  • 12
  • 包裹高度
  • └ weight
  • Number
  • 可选
  • 23
  • 包裹重量
  • └ price
  • Number
  • 可选
  • 12
  • 包裹价格
  • item_params
  • OpenItemParam []
  • 必须
  • 商品参数
  • └ item_id
  • Number
  • 必须
  • 12453
  • 商品ID
  • └ quantity
  • Number
  • 必须
  • 1
  • 商品数量
  • └ english_name
  • String
  • 必须
  • mouse
  • 商品英文名称
  • └ local_name
  • String
  • 必须
  • 鼠标
  • 商品本地名称
  • └ unit_price
  • Number
  • 必须
  • 1
  • 商品单价,单位结算币种最小单位,如人民币分
  • └ sku
  • String
  • 必须
  • sku
  • sku
  • └ sc_item_id
  • Number
  • 可选
  • 1
  • 后台商品ID
  • └ weight
  • Number
  • 必须
  • 12
  • 商品重量,单位g
  • └ item_features
  • String []
  • 可选
  • cf_normal
  • 商品属性,cf_normal:普货、cf_has_battery:含电。
  • └ currency
  • String
  • 必须
  • USD
  • 商品价格币种
  • └ total_price
  • Number
  • 必须
  • 1232
  • 商品总价
  • └ length
  • Number
  • 可选
  • 21
  • 商品长度
  • └ width
  • Number
  • 可选
  • 2
  • 商品宽度
  • └ height
  • Number
  • 可选
  • 1
  • 商品高度
  • └ currency
  • String
  • 可选
  • USD
  • 包裹价格币种,CNY:人民币、USD:美元、RUB:卢布。
  • seller_info_param
  • OpenSellerInfoParam
  • 必须
  • 商家信息参数
  • └ top_user_key
  • String
  • 可选
  • 1343
  • 跨店铺组包时的店铺分组ID
  • sender_param
  • OpenSenderParam
  • 必须
  • 发件人信息
  • └ seller_address_id
  • Number
  • 必须
  • 1244
  • 卖家后台地址id,用来获取卖家详细地址信息,传入值为Long型;
  • returner_param
  • OpenReturnerParam
  • 必须
  • 退货联系人信息
  • └ seller_address_id
  • Number
  • 必须
  • 12442
  • 卖家后台地址id,用来获取卖家详细地址信息,传入值为Long型;
  • receiver_param
  • ReceiverParam
  • 必须
  • 收件人信息
  • └ name
  • String
  • 可选
  • 张三
  • 收件人名称
  • └ telephone
  • String
  • 可选
  • 1023923
  • 收件人座机号
  • └ mobile_phone
  • String
  • 可选
  • 435433
  • 收件人手机号
  • address_param
  • OpenAddressParam
  • 可选
  • 收件人地址信息
  • └ division_id
  • Number
  • 可选
  • 124
  • 最小区划地址库ID
  • └ zip_code
  • String
  • 可选
  • 4545
  • 邮编
  • └ country_name
  • String
  • 可选
  • 中国
  • 国家名称
  • └ province
  • String
  • 可选
  • 浙江省
  • 省份
  • └ city
  • String
  • 可选
  • 杭州市
  • 城市
  • └ district
  • String
  • 可选
  • 西湖区
  • └ street
  • String
  • 可选
  • 文一西路
  • 街道
  • └ detail_address
  • String
  • 可选
  • 610号
  • 详细地址
  • └ country_code
  • String
  • 可选
  • RU
  • 国家二字码,CN:中国、RU:俄罗斯
  • └ user_nick
  • String
  • 可选
  • cnxxx
  • 用户昵称
  • └ email
  • String
  • 可选
  • test@alibaba-inc.com
  • 邮箱
  • pickup_info_param
  • OpenPickupInfoParam
  • 可选
  • 揽收信息参数
  • └ seller_address_id
  • Number
  • 必须
  • 12442
  • 卖家后台地址id,用来获取卖家详细地址信息,传入值为Long型;
locale String 可选 ru_RU
  • 默认值:en_US
  • 多语言

    响应参数

    名称 类型 示例值 描述
    is_success String true 创建是否成功
    need_retry Boolean false 是否需要重试
    result OpenTakingOrderResponse new 请求结果
    • └ logistics_order_id
    • Number
    • 19382
    • 物流订单ID
    error_info ErrorInfo xxx 错误信息
    • └ error_code
    • String
    • B-090-0100-10-15-216
    • 错误码
    • └ error_msg
    • String
    • 地址不能为空
    • 错误描述

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    CainiaoGlobalLogisticOrderCreateRequest req = new CainiaoGlobalLogisticOrderCreateRequest();
    CainiaoGlobalLogisticOrderCreateRequest.OpenOrderParam obj1 = new CainiaoGlobalLogisticOrderCreateRequest.OpenOrderParam();
    CainiaoGlobalLogisticOrderCreateRequest.OpenTradeOrderParam obj2 = new CainiaoGlobalLogisticOrderCreateRequest.OpenTradeOrderParam();
    obj2.setTradeOrderId(12423L);
    obj1.setTradeOrderParam(obj2);
    CainiaoGlobalLogisticOrderCreateRequest.OpenSolutionParam obj3 = new CainiaoGlobalLogisticOrderCreateRequest.OpenSolutionParam();
    obj3.setSolutionCode("CAINIAO_STANDARD");
    List<CainiaoGlobalLogisticOrderCreateRequest.OpenServiceParam> list5 = new ArrayList<CainiaoGlobalLogisticOrderCreateRequest.OpenServiceParam>();
    CainiaoGlobalLogisticOrderCreateRequest.OpenServiceParam obj6 = new CainiaoGlobalLogisticOrderCreateRequest.OpenServiceParam();
    list5.add(obj6);
    obj6.setCode("DOOR_PICKUP");
    CainiaoGlobalLogisticOrderCreateRequest.Features obj8 = new CainiaoGlobalLogisticOrderCreateRequest.Features();
    obj8.setWarehouseCode("TRAN_STORE_30228135");
    obj8.setServiceResourceCode("CAINIAO_STANDARD_30228135");
    obj8.setExpressMailNo("LBxxxx001");
    obj8.setExpressCompanyId("100");
    obj8.setExpressCompanyName("顺丰快递");
    list7.setFeatures(obj8);
    obj3.setServiceParams(list5);
    obj1.setSolutionParam(obj3);
    List<CainiaoGlobalLogisticOrderCreateRequest.OpenPackageParam> list10 = new ArrayList<CainiaoGlobalLogisticOrderCreateRequest.OpenPackageParam>();
    CainiaoGlobalLogisticOrderCreateRequest.OpenPackageParam obj11 = new CainiaoGlobalLogisticOrderCreateRequest.OpenPackageParam();
    list10.add(obj11);
    obj11.setLength(12L);
    obj11.setWidth(324L);
    obj11.setHeight(12L);
    obj11.setWeight(23L);
    obj11.setPrice(12L);
    List<CainiaoGlobalLogisticOrderCreateRequest.OpenItemParam> list14 = new ArrayList<CainiaoGlobalLogisticOrderCreateRequest.OpenItemParam>();
    CainiaoGlobalLogisticOrderCreateRequest.OpenItemParam obj15 = new CainiaoGlobalLogisticOrderCreateRequest.OpenItemParam();
    list14.add(obj15);
    obj15.setItemId(12453L);
    obj15.setQuantity(1L);
    obj15.setEnglishName("mouse");
    obj15.setLocalName("鼠标");
    obj15.setUnitPrice(1L);
    obj15.setSku("sku");
    obj15.setScItemId(1L);
    obj15.setWeight(12L);
    obj15.setItemFeatures("cf_normal");
    obj15.setCurrency("USD");
    obj15.setTotalPrice(1232L);
    obj15.setLength(21L);
    obj15.setWidth(2L);
    obj15.setHeight(1L);
    list12.setItemParams(list14);
    obj11.setCurrency("USD");
    obj1.setPackageParams(list10);
    CainiaoGlobalLogisticOrderCreateRequest.OpenSellerInfoParam obj16 = new CainiaoGlobalLogisticOrderCreateRequest.OpenSellerInfoParam();
    obj16.setTopUserKey("1343");
    obj1.setSellerInfoParam(obj16);
    CainiaoGlobalLogisticOrderCreateRequest.OpenSenderParam obj17 = new CainiaoGlobalLogisticOrderCreateRequest.OpenSenderParam();
    obj17.setSellerAddressId(1244L);
    obj1.setSenderParam(obj17);
    CainiaoGlobalLogisticOrderCreateRequest.OpenReturnerParam obj18 = new CainiaoGlobalLogisticOrderCreateRequest.OpenReturnerParam();
    obj18.setSellerAddressId(12442L);
    obj1.setReturnerParam(obj18);
    CainiaoGlobalLogisticOrderCreateRequest.ReceiverParam obj19 = new CainiaoGlobalLogisticOrderCreateRequest.ReceiverParam();
    obj19.setName("张三");
    obj19.setTelephone("1023923");
    obj19.setMobilePhone("435433");
    CainiaoGlobalLogisticOrderCreateRequest.OpenAddressParam obj20 = new CainiaoGlobalLogisticOrderCreateRequest.OpenAddressParam();
    obj20.setDivisionId(124L);
    obj20.setZipCode("4545");
    obj20.setCountryName("中国");
    obj20.setProvince("浙江省");
    obj20.setCity("杭州市");
    obj20.setDistrict("西湖区");
    obj20.setStreet("文一西路");
    obj20.setDetailAddress("610号");
    obj20.setCountryCode("RU");
    obj19.setAddressParam(obj20);
    obj19.setUserNick("cnxxx");
    obj19.setEmail("test@alibaba-inc.com");
    obj1.setReceiverParam(obj19);
    CainiaoGlobalLogisticOrderCreateRequest.OpenPickupInfoParam obj21 = new CainiaoGlobalLogisticOrderCreateRequest.OpenPickupInfoParam();
    obj21.setSellerAddressId(12442L);
    obj1.setPickupInfoParam(obj21);
    req.setOrderParam(obj1);
    req.setLocale("ru_RU");
    CainiaoGlobalLogisticOrderCreateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <cainiao_global_logistic_order_create_response>
        <is_success>true</is_success>
        <need_retry>false</need_retry>
        <result>
            <logistics_order_id>19382</logistics_order_id>
        </result>
        <error_info>
            <error_code>B-090-0100-10-15-216</error_code>
            <error_msg>地址不能为空</error_msg>
        </error_info>
    </cainiao_global_logistic_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

    返回
    顶部