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

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

返回出参

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

返回示例

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