描述

运费测算

路径

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	包裹列表

...

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

请求样例

代码块

theme	Eclipse
linenumbers	true
collapse	true

{
    "warehouseCode": "CATESTWHCanadaWarehouse",
    "country": "CNCA",
    "state": "四川省AB",
    "city": "广元市HAYNES",
    "district": "利州区",
    "postCode": "123432T0C0Y0",
    "parcelList": [
        {
            "parcelWeight": 12,
            "parcelLength": 311,
            "parcelWidth": 412,
            "parcelHeight": 513,
            "productList": [
                {
                    "sku": "SKGCATESTSKU",
                    "productQty": 2
                },
                {
                    "sku": "Red wineCATESTSKU_001",
                    "productQty": 12
                }
            ]
        },
        {
            "parcelWeight": null2,
            "parcelLength": null11,
            "parcelWidth": null12,
            "parcelHeight": null13,
            "productList": [
                {
                    "sku": "SKGCATESTSKU_002",
                    "productQty": 2
                },
                {
                    "sku": "Red wineCATESTSKU_003",
                    "productQty": 12
                }
            ]
        },
        {
            "parcelWeight": 2,
            "parcelLength": 3,
            "parcelWidth": 4,
            "parcelHeight": 5,
            "productList": []
        }
    ]
}

返回样例

...

字段名

...

数据类型

...

最大长度

...

描述

...

channelName

...

服务名称

...

]
}

响应字段

字段名	数据类型	描述
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

费用名称

费用名称（中文）

billingWeight

costTypeNameEn

Decimal

String

计费重量

	费用名称（英文）
fee	Decimal	费用金额
currency	String	币种

feeDetailListArray费用明细

feeDetailList参数

...

字段名

...

数据类型

...

最大长度

...

描述

...

fee

...

费用金额

...

discount	Integer		折扣（%Off）
zoneItemName	String		费用分区

响应样例

代码块

linenumbers	true
collapse	true


成功响应：
{
    "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": ""
                        },
                        {
              "serviceList": [],             "warehouseCodecostTypeName": "DE住宅地址附加费"
,
       },         {             "serviceListcostTypeNameEn": ["Residential Surcharge",
                {            "currency": "CAD",
       "active": 1,                    "discount": "activeMsg": "Active",",
                            "serviceCodefee": "catest"100.00000000,
                    "serviceName": "testca",       "zoneItemName": ""
            "serviceType": 5,           },
         "serviceTypeName": "Fulfillment"              {
  }             ],             "warehouseCodecostTypeName": "shopify电池附加费",
        },         {
            "serviceListcostTypeNameEn": ["Battery Surcharge",
               {             "currency": "CAD",
      "active": 1,                     "activeMsgdiscount": "Active",
                     "serviceCode       "fee": "UBI.CN2WW.GENERAL",10.00000,
                            "serviceNamezoneItemName": "CN-WW Direct Injection-General",""
                        },
     "serviceType": 5,                  {
  "serviceTypeName": "Fulfillment"                 },        "costTypeName": "加拿大海运费",
       {                     "activecostTypeNameEn": 1,"Canadaseafee",
                            "activeMsgcurrency": "Active", "CAD",
                            "serviceCodediscount": "Melbourne service",
                    "serviceName": "墨尔本服务",       "fee": 9.0000000,
            "serviceType": 5,
                    "serviceTypeNamezoneItemName": "Fulfillment"
                },        }
        {             ]
       "active": 1,        }
            "activeMsg": "Active",    ]
        }
    ],
    "serviceCodeerrors": "测试-服务",
    "message": "",
    "messageId": "",
    "success": true,
    "serviceNamewarnList": "TEST Service 001","
}


失败响应：
{
    "code": "3",
    "data": "",
    "serviceTypeerrors": [
5,        {
            "serviceTypeNamecode": "Fulfillment800357",
            "message": "Field parcelList[1].productList[1].productQty cannot be less than },1"
        },
        {
            "code": "800357",
      "active": 1,      "message": "Field parcelList[0].productList[0].productQty cannot be less than 1"
       "activeMsg": "Active", }
    ],
    "message": "parameters error, please contact your administrator",
    "serviceCodemessageId": "b2cfw",
    "success": false,
       "warnList": ""
}


Field parcelList[0]这里的0代表第一个包裹，以此类推
  "serviceName": "【B2C服务",
                    "serviceType": 5,
                    "serviceTypeName": "Fulfillment"
                }
            ],
            "warehouseCode": "CNwharehouse"
        }
    ],
    "errors": "",
    "message": "",
    "messageId": "",
    "success": true,
    "warnList": ""
}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"；

页面树结构

版本比较

旧版本 6

新版本当前版本

标识

描述

路径

请求头样例

请求字段

请求样例

返回样例

响应字段

响应样例

页面树结构

页面历史

版本比较

旧版本 6

新版本 当前版本

标识

描述

路径

请求头样例

请求字段

请求样例

返回样例

响应字段

响应样例

新版本当前版本