API
预估派送运费-3
更新时间: 2019-11-08 10:20:45 访问次数:3485
接口说明

通过本接口用户可以预估出库费用。

接口英文名称

wh.outbound.calcDeliveryFee

使用场景

使用该接口查询出库单的预估费用。
支持两种查询场景:
1、 查询指定物流渠道,发出已注册商品SKU的预估费用(支持多个商品)
2、 查询指定物流渠道,发出包裹的长宽高、重量、数量的预估费用(暂不支持多个商品)

备注

wh.outbound.calcDeliveryFee是最新查询的海外仓出库(尾程订单)的预估费用(运费)的接口。

  • 附注:海外仓尾程派送方式列表中,有很多您不需要使用的尾程派送方式的费用估算会耗时,造成响应缓慢;
    如遇到接口响应速度慢的问题,请指定尾程派送方式(即winitProductCode参数)进行调用,响应速度能有效提高。

请求说明
URL http://openapi.winit.com.cn/openapi/service
接口测试 http://openapi.sandbox.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
country String() Y 目的地国家
region String() N 目的地州
city String() Y 目的地城市
warehouseCode String(22) Y 仓库代码
winitProductCode String(22) N 派送方式代码
zipCode String(22) Y 邮编
VASList
Array
O
增值服务列表
如果选择支持增值服务的物流渠道(调用接口queryDeliveryWay返回出参serviceCode为非空的物流渠道),卖家可以选择购买——填入购买增值服务的明;卖家也可以选择不购买,整个数组的入参去除。
--|attrList
Array

增值服务选项,以下为子节点
--|--|attrCode
String()
Y 增值服务Code,例如保险服务code
目前的增值服务为:追踪守护服务OSF777778

--|--|attrValue
String()
Y 增值服务值
目前追踪守护OSF777778的增值服务值为保险金额,保险金额可选择0.01-10000之间的数字

按商品编码(已注册商品)、数量计算
productList Array 产品列表,以下为子节点
--| productCode String(255) Y 商品编码,SKU
--| productNum Int Y 商品数量
--| specification String(255) O 商品规格
选填,当产品注册时填写了Specification,则为必填,若注册时没有填写则无须入参
商品长宽高重量、数量计算
length Number(10,2) Y 商品长度
单位CM
width Number(10,2) Y 商品宽度
单位CM
height Number(10,2) Y 商品高度
单位CM
weight Number(10,2) Y 商品重量
单位Kg
productNum Int Y 商品数量
整数
请求示例
3.1.按多个商品SKU进行预估 
{
    "action": "wh.outbound.calcDeliveryFee",
    "app_key": "rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"3B0899234EE1DA86BD808CCCC28A6817",
    "data": {
        "country": "US",
        "region": "FL",
        "city": "coral springs",
        "productList": [
            {
                "productCode": "auto_sku21",
                "productNum": "1",
                "specification": ""
            }
        ],
  "productList": [
            {
                "productCode": "216401",
                "productNum": "1",
                "specification": ""
            }
        ],
        "warehouseCode": "US0001",
        "zipCode": "33071",
        "winitProductCode": "OSF810802"
    },
      "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "269A90E453E8FAF3B63A94E967F5E413",
    "sign_method": "md5",
    "timestamp": "",
    "version": "1.0"
}
2.按商品体积(长宽高)、重量和出库数量计算 

{
    "action": "wh.outbound.calcDeliveryFee",
    "app_key": "rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"990DD1B68FD76566498E43B6D8EAEB63",
     "data": {
        "country": "US",
        "region": "FL",
        "city": "coral springs",
        "productList": [
            {
                "length": "1",
                "width": "1",
                "height": "1",
                "weight": "1",
                "productNum": "1"
            }
        ],
        "warehouseCode": "US0001",
        "zipCode": "33071",
        "winitProductCode": "OSF810802"
    },
    "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "8EF28A7D96837104ADF99E3D1A6FAAFF",
    "sign_method": "md5",
    "timestamp": "",
    "version": "1.0"
}
3.增值服务费用预估: 
{
    "action": "wh.outbound.calcDeliveryFee",
    "app_key": "rebecca",
    "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
    "client_sign":"725FAE76920D34401A0D531BA2B6E1E0",
    "data": {
        "country": "US",
        "region": "FL",
        "city": "coral springs",
        "productList": [
            {
                "productCode": "auto_sku21",
                "productNum": "1",
                "specification": ""
            }
        ],
  "productList": [
            {
                "productCode": "216401",
                "productNum": "1",
                "specification": ""
            }
        ],
"VASList": [{
	    "serviceCode": "OSF777778",
	    "attrList": [{
		"attrCode": "ISA",
		"attrValue": "50"
	    }]
        }],
        "warehouseCode": "US0001",
        "zipCode": "33071",
        "winitProductCode": "OSF810802"
    },
      "language": "zh_CN",
    "platform": "OWNERERP",
    "sign": "4D902B4D15E520D240D608936B9B443B",
    "sign_method": "md5",
    "timestamp": "",
    "version": "1.0"
}

                            
返回出参
名称 类型 必填 说明 示例
code String() Y 错误代码
msg String() Y 提示信息
data Object Y 业务数据
可用派送方式预估
usableDeliverys Array
--|deliveryWayCode String() Y 派送方式编码
--|ISOCode String() Y 币种
--|deliveryWay String() Y 派送方式名称
--|totalFeeUSD Number(10,2) Y 总费用,加上增值费用的总费用
--|logisticsTime Number Y 派送时效天数
--|outboundMethod String() Y 出库方式
--|palletNum Number Y 托盘数
--|FeeList Array Y 费用项,以下为子节点
--|--|feeName String() Y 费用项名称
--|--|feeNumber Number Y 数额
--|--|ISOCode String() Y 币种
VASFeeList 增值费用列表
--|serviceCode String() N 增值服务编码
--|serviceName String() 增值服务名称
--|--|attrList String() N 以下为明细列表
--|attrCode String() N 增值服务Code,例如保险服务code
--|attrValue String() N 增值服务值,例如保险金额
--|attrUnit String() N 增值服务单位
--|FeeNumber String() N 费用金额
--|ISOCode String() N 货币单位
--|packageInfo Array Y 打包信息,以下为子节点
--|--|length Number(10,2) Y 包裹长
--|--|width Number(10,2) Y 包裹宽
--|--|height Number(10,2) Y 包裹高
--|--|weight Number(10,2) Y 包裹重
--|--|CBM Number(10,2) Y 包裹体积

错误的返回结果:错误码,错误信息

返回示例
{
   "code": "0",
   "msg": "操作成功",
   "data": [   {
      "ISOCode": "USD",
      "outboundMethod": "RPL",
      "logisticsTime": null,
      "palletNum": 0,
      "VASFeeList": [      {
         "FeeName": "Tracked Parcel Insurance",
         "ISOCode": "CNY",
         "serviceCode": "OSF777778",
         "serviceName": "Tracked Parcel Insurance",
         "FeeCode": "325",
         "attrList": [         {
            "attrCode": "ISA",
            "attrValue": "50"
         }],
         "FeeNumber": 0.5
      }],
      "totalFeeUSD": 7.76,
      "FeeList":       [
                  {
            "ISOCode": "USD",
            "feeNumber": 7.77,
            "rebate": -0.23,
            "feeCode": "103",
            "feeName": "海外仓最后一公里派送费",
            "discount": 0,
            "paid-up": 7.54
         },
                  {
            "ISOCode": "USD",
            "feeNumber": 0.05,
            "rebate": 0,
            "feeCode": "102",
            "feeName": "Outbound Order Handling Fee",
            "discount": 0,
            "paid-up": 0.05
         },
                  {
            "ISOCode": "USD",
            "feeNumber": 0.1,
            "rebate": 0,
            "feeCode": "102",
            "feeName": "Small Size Order Packing Surcharge",
            "discount": 0,
            "paid-up": 0.1
         }
      ],
      "deliveryWayCode": "OSF810802",
      "deliveryWay": "USPS - Priority Mail (Express 2-3 Business Days)-eBay-USWC",
      "packageInfo":       {
         "length": 16,
         "width": 8,
         "weight": 0.0363,
         "height": 8,
         "CBM": 0.001024
      }
   }]
}