API
预估派送运费-3
更新时间： 2021-06-24 16:35:05 访问次数：10085
接口说明
通过本接口用户可以预估出库费用。
1、 查询指定物流渠道，发出已注册商品SKU的预估费用（支持多个商品）
2、 查询指定物流渠道，发出包裹的长宽高、重量、数量的预估费用，不支持多商品
3、 不指定物流渠道，发出已注册商品SKU的预估费用（支持多个商品）
4、 不指定物流渠道，发出包裹的长宽高、重量、数量的预估费用，不支持多商品
请求说明
| URL | https://openapi.winit.com.cn/openapi/service |
| 接口测试 | https://sandboxopenapi.winit.com.cn/openapi/service |
| 接口名称 | wh.outbound.calcDeliveryFee |
| 验证方法 | Token,md5 |
| 格式 | json |
| 字符编码 | UTF-8 |
| http请求方式 | http |
| 请求数限制 | 默认每分钟1000，有需要可申请加大。 |
请求入参
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| country | String() | Y | 目的地国家 | US |
| region | String() | N | 目的地州 | FL |
| city | String() | Y | 目的地城市 | coral springs |
| salesAmount | String() | N | 商品销售总金额 | 10 |
| currency | String() | N | 销售金额币种 | |
| VATNo | String() | N | 卖家VAT | |
| iossNo | String() | N | IOSS | |
| warehouseCode | String(22) | Y | 仓库代码 | US0001 |
| winitProductCode | String(22) | N | 派送方式代码 | OSF810802 |
| zipCode | String(22) | Y | 邮编 | 33071 |
| salesAmount | BigDecimal（6,2） | Y | 销售金额
限制0.01-999999.99 |
10 |
| currency | String(128) | N | 销售金额币种 | USD |
| 增值服务列表VASList | ||||
| --|serviceCode |
String() |
增值服务编码 | OSF777778 | |
| 增值服务明细信息VASList.attrList | ||||
| --|--|attrCode |
String() |
Y | 增值服务属性code | ISA |
| --|--|attrValue |
String() |
Y | 增值服务值 | 10 |
| 按商品编码（已注册商品）、数量计算 | ||||
| 商品列表productList | ||||
| --| productCode | String(255) | Y | 商品编码，SKU |
216401 |
| --| productNum | Int | Y | 商品数量 | 1 |
| --| specification | String(255) | O | 商品规格
选填，当产品注册时填写了Specification，则为必填，若注册时没有填写则无需入参 |
|
| 按商品长宽高重量、数量计算 | ||||
| length | Number(10,2) | Y | 商品长度
单位CM |
1 |
| width | Number(10,2) | Y | 商品宽度
单位CM |
1 |
| height | Number(10,2) | Y | 商品高度
单位CM |
1 |
| weight | Number(10,2) | Y | 商品重量
单位Kg |
1 |
| productNum | Int | Y | 商品数量
整数 |
1 |
请求示例
1.按多个商品SKU进行预估
{
"action": "wh.outbound.calcDeliveryFee",
"app_key": "rebecca",
"client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
"client_sign":"3B0899234EE1DA86BD808CCCC28A6817",
"data": {
"country": "US",
"region": "FL",
"city": "coral springs",
"salesAmount":"",
"currency":"USD",
"iossNo": "",
"VATNo":"",
"iossNo": "",
"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"
}
4.输入电商销售价格进行预估
{
"action": "wh.outbound.calcDeliveryFee",
"app_key": "rebecca",
"client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
"client_sign": "9B2CA836EA11F61C9A979A56B0DA787D",
"data": {
"country": "US",
"region": "FL",
"city": "coral springs",
"salesAmount": "10000",
"currency": "USD",
"productList": [
{
"productCode": "216401",
"productNum": "1",
"specification": ""
}
],
"warehouseCode": "US0001",
"zipCode": "33071",
"winitProductCode": "OSF810802"
},
"language": "zh_CN",
"platform": "OWNERERP",
"sign": "5C6866DC4A154634C372AE1A8E30B69E",
"sign_method": "md5",
"timestamp": "",
"version": "1.0"
}
返回出参
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| code | String() | Y | 错误代码 | |
| msg | String() | Y | 提示信息 | |
| data | Object | Y | 业务数据 | |
| 可用派送方式预估 | ||||
| 可用派送方式预估usableDeliverys | ||||
| --|deliveryWayCode | String() | Y | 派送方式编码 | |
| --|ISOCode | String() | Y | 币种 | |
| --|deliveryWay | String() | Y | 派送方式名称 | |
| --|totalFeeUSD | Number(10,2) | Y | 总费用，加上增值费用的总费用 | |
| --|logisticsTime | Number | Y | 派送时效天数 | |
| --|outboundMethod | String() | Y | 出库方式 | |
| --|palletNum | Number | Y | 托盘数 | |
| 费用列表FeeList | ||||
| --|--|feeName | String() | Y | 费用项名称 | |
| --|--|feeCode | String() | Y | 费用项编码 | |
| --|--|feeNumber | Number | Y | 总费用 | |
| --|--|ISOCode | String() | Y | 币种 | |
| --|--|rebate | Number | N | 返利 | |
| --|--|discount | Number | N | 折扣 | |
| --|--|paid-up | Number | N | 应收 | |
| VASFeeList | 增值费用列表 | |||
| --|--|serviceCode | String() | N | 增值服务编码 | |
| --|--|serviceName | String() | 增值服务名称 | ||
| --|--|feeCode | String() | N | 费用项编码 | |
| --|--|FeeNumber | String() | N | 费用金额 | |
| --|--|ISOCode | String() | N | 货币单位 | |
| 增值明细信息VASFeeList.attrList | ||||
| --|--|--|attrCode | String() | N | 增值服务Code，例如保险服务code | |
| --|--|--|attrValue | String() | N | 增值服务值，例如保险金额 | |
| --|--|--|attrUnit | String() | N | 增值服务单位---已停用 | |
| 打包信息packageInfo | ||||
| --|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
}
}]
}
关键词
