创建线上发货物流订单
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 | ||||||
---|---|---|---|---|---|---|---|---|---|---|---|
address_d_t_os | Json | 必须 | addresses | ||||||||
declare_product_d_t_os | AeopWlDeclareProductForTopDto [] | 必须 |
|
申报产品信息,列表类型,以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); | |||||||
|
|||||||||||
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 |
|
包裹数量: 创建国家小包订单时非必填,创建国家快递订单时必填 | ||||||
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为哈尔滨备货仓暂不支持,该渠道请做忽略。 | |||||||
invoice_number | String | 可选 | 38577123 | 发票号(可空) | |||||||
top_user_key | String | 可选 | xxxxxxx |
|
ISV用户唯一标识,一般为userId,最大长度为16个字符 | ||||||
insurance_coverage | Money | 可选 | 包裹保额 | ||||||||
|
|||||||||||
is_agree_upgrade_reverse_parcel_insure | Boolean | 可选 | false | 是否同意升级逆向高货值保险 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
result | AeopWlCreateWarehouseOrderResultDto | result | |
|
|||
result_success | Boolean | false | 调用是否成功 |
ext_info | String | {"offlineTips":"xxx"} | 接口透出额外提示错误或者文案json格式 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 | 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()); |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | < 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 >{"offlineTips":"xxx"}</ ext_info > </ aliexpress_logistics_order_createorder_response > |
1 2 3 4 5 6 | < 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优先白名单 |