预估派送运费-3
更新时间: 2024-10-11 18:30:07 访问次数:15439
接口说明
通过本接口用户可以预估出库费用,包含库内处理费及派送费用等。
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"
}
返回出参
返回参数说明:正确的返回编码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 | 应收 | |
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": "5",
"amount": 26.12,
"palletNum": 0,
"VASFeeList": [
],
"totalFeeUSD": 26.12,
"standardCurrency": "USD",
"FeeList": [
{
"ISOCode": "USD",
"feeNumber": 17.64,
"feeSource": "OUTBOUND",
"rebate": -0.5292,
"feeCode": "103",
"feeName": "最后一公里派送费",
"discount": 0,
"paid-up": 17.1108,
"endDistName": "ZONE8",
"feeItemCode": "1000010",
"startDistName": "USWC Warehouse"
},
{
"ISOCode": "USD",
"feeNumber": 4.86,
"feeSource": "OUTBOUND",
"rebate": 0,
"feeCode": "287",
"feeName": "扩展地区附加费",
"discount": 0,
"paid-up": 4.86,
"endDistName": "ZONE8",
"feeItemCode": "1031248",
"startDistName": "USWC Warehouse"
},
{
"ISOCode": "USD",
"feeNumber": 0.2,
"feeSource": "OUTBOUND",
"rebate": 0,
"feeCode": "3000011",
"feeName": "出库处理费-续件费",
"discount": 0,
"paid-up": 0.2,
"endDistName": "USWC Warehouse",
"feeItemCode": "3000011",
"startDistName": "USWC Warehouse"
},
{
"ISOCode": "USD",
"feeNumber": 0.24,
"feeSource": "OUTBOUND",
"rebate": 0,
"feeCode": "102",
"feeName": "出库处理费",
"discount": 0,
"paid-up": 0.24,
"endDistName": "USWC Warehouse",
"feeItemCode": "1000914",
"startDistName": "USWC Warehouse"
},
{
"ISOCode": "USD",
"feeNumber": 0,
"feeSource": "OUTBOUND",
"rebate": 0,
"feeCode": "3000016",
"feeName": "出库处理费-应急附加费",
"discount": 0,
"paid-up": 0,
"endDistName": "USWC Warehouse",
"feeItemCode": "3000016",
"startDistName": "USWC Warehouse"
},
{
"ISOCode": "USD",
"feeNumber": 3.71,
"feeSource": "OUTBOUND",
"rebate": 0,
"feeCode": "100",
"feeName": "燃油附加费",
"discount": 0,
"paid-up": 3.71,
"endDistName": "ZONE8",
"feeItemCode": "1003247",
"startDistName": "USWC Warehouse"
}
],
"deliveryWayCode": "OSF811006991",
"deliveryWay": "UPS - Ground (Standard 1-5 Business Days)-US",
"packageInfo": {
"length": 15,
"width": 10,
"weight": 0.04,
"height": 1,
"CBM": 0.000001
}
}
]
}
关键词