描述

运费测算

路径

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

String

Array

20

M

包裹列表

parceList参数

字段名	数据类型	最大长度	必填	描述
parcelWeight

decimal

Decimal

O

包裹重量

包裹重量（productList为空时必填）

parcelLength

decimal

Decimal

O

包裹长

包裹长（productList为空时必填）

parcelWidth

decimal

Decimal

O

包裹宽

包裹宽（productList为空时必填）

parcelHeight

decimal

Decimal

O

包裹高

包裹高（productList为空时必填）
productList	Array		O	包裹下商品列表（包裹长，宽，高，重量任一为空时必填，使用商品实际长宽高重量计算出包裹长宽高）

productList参数

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

请求样例

代码块

返回样例

...

字段名

...

数据类型

...

最大长度

...

描述

...

warehouseCode

...

仓库代码

...

serviceList

...

服务列表

...

代码块

theme	Eclipse
linenumbers	true
collapse	true

{
    "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	费用分区

响应样例

代码块

linenumbers	true
collapse	true


成功响应：
{
    "code": "0",
    "data": [
        {
            "channelName": "CA Domestic CPC FOR OVERSEAS "serviceList": [],WH",
            "feeItemList": [
                {
                    "billingWeight": "",
                    "costType": 1,
                    "costTypeName": "Outbound Handling Fee",
                    "currency": "CAD",
                    "discount": 0,
                    "fee": 81.000,
                    "warehouseCodefeeDetailList": "DE""
                }
            ]
        },
        {
            "channelName": "serviceList"加拿大运输",
            "feeItemList": [
                {
                    "billingWeight": "",
                    "activecostType": 1,
                    "costTypeName": "Outbound Handling "activeMsg": "Active"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,
                    "serviceCode"feeDetailList": [
                        {
                            "costTypeName": "catest尾程基本运费",
                            "serviceNamecostTypeNameEn": "testcaLast Mile Basic Fee",
                    "serviceType        "currency": 5,"CAD",
                            "serviceTypeNamediscount": "Fulfillment",
                }             ],"fee": 42.00000000,
                     "warehouseCode       "zoneItemName": "shopify"加拿大分区"
                        },
                        {
                            "costTypeName": "偏远地区附加费",
                            "costTypeNameEn": "Remote Area Surcharge",
                            "currency": "CAD",
                            "discount": "",
                            "fee": 65.0000000,
                            "serviceListzoneItemName": [ ""
                        },
                        {
                            "active": 1,"costTypeName": "燃油附加费",
                            "costTypeNameEn": "Fuel Surcharge",
                            "activeMsgcurrency": "ActiveCAD",
                            "serviceCodediscount": "",
"UBI.CN2WW.GENERAL",                            "fee": 10.70000000000000,
                            "zoneItemName": ""
                        },
                        {
                            "costTypeName": "安全管理费",
                            "costTypeNameEn": "Security Surcharge",
                            "serviceNamecurrency": "CN-WW Direct Injection-General","CAD",
                            "discount": "",
                            "serviceTypefee": 5,10.00000,
                            "serviceTypeNamezoneItemName": "Fulfillment"
                        },
                        {
                    "active        "costTypeName": 1,"其它附加费",
                            "activeMsgcostTypeNameEn": "ActiveOther Surcharge",
                            "serviceCodecurrency": "Melbourne serviceCAD",
                            "serviceNamediscount": "墨尔本服务",
                    "serviceType        "fee": 5,10.00000,
                            "serviceTypeNamezoneItemName": "Fulfillment""
                        },
                        {
                            "costTypeName": "住宅地址附加费",
                            "costTypeNameEn": "Residential Surcharge",
                            "currency": "CAD",
                            "discount": "",
                            "fee": 100.00000000,
                            "activezoneItemName": 1, ""
                        },
                        {
                            "activeMsgcostTypeName": "Active电池附加费",
                    "serviceCode        "costTypeNameEn": "测试-服务Battery Surcharge",
                    "serviceName        "currency": "TEST Service 001","CAD",
                            "discount": "",
                      "serviceType      "fee": 5,10.00000,
                            "serviceTypeNamezoneItemName": "Fulfillment""
                        },
                        {
                      "active      "costTypeName": 1"加拿大海运费",
                      "activeMsg      "costTypeNameEn": "ActiveCanadaseafee",
                            "serviceCodecurrency": "b2cfwCAD",
                            "serviceNamediscount": "【B2C服务",
                            "serviceTypefee": 5,9.0000000,
                            "serviceTypeNamezoneItemName": "Fulfillment""
                        }
                    ]
                }
            ]
        }
    ],
    "errors": "",
    "message": "",
    "warehouseCodemessageId": "CNwharehouse",
    "success": true,
    "warnList": ""
}


失败响应：
{
    "code": "3",
    "data": "",
    "errors": [
        {
            "code": "800357",
            "message": "Field parcelList[1].productList[1].productQty cannot be less than 1"
        },
        {
            "code": "800357",
     "errors       "message": "Field parcelList[0].productList[0].productQty cannot be less than 1"
        }
    ],
    "message": "parameters error, please contact your administrator",
    "messageId": "",
    "success": truefalse,
    "warnList": ""
}


Field parcelList[0]这里的0代表第一个包裹，以此类推
Field parcelList[0].productList[0]这里的0代表第一个包裹和第一个包裹下的第一个商品，以此类推

备注信息（需注意）：

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[0] parcelLength,parcelWidth,parcelHeight,parcelWeight must be filled in and positive"、"message": "Field parcelList[0].parcelWeight cannot be less than 0.001"；parcelList[0]这里的0代表第一个包裹，以此类推

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"；

页面树结构

版本比较

旧版本 1

新版本当前版本

标识

描述

路径

请求头样例

请求字段

请求样例

返回样例

响应字段

响应样例

页面树结构

页面历史

版本比较

旧版本 1

新版本 当前版本

标识

描述

路径

请求头样例

请求字段

请求样例

返回样例

响应字段

响应样例

新版本当前版本