文档中心 > API类目 > ICBU-物流

alibaba.onetouch.logistics.express.charge.calculate (计算快递运费&下单参数校验)

计算快递运费、下单参数校验

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
paramn_query PlaceOrderDTO 必须 请求参数对象
  • cargo_list
  • CargoList []
  • 必须
  • 货品信息
  • └ unit
  • String
  • 必须
  • pcs
  • 单位
  • └ hscode
  • String
  • 必须
  • 12345678
  • 海关编码
  • └ quantity
  • Number
  • 必须
  • 1
  • 货物数量
  • └ declaration_value
  • String
  • 必须
  • 1
  • 1
  • └ price
  • String
  • 可选
  • 1
  • 货物单价
  • └ name_cn
  • String
  • 必须
  • 无线耳机
  • 货物中文名
  • └ currency
  • String
  • 必须
  • USD
  • 1
  • └ name_en
  • String
  • 必须
  • wireless headsets
  • 货物英文名
  • product_type
  • ProductType []
  • 必须
  • 商品特性列表对象
  • └ code
  • String
  • 必须
  • battery
  • 商品类型code
  • children
  • Children []
  • 可选
  • 商品特性列表对象
  • └ code
  • String
  • 可选
  • inlayBattery
  • 商品类型code
  • children
  • LeafNode []
  • 可选
  • 商品特性列表对象
  • └ code
  • String
  • 可选
  • oneLessHundredWh
  • 商品类型code
  • └ name
  • String
  • 可选
  • 单块电池≤100Wh
  • 商品类型
  • └ name
  • String
  • 可选
  • 内置/配置电池
  • 商品类型
  • └ name
  • String
  • 必须
  • 电池
  • 商品类型
  • └ material
  • String
  • 可选
  • 塑料
  • 材质
  • └ purpose
  • String
  • 可选
  • 喝水用杯子
  • 用途
  • └ origin_zip_code
  • String
  • 必须
  • 518000
  • 起始地邮编
  • deliver_warehouse_express
  • DeliverWarehouseExpressDto
  • 可选
  • 交货到仓快递信息
  • └ logistics_company
  • String
  • 可选
  • UPS
  • 国内快递公司code
  • └ tracking_numbers
  • String []
  • 可选
  • ["111111","22222"]
  • 运单号
  • └ package_quantity
  • String
  • 可选
  • 2
  • 包裹数量
  • package_list
  • PackageList []
  • 必须
  • 包裹信息
  • └ quantity
  • String
  • 必须
  • 2
  • 数量
  • └ length
  • String
  • 必须
  • 5
  • └ width
  • String
  • 必须
  • 10
  • └ weight
  • String
  • 必须
  • 3
  • 重量
  • └ type
  • String
  • 必须
  • box
  • 包装类型
  • └ height
  • String
  • 必须
  • 2
  • └ destination_country_code
  • String
  • 必须
  • US
  • 目的地国家
  • └ warehouse_code
  • String
  • 必须
  • ASP_YH_SZJC
  • 仓库编码
  • └ product_code
  • String
  • 必须
  • EX_ASP_standard3C
  • 产品编码
  • consignor_address
  • ConsignorAddress
  • 必须
  • 发货人地址
  • address
  • Address
  • 必须
  • 国家、省、市、详细地址信息
  • └ zip
  • String
  • 必须
  • 518000
  • 邮编
  • country
  • Country
  • 必须
  • 国家
  • └ code
  • String
  • 必须
  • CN
  • 地址代码
  • └ area_id
  • Number
  • 可选
  • 1
  • 地址id
  • └ name
  • String
  • 必须
  • china
  • 地址名字
  • └ address
  • String
  • 必须
  • 阿里西溪园区
  • 地址
  • town
  • Town
  • 可选
  • 乡、镇名称
  • └ code
  • String
  • 可选
  • 330009
  • 地址代码
  • └ area_id
  • Number
  • 可选
  • 330009
  • 地址id
  • └ name
  • String
  • 可选
  • 测试街道
  • 地址名字
  • province
  • Province
  • 必须
  • 省份
  • └ code
  • String
  • 必须
  • 330000
  • 地址代码
  • └ area_id
  • Number
  • 可选
  • 330000
  • 地址id
  • └ name
  • String
  • 必须
  • 浙江省
  • 地址名字
  • city
  • City
  • 必须
  • 城市
  • └ code
  • String
  • 必须
  • 330100
  • 地址代码
  • └ area_id
  • Number
  • 可选
  • 330100
  • 地址id
  • └ name
  • String
  • 必须
  • 杭州市
  • 地址名字
  • district
  • District
  • 可选
  • 地区
  • └ code
  • String
  • 可选
  • 330108
  • 地址代码
  • └ name
  • String
  • 可选
  • 滨江区
  • 地址名字
  • contact
  • Contact
  • 必须
  • 联系方式(邮箱、电话号码、手机号码等)
  • └ phone_code
  • String
  • 可选
  • +86
  • 电话区号
  • └ mobile_no
  • String
  • 必须
  • 13798909890
  • 手机号码
  • └ email
  • String
  • 必须
  • aaa@test.com"
  • 邮箱
  • └ contact_person
  • String
  • 必须
  • 张三
  • 联系人姓名
  • └ company_name_cn
  • String
  • 必须
  • 测试公司名称
  • 公司中文名
  • express_customs
  • ExpressCustomsDto
  • 必须
  • 申报信息
  • └ declaration_amount
  • String
  • 必须
  • 15
  • 申报金额
  • └ need_customs_clearance
  • String
  • 必须
  • 1
  • 是否正式报关
  • └ declaration_currency
  • String
  • 必须
  • USD
  • 报关币种,出口发货中心默认USD
  • └ need_pickup
  • Boolean
  • 可选
  • true
  • 1
  • └ destination_zip_code
  • String
  • 必须
  • 07005
  • 目的地邮编
  • └ supply_chain_biz_id
  • String
  • 可选
  • 1001
  • 发货批次ID
  • consignee_address
  • ConsigneeAddress
  • 必须
  • 收货人地址
  • address
  • Address
  • 必须
  • 国家、省、市、详细地址信息
  • └ zip
  • String
  • 必须
  • 07005
  • 邮编
  • country
  • Country
  • 必须
  • 国家
  • └ code
  • String
  • 必须
  • US
  • 地址代码
  • └ area_id
  • Number
  • 可选
  • 228
  • 地址id
  • └ name
  • String
  • 必须
  • United States of America
  • 地址名字
  • └ phone_code
  • String
  • 可选
  • +1
  • 未知
  • └ address
  • String
  • 必须
  • address1
  • 地址
  • province
  • Province
  • 必须
  • 省份
  • └ code
  • String
  • 可选
  • 922878740000000000
  • 地址代码
  • └ area_id
  • String
  • 可选
  • 100
  • 地址代码
  • └ name
  • String
  • 必须
  • New Jersey
  • 地址名字
  • town
  • Town
  • 可选
  • 乡、镇名称
  • └ code
  • String
  • 可选
  • 922878740000000001
  • 地址代码
  • └ area_id
  • String
  • 可选
  • 101
  • 地址代码
  • └ name
  • String
  • 可选
  • Wall township
  • 地址名字
  • └ address2
  • String
  • 可选
  • address2
  • 地址2
  • city
  • City
  • 必须
  • 城市
  • └ code
  • String
  • 可选
  • 922878746212000000
  • 地址代码
  • └ name
  • String
  • 必须
  • Absecon heights"
  • 地址名字
  • district
  • District
  • 可选
  • 地区
  • └ code
  • String
  • 可选
  • 1
  • 地址代码
  • └ area_id
  • String
  • 可选
  • 1
  • 地址代码
  • └ name
  • String
  • 可选
  • 1
  • 地址名字
  • contact
  • Contact
  • 可选
  • 联系方式(邮箱、电话号码、手机号码等)
  • └ phone_area
  • String
  • 可选
  • 1
  • 电话区码
  • └ phone_code
  • String
  • 可选
  • 1
  • 电话区号
  • └ mobile_no
  • String
  • 必须
  • 1
  • 手机号码
  • └ email
  • String
  • 必须
  • 11
  • 邮箱
  • └ address_email
  • String
  • 可选
  • test2@163.com
  • 地址所有者邮箱(卖家维护收货地址, 值等于买家邮箱)
  • └ company_name_en
  • String
  • 必须
  • test company name
  • 公司英文名
  • └ contact_person
  • String
  • 必须
  • simon test
  • 联系人姓名
  • └ type
  • String
  • 可选
  • CONSIGNEE
  • 地址类型
  • └ trade_biz_id
  • String
  • 可选
  • 20499906501020531
  • 交易单号(例如阿里国际站的信保单ID),注意此字段不为空时,trade_platform字段必填(默认为ICBU)
  • └ trade_platform
  • String
  • 可选
  • ICBU
  • 跨境电商平台代码:ICBU(阿里巴巴国际站)、ALIEXPRESS(速卖通)、AMAZON(亚马逊)等

响应参数

名称 类型 示例值 描述
result Result Result 接口返回model
  • └ error_message
  • String
  • invalidate request
  • 返回结果描述
  • values
  • ExpressFreightDTO
  • ExpressFreightDTO
  • 结果对象
  • express_quote_item_list
  • ExpressQuoteItemList []
  • ExpressQuoteItemList
  • 费用项列表
  • └ code
  • String
  • logisticsExpressASP_EX0001
  • 费用编码
  • └ quantity
  • Number
  • 1
  • 数量
  • sales_amount
  • Money
  • Money
  • 价格信息
  • └ amount
  • String
  • 109.2
  • 金额
  • └ currency
  • String
  • CNY
  • 币种
  • └ name
  • String
  • 基础运费
  • 费用名称
  • └ charge_desc
  • String
  • 基础运费
  • 费用描述
  • └ currency
  • String
  • CNY
  • 币种
  • └ type
  • String
  • base_freight
  • 费用类型
  • └ sales_amount
  • String
  • 100
  • 销售总价
  • └ discount_amount
  • String
  • 10
  • 折扣总价
  • └ success
  • Boolean
  • true
  • 是否成功
  • └ error_code
  • Number
  • 402
  • 返回结果编码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaOnetouchLogisticsExpressChargeCalculateRequest req = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest();
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.PlaceOrderDTO obj1 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.PlaceOrderDTO();
List<AlibabaOnetouchLogisticsExpressChargeCalculateRequest.CargoList> list3 = new ArrayList<AlibabaOnetouchLogisticsExpressChargeCalculateRequest.CargoList>();
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.CargoList obj4 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.CargoList();
list3.add(obj4);
obj4.setUnit("pcs");
obj4.setHscode("12345678");
obj4.setQuantity(1L);
obj4.setDeclarationValue("1");
obj4.setPrice("1");
obj4.setNameCn("无线耳机");
obj4.setCurrency("USD");
obj4.setNameEn("wireless headsets");
List<AlibabaOnetouchLogisticsExpressChargeCalculateRequest.ProductType> list7 = new ArrayList<AlibabaOnetouchLogisticsExpressChargeCalculateRequest.ProductType>();
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.ProductType obj8 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.ProductType();
list7.add(obj8);
obj8.setCode("battery");
List<AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Children> list11 = new ArrayList<AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Children>();
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Children obj12 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Children();
list11.add(obj12);
obj12.setCode("inlayBattery");
List<AlibabaOnetouchLogisticsExpressChargeCalculateRequest.LeafNode> list15 = new ArrayList<AlibabaOnetouchLogisticsExpressChargeCalculateRequest.LeafNode>();
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.LeafNode obj16 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.LeafNode();
list15.add(obj16);
obj16.setCode("oneLessHundredWh");
obj16.setName("单块电池≤100Wh");
list13.setChildren(list15);
obj12.setName("内置/配置电池");
list9.setChildren(list11);
obj8.setName("电池");
list5.setProductType(list7);
obj4.setMaterial("塑料");
obj4.setPurpose("喝水用杯子");
obj1.setCargoList(list3);
obj1.setOriginZipCode("518000");
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.DeliverWarehouseExpressDto obj17 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.DeliverWarehouseExpressDto();
obj17.setLogisticsCompany("UPS");
obj17.setTrackingNumbers(""111111","22222"");
obj17.setPackageQuantity("2");
obj1.setDeliverWarehouseExpress(obj17);
List<AlibabaOnetouchLogisticsExpressChargeCalculateRequest.PackageList> list19 = new ArrayList<AlibabaOnetouchLogisticsExpressChargeCalculateRequest.PackageList>();
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.PackageList obj20 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.PackageList();
list19.add(obj20);
obj20.setQuantity("2");
obj20.setLength("5");
obj20.setWidth("10");
obj20.setWeight("3");
obj20.setType("box");
obj20.setHeight("2");
obj1.setPackageList(list19);
obj1.setDestinationCountryCode("US");
obj1.setWarehouseCode("ASP_YH_SZJC");
obj1.setProductCode("EX_ASP_standard3C");
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.ConsignorAddress obj21 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.ConsignorAddress();
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Address obj22 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Address();
obj22.setZip("518000");
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Country obj23 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Country();
obj23.setCode("CN");
obj23.setAreaId(1L);
obj23.setName("china");
obj22.setCountry(obj23);
obj22.setAddress("阿里西溪园区");
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Town obj24 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Town();
obj24.setCode("330009");
obj24.setAreaId(330009L);
obj24.setName("测试街道");
obj22.setTown(obj24);
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Province obj25 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Province();
obj25.setCode("330000");
obj25.setAreaId(330000L);
obj25.setName("浙江省");
obj22.setProvince(obj25);
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.City obj26 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.City();
obj26.setCode("330100");
obj26.setAreaId(330100L);
obj26.setName("杭州市");
obj22.setCity(obj26);
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.District obj27 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.District();
obj27.setCode("330108");
obj27.setName("滨江区");
obj22.setDistrict(obj27);
obj21.setAddress(obj22);
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Contact obj28 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Contact();
obj28.setPhoneCode("+86");
obj28.setMobileNo("13798909890");
obj28.setEmail("aaa@test.com\"");
obj21.setContact(obj28);
obj21.setContactPerson("张三");
obj21.setCompanyNameCn("测试公司名称");
obj1.setConsignorAddress(obj21);
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.ExpressCustomsDto obj29 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.ExpressCustomsDto();
obj29.setDeclarationAmount("15");
obj29.setNeedCustomsClearance("1");
obj29.setDeclarationCurrency("USD");
obj1.setExpressCustoms(obj29);
obj1.setNeedPickup(true);
obj1.setDestinationZipCode("07005");
obj1.setSupplyChainBizId("1001");
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.ConsigneeAddress obj30 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.ConsigneeAddress();
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Address obj31 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Address();
obj31.setZip("07005");
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Country obj32 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Country();
obj32.setCode("US");
obj32.setAreaId(228L);
obj32.setName("United States of America");
obj32.setPhoneCode("+1");
obj31.setCountry(obj32);
obj31.setAddress("address1");
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Province obj33 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Province();
obj33.setCode("922878740000000000");
obj33.setAreaId("100");
obj33.setName("New Jersey");
obj31.setProvince(obj33);
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Town obj34 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Town();
obj34.setCode("922878740000000001");
obj34.setAreaId("101");
obj34.setName("Wall township");
obj31.setTown(obj34);
obj31.setAddress2("address2");
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.City obj35 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.City();
obj35.setCode("922878746212000000");
obj35.setName("Absecon heights\"");
obj31.setCity(obj35);
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.District obj36 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.District();
obj36.setCode("1");
obj36.setAreaId("1");
obj36.setName("1");
obj31.setDistrict(obj36);
obj30.setAddress(obj31);
AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Contact obj37 = new AlibabaOnetouchLogisticsExpressChargeCalculateRequest.Contact();
obj37.setPhoneArea("1");
obj37.setPhoneCode("1");
obj37.setMobileNo("1");
obj37.setEmail("11");
obj30.setContact(obj37);
obj30.setAddressEmail("test2@163.com");
obj30.setCompanyNameEn("test company name");
obj30.setContactPerson("simon test");
obj30.setType("CONSIGNEE");
obj1.setConsigneeAddress(obj30);
obj1.setTradeBizId("20499906501020531");
obj1.setTradePlatform("ICBU");
req.setParamnQuery(obj1);
AlibabaOnetouchLogisticsExpressChargeCalculateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_onetouch_logistics_express_charge_calculate_response>
    <result>
        <error_message>invalidate request</error_message>
        <values>
            <express_quote_item_list>
                <express_quote_item_list>
                    <code>logisticsExpressASP_EX0001</code>
                    <quantity>1</quantity>
                    <sales_amount>
                        <amount>109.2</amount>
                        <currency>CNY</currency>
                    </sales_amount>
                    <name>基础运费</name>
                    <charge_desc>基础运费</charge_desc>
                    <currency>CNY</currency>
                    <type>base_freight</type>
                </express_quote_item_list>
            </express_quote_item_list>
            <sales_amount>100</sales_amount>
            <discount_amount>10</discount_amount>
        </values>
        <success>true</success>
        <error_code>402</error_code>
    </result>
</alibaba_onetouch_logistics_express_charge_calculate_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

返回
顶部