预估派送运费-3
更新时间: 2025-05-08 16:11:37 访问次数:16461
接口说明
通过本接口用户可以预估出库费用,包含库内处理费及派送费用等。
1、 查询指定物流渠道,发出已注册商品SKU的预估费用(支持多个商品)
2、 查询指定物流渠道,发出包裹的长宽高、重量、数量的预估费用,不支持多商品
3、 不指定物流渠道,发出已注册商品SKU的预估费用(支持多个商品)
4、 不指定物流渠道,发出包裹的长宽高、重量、数量的预估费用,不支持多商品
注:当前接口预估,不会校验客户产品权限、商品限制、平台限制等内容。如有需要请联系客服开通权限
接口名称
wh.outbound.calcDeliveryFee
请求说明
请求内容 | 说明 |
---|---|
URL | https://openapi.winit.com.cn/openapi/service |
接口测试 | https://sandboxopenapi.winit.com.cn/openapi/service |
验证方法 | Token,md5 |
格式 | json |
字符编码 | UTF-8 |
http请求方式 | http |
请求数限制 | 默认每分钟1000,1000有需要可申请加大。 |
请求入参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
warehouseCode | String(22) | Y | 仓库代码 | US0001 |
winitProductCode | String(22) | N | 派送方式代码 | OSF810802 |
country | String() | Y | 目的地国家 | US |
region | String() | N | 目的地州 | FL |
city | String() | N | 目的地城市 | coral springs |
zipCode | String(22) | Y | 目的地邮编 | 33071 |
VATNo | String() | N | 卖家VAT | |
iossNo | String() | N | IOSS | |
salesAmount | BigDecimal(6,2) | N | 销售金额 限制0.01-999999.99 | 10 |
currency | String(128) | N | 销售金额币种 | USD |
storeType | String(100) | N | 电商平台类型 eBay,Amazon,Wish,TikTok,Temu,Shopify,OTTO,AliExpress,Shein,Other |
|
VASList | Array | N | 增值服务列表 | |
– serviceCode | String() | N | 增值服务编码 | OSF777778 |
VASList.attrList | Array | N | 增值服务明细信息 | |
– – attrCode | String() | N | 增值服务属性code | ISA |
– – attrValue | String() | N | 增值服务值 | 10 |
productList | Array | Y | 商品列表,以下方式二选一 1.按商品SKU预估,入参:SKU、数量、规格 2.按商品尺重预估,入参:长宽高、重量、数量 |
|
– productCode | String(255) | N | 商品编码,SKU | 216401 |
– productNum | Int | N | 商品数量 | 1 |
– specification | String(255) | O | 商品规格 选填,当商品注册时填写了Specification,则为必填,若注册时没有填写则无需入参 | |
– length | Number(10,2) | N | 商品长度 ,单位CM | 1 |
– width | Number(10,2) | N | 商品宽度 ,单位CM | 1 |
– height | Number(10,2) | N | 商品高度 ,单位CM | 1 |
– weight | Number(10,4) | N | 商品重量 ,单位Kg | 1 |
– productNum | Int | N | 商品数量 ,整数 | 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"
}
5.出库加包装预估
{
"action": "wh.outbound.calcDeliveryFee",
"app_key": "rebecca",
"client_id": "ZDCYZGRMOTETZJCXNC00NJVJLWJHMMYTYME2NTK5ZTYYM2QZ",
"client_sign": "393ABCFF7BDE3CF35728D66B2BC493CE",
"data": {
"country": "US",
"region": "FL",
"city": "coral springs",
"salesAmount": "",
"currency": "USD",
"iossNo": "",
"VATNo": "",
"productList": [
{
"productCode": "216401",
"productNum": "1",
"specification": ""
}
],
"VASList": [
{
"serviceCode": "OSF24WW008",
"attrList": [
{
"attrCode": "PACKAGE_TYPE_MATERIAL",
"attrValue": "CARTON_BOX"
},
{
"attrCode": "PACKAGE_MODE",
"attrValue": "PACKAGING_WINIT"
}
]
}
],
"warehouseCode": "US0001",
"zipCode": "33071",
"winitProductCode": "OSF810802"
},
"language": "zh_CN",
"platform": "OWNERERP",
"sign": "DBA408FB435969F465C6ED1AE8F44B58",
"sign_method": "md5",
"timestamp": "",
"version": "1.0"
}
6.平台限制预估
平台限制预估请申请权限
{
"action": "wh.outbound.calcDeliveryFee",
"app_key": "rebecca",
"client_id": "ZDCYZGRMOTETZJCXNC00NJVJLWJHMMYTYME2NTK5ZTYYM2QZ",
"client_sign": "393ABCFF7BDE3CF35728D66B2BC493CE",
"data": {
"country": "US",
"region": "FL",
"city": "Mayo",
"salesAmount": "",
"currency": "USD",
"storeType": "ebay",
"productList": [
{
"productCode": "auto_sku_003",
"productNum": "1",
"specification": "",
"skuType": "SINGLE",
"skuStandardQuantity": ""
},
{
"productCode": "auto_sku_002",
"productNum": "1",
"specification": "",
"skuType": "SINGLE",
"skuStandardQuantity": ""
}
],
"warehouseCode": "US0001",
"zipCode": "32066",
"winitProductCode": "OSF810802"
},
"language": "zh_CN",
"platform": "OWNERERP",
"sign": "DBA408FB435969F465C6ED1AE8F44B58",
"sign_method": "md5",
"timestamp": "",
"version": "1.0"
}
返回出参
返回参数说明:正确的返回编码code:0及结果data,错误的返回错误码及错误信息msg。
名称 | 类型 | 必传 | 说明 | 示例 |
---|---|---|---|---|
data | Array | Y | 可用派送方式预估 | |
– deliveryWayCode | String() | Y | 派送方式编码 | |
– deliveryWay | String() | Y | 派送方式名称 | |
– logisticsTime | Number | Y | 派送时效天数 | |
– outboundMethod | String() | Y | 出库方式 | |
– palletNum | Number | Y | 托盘数 | |
– totalFeeUSD | Number(10,2) | Y | 原币总金额,加上增值费用的总费用 注:币种以ISOCode返回为准 |
|
– ISOCode | String() | Y | 原币币种 | AUD |
– amount | String() | Y | 本位币总金额,加上增值费用的总费用 | |
– standardCurrency | String() | Y | 本位币币种,默认USD | USD |
FeeList | Array | Y | 费用列表 | |
– – feeName | String() | Y | 费用项名称 | |
– – feeItemCode | String() | Y | 费用项编码 | |
– – feeCode | String() | Y | 已停用,费用项编码 | |
– – feeNumber | Number | Y | 总费用 | |
– – ISOCode | String() | Y | 币种 | |
– – rebate | Number | N | 返利 | |
– – discount | Number | N | 折扣 | |
– – paid-up | Number | N | 应收 | |
– – endDistName | String() | Y | 目的分区 若费用项编码为1000010最后一公里派送费,则目的分区为买家分区 其他场景分区可忽略 |
|
VASFeeList | Array | N | 增值费用列表 | |
– – serviceCode | String() | N | 增值服务编码 | |
– – serviceName | String() | N | 增值服务名称 | |
– – feeCode | String() | N | 费用项编码 | |
– – FeeNumber | String() | N | 费用金额 | |
– – ISOCode | String() | N | 货币单位 | |
VASFeeList.attrList | Array | N | 增值明细信息 | |
– – – attrCode | String() | N | 增值服务Code,例如保险服务code | |
– – – attrValue | String() | N | 增值服务值,例如保险金额 | |
– – – attrUnit | String() | N | 增值服务单位—已停用 | |
packageInfo | Object | 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": 8,
"palletNum": 0,
"totalFeeUSD": 16.87,
"FeeList": [
{
"ISOCode": "USD",
"feeNumber": 10.71,
"feeSource": "OUTBOUND",
"rebate": -0.3213,
"feeCode": "103",
"feeName": "最后一公里派送费",
"discount": 0,
"paid-up": 10.3887,
"endDistName": "Zone8",
"feeItemCode": "1000010",
"startDistName": "USWC Warehouse"
},
{
"ISOCode": "USD",
"feeNumber": 3.50,
"feeSource": "OUTBOUND",
"rebate": 0,
"feeCode": "287",
"feeName": "扩展地区附加费",
"discount": 0,
"paid-up": 3.50,
"endDistName": "Zone8",
"feeItemCode": "1031248",
"startDistName": "USWC Warehouse"
},
{
"ISOCode": "USD",
"feeNumber": 0.26,
"feeSource": "OUTBOUND",
"rebate": 0,
"feeCode": "102",
"feeName": "出库处理费",
"discount": 0,
"paid-up": 0.26,
"endDistName": "USWC Warehouse",
"feeItemCode": "1000914",
"startDistName": "USWC Warehouse"
},
{
"ISOCode": "USD",
"feeNumber": 0.20,
"feeSource": "OUTBOUND",
"rebate": 0,
"feeCode": "102",
"feeName": "出库处理费-标准包装打包费",
"discount": 0,
"paid-up": 0.20,
"endDistName": "USWC Warehouse",
"feeItemCode": "1046247",
"startDistName": "USWC Warehouse"
},
{
"ISOCode": "USD",
"feeNumber": 0.00,
"feeSource": "OUTBOUND",
"rebate": 0,
"feeCode": "3000016",
"feeName": "出库处理费-应急附加费",
"discount": 0,
"paid-up": 0.00,
"endDistName": "USWC Warehouse",
"feeItemCode": "3000016",
"startDistName": "USWC Warehouse"
},
{
"ISOCode": "USD",
"feeNumber": 2.52,
"feeSource": "OUTBOUND",
"rebate": 0,
"feeCode": "100",
"feeName": "燃油附加费",
"discount": 0,
"paid-up": 2.52,
"endDistName": "Zone8",
"feeItemCode": "1003247",
"startDistName": "USWC Warehouse"
}
],
"deliveryWayCode": "OSF811007100",
"deliveryWay": "FedEx - Ground Economy (Economy 2-8 Business Days)-US",
"packageInfo": {
"length": 15,
"width": 11.0,
"weight": 0.0300,
"height": 11.0,
"CBM": 0.001815000
}
}
]
}
关键词