描述

运费测算

路径

HTTP Verb	URL
POST	/api/supplier-service/v1/b2c/freightCalculation

请求头样例

POST /api/supplier-service/v1/b2b/poList
Host: http://cfs-qa.etowertech.com/
Content-Type: application/json
Accept: application/json
Authorization:WallTech etotest8xkIIphLnbkjRACNj4P:pc9H97D-_b2_TSCVvNj81A
X-WallTech-Date:Tue, 02 Aug 2022 06:43:37 GMT

请求字段

字段名	数据类型	最大长度	必填	描述
warehouseCode	String	50	M	仓库代码
country	String	2	M	国家二字代码（CN, US ...）
state	String	50	M	州（省）
city	String	50	M	城市
district	String	50	M	区
postCode	String	30	M	邮编
parcelList	Array	20	M	包裹列表

parceList参数

字段名	数据类型	必填	描述
parcelWeight	Decimal	O	包裹重量（productList为空时必填）
parcelLength	Decimal	O	包裹长（productList为空时必填）
parcelWidth	Decimal	O	包裹宽（productList为空时必填）
parcelHeight	Decimal	O	包裹高（productList为空时必填）
productList	Array	O	包裹下商品列表（包裹长，宽，高，重量任一为空时必填，使用商品实际长宽高重量计算出包裹长宽高）

productList参数

字段名	数据类型	最大长度	必填	描述
sku	String	50	M	商品编码
productQty	Integer		M	商品数量

请求样例

{
    "warehouseCode": "CanadaWarehouse",
    "country": "CA",
    "state": "AB",
    "city": "HAYNES",
    "district": "",
    "postCode": "T0C0Y0",
    "parcelList": [
        {
            "parcelWeight": 2,
            "parcelLength": 11,
            "parcelWidth": 12,
            "parcelHeight": 13,
            "productList": [
                {
                    "sku": "CATESTSKU",
                    "productQty": 2
                },
                {
                    "sku": "CATESTSKU_001",
                    "productQty": 2
                }
            ]
        },
        {
            "parcelWeight": 2,
            "parcelLength": 11,
            "parcelWidth": 12,
            "parcelHeight": 13,
            "productList": [
                {
                    "sku": "CATESTSKU_002",
                    "productQty": 2
                },
                {
                    "sku": "CATESTSKU_003",
                    "productQty": 2
                }
            ]
        }
    ]
}

响应字段

字段名	数据类型	描述
channelName	String	服务名称
channelId	Long	服务id
lastMileBillingWeight	Decimal	派送费计费重量
feeItemList	Array	费用列表

feeItemList参数

字段名	数据类型	描述
costType	Integer	费用类型（1：出库处理费（Outbound Handling Fee）；8：尾程运费（Last Mile Fee））
costTypeName	String	费用名称
billingWeight	Decimal	计费重量
fee	Decimal	费用金额
currency	String	币种
feeDetailList	Array	费用明细

feeDetailList参数

字段名	数据类型	描述
costTypeName	String	费用名称（中文）
costTypeNameEn	String	费用名称（英文）
fee	Decimal	费用金额
currency	String	币种
discount	Integer	折扣（%Off）
zoneItemName	String	费用分区

响应样例

{
    "code": "0",
    "data": [
        {
            "channelName": "CA Domestic CPC FOR OVERSEAS WH",
            "feeItemList": [
                {
                    "billingWeight": "",
                    "costType": 1,
                    "costTypeName": "Outbound Handling Fee",
                    "currency": "CAD",
                    "discount": 0,
                    "fee": 81.000,
                    "feeDetailList": ""
                }
            ]
        },
        {
            "channelName": "加拿大运输",
            "feeItemList": [
                {
                    "billingWeight": "",
                    "costType": 1,
                    "costTypeName": "Outbound Handling Fee",
                    "currency": "CAD",
                    "discount": 0,
                    "fee": 81.000,
                    "feeDetailList": ""
                },
                {
                    "billingWeight": 10.000,
                    "costType": 8,
                    "costTypeName": "Last Mile Fee",
                    "currency": "CAD",
                    "discount": 0,
                    "fee": 256.700,
                    "feeDetailList": [
                        {
                            "costTypeName": "尾程基本运费",
                            "costTypeNameEn": "Last Mile Basic Fee",
                            "currency": "CAD",
                            "discount": "",
                            "fee": 42.00000000,
                            "zoneItemName": "加拿大分区"
                        },
                        {
                            "costTypeName": "偏远地区附加费",
                            "costTypeNameEn": "Remote Area Surcharge",
                            "currency": "CAD",
                            "discount": "",
                            "fee": 65.0000000,
                            "zoneItemName": ""
                        },
                        {
                            "costTypeName": "燃油附加费",
                            "costTypeNameEn": "Fuel Surcharge",
                            "currency": "CAD",
                            "discount": "",
                            "fee": 10.70000000000000,
                            "zoneItemName": ""
                        },
                        {
                            "costTypeName": "安全管理费",
                            "costTypeNameEn": "Security Surcharge",
                            "currency": "CAD",
                            "discount": "",
                            "fee": 10.00000,
                            "zoneItemName": ""
                        },
                        {
                            "costTypeName": "其它附加费",
                            "costTypeNameEn": "Other Surcharge",
                            "currency": "CAD",
                            "discount": "",
                            "fee": 10.00000,
                            "zoneItemName": ""
                        },
                        {
                            "costTypeName": "住宅地址附加费",
                            "costTypeNameEn": "Residential Surcharge",
                            "currency": "CAD",
                            "discount": "",
                            "fee": 100.00000000,
                            "zoneItemName": ""
                        },
                        {
                            "costTypeName": "电池附加费",
                            "costTypeNameEn": "Battery Surcharge",
                            "currency": "CAD",
                            "discount": "",
                            "fee": 10.00000,
                            "zoneItemName": ""
                        },
                        {
                            "costTypeName": "加拿大海运费",
                            "costTypeNameEn": "Canadaseafee",
                            "currency": "CAD",
                            "discount": "",
                            "fee": 9.0000000,
                            "zoneItemName": ""
                        }
                    ]
                }
            ]
        }
    ],
    "errors": "",
    "message": "",
    "messageId": "",
    "success": true,
    "warnList": ""
}

备注信息（需注意）：

1、shipper仓库禁用，报错："message": "shipperAddressCode:CanadaWarehouse,Relevant warehouse do not active in shipper"；

2、shipper与仓库不匹配，报错："message":"shipperAddressCode:CanadaWarehousetest,Relevant warehouse do not exist in shipper"；

3、shipper商品禁用，报错："message": "SKU:[CATESTSKU] has been disabled"；

4、shipper与商品不匹配：报错："message": "sku:CATESTSKUtest,Does not exist in the selected shippers commodity wareHouse"；

5、国家不存在（只校验了国家二字码，全称也会直接报错）：报错："message": "Field country value:Canada is invalid"；

6、sku信息为空，校验包裹重量、长、宽、高不能为空，不能为负数，不能为0，小数点前后位数无限制与界面的一致，否则报错："message": "parcelList[\{1}] parcelLength,parcelWidth,parcelHeight,parcelWeight must be filled in and positive"、"message": "Field parcelList[0].parcelWeight cannot be less than 0.001"；

7、sku数量校验不能为空，不能为负数，不能为0，否则报错： "message": "parcelList[0].productList[0].productQty cant be null"、 "message": "Field parcelList[0].productList[0].productQty cannot be less than 1"；

8、sku校验不能为空，否则报错： "message": "parcelList[0].productList[0].sku cant be null"；

页面树结构

19.运费测算

描述

路径

请求头样例

请求字段

请求样例

响应字段

响应样例