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

aliexpress.logistics.order.createorder (创建子交易单线上物流订单)

创建线上发货物流订单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
address_d_t_os Json 必须 addresses
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 可选 SF 国内快递公司编码,物流公司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
    • └ currency_code
    • String
    • 可选
    • USD
    • 币种三字码
    is_agree_upgrade_reverse_parcel_insure Boolean 可选 false 是否同意升级逆向高货值保险

    响应参数

    名称 类型 示例值 描述
    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
    • 物流订单号
    • └ out_order_code
    • String
    • LP00507480159000
    • LP单号
    result_success Boolean false 调用是否成功
    ext_info String {"offlineTips":"xxx"} 接口透出额外提示错误或者文案json格式

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AliexpressLogisticsOrderCreateorderRequest req = new AliexpressLogisticsOrderCreateorderRequest();
    req.setAddressDTOsString("");
    List<AliexpressLogisticsOrderCreateorderRequest.AeopWlDeclareProductForTopDto> list2 = new ArrayList<AliexpressLogisticsOrderCreateorderRequest.AeopWlDeclareProductForTopDto>();
    AliexpressLogisticsOrderCreateorderRequest.AeopWlDeclareProductForTopDto obj3 = new AliexpressLogisticsOrderCreateorderRequest.AeopWlDeclareProductForTopDto();
    list2.add(obj3);
    obj3.setAneroidMarkup(false);
    obj3.setBreakable(false);
    obj3.setCategoryCnDesc("连衣裙");
    obj3.setCategoryEnDesc("dress");
    obj3.setContainsBattery(false);
    obj3.setHsCode("77234");
    obj3.setOnlyBattery(false);
    obj3.setProductDeclareAmount("1.3");
    obj3.setProductId(1000L);
    obj3.setProductNum(2L);
    obj3.setProductWeight("1.5");
    obj3.setScItemCode("scItem code");
    obj3.setScItemId(1000L);
    obj3.setScItemName("scItem name");
    obj3.setSkuCode("sku code");
    obj3.setSkuValue("sku value");
    obj3.setContainsSpecialGoods(false);
    obj3.setChildOrderId(1000172130022100L);
    req.setDeclareProductDTOs(list2);
    req.setDomesticLogisticsCompany("SF");
    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");
    AliexpressLogisticsOrderCreateorderRequest.Money obj4 = new AliexpressLogisticsOrderCreateorderRequest.Money();
    obj4.setCent(99L);
    obj4.setCurrencyCode("USD");
    req.setInsuranceCoverage(obj4);
    req.setIsAgreeUpgradeReverseParcelInsure(false);
    AliexpressLogisticsOrderCreateorderResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <aliexpress_logistics_order_createorder_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>
            <out_order_code>LP00507480159000</out_order_code>
        </result>
        <result_success>false</result_success>
        <ext_info>{&quot;offlineTips&quot;:&quot;xxx&quot;}</ext_info>
    </aliexpress_logistics_order_createorder_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

    返回
    顶部