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 } }] }
关键词