API
预估派送运费-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预估

  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. }

返回出参

返回参数说明:正确的返回编码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. }