API
预估派送运费-3
更新时间： 2025-07-11 16:54:07 访问次数：17610

接口说明

通过本接口用户可以预估出库费用，包含库内处理费及派送费用等。
1、查询指定物流渠道，发出已注册商品SKU的预估费用（支持多个商品）
2、查询指定物流渠道，发出包裹的长宽高、重量、数量的预估费用，不支持多商品
3、不指定物流渠道，发出已注册商品SKU的预估费用（支持多个商品）
4、不指定物流渠道，发出包裹的长宽高、重量、数量的预估费用，不支持多商品
5、查询指定Winit产品分类，发出已注册商品SKU的预估费用（支持多个商品）
6、查询指定Winit产品分类，发出包裹的长宽高、重量、数量的预估费用，不支持多商品

注：

  1. 如需预估住宅地址相关的费用，卖家需先调用地址校验接口确认地址“是否为住宅地址”，再使用本接口进行费用测算。测算时入参字段isResidentialAddress，系统将按照入参的结果进行预估费用。
  2. 当前接口预估，不会校验客户产品权限、商品限制、平台限制等内容。如有需要请联系客服开通权限

接口名称

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
winitProductCategory4 String() N Winit产品分类
OSF811：标准出库
OSF823：自提出库
OSF822：三方面单服务
建议派送方式和产品分类二选一入参，或者都不入参		 OSF811
country String() Y 目的地国家 US
region String() N 目的地州 FL
city String() N 目的地城市 coral springs
zipCode String(22) Y 目的地邮编 33071
isResidentialAddress String N 是否住宅地址，Y/N
传Y，若派送方式涉及住宅附加费收费项，则会返回相应的费用
传N或不传，默认按商业地址测算费用
注：若无法判断地址类型，建议先调用地址校验接口测算地址是否为住宅		 Y
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

请求示例

1.多个商品SKU预估

  1. {
  2.     "action": "wh.outbound.calcDeliveryFee",
  3.     "app_key": "rebecca",
  4.     "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5.     "client_sign":"3B0899234EE1DA86BD808CCCC28A6817",
  6.     "data": {
  7.         "country": "US",
  8.         "region": "FL",
  9.         "city": "coral springs",
  10.         "salesAmount":"",
  11.         "currency":"USD",
  12.           "iossNo": "",
  13.         "VATNo":"",
  14.           "iossNo": "",
  15.         "productList": [
  16.             {
  17.                 "productCode": "auto_sku21",
  18.                 "productNum": "1",
  19.                 "specification": ""
  20.             }
  21.         ],
  22.         "productList": [
  23.             {
  24.                 "productCode": "216401",
  25.                 "productNum": "1",
  26.                 "specification": ""
  27.             }
  28.         ],
  29.         "warehouseCode": "US0001",
  30.         "zipCode": "33071",
  31.         "winitProductCode": "OSF810802"
  32.     },
  33.       "language": "zh_CN",
  34.     "platform": "OWNERERP",
  35.     "sign": "269A90E453E8FAF3B63A94E967F5E413",
  36.     "sign_method": "md5",
  37.     "timestamp": "",
  38.     "version": "1.0"
  39. }

2.商品尺重和数量预估

  1. {
  2.     "action": "wh.outbound.calcDeliveryFee",
  3.     "app_key": "rebecca",
  4.     "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5.     "client_sign":"990DD1B68FD76566498E43B6D8EAEB63",
  6.      "data": {
  7.         "country": "US",
  8.         "region": "FL",
  9.         "city": "coral springs",
  10.         "productList": [
  11.             {
  12.                 "length": "1",
  13.                 "width": "1",
  14.                 "height": "1",
  15.                 "weight": "1",
  16.                 "productNum": "1"
  17.             }
  18.         ],
  19.         "warehouseCode": "US0001",
  20.         "zipCode": "33071",
  21.         "winitProductCode": "OSF810802"
  22.     },
  23.     "language": "zh_CN",
  24.     "platform": "OWNERERP",
  25.     "sign": "8EF28A7D96837104ADF99E3D1A6FAAFF",
  26.     "sign_method": "md5",
  27.     "timestamp": "",
  28.     "version": "1.0"
  29. }

3.增值服务费用预估

  1. {
  2.     "action": "wh.outbound.calcDeliveryFee",
  3.     "app_key": "rebecca",
  4.     "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5.     "client_sign":"725FAE76920D34401A0D531BA2B6E1E0",
  6.     "data": {
  7.         "country": "US",
  8.         "region": "FL",
  9.         "city": "coral springs",
  10.         "productList": [
  11.             {
  12.                 "productCode": "auto_sku21",
  13.                 "productNum": "1",
  14.                 "specification": ""
  15.             }
  16.         ],
  17.         "productList": [
  18.             {
  19.                 "productCode": "216401",
  20.                 "productNum": "1",
  21.                 "specification": ""
  22.             }
  23.         ],
  24.    "VASList": [{
  25.         "serviceCode": "OSF777778",
  26.         "attrList": [{
  27.           "attrCode": "ISA",
  28.           "attrValue": "50"
  29.         }]
  30.         }],
  31.         "warehouseCode": "US0001",
  32.         "zipCode": "33071",
  33.         "winitProductCode": "OSF810802"
  34.     },
  35.     "language": "zh_CN",
  36.     "platform": "OWNERERP",
  37.     "sign": "4D902B4D15E520D240D608936B9B443B",
  38.     "sign_method": "md5",
  39.     "timestamp": "",
  40.     "version": "1.0"
  41. }

4.电商销售价格进行预估

  1. {
  2.     "action": "wh.outbound.calcDeliveryFee",
  3.     "app_key": "rebecca",
  4.     "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5.     "client_sign": "9B2CA836EA11F61C9A979A56B0DA787D",
  6.     "data": {
  7.         "country": "US",
  8.         "region": "FL",
  9.         "city": "coral springs",
  10.         "salesAmount": "10000",
  11.         "currency": "USD",
  12.         "productList": [
  13.             {
  14.                 "productCode": "216401",
  15.                 "productNum": "1",
  16.                 "specification": ""
  17.             }
  18.         ],
  19.         "warehouseCode": "US0001",
  20.         "zipCode": "33071",
  21.         "winitProductCode": "OSF810802"
  22.     },
  23.     "language": "zh_CN",
  24.     "platform": "OWNERERP",
  25.     "sign": "5C6866DC4A154634C372AE1A8E30B69E",
  26.     "sign_method": "md5",
  27.     "timestamp": "",
  28.     "version": "1.0"
  29. }

5.出库加包装预估

  1. {
  2.     "action": "wh.outbound.calcDeliveryFee",
  3.     "app_key": "rebecca",
  4.     "client_id": "ZDCYZGRMOTETZJCXNC00NJVJLWJHMMYTYME2NTK5ZTYYM2QZ",
  5.     "client_sign": "393ABCFF7BDE3CF35728D66B2BC493CE",
  6.     "data": {
  7.         "country": "US",
  8.         "region": "FL",
  9.         "city": "coral springs",
  10.         "salesAmount": "",
  11.         "currency": "USD",
  12.         "iossNo": "",
  13.         "VATNo": "",
  14.         "productList": [
  15.             {
  16.                 "productCode": "216401",
  17.                 "productNum": "1",
  18.                 "specification": ""
  19.             }
  20.         ],
  21.         "VASList": [
  22.             {
  23.                 "serviceCode": "OSF24WW008",
  24.                 "attrList": [
  25.                     {
  26.                         "attrCode": "PACKAGE_TYPE_MATERIAL",
  27.                         "attrValue": "CARTON_BOX"
  28.                     },
  29.                     {
  30.                         "attrCode": "PACKAGE_MODE",
  31.                         "attrValue": "PACKAGING_WINIT"
  32.                     }
  33.                 ]
  34.             }
  35.         ],
  36.         "warehouseCode": "US0001",
  37.         "zipCode": "33071",
  38.         "winitProductCode": "OSF810802"
  39.     },
  40.     "language": "zh_CN",
  41.     "platform": "OWNERERP",
  42.     "sign": "DBA408FB435969F465C6ED1AE8F44B58",
  43.     "sign_method": "md5",
  44.     "timestamp": "",
  45.     "version": "1.0"
  46. }

6.平台限制预估

平台限制预估请申请权限

  1. {
  2.     "action": "wh.outbound.calcDeliveryFee",
  3.     "app_key": "rebecca",
  4.     "client_id": "ZDCYZGRMOTETZJCXNC00NJVJLWJHMMYTYME2NTK5ZTYYM2QZ",
  5.     "client_sign": "393ABCFF7BDE3CF35728D66B2BC493CE",
  6.     "data": {
  7.         "country": "US",
  8.         "region": "FL",
  9.         "city": "Mayo",
  10.         "salesAmount": "",
  11.         "currency": "USD",
  12.         "storeType": "ebay",
  13.         "productList": [
  14.             {
  15.                 "productCode": "auto_sku_003",
  16.                 "productNum": "1",
  17.                 "specification": "",
  18.                 "skuType": "SINGLE",
  19.                 "skuStandardQuantity": ""
  20.             },
  21.             {
  22.                 "productCode": "auto_sku_002",
  23.                 "productNum": "1",
  24.                 "specification": "",
  25.                 "skuType": "SINGLE",
  26.                 "skuStandardQuantity": ""
  27.             }
  28.         ],
  29.         "warehouseCode": "US0001",
  30.         "zipCode": "32066",
  31.         "winitProductCode": "OSF810802"
  32.     },
  33.     "language": "zh_CN",
  34.     "platform": "OWNERERP",
  35.     "sign": "DBA408FB435969F465C6ED1AE8F44B58",
  36.     "sign_method": "md5",
  37.     "timestamp": "",
  38.     "version": "1.0"
  39. }

7.住宅地址费用预估

  1. {
  2.     "action": "wh.outbound.calcDeliveryFee",
  3.     "app_key": "rebecca",
  4.     "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5.     "client_sign":"3B0899234EE1DA86BD808CCCC28A6817",
  6.     "data": {
  7.         "country": "US",
  8.         "region": "FL",
  9.         "city": "coral springs",
  10.         "salesAmount":"",
  11.         "isResidentialAddress":"Y",
  12.         "currency":"USD",
  13.         "iossNo": "",
  14.         "VATNo":"",
  15.         "iossNo": "",
  16.         "productList": [
  17.             {
  18.                 "productCode": "auto_sku21",
  19.                 "productNum": "1",
  20.                 "specification": ""
  21.             }
  22.         ],
  23.         "productList": [
  24.             {
  25.                 "productCode": "216401",
  26.                 "productNum": "1",
  27.                 "specification": ""
  28.             }
  29.         ],
  30.         "warehouseCode": "US0001",
  31.         "zipCode": "33071",
  32.         "winitProductCode": "OSF810802"
  33.     },
  34.     "language": "zh_CN",
  35.     "platform": "OWNERERP",
  36.     "sign": "269A90E453E8FAF3B63A94E967F5E413",
  37.     "sign_method": "md5",
  38.     "timestamp": "",
  39.     "version": "1.0"
  40. }

8.Winit产品分类费用预估

  1. {
  2.     "action": "wh.outbound.calcDeliveryFee",
  3.     "app_key": "rebecca",
  4.     "data": {
  5.         "country": "US",
  6.         "zipCode": "90001",
  7.         "city": "Los angele1",
  8.         "winitProductCode": "",
  9.         "region": "CA",
  10.         "productList": [
  11.             {
  12.                 "productCode": "auto_sku22",
  13.                 "productNum": 2
  14.             }
  15.         ],
  16.         "warehouseCode": "US0001",
  17.         "winitProductCategory4": "OSF811"
  18.     },
  19.     "format": "json",
  20.     "language": "zh_CN",
  21.     "platform": "OWNERERP",
  22.     "sign": "0CEA5ACE6010E61BB5A33163408A84F5",
  23.     "sign_method": "md5",
  24.     "timestamp": "2024-09-03 10:54:00",
  25.     "version": "1.0"
  26. }

返回出参

返回参数说明：正确的返回编码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 包裹体积

返回示例

  1. {
  2.   "code": "0",
  3.   "msg": "操作成功",
  4.   "data": [
  5.     {
  6.       "ISOCode": "USD",
  7.       "outboundMethod": "RPL",
  8.       "logisticsTime": 8,
  9.       "palletNum": 0,
  10.       "totalFeeUSD": 16.87,
  11.       "FeeList": [
  12.         {
  13.           "ISOCode": "USD",
  14.           "feeNumber": 10.71,
  15.           "feeSource": "OUTBOUND",
  16.           "rebate": -0.3213,
  17.           "feeCode": "103",
  18.           "feeName": "最后一公里派送费",
  19.           "discount": 0,
  20.           "paid-up": 10.3887,
  21.           "endDistName": "Zone8",
  22.           "feeItemCode": "1000010",
  23.           "startDistName": "USWC Warehouse"
  24.         },
  25.         {
  26.           "ISOCode": "USD",
  27.           "feeNumber": 3.50,
  28.           "feeSource": "OUTBOUND",
  29.           "rebate": 0,
  30.           "feeCode": "287",
  31.           "feeName": "扩展地区附加费",
  32.           "discount": 0,
  33.           "paid-up": 3.50,
  34.           "endDistName": "Zone8",
  35.           "feeItemCode": "1031248",
  36.           "startDistName": "USWC Warehouse"
  37.         },
  38.         {
  39.           "ISOCode": "USD",
  40.           "feeNumber": 0.26,
  41.           "feeSource": "OUTBOUND",
  42.           "rebate": 0,
  43.           "feeCode": "102",
  44.           "feeName": "出库处理费",
  45.           "discount": 0,
  46.           "paid-up": 0.26,
  47.           "endDistName": "USWC Warehouse",
  48.           "feeItemCode": "1000914",
  49.           "startDistName": "USWC Warehouse"
  50.         },
  51.         {
  52.           "ISOCode": "USD",
  53.           "feeNumber": 0.20,
  54.           "feeSource": "OUTBOUND",
  55.           "rebate": 0,
  56.           "feeCode": "102",
  57.           "feeName": "出库处理费-标准包装打包费",
  58.           "discount": 0,
  59.           "paid-up": 0.20,
  60.           "endDistName": "USWC Warehouse",
  61.           "feeItemCode": "1046247",
  62.           "startDistName": "USWC Warehouse"
  63.         },
  64.         {
  65.           "ISOCode": "USD",
  66.           "feeNumber": 0.00,
  67.           "feeSource": "OUTBOUND",
  68.           "rebate": 0,
  69.           "feeCode": "3000016",
  70.           "feeName": "出库处理费-应急附加费",
  71.           "discount": 0,
  72.           "paid-up": 0.00,
  73.           "endDistName": "USWC Warehouse",
  74.           "feeItemCode": "3000016",
  75.           "startDistName": "USWC Warehouse"
  76.         },
  77.         {
  78.           "ISOCode": "USD",
  79.           "feeNumber": 2.52,
  80.           "feeSource": "OUTBOUND",
  81.           "rebate": 0,
  82.           "feeCode": "100",
  83.           "feeName": "燃油附加费",
  84.           "discount": 0,
  85.           "paid-up": 2.52,
  86.           "endDistName": "Zone8",
  87.           "feeItemCode": "1003247",
  88.           "startDistName": "USWC Warehouse"
  89.         }
  90.       ],
  91.       "deliveryWayCode": "OSF811007100",
  92.       "deliveryWay": "FedEx - Ground Economy (Economy 2-8 Business Days)-US",
  93.       "packageInfo": {
  94.         "length": 15,
  95.         "width": 11.0,
  96.         "weight": 0.0300,
  97.         "height": 11.0,
  98.         "CBM": 0.001815000
  99.       }
  100.     }
  101.   ]
  102. }