华为 协议接入
ZenovaConnect 通过 FusionSolar / SmartPVMS 北向接口 对接 华为 设备，统一字段后推到你的通道。
✓ 已对接
对接详情
- API 来源
- FusionSolar / SmartPVMS 北向接口
- 类别
- 逆变器
- 认证方式
- oauth2
- 数据精度
- 5min
- 下行控制
- 支持
- 申请接入
- 2024-02
- 上线时间
- 2024-Q3
覆盖商用 + 户用 + 储能整线
实际接入经验
我们最早对接的厂商之一(2024 Q1)。FusionSolar OpenAPI v2 文档完整、字段命名规范、API 改版有 changelog。 踩过的最大坑是某型号的 EDay(当日发电量)单位从 kWh 静默变成 kWh × 10,导致看板数字 翻 10 倍。修复成本:重发 6 个月历史数据 + 客户沟通 + 监控规则加单位校验。 告警代码字典较深,完整覆盖需要 3-4 周。OAuth2 凭据由商务流程下发,token 有效期较短 需要 retry + 自动刷新逻辑。
字段映射
| 厂商字段 | BaseData 字段 | 说明 |
|---|---|---|
| stationCode | PlantId | 1:1 |
| devSn | InverterSN | 1:1,需 stationCode 上下文 |
| dayEnergy | EDay | kWh(注意单位曾被改成 ×10) |
| totalEnergy | ETotal | 累计 kWh |
| invtActivePower | PowerACOutputActive | kW |
| tempInside | Temperature | 摄氏度 |
| gridFreq | FrqAC | Hz |
| vGridPhaseA | UAC1 | V · 三相分相 |
| iGridPhaseA | IAC1 | A · 三相分相 |
| alarms | AlertArray | 数组,需按厂商告警代码映射 |
接入坑点
- API minor version 升级每年 2-4 次,每次需要测试套件全跑一遍并对照 changelog
- EDay 单位曾经静默改成 kWh × 10,无 changelog 提醒,后续监控加单位校验
- 告警代码字典较深,首次接入需要 3-4 周覆盖所有 alarm code → BaseData AlertArray 的映射
- OAuth2 token 有效期较短,需要 retry + 自动刷新逻辑;凭据轮换约 6-12 月一次
✓ ZENOVACONNECT 已接入
生产环境对接自 2024-Q3 · API 来源 FusionSolar / SmartPVMS 北向接口