Xinyao Yun protocol integration
ZenovaConnect integrates Xinyao Yun devices via 新耀云平台三方接口, normalizes fields, and pushes to your channel.
Integration details
- API source
- 新耀云平台三方接口
- Category
- 逆变器
- Auth method
- signed-request
- Data resolution
- 5min
- Downlink control
- No
- Applied at
- 2024-Q4
已拿到三方接口文档,对接进行中
Production observations
Xinyaoyun PV cloud Open API. Full doc in hand; integration in progress. Auth uses MD5 signing: `sign = MD5(key + appid + timestamp)`. Public headers are `auth-cert-appid`, `auth-cert-timestamp` (13-digit millis), `auth-cert-sign`. The shared `key` is never transmitted — classic v1-style signature, sensitive to clock skew and replay-window handling. Fields use a "data-item ID + value" model: data items are numeric (162=power, 163=daily energy, 160=cumulative, etc). Clients request by ID list, not field name. This supports multi-device-type (1 inverter / 2 combiner / 3 weather station / 15 meter) and dual-source metering (01 inverter-computed / 02 meter-computed). Alarm API is "batch query all unrecovered alarms" semantics — requires polling-and-diff, not event subscription.
Field mapping
| Vendor field | BaseData field | Note |
|---|---|---|
| plantList.id | PlantId | Plant ID |
| deviceSn | InverterSN | Device SN |
| 数据项 162 | PowerACOutputActive | W · current power |
| 数据项 163 | EDay | kWh · daily energy |
| 数据项 160 | ETotal | kWh · cumulative energy |
| 数据项 17/18/19 | UDC1, UDC2, UDC3 | V · DC input voltages 1-N (up to 32) |
| 数据项 33/34/35 | IDC1, IDC2, IDC3 | A · DC input currents 1-N |
| 三相输出频率 | FrqAC | Hz |
| 三相输出电压 | UAC1, UAC2, UAC3 | V · phase A/B/C |
| 内部温度(数据项 1) | Temperature | Celsius |
| 告警代码 | AlertArray | Batch unrecovered alarms — poll + diff |
| deviceStatus | (状态字段) | 01 running / 02 maintenance / 03 retired / 04 not-grid-tied |
Integration gotchas
- MD5 v1-style signing is sensitive to clock skew — needs NTP sync + retry-on-sign-fail with fresh timestamp
- Data items are numeric IDs (162/163/160…) — we maintain a complete ID→BaseData mapping table; new IDs occasionally appear outside the doc
- Dual metering sources (inverter vs meter) can coexist on the same plant — aggregation rule must be explicit
- Alarms are 'batch query all unrecovered' rather than event stream — we diff on our side to detect new/recovered
- Multi-device-type (inverter/combiner/weather/meter) shares one data-item namespace — adapter must branch on deviceType
⏳ ZENOVACONNECT INTEGRATION IN PROGRESS
API docs in hand, integration in progress · source 新耀云平台三方接口
Field observations
We documented 9 vendor integrations in detail. Useful comparison for this brand.
Read the article →Xinyao Yun integration — request priority
We can prioritize. Tell us your timeline and device scale.