API
WO05-1.预计运费-新
更新时间: 2017-11-22 17:10:49 访问次数:754
接口说明

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

使用场景

用户可使用本接口预计计算出库费用。 可分两种情况计算: 1、 通过产品编码、产品数量计算(支持多个产品) 2、 通过产品长宽高、重量、数量计算(暂不支持多个产品的费用计算)

备注

请求说明
URL http://api.winit.com.cn/ADInterface/api
接口测试 http://erp.sandbox.winit.com.cn/ADInterface/api
验证方法 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 邮编
按产品编码(已注册产品)、数量计算
productList Array 产品列表,以下为子节点
--| productCode String(255) Y 产品编码
--| productNum Int Y 产品数量
--| specification String(255) 选填,当产品注册时填写了Specification,则下入库单时必填。 产品规格
按产品长宽高重量、数量计算
length Number(10,2) Y 产品长度
width Number(10,2) Y 产品宽度
height Number(10,2) Y 产品高度
weight Number(10,2) Y 产品重量(Kg)
productNum Int Y 产品数量
请求示例
1.按商品sku、出库商品数量计算
{
    "action": "wh.outbound.calcDeliveryFee",
    "app_key": "rebecca",
    "data": {
        "country": "US",
        "region": "FL",
        "city": "coral springs",
        "productList": [
            {
                "productCode": "auto_sku52",
                "productNum": "1",
                "specification": ""
            }
        ],
        "warehouseCode": "USTX",
        "zipCode": "33071",
        "winitProductCode": ""
    },
    "format": "json",
    "language": "zh_CN",
    "platform": "",
    "sign": "00000000000000000000000000000000",
    "sign_method": "md5",
    "timestamp": "",
    "version": "1.0"
}
2.按商品体积(长宽高)、重量和出库数量计算
{
    "action": "wh.outbound.calcDeliveryFee",
    "app_key": "rebecca",
    "data": {
        "country": "US",
        "region": "FL",
        "city": "coral springs",
        "productList": [
            {
                "length": "1",
                "width": "1",
                "height": "1",
                "weight": "1",
                "productNum": "1"
            }
        ],
        "warehouseCode": "US0001",
        "zipCode": "33071",
        "winitProductCode": ""
    },
    "format": "json",
    "language": "zh_CN",
    "platform": "",
    "sign": "00000000000000000000000000000000",
    "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 币种
--|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":    [
            {
         "FeeList":          [
                        {
               "feeNumber": 13.36,
               "ISOCode": "USD",
               "feeName": "海外仓最后一公里派送费"
            },
                        {
               "feeNumber": 0.06,
               "ISOCode": "USD",
               "feeName": "Outbound Order Handling Fee"
            },
                        {
               "feeNumber": 0.1,
               "ISOCode": "USD",
               "feeName": "Small Size Order Packing Surcharge"
            }
         ],
         "ISOCode": "USD",
         "deliveryWay": "UPS GROUND SERVICE",
         "packageInfo":          {
            "weight": 1,
            "height": 1,
            "CBM": 1.0E-6,
            "width": 1,
            "length": 1
         },
         "totalFeeUSD": 13.52,
         "deliveryWayCode": "OSF810595",
         "palletNum": 0,
         "outboundMethod": "RPL",
         "logisticsTime": 5
      },
            {
         "FeeList":          [
                        {
               "feeNumber": 13.36,
               "ISOCode": "USD",
               "feeName": "海外仓最后一公里派送费"
            },
                        {
               "feeNumber": 5.13,
               "ISOCode": "USD",
               "feeName": "Signature Fee"
            },
                        {
               "feeNumber": 0.06,
               "ISOCode": "USD",
               "feeName": "Outbound Order Handling Fee"
            },
                        {
               "feeNumber": 0.1,
               "ISOCode": "USD",
               "feeName": "Small Size Order Packing Surcharge"
            }
         ],
         "ISOCode": "USD",
         "deliveryWay": "UPS Ground Sign Service",
         "packageInfo":          {
            "weight": 1,
            "height": 1,
            "CBM": 1.0E-6,
            "width": 1,
            "length": 1
         },
         "totalFeeUSD": 18.65,
         "deliveryWayCode": "OSF810598",
         "palletNum": 0,
         "outboundMethod": "RPL",
         "logisticsTime": 5
      },
            {
         "FeeList":          [
                        {
               "feeNumber": 46.36,
               "ISOCode": "USD",
               "feeName": "海外仓最后一公里派送费"
            },
                        {
               "feeNumber": 0.06,
               "ISOCode": "USD",
               "feeName": "Outbound Order Handling Fee"
            },
                        {
               "feeNumber": 0.1,
               "ISOCode": "USD",
               "feeName": "Small Size Order Packing Surcharge"
            }
         ],
         "ISOCode": "USD",
         "deliveryWay": "UPS NEXT DAY AIR SAVER SERVICE",
         "packageInfo":          {
            "weight": 1,
            "height": 1,
            "CBM": 1.0E-6,
            "width": 1,
            "length": 1
         },
         "totalFeeUSD": 46.52,
         "deliveryWayCode": "OSF810601",
         "palletNum": 0,
         "outboundMethod": "RPL",
         "logisticsTime": 1
      },
            {
         "FeeList":          [
                        {
               "feeNumber": 46.36,
               "ISOCode": "USD",
               "feeName": "海外仓最后一公里派送费"
            },
                        {
               "feeNumber": 5.13,
               "ISOCode": "USD",
               "feeName": "Signature Fee"
            },
                        {
               "feeNumber": 0.06,
               "ISOCode": "USD",
               "feeName": "Outbound Order Handling Fee"
            },
                        {
               "feeNumber": 0.1,
               "ISOCode": "USD",
               "feeName": "Small Size Order Packing Surcharge"
            }
         ],
         "ISOCode": "USD",
         "deliveryWay": "UPS Next Day Air Saver Sign Service",
         "packageInfo":          {
            "weight": 1,
            "height": 1,
            "CBM": 1.0E-6,
            "width": 1,
            "length": 1
         },
         "totalFeeUSD": 51.65,
         "deliveryWayCode": "OSF810604",
         "palletNum": 0,
         "outboundMethod": "RPL",
         "logisticsTime": 1
      },
            {
         "FeeList":          [
                        {
               "feeNumber": 23.53,
               "ISOCode": "USD",
               "feeName": "海外仓最后一公里派送费"
            },
                        {
               "feeNumber": 0.06,
               "ISOCode": "USD",
               "feeName": "Outbound Order Handling Fee"
            },
                        {
               "feeNumber": 0.1,
               "ISOCode": "USD",
               "feeName": "Small Size Order Packing Surcharge"
            }
         ],
         "ISOCode": "USD",
         "deliveryWay": "UPS 3RD DAY SELECT-RESIDENTIAL SERVICE",
         "packageInfo":          {
            "weight": 1,
            "height": 1,
            "CBM": 1.0E-6,
            "width": 1,
            "length": 1
         },
         "totalFeeUSD": 23.69,
         "deliveryWayCode": "OSF810607",
         "palletNum": 0,
         "outboundMethod": "RPL",
         "logisticsTime": 3
      },
            {
         "FeeList":          [
                        {
               "feeNumber": 23.53,
               "ISOCode": "USD",
               "feeName": "海外仓最后一公里派送费"
            },
                        {
               "feeNumber": 5.13,
               "ISOCode": "USD",
               "feeName": "Signature Fee"
            },
                        {
               "feeNumber": 0.06,
               "ISOCode": "USD",
               "feeName": "Outbound Order Handling Fee"
            },
                        {
               "feeNumber": 0.1,
               "ISOCode": "USD",
               "feeName": "Small Size Order Packing Surcharge"
            }
         ],
         "ISOCode": "USD",
         "deliveryWay": "UPS 3rd Day Select-Residential Sign Service",
         "packageInfo":          {
            "weight": 1,
            "height": 1,
            "CBM": 1.0E-6,
            "width": 1,
            "length": 1
         },
         "totalFeeUSD": 28.82,
         "deliveryWayCode": "OSF810610",
         "palletNum": 0,
         "outboundMethod": "RPL",
         "logisticsTime": 3
      },
            {
         "FeeList":          [
                        {
               "feeNumber": 10.2,
               "ISOCode": "USD",
               "feeName": "海外仓最后一公里派送费"
            },
                        {
               "feeNumber": 0.06,
               "ISOCode": "USD",
               "feeName": "Outbound Order Handling Fee"
            },
                        {
               "feeNumber": 0.1,
               "ISOCode": "USD",
               "feeName": "Small Size Order Packing Surcharge"
            }
         ],
         "ISOCode": "USD",
         "deliveryWay": "UPS SUREPOST SERVICE",
         "packageInfo":          {
            "weight": 1,
            "height": 1,
            "CBM": 1.0E-6,
            "width": 1,
            "length": 1
         },
         "totalFeeUSD": 10.36,
         "deliveryWayCode": "OSF810613",
         "palletNum": 0,
         "outboundMethod": "RPL",
         "logisticsTime": 6
      },
            {
         "FeeList":          [
                        {
               "feeNumber": 23.16,
               "ISOCode": "USD",
               "feeName": "海外仓最后一公里派送费"
            },
                        {
               "feeNumber": 0.06,
               "ISOCode": "USD",
               "feeName": "Outbound Order Handling Fee"
            },
                        {
               "feeNumber": 0.1,
               "ISOCode": "USD",
               "feeName": "Small Size Order Packing Surcharge"
            }
         ],
         "ISOCode": "USD",
         "deliveryWay": "USPS Priority Mail Parcels Tracked Service",
         "packageInfo":          {
            "weight": 1,
            "height": 1,
            "CBM": 1.0E-6,
            "width": 1,
            "length": 1
         },
         "totalFeeUSD": 23.32,
         "deliveryWayCode": "OSF810757",
         "palletNum": 0,
         "outboundMethod": "RPL",
         "logisticsTime": 3
      },
            {
         "FeeList":          [
                        {
               "feeNumber": 14.91,
               "ISOCode": "USD",
               "feeName": "海外仓最后一公里派送费"
            },
                        {
               "feeNumber": 0.06,
               "ISOCode": "USD",
               "feeName": "Outbound Order Handling Fee"
            },
                        {
               "feeNumber": 0.1,
               "ISOCode": "USD",
               "feeName": "Small Size Order Packing Surcharge"
            }
         ],
         "ISOCode": "USD",
         "deliveryWay": "USPS Priority Mail Parcels Tracked Service-for ebay",
         "packageInfo":          {
            "weight": 1,
            "height": 1,
            "CBM": 1.0E-6,
            "width": 1,
            "length": 1
         },
         "totalFeeUSD": 15.07,
         "deliveryWayCode": "OSF810802",
         "palletNum": 0,
         "outboundMethod": "RPL",
         "logisticsTime": 3
      },
            {
         "FeeList":          [
                        {
               "feeNumber": 195,
               "ISOCode": "USD",
               "feeName": "海外仓最后一公里派送费"
            },
                        {
               "feeNumber": 20,
               "ISOCode": "USD",
               "feeName": "海外仓库内增值服务-出库打托"
            },
                        {
               "feeNumber": 0.06,
               "ISOCode": "USD",
               "feeName": "Outbound Order Handling Fee"
            }
         ],
         "ISOCode": "USD",
         "deliveryWay": "DHL Global Forwarding Service",
         "packageInfo":          {
            "weight": 20,
            "height": 14.97,
            "CBM": 0.185434468,
            "width": 101.6,
            "length": 121.92
         },
         "totalFeeUSD": 215.06,
         "deliveryWayCode": "OSF811075",
         "palletNum": 1,
         "outboundMethod": "PTL",
         "logisticsTime": 7
      },
            {
         "FeeList": [         {
            "feeNumber": 0.06,
            "ISOCode": "USD",
            "feeName": "Outbound Order Handling Fee"
         }],
         "ISOCode": "USD",
         "deliveryWay": "Test Last-mile Service-USWC",
         "packageInfo":          {
            "weight": 1,
            "height": 1,
            "CBM": 1.0E-6,
            "width": 1,
            "length": 1
         },
         "totalFeeUSD": 0.06,
         "deliveryWayCode": "OSF820844",
         "palletNum": 0,
         "outboundMethod": "RPL",
         "logisticsTime": 1
      },
            {
         "FeeList":          [
                        {
               "feeNumber": 0.06,
               "ISOCode": "USD",
               "feeName": "Outbound Order Handling Fee"
            },
                        {
               "feeNumber": 5,
               "ISOCode": "USD",
               "feeName": "Outbound Order Handling-self pick fee"
            }
         ],
         "ISOCode": "USD",
         "deliveryWay": "Self Pick Service",
         "packageInfo":          {
            "weight": 1,
            "height": 1,
            "CBM": 1.0E-6,
            "width": 1,
            "length": 1
         },
         "totalFeeUSD": 5.06,
         "deliveryWayCode": "OSF820856",
         "palletNum": 0,
         "outboundMethod": "RPL",
         "logisticsTime": 1
      },
            {
         "FeeList":          [
                        {
               "feeNumber": 0.06,
               "ISOCode": "USD",
               "feeName": "Outbound Order Handling Fee"
            },
                        {
               "feeNumber": 0.14,
               "ISOCode": "USD",
               "feeName": "销毁费"
            }
         ],
         "ISOCode": "USD",
         "deliveryWay": "Scrap Service(销毁服务)",
         "packageInfo":          {
            "weight": 1,
            "height": 1,
            "CBM": 1.0E-6,
            "width": 1,
            "length": 1
         },
         "totalFeeUSD": 0.2,
         "deliveryWayCode": "OSF830859",
         "palletNum": 0,
         "outboundMethod": "RPL",
         "logisticsTime": 2
      }
   ]
                                    }