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

创建线上发货物流订单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
address_d_t_os Addressdtos 必须 addresses
  • sender
  • AeopWlDeclareAddressDto
  • 可选
  • sender address
  • └ phone
  • String
  • 可选
  • 098-234234
  • 电话
  • └ fax
  • String
  • 可选
  • 234234234
  • 传真
  • └ member_type
  • String
  • 可选
  • 类型
  • 类型
  • └ trademanage_id
  • String
  • 可选
  • cn234234234
  • 旺旺
  • └ street
  • String
  • 可选
  • street
  • 街道
  • └ country
  • String
  • 可选
  • RU
  • 国家
  • └ city
  • String
  • 可选
  • Moscow
  • 城市
  • └ county
  • String
  • 可选
  • county
  • └ email
  • String
  • 可选
  • alibaba@alibaba.com
  • 邮箱
  • └ address_id
  • Number
  • 必须
  • 1000
  • 卖家后台地址id,用来获取卖家详细地址信息,传入值为Long型;传入addressId后,其余字段值无效。
  • └ name
  • String
  • 可选
  • Linda
  • 姓名
  • └ province
  • String
  • 可选
  • Moscow
  • 省份
  • └ street_address
  • String
  • 可选
  • street address
  • 详细地址
  • └ mobile
  • String
  • 可选
  • 18766234324
  • 电话
  • └ post_code
  • String
  • 可选
  • 056202
  • 邮编
  • pickup
  • AeopWlDeclareAddressDto
  • 可选
  • pickup address
  • └ phone
  • String
  • 可选
  • 098-234234
  • 电话
  • └ fax
  • String
  • 可选
  • 234234234
  • 传真
  • └ member_type
  • String
  • 可选
  • 类型
  • 类型
  • └ trademanage_id
  • String
  • 可选
  • cn234234234
  • 旺旺
  • └ street
  • String
  • 可选
  • street
  • 街道
  • └ country
  • String
  • 可选
  • RU
  • 国家
  • └ city
  • String
  • 可选
  • Moscow
  • 城市
  • └ county
  • String
  • 可选
  • county
  • └ email
  • String
  • 可选
  • alibaba@alibaba.com
  • 邮箱
  • └ address_id
  • Number
  • 必须
  • 1000
  • 卖家后台地址id,用来获取卖家详细地址信息,传入值为Long型;传入addressId后,其余字段值无效。
  • └ name
  • String
  • 可选
  • Linda
  • 姓名
  • └ province
  • String
  • 可选
  • Moscow
  • 省份
  • └ street_address
  • String
  • 可选
  • street address
  • 详细地址
  • └ mobile
  • String
  • 可选
  • 18766234324
  • 电话
  • └ post_code
  • String
  • 可选
  • 056202
  • 邮编
  • └ from_warehouse_code
  • String
  • 可选
  • AML001
  • 仓Code
  • receiver
  • AeopWlDeclareAddressDto
  • 必须
  • receiver address
  • └ phone
  • String
  • 可选
  • 098-234234
  • 电话
  • └ fax
  • String
  • 可选
  • 234234234
  • 传真
  • └ member_type
  • String
  • 可选
  • 类型
  • 类型
  • └ trademanage_id
  • String
  • 可选
  • cn234234234
  • 旺旺
  • └ street
  • String
  • 可选
  • street
  • 街道
  • └ post_code
  • String
  • 可选
  • 056202
  • 邮编
  • └ country
  • String
  • 可选
  • RU
  • 国家
  • └ city
  • String
  • 可选
  • Moscow
  • 城市
  • └ county
  • String
  • 可选
  • county
  • └ email
  • String
  • 可选
  • alibaba@alibaba.com
  • 邮箱
  • └ address_id
  • Number
  • 可选
  • 1000
  • 卖家后台地址id,用来获取卖家详细地址信息,传入值为Long型;传入addressId后,其余字段值无效。
  • └ name
  • String
  • 可选
  • Linda
  • 姓名
  • └ province
  • String
  • 可选
  • Moscow
  • 省份
  • └ street_address
  • String
  • 可选
  • street address
  • 详细地址
  • └ mobile
  • String
  • 可选
  • 18766234324
  • 电话
  • refund
  • AeopWlDeclareAddressDto
  • 可选
  • refund address
  • └ phone
  • String
  • 可选
  • 098-234234
  • 电话
  • └ fax
  • String
  • 可选
  • 234234234
  • 传真
  • └ member_type
  • String
  • 可选
  • 类型
  • 类型
  • └ trademanage_id
  • String
  • 可选
  • cn234234234
  • 旺旺
  • └ street
  • String
  • 可选
  • street
  • 街道
  • └ country
  • String
  • 可选
  • RU
  • 国家
  • └ city
  • String
  • 可选
  • Moscow
  • 城市
  • └ county
  • String
  • 可选
  • county
  • └ email
  • String
  • 可选
  • alibaba@alibaba.com
  • 邮箱
  • └ address_id
  • Number
  • 必须
  • 1000
  • 卖家后台地址id,用来获取卖家详细地址信息,传入值为Long型;传入addressId后,其余字段值无效。
  • └ name
  • String
  • 可选
  • Linda
  • 姓名
  • └ province
  • String
  • 可选
  • Moscow
  • 省份
  • └ street_address
  • String
  • 可选
  • street address
  • 详细地址
  • └ mobile
  • String
  • 可选
  • 18766234324
  • 电话
  • └ post_code
  • String
  • 可选
  • 056202
  • 邮编
declare_product_d_t_os AeopWlDeclareProductForTopDto [] 必须
  • 最大列表长度:50
  • 申报产品信息,列表类型,以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);
    • └ aneroid_markup
    • Boolean
    • 可选
    • false
    • 判断是否属于非液体化妆品
    • └ breakable
    • Boolean
    • 可选
    • false
    • 是否易碎
    • └ category_cn_desc
    • String
    • 可选
    • 连衣裙
    • 类目中文名称
    • └ category_en_desc
    • String
    • 可选
    • dress
    • 类目英文名称
    • └ contains_battery
    • Boolean
    • 可选
    • false
    • 是否包含电池
    • └ hs_code
    • String
    • 可选
    • 77234
    • 海关编码
    • └ only_battery
    • Boolean
    • 可选
    • false
    • 是否纯电池
    • └ product_declare_amount
    • String
    • 可选
    • 1.3
    • 产品申报金额
    • └ product_id
    • Number
    • 可选
    • 1000
    • 商品ID
    • └ product_num
    • Number
    • 可选
    • 2
    • 产品数量
    • └ product_weight
    • String
    • 可选
    • 1.5
    • 产品重量
    • └ sc_item_code
    • String
    • 可选
    • scItem code
    • scItem code
    • └ sc_item_id
    • Number
    • 可选
    • 1000
    • scItem id
    • └ sc_item_name
    • String
    • 可选
    • scItem name
    • scItem name
    • └ sku_code
    • String
    • 可选
    • sku code
    • sku code
    • └ sku_value
    • String
    • 可选
    • sku value
    • sku value
    • └ contains_special_goods
    • 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
  • 默认值:0
  • 包裹数量: 创建国家小包订单时非必填,创建国家快递订单时必填
    trade_order_from String 必须 ESCROW 订单来源
    trade_order_id Number 必须 66715700375804 交易订单号
    undeliverable_decision Number 可选 0
  • 默认值:-1
  • 不可达处理(退回: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为哈尔滨备货仓暂不支持,该渠道请做忽略。
    invoice_number String 可选 38577123 发票号(可空)
    top_user_key String 可选 xxxxxxx
  • 最大长度:16
  • ISV用户唯一标识,一般为userId,最大长度为16个字符
    insurance_coverage Money 可选 包裹保额
    • └ cent
    • Number
    • 可选
    • 99
    • 默认值:0
    • └ currency_code
    • String
    • 可选
    • USD
    • 币种三字码
    is_agree_upgrade_reverse_parcel_insure Boolean 可选 true 是否同意升级逆向高货值保险

    响应参数

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

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AliexpressLogisticsCreatewarehouseorderRequest req = new AliexpressLogisticsCreatewarehouseorderRequest();
    AliexpressLogisticsCreatewarehouseorderRequest.Addressdtos obj1 = new AliexpressLogisticsCreatewarehouseorderRequest.Addressdtos();
    AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareAddressDto obj2 = new AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareAddressDto();
    obj2.setPhone("098-234234");
    obj2.setFax("234234234");
    obj2.setMemberType("类型");
    obj2.setTrademanageId("cn234234234");
    obj2.setStreet("street");
    obj2.setCountry("RU");
    obj2.setCity("Moscow");
    obj2.setCounty("county");
    obj2.setEmail("alibaba@alibaba.com");
    obj2.setAddressId(1000L);
    obj2.setName("Linda");
    obj2.setProvince("Moscow");
    obj2.setStreetAddress("street address");
    obj2.setMobile("18766234324");
    obj2.setPostCode("056202");
    obj1.setSender(obj2);
    AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareAddressDto obj3 = new AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareAddressDto();
    obj3.setPhone("098-234234");
    obj3.setFax("234234234");
    obj3.setMemberType("类型");
    obj3.setTrademanageId("cn234234234");
    obj3.setStreet("street");
    obj3.setCountry("RU");
    obj3.setCity("Moscow");
    obj3.setCounty("county");
    obj3.setEmail("alibaba@alibaba.com");
    obj3.setAddressId(1000L);
    obj3.setName("Linda");
    obj3.setProvince("Moscow");
    obj3.setStreetAddress("street address");
    obj3.setMobile("18766234324");
    obj3.setPostCode("056202");
    obj3.setFromWarehouseCode("AML001");
    obj1.setPickup(obj3);
    AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareAddressDto obj4 = new AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareAddressDto();
    obj4.setPhone("098-234234");
    obj4.setFax("234234234");
    obj4.setMemberType("类型");
    obj4.setTrademanageId("cn234234234");
    obj4.setStreet("street");
    obj4.setPostCode("056202");
    obj4.setCountry("RU");
    obj4.setCity("Moscow");
    obj4.setCounty("county");
    obj4.setEmail("alibaba@alibaba.com");
    obj4.setAddressId(1000L);
    obj4.setName("Linda");
    obj4.setProvince("Moscow");
    obj4.setStreetAddress("street address");
    obj4.setMobile("18766234324");
    obj1.setReceiver(obj4);
    AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareAddressDto obj5 = new AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareAddressDto();
    obj5.setPhone("098-234234");
    obj5.setFax("234234234");
    obj5.setMemberType("类型");
    obj5.setTrademanageId("cn234234234");
    obj5.setStreet("street");
    obj5.setCountry("RU");
    obj5.setCity("Moscow");
    obj5.setCounty("county");
    obj5.setEmail("alibaba@alibaba.com");
    obj5.setAddressId(1000L);
    obj5.setName("Linda");
    obj5.setProvince("Moscow");
    obj5.setStreetAddress("street address");
    obj5.setMobile("18766234324");
    obj5.setPostCode("056202");
    obj1.setRefund(obj5);
    req.setAddressDTOs(obj1);
    List<AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareProductForTopDto> list7 = new ArrayList<AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareProductForTopDto>();
    AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareProductForTopDto obj8 = new AliexpressLogisticsCreatewarehouseorderRequest.AeopWlDeclareProductForTopDto();
    list7.add(obj8);
    obj8.setAneroidMarkup(false);
    obj8.setBreakable(false);
    obj8.setCategoryCnDesc("连衣裙");
    obj8.setCategoryEnDesc("dress");
    obj8.setContainsBattery(false);
    obj8.setHsCode("77234");
    obj8.setOnlyBattery(false);
    obj8.setProductDeclareAmount("1.3");
    obj8.setProductId(1000L);
    obj8.setProductNum(2L);
    obj8.setProductWeight("1.5");
    obj8.setScItemCode("scItem code");
    obj8.setScItemId(1000L);
    obj8.setScItemName("scItem name");
    obj8.setSkuCode("sku code");
    obj8.setSkuValue("sku value");
    obj8.setContainsSpecialGoods(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.setInvoiceNumber("38577123");
    req.setTopUserKey("xxxxxxx");
    AliexpressLogisticsCreatewarehouseorderRequest.Money obj9 = new AliexpressLogisticsCreatewarehouseorderRequest.Money();
    obj9.setCent(99L);
    obj9.setCurrencyCode("USD");
    req.setInsuranceCoverage(obj9);
    req.setIsAgreeUpgradeReverseParcelInsure(true);
    AliexpressLogisticsCreatewarehouseorderResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <aliexpress_logistics_createwarehouseorder_response>
        <result>
            <error_code>1</error_code>
            <error_desc>System error</error_desc>
            <intl_tracking_no>LN123123123CN</intl_tracking_no>
            <out_order_id>35631664365</out_order_id>
            <success>true</success>
            <trade_order_from>ESCROW</trade_order_from>
            <trade_order_id>66715700375804</trade_order_id>
            <warehouse_order_id>3017539175</warehouse_order_id>
        </result>
        <result_success>false</result_success>
    </aliexpress_logistics_createwarehouseorder_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>

    错误码解释

    错误码 错误描述 解决方案
    -10 其他错误 其他错误
    -27 调用菜鸟接口同步创建物流订单时,菜鸟接口返回的业务异常 稍后再试或联系管理员
    -22 平台美国规则限制 平台美国规则限制
    -2 下单条件不否,有未支付的订单 下单条件不否,有未支付的订单
    -14 遇到了4PL使用范围限制 遇到了4PL使用范围限制
    -1 参数错误 参数错误
    0 SYSTEM_EXCEPTION SYSTEM_EXCEPTION
    -20 创建物流订单前查询卖家地址后台,地址id错误,未找到对应的地址信息 创建物流订单前查询卖家地址后台,地址id错误,未找到对应的地址信息
    -21 创建物流订单时,检测到卖家地址信息未升级到4级地址库 创建物流订单时,检测到卖家地址信息未升级到4级地址库
    -11 菜鸟服务校验不通过,买家选择了菜鸟物流,卖家却选择了其他物流 菜鸟服务校验不通过,买家选择了菜鸟物流,卖家却选择了其他物流
    -4 调用物流宝订单出错 调用物流宝订单出错
    -7 发货商品超重 发货商品超重
    -8 超过最大订单金额:京邮通最大7美金 超过最大订单金额:京邮通最大7美金
    -3 国内物流公司有误 国内物流公司有误
    -5 没有可销售库存 没有可销售库存
    -6 发货商品数量超过限制 发货商品数量超过限制
    -12 菜鸟产品校验不通过,买家选择了菜鸟物流,卖家却选择了其他物流 菜鸟产品校验不通过,买家选择了菜鸟物流,卖家却选择了其他物流
    -13 类目品名在黑名单中,不允许 类目品名在黑名单中,不允许
    -15 限制:选择了带电渠道,就必须选带电或非液体化妆品 限制:选择了带电渠道,就必须选带电或非液体化妆品
    -16 不能包含锂离子电池 不能包含锂离子电池
    -18 创建物流订单前查询卖家地址后台,无地址信息 创建物流订单前查询卖家地址后台,无地址信息
    -28 仓发模式不允许卖家手动创建线上发货单或手动声明发货 仓发模式不允许卖家手动创建线上发货单或手动声明发货
    -24 不在4pl优先白名单 不在4pl优先白名单

    API工具

    如何获得此API

    FAQ

    返回
    顶部