---
title: "SolaX Inverter (Cloud API)"
description: "SolaX inverterek (X1, X3, A1, J1) a TapHome-ban a SolaX Cloud API-n, HTTPS-en: PV-termelés, akkumulátor, hálózat. Kell dongle és API token."
url: "https://taphome.com/hu/compatibility/solax-inverter/"
language: hu
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["http","inverter","cloud-api","solar","battery-storage","energy-monitoring"]
  questions: ["Hogyan integrálható a SolaX inverter a TapHome-mal a Cloud API-n keresztül?","Milyen adatokat biztosít a SolaX Cloud API sablon a TapHome-ban?","Hogyan szerezhető meg a SolaX API tokenID a TapHome-hoz?","Mi a különbség a SolaX Cloud API és a Modbus sablon között a TapHome-ban?","Működik a SolaX Cloud API sablon az összes SolaX invertermodellel?","Milyen API-korlátok vonatkoznak a SolaX Cloud integrációra?"]
---

# SolaX Inverter (Cloud API)

Kommunikáció: Packet Parser → HTTP

- [SolaX Power hivatalos weboldal](https://www.solaxpower.com)

## Integrációs útmutató

A SolaX Cloud API sablon a TapHome-ot bármely SolaX inverterrel összeköti a SolaxCloud monitoring platformon keresztül. A [SolaX Hybrid X1/X3 Gen 4](https://taphome.com/hu/compatibility/solax-hybrid-x3-gen-4/) sablontól eltérően, amely Modbus RTU-t használ RS-485-ön keresztül, ez a felhőalapú integráció nem igényel fizikai bekötést az inverterhez. A TapHome a SolaX Cloud szervereket kérdezi le HTTPS-en keresztül, és valós idejű adatokat kap JSON formátumban.

A sablon az összes SolaX invertertípust támogatja (23 modell az X1, X3, A1 és J1 sorozatokból), és 11 monitorozó eszközt biztosít, amelyek lefedik az AC kimenetet, az akkumulátor állapotát, a hálózati energiaáramlást és az MPPT-nkénti PV-termelést. Az egyetlen követelmény egy SolaxCloud fiók, egy internetkapcsolattal rendelkező kommunikációs dongle (Pocket WiFi, LAN vagy 4G) és az API token.

## Konfiguráció

### SolaxCloud fiók beállítása

Az invertert regisztrálni kell és online állapotban kell lennie a [SolaxCloud](https://www.solaxcloud.com)-on. Az inverteren telepítve kell lennie egy kommunikációs modulnak (Pocket WiFi, LAN vagy 4G dongle), amely csatlakozik az internethez.

### Az API token beszerzése (tokenID)

1. Jelentkezz be a SolaxCloud-ba a [www.solaxcloud.com](https://www.solaxcloud.com) címen
2. A bal oldali menüben navigálj a **Service > Third-party ecosystem** (vagy az **API** szekció) menüpontra
3. Másold ki a megjelenített **tokenID**-t — ez egy 23 vagy 24 karakteres karakterlánc

A token ingyenes minden regisztrált SolaxCloud felhasználó számára.

### A regisztrációs szám megkeresése (sn)

Az `sn` paraméter a **kommunikációs dongle regisztrációs száma** — nem az inverter sorozatszáma. Ez gyakori félreértés forrása.

Hol találod:
- **A donglen** — a Pocket WiFi / LAN / 4G modul címkéjén nyomtatva (vonalkód vagy QR-kód)
- **A SolaxCloud-ban** — navigálj a **Device > Inverter** menüpontra, és keresd a **Registration No.** oszlopot a táblázatban

### Importparaméterek

A sablon TapHome-ba importálásakor add meg:
- **Token ID** — a tokenID a SolaxCloud-ból
- **Registration No.** — a kommunikációs dongle 10 karakteres sorozatszáma

### Internetfüggőség

Ez egy kizárólag felhőalapú integráció. Minden adat a SolaX Cloud szervereken (`www.solaxcloud.com:9443`) keresztül halad. A sablon nem működik aktív internetkapcsolat nélkül sem a TapHome CCU-n, sem az inverter kommunikációs donglján.

> [!TIP]
> Azok számára, akik helyi kommunikációt preferálnak felhőfüggőség nélkül, a [SolaX Hybrid X1/X3 Gen 4 (Modbus RTU)](https://taphome.com/hu/compatibility/solax-hybrid-x3-gen-4/) sablon közvetlen RS-485 kommunikációt biztosít a Gen 4 hibrid inverterekkel.

## Eszközképességek

### AC kimenet és energiatermelés

Az **AC Output** villanyóra méri a teljes AC energiatermelést (`yieldtotal` kWh-ban) és a valós idejű kimeneti teljesítményt (`acpower` W-ban, kW-ra konvertálva). Egy szervizattribútum jelzi a napi hozamot (`yieldtoday` kWh-ban), amely éjfélkor nullázódik.

### Akkumulátor monitorozás

- **Battery SOC** — az akkumulátor töltöttségi állapota százalékban a `soc` mezőből. Az érték 100-zal osztva a TapHome 0–1 analóg bemeneti tartományához (pl. 85% → 0,85). Ez a leggyorsabban lekérdezett eszköz 2,5 másodperces intervallummal
- **Battery Power** — pillanatnyi töltési/kisütési teljesítmény wattban. Pozitív értékek töltést jeleznek (PV-ből vagy hálózatból), negatív értékek kisütést a terhelésbe

### Hálózati teljesítmény és energiamérés

Három eszköz fedi le a hálózati energiaáramlást:

- **Grid Power** — nyers kétirányú hálózati teljesítmény wattban. Pozitív = betáplálás a hálózatba, negatív = vételezés a hálózatból
- **From Grid** — villanyóra, amely a hálózatból fogyasztott energiát méri. Teljes fogyasztás (`consumeenergy` kWh-ban) és valós idejű vételi teljesítmény (a `feedinpower`-ből kinyerve negatív értéknél, kW-ra konvertálva)
- **To Grid** — villanyóra, amely a hálózatba betáplált energiát méri. Teljes betáplált energia (`feedinenergy` kWh-ban) és valós idejű betáplálási teljesítmény (a `feedinpower`-ből kinyerve pozitív értéknél, kW-ra konvertálva)

### PV-termelés monitorozás

A sablon öt PV-termelési eszközt biztosít:

- **PV Production (Total)** — számított szenzor, amely összegzi mind a 4 MPPT bemenet DC teljesítményét. Null-biztos — a 4-nél kevesebb stringgel rendelkező inverterek null-t adnak vissza a nem használt MPPT-kre, amit a képlet nullaként kezel
- **PV Production (MPPT 1–4)** — egyedi DC teljesítményértékek minden PV string bemenethez wattban

### Modulszintű diagnosztika

A modul fő szkriptje minden lekérdezésnél ellenőrzi az inverter állapotát, és jelenti a problémákat:

- A **100** (Wait Mode) és **110** (Standby) állapotok figyelmeztetéseket váltanak ki a TapHome-ban
- A **103** (Fault Mode) és **104** (Permanent Fault Mode) állapotok hibákat váltanak ki
- Ha az API válasz hibát jelez, az `exception` mezőből származó hibaüzenet kerül jelentésre

Két szervizattribútum érhető el a modulon:

- **Inverter status** — állapotkódokat (100–113) olvasható nevekre képezi le (Wait Mode, Check Mode, Normal Mode, Fault Mode, Permanent Fault Mode, Update Mode, EPS Check Mode, EPS Mode, Self-Test Mode, Idle Mode, Standby Mode, Pv Wake Up Bat Mode, Gen Check Mode, Gen Run Mode)
- **Inverter type** — típuskódokat (1–23) modellnevekre képezi le (X1-LX, X-Hybrid, X1-Boost/Air/Mini, X3-Hybrid-G4 stb.)

### További lehetőségek

A SolaX Cloud API ezenfelül biztosítja a Meter 2 AC teljesítményt (`feedinpowerM2`), háromfázisú EPS (Emergency Power Supply) teljesítményt (`peps1`–`peps3`), az adatfeltöltés időbélyegét, az inverter sorozatszámát és az akkumulátor állapotát. Ezek egy jövőbeli sablonfrissítésben adhatók hozzá.

## Hibaelhárítás

### Az API hibát ad vagy nem szolgáltat adatokat

1. Ellenőrizd, hogy az inverter online a SolaxCloud-on — jelentkezz be a webportálon és ellenőrizd az eszköz állapotát
2. Győződj meg róla, hogy a tokenID helyes és nem lett újragenerálva (a régi tokenek érvénytelenné válnak)
3. Bizonyosodj meg, hogy az `sn` paraméter a **kommunikációs dongle regisztrációs száma**, nem az inverter sorozatszáma
4. Ellenőrizd, hogy a kommunikációs dongle aktív internetkapcsolattal rendelkezik

### Elavult vagy késleltetett értékek

A SolaX Cloud API a kommunikációs dongle által legutóbb feltöltött adatokat adja vissza. Az adatok frissessége a dongle feltöltési intervallumától függ (jellemzően 5 percenként). A sablon 20 másodpercenként kérdezi le az API-t, de a mögöttes adatok ritkábban frissülhetnek.

### API-korlát hibák

Az API legfeljebb 10 lekérdezést engedélyez percenként és 10 000 lekérdezést naponta. A sablon 20 másodperces intervallumal kérdez le (körülbelül 3 lekérdezés percenként), ami a korlátokon belül van. Ha több rendszer (TapHome, Home Assistant, egyéb eszközök) ugyanazt a tokenID-t használja, az összkérdezésszám meghaladhatja a korlátot.

> [!WARNING]
> A SolaX Cloud API aktív internetkapcsolatot igényel, és a SolaX Cloud szerverek elérhetőségétől függ. Felhőkiesések vagy internetszakadások esetén a sablon nem kap frissített adatokat. Garantált helyi vezérlést igénylő telepítéseknél fontold meg a [Modbus RTU sablon](https://taphome.com/hu/compatibility/solax-hybrid-x3-gen-4/) használatát.

## Elérhető eszközök 11

Ezek az eszközök az importálás után jelennek meg a TapHome-ban.

SolaX Inverter Modul

Szerviz attribútumok

|                   |                                                                                                                                                      |
|-------------------|------------------------------------------------------------------------------------------------------------------------------------------------------|
| Inverter állapota | Aktuális üzemmód — Wait, Check, Normal, Fault, Permanent Fault, Update, EPS Check, EPS, Self-Test, Idle, Standby, Pv Wake Up Bat, Gen Check, Gen Run |
| Inverter típusa   | Csatlakoztatott invertermodell — azonosítja a telepített SolaX sorozatot (X1, X3, A1, J1) és generációt                                              |

Egyéni változók

|                    |                                                                         |
|--------------------|-------------------------------------------------------------------------|
| `tokenID` (string) | SolaX Cloud API token ID (a SolaX Cloud fiók API oldalán szerezhető be) |
| `sn` (string)      | A SolaX kommunikációs modul sorozatszáma (Registration No.)             |

Olvasás (modul)

```taphome
var response := sendhttprequest("/proxy/api/getRealtimeInfo.do?tokenId="+tokenID+"&sn="+sn);

if parsejson(response.Content, "success")
	json := parsejson(response.Content, "result", 1);
	
	var statusCode := parsejson(json,"inverterStatus");
	if statusCode = "100"
	  addwarning("Inverter in waiting - Check DC");
	end
	if statusCode =  "103"
	  adderror("Inverter in fault mode");
	end
	if statusCode = "104"
	  adderror("Inverter in permanent fault mode");
	end
	if statusCode = "110"
	  addwarning("Inverter in standby mode");
	end
else
 	adderror(parsejson(response.Content, "exception"));
end
```

Szerviz attribútumok

Inverter status

```taphome
var statusCode := parsejson(json,"inverterStatus");

IF(statusCode = "100",return("Wait Mode"));
IF(statusCode = "101",return("Check Mode"));
IF(statusCode = "102",return("Normal Mode"));
IF(statusCode = "103",return("Fault Mode"));
IF(statusCode = "104",return("Permanent Fault Mode"));
IF(statusCode = "105",return("Update Mode"));
IF(statusCode = "106",return("EPS Check Mode"));
IF(statusCode = "107",return("EPS Mode"));
IF(statusCode = "108",return("Self-Test Mode"));
IF(statusCode = "109",return("Idle Mode"));
IF(statusCode = "110",return("Standby Mode"));
IF(statusCode = "111",return("Pv Wake Up Bat Mode"));
IF(statusCode = "112",return("Gen Check Mode"));
IF(statusCode = "113",return("Gen Run Mode"));
```

Inverter type

```taphome
var type := parsejson(json,"inverterType");

IF(type = "1",return("X1-LX"));
IF(type = "2",return("X-Hybrid"));
IF(type = "3",return("X1-Hybiyd/Fit"));
IF(type = "4",return("X1-Boost/Air/Mini"));
IF(type = "5",return("X3-Hybiyd/Fit"));
IF(type = "6",return("X3-20K/30K"));
IF(type = "7",return("X3-MIC/PRO"));
IF(type = "8",return("X1-Smart"));
IF(type = "9",return("X1-AC"));
IF(type = "10",return("A1-Hybrid"));
IF(type = "11",return("A1-Fit"));
IF(type = "12",return("A1-Grid"));
IF(type = "13",return("J1-ESS"));
IF(type = "14",return("X3-Hybrid-G4"));
IF(type = "15",return("X1-Hybrid-G4"));
IF(type = "16",return("X3-MIC/PRO-G2"));
IF(type = "17",return("X1-SPT"));
IF(type = "18",return("X1-Boost/Mini-G4"));
IF(type = "19",return("A1-HYB-G2"));
IF(type = "20",return("A1-AC-G2"));
IF(type = "21",return("A1-SMT-G2"));
IF(type = "22",return("X3-FTH"));
IF(type = "23",return("X3-MGA-G2"));
```

AC kimenet Villanyóra Csak olvasható

Teljes és napi AC energiatermelés (kWh) valós idejű kimeneti teljesítménnyel (kW)

numeric Egység: kWh / kW JSON parsejson()

Szerviz attribútumok

|                                     |                                            |
|-------------------------------------|--------------------------------------------|
| Inverter.AC.energy.out.daily \[kWh] | Napi AC energiahozam — éjfélkor nullázódik |

Összes fogyasztás olvasása

```taphome
parsejson(json, "yieldtotal", 1)
```

Igény olvasása

```taphome
parsejson(json, "acpower", 1) / 1000
```

Szerviz attribútumok

Inverter.AC.energy.out.daily \[kWh]

```taphome
parsejson(json, "yieldtoday", 1)
```

Akkumulátor SOC Analóg bemenet Csak olvasható

Akkumulátor töltöttségi állapot százalékban — 0% (üres) – 100% (tele)

numeric Egység: % JSON parsejson()

Bemeneti szint olvasása

```taphome
parsejson(json, "soc", 1) / 100
```

Akkumulátor teljesítmény Változó Csak olvasható

Pillanatnyi akkumulátor-teljesítmény wattban — pozitív töltéskor, negatív kisütéskor

numeric Egység: W JSON parsejson()

Olvasás

```taphome
parsejson(json,"batPower",1)
```

Hálózatból vételezett Villanyóra Csak olvasható

Hálózatból fogyasztott energia — teljes fogyasztás (kWh) és valós idejű vételi teljesítmény (kW)

numeric Egység: kWh / kW JSON parsejson()

Összes fogyasztás olvasása

```taphome
parsejson(json, "consumeenergy", 1)
```

Igény olvasása

```taphome
var power := parsejson(json, "feedinpower", 1);
if(power < 0, power * -1, 0) / 1000
```

Hálózati teljesítmény Változó Csak olvasható

Kétirányú hálózati teljesítmény wattban — pozitív exportnál, negatív importnál

numeric Egység: W JSON parsejson()

Olvasás

```taphome
parsejson(json, "feedinpower", 1)
```

FV-termelés (összesen) Változó Csak olvasható

Összesített DC teljesítmény az összes MPPT bemenetből — automatikusan összegzi az elérhető stringeket

numeric Egység: W JSON parsejson()

Olvasás

```taphome
var PV1 := parsejson(json,"powerdc1",1);
var PV2 := parsejson(json,"powerdc2",1);
var PV3 := parsejson(json,"powerdc3",1);
var PV4 := parsejson(json,"powerdc4",1);

if(isnull(PV1), 0, PV1) +
if(isnull(PV2), 0, PV2) +
if(isnull(PV3), 0, PV3) +
if(isnull(PV4), 0, PV4)
```

FV-termelés (MPPT 1) Változó Csak olvasható

numeric Egység: W JSON parsejson()

Olvasás

```taphome
parsejson(json,"powerdc1",1)
```

FV-termelés (MPPT 2) Változó Csak olvasható

numeric Egység: W JSON parsejson()

Olvasás

```taphome
parsejson(json,"powerdc2",1)
```

FV-termelés (MPPT 3) Változó Csak olvasható

numeric Egység: W JSON parsejson()

Olvasás (modul)

```taphome
parsejson(json,"powerdc3",1)
```

FV-termelés (MPPT 4) Változó Csak olvasható

numeric Egység: W JSON parsejson()

Olvasás (modul)

```taphome
parsejson(json,"powerdc4",1)
```

Hálózatba betáplált Villanyóra Csak olvasható

Hálózatba betáplált energia — teljes betáplált energia (kWh) és valós idejű betáplálási teljesítmény (kW)

numeric Egység: kWh / kW JSON parsejson()

Összes fogyasztás olvasása

```taphome
parsejson(json, "feedinenergy", 1)
```

Igény olvasása

```taphome
var power := parsejson(json, "feedinpower", 1);
if(power > 0, power, 0) / 1000
```

**Kapcsolat:** Packet Parser → HTTP

Lehetséges fejlesztések (7)

- Meter 2 AC Power — Inverter.Meter2.AC.power.total, 1 W. Secondary meter power reading — available for dual-meter setups
- EPS Phase 1 Power — Inverter.AC.EPS.power.R, 1 W. Emergency Power Supply output phase R
- EPS Phase 2 Power — Inverter.AC.EPS.power.S, 1 W. Emergency Power Supply output phase S
- EPS Phase 3 Power — Inverter.AC.EPS.power.T, 1 W. Emergency Power Supply output phase T
- Upload Time — Last data upload timestamp from inverter to SolaX Cloud. Useful for stale-data detection
- Inverter Serial Number — Serial number of the inverter hardware (different from communication module SN)
- Battery Status — Battery status code with mapped states. Documented in HA integration but not in official API V6.1 PDF

## Importálási paraméterek

Ezeket az értékeket az XML importálásakor adja meg.

| Az alkalmazás kéri                      | Alapérték              |
|-----------------------------------------|------------------------|
| Token ID                                | Importáláskor adja meg |
| Registration No. (communication module) | Importáláskor adja meg |

## Források

- SolaX Cloud User Monitoring API V6.1
  
  [www.solaxcloud.com](https://www.solaxcloud.com/user_api/SolaxCloud_User_Monitoring_API_V6.1.pdf) 2026-03-28
  
  [PDF](https://taphome.com/compatibility/devices/solax-inverter/manufacturer/SolaxCloud_User_Monitoring_API_V6.1.pdf)
- Home Assistant SolaX Cloud API Integration
  
  [github.com](https://github.com/NoUsername10/Solax-Cloud-API-for-Home-assistant) 2026-03-28
- SolaX KB: How to Obtain API Token
  
  [solaxpowerservice.zendesk.com](https://solaxpowerservice.zendesk.com/hc/en-001/articles/11054415299087-How-to-abtain-my-API-token) 2026-03-28

A gyártói dokumentumok © a mindenkori tulajdonosaikat illetik. A gyártó által közzétett formában, kizárólag tájékoztatásul tesszük elérhetővé őket.

## Kapcsolódó dokumentáció

- [Packet Parser integráció](https://taphome.com/hu/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hu/docs/integration/packet-parser/)
- [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/)
- [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/)