API
预估派送运费-3
更新时间: 2024-04-11 22:24:58 访问次数:14116

接口说明

通过本接口用户可以预估出库费用,包含库内处理费及派送费用等。
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
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 费用项名称
–|–|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. "ISOCode": "USD",
  6. "outboundMethod": "RPL",
  7. "logisticsTime": null,
  8. "palletNum": 0,
  9. "VASFeeList": [ {
  10. "FeeName": "Tracked Parcel Insurance",
  11. "ISOCode": "CNY",
  12. "serviceCode": "OSF777778",
  13. "serviceName": "Tracked Parcel Insurance",
  14. "FeeCode": "325",
  15. "attrList": [ {
  16. "attrCode": "ISA",
  17. "attrValue": "50"
  18. }],
  19. "FeeNumber": 0.5
  20. }],
  21. "totalFeeUSD": 7.76,
  22. "FeeList": [
  23. {
  24. "ISOCode": "USD",
  25. "feeNumber": 7.77,
  26. "rebate": -0.23,
  27. "feeCode": "103",
  28. "feeName": "海外仓最后一公里派送费",
  29. "discount": 0,
  30. "paid-up": 7.54
  31. },
  32. {
  33. "ISOCode": "USD",
  34. "feeNumber": 0.05,
  35. "rebate": 0,
  36. "feeCode": "102",
  37. "feeName": "Outbound Order Handling Fee",
  38. "discount": 0,
  39. "paid-up": 0.05
  40. },
  41. {
  42. "ISOCode": "USD",
  43. "feeNumber": 0.1,
  44. "rebate": 0,
  45. "feeCode": "102",
  46. "feeName": "Small Size Order Packing Surcharge",
  47. "discount": 0,
  48. "paid-up": 0.1
  49. }
  50. ],
  51. "deliveryWayCode": "OSF810802",
  52. "deliveryWay": "USPS - Priority Mail (Express 2-3 Business Days)-eBay-USWC",
  53. "packageInfo": {
  54. "length": 16,
  55. "width": 8,
  56. "weight": 0.0363,
  57. "height": 8,
  58. "CBM": 0.001024
  59. }
  60. }]
  61. }