开发者文档
查询ISP预估费用

 1.接口说明

卖家或第三方通过该接口可查询ISP预估费用信息。

2.使用场景

卖家或第三方通过该接口可查询ISP预估费用信息

 

3.请求说明

URL

http://openapi.winit.com.cn/openapi/service

接口测试

http://openapi.sandbox.winit.com.cn/openapi/service

请求方法

action:isp.feeCalc.estimate

验证方式

Token,md5

格式

json

字符编码UTF-8

http请求方式

http,post

请求数限制

默认每分钟300,有需要可以申请加大

4.请求入参

名称

类型

必填

说明

示例

shipperAddrCode

String(60)

N

寄件人地址code


warehouseCodeString(60)Y验货仓
buyerCountryCodeString(30)Y收件人国家
buyerPostcodeString(30)Y收件人邮编
length

Numeric(10,2)

Y长(cm)
width

Numeric(10,2)

Y宽(cm)
height

Numeric(10,2)

Y高(cm)
weight

Numeric(10,2)

Y重量(kg)
winitProductCodeString(60)Ywinit产品code
declareValueTotal

Numeric(10,2)

Y总申报价值(USD)

5.返回出参

名称

类型

说明

示例

currency

String(20)

币种


totalFeeCNY

Numeric(10,2)

总额


productQuotation

String(200)

产品报价单

feeDetailList

以下字段为

feeDetailList

节点

费用明细列表


resultFee

Numeric(10,2)

费用金额


currency

String(20)

币种


salesChangeItemName

String(60)

费用名称


 

6.请求示例

{
    "action": "isp.feeCalc.estimate",
    "app_key": "rebecca",
    "data": {
            "shipperAddrCode": "test008",
            "warehouseCode":"YW10000008",
            "buyerCountryCode":"UK",
            "buyerPostcode":"29169-6036",
            "length":"11",
            "width":"6",
            "height":"11",
            "weight":"1.5",
            "winitProductCode":"ISP1005",
            "declareValueTotal":"2.19"
    },
    "format": "json",
    "language": "zh_CN",
    "platform": "",
    "sign": "00000000000000000000000000000000",
    "sign_method": "md5",
    "timestamp": "2016-11-24 10:35:23",
    "version": "1.0"
}


返回结果示例

{
   "code": "0",
   "msg": "操作成功",
   "data":    {
      "currency": "CNY",
      "totalFeeCNY": 105.84,
      "feeDetailList":       [
                  {
            "resultFee": 69.42,
            "currency": "CNY",
            "salesChangeItemName": "ISP专线费"
         },
                  {
            "resultFee": 5.8,
            "currency": "USD",
            "salesChangeItemName": "ISPGST&VAT"
         }
      ],
      "productQuotation": "http://www.winit.com.cn/college/seller/isp/operation-guide/item/311-3-2"
   }
}

 

返回参数说明

 

正确的返回结果:isp预估费用信息。

错误的返回结果:


错误代码

错误信息(中文)

错误信息(英文)

解决方案

02010250001

字段[{0}]不能为空

The   field[{0}] can not null

填写相应字段值后重新请求

02010250002

字段[{0}]长度不能超过{1}

The length of   the field[{0}] must be less {1}

根据提示修改字段值后重新请求

02010250003

字段[{0}]类型错误

The type of   the field [{0}] is wrong

{字段}的类型填写有误,修改后重新请求

02010250048

字段{0}整数位超过长度{1}

Field {0}   integer bit over length {1}

按照正确规则提示修改后重新请求

02010250049

字段{0}小数位超过长度{1}

Field {0}   decimal number over length {1}

按照正确规则提示修改后重新请求

01030240005

您输入的仓库信息不正确,请您核对后重新输入!

You enter the   warehouse information is not correct,

Please check   it again after the input!

根据提示修改字段值后重新请求

01030241002

收件人国家[{0}]填写有误,请核对后重新输入

The   receiver's country [{0}]name you entered

is incorrect.   Please check and try again.

收件人国家应正确填写二字代码,修改后重新请求

01030241003

Winit产品code[{0}]有误,请核对后重新输入

The code [{0}]   of Winit products you entered

is incorrect.   Please check and try again.

winit产品code不存在或已下架,请联系Winit   IT更新数据,或调用【查询WINIT产品】获取信息

product.not.find

产品编码:{0},未找到產品

producCode:{0}, product isn't find

根据提示修改字段值后重新请求

winit.procutrule.

postcode.exception

产品邮编校验不通过

address   PostCode exception

根据提示修改字段值后重新请求

LogisticsDist.not.find2

国家编码:{0},产品编码:{1},邮编:{2},类型{3}没有找到对应的物流分区

CountryCode:{0},   ProductCode:{1}, PostCode:{2},

LogisticsDist   not find

物流分区未找到,请检查输入参数重新请求

winit.procutrule.size.

Length.min.exception

长度超过限制,应不小于{0}

根据提示修改字段值后重新请求

winit.procutrule.size.

Length.max.exception

长度超过限制,应不大于{0}

根据提示修改字段值后重新请求

winit.procutrule.size.

Length.min.max.exception

长度超过限制,长度范围应为{0}-{1}

根据提示修改字段值后重新请求

winit.procutrule.size.

Width.min.exception

宽超过限制,应不小于{0}

根据提示修改字段值后重新请求

winit.procutrule.size.

Width.max.exception

宽超过限制,应不大于{0}

根据提示修改字段值后重新请求

winit.procutrule.size.

Width.min.max.exception

宽度超过限制,宽度范围应为{0}-{1}

根据提示修改字段值后重新请求

winit.procutrule.size.

Hight.min.exception

高超过限制,应不小于{0}

根据提示修改字段值后重新请求

winit.procutrule.size.

Hight.max.exception

高超过限制,应不大于{0}

根据提示修改字段值后重新请求

winit.procutrule.size.

Hight.min.max.exception

高度超过限制,高度范围应为{0}-{1}

根据提示修改字段值后重新请求

winit.procutrule.size.

Weight.min.exception

重量超过限制,应不小于{0}

根据提示修改字段值后重新请求

winit.procutrule.size.

Weight.max.exception

重量超过限制,应不大于{0}

根据提示修改字段值后重新请求

winit.procutrule.size.

Weight.min.max.exception

重量超过限制,重量范围应为{0}-{1}

根据提示修改字段值后重新请求

winit.procutrule.size.

LWH.min.exception

周长超过限制,应不小于{0}

根据提示修改字段值后重新请求

winit.procutrule.size.

LWH.max.exception

周长超过限制,应不大于{0}

根据提示修改字段值后重新请求

winit.procutrule.size.

LWH.min.max.exception

周长超过限制,周长范围应为{0}-{1}

根据提示修改字段值后重新请求

winit.procutrule.size.

LWH2.min.exception

长+宽*2+高*2小于最小限制{0}

根据提示修改字段值后重新请求

winit.procutrule.size.

LWH2.max.exception

长+宽*2+高*2过最大限制{0}

根据提示修改字段值后重新请求

winit.procutrule.size.

Volume.min.exception

体积小于最小限制{0}

根据提示修改字段值后重新请求

winit.procutrule.size.

Volume.max.exception

体积过最大限制{0}

根据提示修改字段值后重新请求


start   LogisticsDist not found, winitProductCode:{0},startCountryCode[{1}],startPostCode[{2}]

起始物流分区未找到,请检查产品Code、起始国家和起始邮编重新请求


end LogisticsDist not found, winitProductCode:{0},endCountryCode[{1}],endPostCode[{2}]

目的物流分区未找到,请检查产品Code、目的国家和目的邮编重新请求


ISP费用计算失败

ISP费用计算失败,请检查输入参数,如继续出现此问题请联系winit IT

说明:{0},{1}都表示提示信息中的参数值