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

qimen.aliexpress.logistics.createwarehouseorder (创建线上物流订单)

创建线上发货物流订单 关于中国邮政平常小包 使用说明请参见http://seller.aliexpress.com/so/onlinelogistics_postbj.php

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
id String 必须 cn12343523 卖家登录的login_id
address_d_t_os AddressDTOs 必须 addresses
  • refund
  • AeopWlDeclareAddressDTO
  • 必须
  • refund address
  • └ mobile
  • String
  • 可选
  • 18766234324
  • 电话
  • └ street_address
  • String
  • 可选
  • street address
  • 详细地址
  • └ province
  • String
  • 可选
  • Moscow
  • 省份
  • └ name
  • String
  • 可选
  • Linda
  • 姓名
  • └ address_id
  • Number
  • 必须
  • 1000
  • 卖家后台地址id,用来获取卖家详细地址信息,传入值为Long型;传入addressId后,其余字段值无效。
  • └ email
  • String
  • 可选
  • alibaba@alibaba.com
  • 邮箱
  • └ county
  • String
  • 可选
  • county
  • └ city
  • String
  • 可选
  • Moscow
  • 城市
  • └ country
  • String
  • 可选
  • RU
  • 国家
  • └ street
  • String
  • 可选
  • street
  • 街道
  • └ post_code
  • String
  • 可选
  • 056202
  • 邮编
  • └ trademanage_id
  • String
  • 可选
  • cn234234234
  • 旺旺
  • └ member_type
  • String
  • 可选
  • refund
  • 类型
  • └ fax
  • String
  • 可选
  • 234234234
  • 传真
  • └ phone
  • String
  • 可选
  • 098-234234
  • 电话
  • receiver
  • AeopWlDeclareAddressDTO
  • 必须
  • receiver address
  • └ mobile
  • String
  • 可选
  • 18766234324
  • 电话
  • └ street_address
  • String
  • 可选
  • street address
  • 详细地址
  • └ province
  • String
  • 可选
  • Moscow
  • 省份
  • └ name
  • String
  • 可选
  • Linda
  • 姓名
  • └ address_id
  • Number
  • 可选
  • 1000
  • 卖家后台地址id,用来获取卖家详细地址信息,传入值为Long型;传入addressId后,其余字段值无效。
  • └ email
  • String
  • 可选
  • alibaba@alibaba.com
  • 邮箱
  • └ county
  • String
  • 可选
  • county
  • └ city
  • String
  • 可选
  • Moscow
  • 城市
  • └ country
  • String
  • 可选
  • RU
  • 国家
  • └ post_code
  • String
  • 可选
  • 056202
  • 邮编
  • └ street
  • String
  • 可选
  • street
  • 街道
  • └ trademanage_id
  • String
  • 可选
  • cn234234234
  • 旺旺
  • └ member_type
  • String
  • 可选
  • receiver
  • 类型
  • └ fax
  • String
  • 可选
  • 234234234
  • 传真
  • └ phone
  • String
  • 可选
  • 098-234234
  • 电话
  • pickup
  • AeopWlDeclareAddressDTO
  • 可选
  • pickup address
  • └ mobile
  • String
  • 可选
  • 18766234324
  • 电话
  • └ street_address
  • String
  • 可选
  • street address
  • 详细地址
  • └ province
  • String
  • 可选
  • Moscow
  • 省份
  • └ name
  • String
  • 可选
  • Linda
  • 姓名
  • └ address_id
  • Number
  • 可选
  • 1000
  • 卖家后台地址id,用来获取卖家详细地址信息,传入值为Long型;传入addressId后,其余字段值无效。
  • └ email
  • String
  • 可选
  • alibaba@alibaba.com
  • 邮箱
  • └ county
  • String
  • 可选
  • county
  • └ city
  • String
  • 可选
  • Moscow
  • 城市
  • └ country
  • String
  • 可选
  • RU
  • 国家
  • └ street
  • String
  • 可选
  • street
  • 街道
  • └ post_code
  • String
  • 可选
  • 056202
  • 邮编
  • └ trademanage_id
  • String
  • 可选
  • cn234234234
  • 旺旺
  • └ member_type
  • String
  • 可选
  • pickup
  • 类型
  • └ fax
  • String
  • 可选
  • 234234234
  • 传真
  • └ phone
  • String
  • 可选
  • 098-234234
  • 电话
  • sender
  • AeopWlDeclareAddressDTO
  • 必须
  • sender address
  • └ mobile
  • String
  • 可选
  • 18766234324
  • 电话
  • └ street_address
  • String
  • 可选
  • street address
  • 详细地址
  • └ province
  • String
  • 可选
  • Moscow
  • 省份
  • └ name
  • String
  • 可选
  • Linda
  • 姓名
  • └ address_id
  • Number
  • 必须
  • 1000
  • 卖家后台地址id,用来获取卖家详细地址信息,传入值为Long型;传入addressId后,其余字段值无效。
  • └ email
  • String
  • 可选
  • alibaba@alibaba.com
  • 邮箱
  • └ county
  • String
  • 可选
  • county
  • └ city
  • String
  • 可选
  • Moscow
  • 城市
  • └ country
  • String
  • 可选
  • RU
  • 国家
  • └ street
  • String
  • 可选
  • street
  • 街道
  • └ post_code
  • String
  • 可选
  • 056202
  • 邮编
  • └ trademanage_id
  • String
  • 可选
  • cn234234234
  • 旺旺
  • └ member_type
  • String
  • 可选
  • sender
  • 类型
  • └ fax
  • String
  • 可选
  • 234234234
  • 传真
  • └ phone
  • String
  • 可选
  • 098-234234
  • 电话
declare_product_d_t_os AeopWlDeclareProductForTopDTO [] 可选
  • 最大列表长度:999
  • 申报产品信息,列表类型,以json格式来表达。{productId为产品ID(必填,如为礼品,则设置为0);categoryCnDesc为申报中文名称(必填,长度1-20);categoryEnDesc为申报英文名称(必填,长度1-60);productNum产品件数(必填1-999);productDeclareAmount为产品申报金额(必填,0.01-10000.00);productWeight为产品申报重量(必填0.001-2.000);isContainsBattery为是否包含锂电池(必填0/1);scItemId为仓储发货属性代码(团购订单,仓储发货必填,物流服务为RUSTON 哈尔滨备货仓 HRB_WLB_RUSTONHEB,属性代码对应AE商品的sku属性一级,暂时没有提供接口查询属性代码,可以在仓储管理--库存管理页面查看,例如: 团购产品的sku属性White对应属性代码 40414943126);skuValue为属性名称(团购订单,仓储发货必填,例如:White);hsCode为产品海关编码,获取相关数据请至:http://www.customs.gov.cn/Tabid/67737/Default.aspx};isAneroidMarkup为是否含非液体化妆品(必填,填0代表不含非液体化妆品;填1代表含非液体化妆品;默认为0);isOnlyBattery为是否含纯电池产品(必填,填0代表不含纯电池产品;填1代表含纯电池产品;默认为0);
    • └ sku_value
    • String
    • 可选
    • sku value
    • SKU名称
    • └ sku_code
    • String
    • 可选
    • sku code
    • SKU编码
    • └ sc_item_name
    • String
    • 可选
    • scItem name
    • scItem name
    • └ sc_item_id
    • String
    • 可选
    • 1000
    • scItem id
    • └ sc_item_code
    • String
    • 可选
    • scItem code
    • scItem code
    • └ product_weight
    • String
    • 可选
    • 1.5
    • 产品重量
    • └ product_num
    • Number
    • 可选
    • 2
    • 产品数量
    • └ product_id
    • Number
    • 可选
    • 1000
    • 商品ID
    • └ product_declare_amount
    • String
    • 可选
    • 1.3
    • 产品申报金额
    • └ only_battery
    • Boolean
    • 可选
    • false
    • 是否纯电池
    • └ hs_code
    • String
    • 可选
    • 77234
    • 海关编码
    • └ contains_battery
    • Boolean
    • 可选
    • false
    • 是否包含电池
    • └ category_en_desc
    • String
    • 可选
    • dress
    • 类目英文名称
    • └ category_cn_desc
    • String
    • 可选
    • 连衣裙
    • 类目中文名称
    • └ breakable
    • Boolean
    • 可选
    • false
    • 是否易碎
    • └ aneroid_markup
    • Boolean
    • 可选
    • false
    • 判断是否属于非液体化妆品
    • └ child_order_id
    • Number
    • 可选
    • 1000172130022100
    • 交易子单号
    domestic_logistics_company String 可选 tiantiankuaidi 国内快递公司名称,物流公司Id为-1时,必填
    domestic_logistics_company_id Number 必须 505 国内快递ID(物流公司是other时,ID为-1)
    domestic_tracking_no String 必须 L12345899 国内快递运单号,长度1-32
    package_num Number 可选 1 包裹数量: 创建国家小包订单时非必填,创建国家快递订单时必填
    trade_order_from String 必须 ESCROW 订单来源
    trade_order_id Number 必须 66715700375804 交易订单号
    undeliverable_decision Number 可选 0 不可达处理(退回:0/销毁:1) 。详情请参考:http://bbs.seller.aliexpress.com/bbs/read.php?tid=514111
    warehouse_carrier_service String 必须 CPAM_WLB_FPXSZ;CPAM_WLB_CPHSH;CPAM_WLB_ZTOBJ;HRB_WLB_ZTOGZ;HRB_WLB_ZTOSH 根据订单号获取线上发货物流方案“API获取用户选择的实际发货物流服务(物流服务key,即仓库服务名称)例如:HRB_WLB_ZTOGZ是 中俄航空 Ruston广州仓库; HRB_WLB_RUSTONHEB为哈尔滨备货仓暂不支持,该渠道请做忽略。
    top_user_key String 可选 xxx ISV用户唯一标识,一般为ISV自己的userId,最大长度为16个字符
    insurance_coverage Money 可选 包裹保额
    • └ cent
    • Number
    • 可选
    • 99
    • └ currency_code
    • String
    • 可选
    • USD
    • 币种三字码

    响应参数

    名称 类型 示例值 描述
    result AeopWlCreateWarehouseOrderResultDTO 创建订单返回的结果
    • └ warehouse_order_id
    • Number
    • 3017539175
    • 物流订单号
    • └ trade_order_id
    • Number
    • 66715700375804
    • 交易订单号
    • └ trade_order_from
    • String
    • ESCROW
    • 订单来源
    • └ success
    • Boolean
    • true
    • 创建订单是否成功
    • └ out_order_id
    • Number
    • 35631664365
    • 外部订单号
    • └ intl_tracking_no
    • String
    • LN123123123CN
    • 国际运单号
    • └ error_desc
    • String
    • System error
    • 创建时错误信息
    • └ error_code
    • Number
    • 1
    • 创建时错误码(1表示无错误)
    result_success Boolean false 调用是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
    AliexpressLogisticsCreatewarehouseorderRequest req = new AliexpressLogisticsCreatewarehouseorderRequest();
    req.setId("cn12343523");
    AliexpressLogisticsCreatewarehouseorderRequest.AddressDTOs obj1 = new AliexpressLogisticsCreatewarehouseorderRequest.AddressDTOs();
    AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareAddressDTO obj2 = new AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareAddressDTO();
    obj2.setMobile("18766234324");
    obj2.setStreetAddress("street address");
    obj2.setProvince("Moscow");
    obj2.setName("Linda");
    obj2.setAddressId(1000L);
    obj2.setEmail("alibaba@alibaba.com");
    obj2.setCounty("county");
    obj2.setCity("Moscow");
    obj2.setCountry("RU");
    obj2.setStreet("street");
    obj2.setPostCode("056202");
    obj2.setTrademanageId("cn234234234");
    obj2.setMemberType("refund");
    obj2.setFax("234234234");
    obj2.setPhone("098-234234");
    obj1.setRefund(obj2);
    AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareAddressDTO obj3 = new AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareAddressDTO();
    obj3.setMobile("18766234324");
    obj3.setStreetAddress("street address");
    obj3.setProvince("Moscow");
    obj3.setName("Linda");
    obj3.setAddressId(1000L);
    obj3.setEmail("alibaba@alibaba.com");
    obj3.setCounty("county");
    obj3.setCity("Moscow");
    obj3.setCountry("RU");
    obj3.setPostCode("056202");
    obj3.setStreet("street");
    obj3.setTrademanageId("cn234234234");
    obj3.setMemberType("receiver");
    obj3.setFax("234234234");
    obj3.setPhone("098-234234");
    obj1.setReceiver(obj3);
    AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareAddressDTO obj4 = new AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareAddressDTO();
    obj4.setMobile("18766234324");
    obj4.setStreetAddress("street address");
    obj4.setProvince("Moscow");
    obj4.setName("Linda");
    obj4.setAddressId(1000L);
    obj4.setEmail("alibaba@alibaba.com");
    obj4.setCounty("county");
    obj4.setCity("Moscow");
    obj4.setCountry("RU");
    obj4.setStreet("street");
    obj4.setPostCode("056202");
    obj4.setTrademanageId("cn234234234");
    obj4.setMemberType("pickup");
    obj4.setFax("234234234");
    obj4.setPhone("098-234234");
    obj1.setPickup(obj4);
    AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareAddressDTO obj5 = new AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareAddressDTO();
    obj5.setMobile("18766234324");
    obj5.setStreetAddress("street address");
    obj5.setProvince("Moscow");
    obj5.setName("Linda");
    obj5.setAddressId(1000L);
    obj5.setEmail("alibaba@alibaba.com");
    obj5.setCounty("county");
    obj5.setCity("Moscow");
    obj5.setCountry("RU");
    obj5.setStreet("street");
    obj5.setPostCode("056202");
    obj5.setTrademanageId("cn234234234");
    obj5.setMemberType("sender");
    obj5.setFax("234234234");
    obj5.setPhone("098-234234");
    obj1.setSender(obj5);
    req.setAddressDTOs(obj1);
    List<AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareProductForTopDTO> list7 = new ArrayList<AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareProductForTopDTO>();
    AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareProductForTopDTO obj8 = new AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareProductForTopDTO();
    list7.add(obj8);
    obj8.setSkuValue("sku value");
    obj8.setSkuCode("sku code");
    obj8.setScItemName("scItem name");
    obj8.setScItemId("1000");
    obj8.setScItemCode("scItem code");
    obj8.setProductWeight("1.5");
    obj8.setProductNum(2L);
    obj8.setProductId(1000L);
    obj8.setProductDeclareAmount("1.3");
    obj8.setOnlyBattery(false);
    obj8.setHsCode("77234");
    obj8.setContainsBattery(false);
    obj8.setCategoryEnDesc("dress");
    obj8.setCategoryCnDesc("连衣裙");
    obj8.setBreakable(false);
    obj8.setAneroidMarkup(false);
    obj8.setChildOrderId(1000172130022100L);
    req.setDeclareProductDTOs(list7);
    req.setDomesticLogisticsCompany("tiantiankuaidi");
    req.setDomesticLogisticsCompanyId(505L);
    req.setDomesticTrackingNo("L12345899");
    req.setPackageNum(1L);
    req.setTradeOrderFrom("ESCROW");
    req.setTradeOrderId(66715700375804L);
    req.setUndeliverableDecision(0L);
    req.setWarehouseCarrierService("CPAM_WLB_FPXSZ;CPAM_WLB_CPHSH;CPAM_WLB_ZTOBJ;HRB_WLB_ZTOGZ;HRB_WLB_ZTOSH");
    req.setTopUserKey("xxx");
    AliexpressLogisticsCreatewarehouseorderRequest.Money obj9 = new AliexpressLogisticsCreatewarehouseorderRequest.Money();
    obj9.setCent(99L);
    obj9.setCurrencyCode("USD");
    req.setInsuranceCoverage(obj9);
    AliexpressLogisticsCreatewarehouseorderResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <result>
        <warehouse_order_id>3017539175</warehouse_order_id>
        <trade_order_id>66715700375804</trade_order_id>
        <trade_order_from>ESCROW</trade_order_from>
        <success>true</success>
        <out_order_id>35631664365</out_order_id>
        <intl_tracking_no>LN123123123CN</intl_tracking_no>
        <error_desc>System error</error_desc>
        <error_code>1</error_code>
    </result>
    <result_success>false</result_success>
    

    异常示例

    • 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

    返回
    顶部