---
title: "SolaX Inverter (Cloud API)"
description: "Integrácia SolaX Cloud API pre všetky typy solárnych invertorov SolaX (séria X1, X3, A1, J1)."
url: "https://taphome.com/sk/compatibility/solax-inverter/"
language: sk
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["http","inverter","cloud-api","solar","battery-storage","energy-monitoring"]
  questions: ["Ako integrovať solárny invertor SolaX s TapHome cez Cloud API?","Aké dáta poskytuje šablóna SolaX Cloud API v TapHome?","Ako získať SolaX API tokenID pre TapHome?","Aký je rozdiel medzi šablónou SolaX Cloud API a Modbus v TapHome?","Funguje šablóna SolaX Cloud API so všetkými modelmi SolaX invertorov?","Aké sú limity API pre integráciu SolaX Cloud?"]
---

# SolaX Inverter (Cloud API)

Komunikácia: Packet Parser → HTTP

- [Oficiálna stránka SolaX Power](https://www.solaxpower.com)

## Návod na integráciu

Šablóna SolaX Cloud API prepojí TapHome s ľubovoľným solárnym invertorom SolaX prostredníctvom monitorovacej platformy SolaxCloud. Na rozdiel od šablóny [SolaX Hybrid X1/X3 Gen 4](https://taphome.com/sk/compatibility/solax-hybrid-x3-gen-4/), ktorá používa Modbus RTU cez RS-485, táto cloudová integrácia nevyžaduje žiadne fyzické zapojenie k invertoru. TapHome dopytuje servery SolaX Cloud cez HTTPS a prijíma dáta v reálnom čase vo formáte JSON.

Šablóna podporuje všetky typy invertorov SolaX (23 modelov naprieč sériami X1, X3, A1 a J1) a poskytuje 11 monitorovacích zariadení pokrývajúcich AC výstup, stav batérie, tok energie do siete a FV výrobu na jednotlivých MPPT vstupoch. Jedinou požiadavkou je účet na SolaxCloud, komunikačný dongle s pripojením na internet (Pocket WiFi, LAN alebo 4G) a API token.

## Konfigurácia

### Nastavenie účtu SolaxCloud

Invertor musí byť zaregistrovaný a online na [SolaxCloud](https://www.solaxcloud.com). Na invertore musí byť nainštalovaný komunikačný modul (Pocket WiFi, LAN alebo 4G dongle) pripojený k internetu.

### Získanie API tokenu (tokenID)

1. Prihláste sa do SolaxCloud na [www.solaxcloud.com](https://www.solaxcloud.com)
2. V ľavom bočnom paneli prejdite na **Service > Third-party ecosystem** (alebo sekciu **API**)
3. Skopírujte zobrazený **tokenID** — ide o 23- alebo 24-znakový reťazec

Token je bezplatný pre všetkých registrovaných používateľov SolaxCloud.

### Nájdenie registračného čísla (sn)

Parameter `sn` je **registračné číslo komunikačného donglu** — nie sériové číslo invertora. Toto je častý zdroj zámeny.

Kde ho nájsť:
- **Na dongli** — vytlačené na štítku modulu Pocket WiFi / LAN / 4G (čiarový kód alebo QR kód)
- **V SolaxCloud** — prejdite na **Device > Inverter** a vyhľadajte stĺpec **Registration No.** v tabuľke

### Importné parametre

Pri importovaní šablóny v TapHome zadajte:
- **Token ID** — tokenID zo SolaxCloud
- **Registration No.** — 10-znakové sériové číslo komunikačného donglu

### Závislosť na internete

Toto je čisto cloudová integrácia. Všetky dáta prúdia cez servery SolaX Cloud (`www.solaxcloud.com:9443`). Šablóna nebude fungovať bez aktívneho internetového pripojenia na TapHome CCU aj na komunikačnom dongli invertora.

> [!TIP]
> Pre používateľov, ktorí preferujú lokálnu komunikáciu bez závislosti na cloude, šablóna [SolaX Hybrid X1/X3 Gen 4 (Modbus RTU)](https://taphome.com/sk/compatibility/solax-hybrid-x3-gen-4/) poskytuje priamu komunikáciu cez RS-485 s hybridnými invertormi Gen 4.

## Schopnosti zariadenia

### AC výstup a energetická produkcia

Elektromer **AC Output** meria celkovú produkciu AC energie (`yieldtotal` v kWh) a aktuálny výstupný výkon (`acpower` vo W, konvertovaný na kW). Servisný atribút zobrazuje denný výnos (`yieldtoday` v kWh), ktorý sa resetuje o polnoci.

### Monitorovanie batérie

- **Battery SOC** — stav nabitia batérie v percentách z poľa `soc`. Hodnota je vydelená 100 pre rozsah analógového vstupu TapHome 0–1 (napr. 85 % → 0,85). Toto je najrýchlejšie dopytované zariadenie s intervalom 2,5 sekundy
- **Battery Power** — okamžitý výkon nabíjania/vybíjania batérie vo wattoch. Kladné hodnoty znamenajú nabíjanie (z FV alebo siete), záporné hodnoty znamenajú vybíjanie do záťaže

### Výkon siete a meranie energie

Tri zariadenia pokrývajú tok energie do/zo siete:

- **Grid Power** — surový obojsmerný výkon siete vo wattoch. Kladný = export do siete, záporný = odber zo siete
- **From Grid** — elektromer sledujúci energiu spotrebovanú zo siete. Celková spotreba (`consumeenergy` v kWh) a aktuálny výkon odberu (extrahovaný z `feedinpower` keď záporný, konvertovaný na kW)
- **To Grid** — elektromer sledujúci energiu exportovanú do siete. Celková energia dodaná do siete (`feedinenergy` v kWh) a aktuálny výkon dodávky (extrahovaný z `feedinpower` keď kladný, konvertovaný na kW)

### Monitorovanie FV výroby

Šablóna poskytuje päť zariadení pre FV výrobu:

- **PV Production (Total)** — vypočítaný senzor sčítajúci DC výkon zo všetkých 4 MPPT vstupov. Odolný voči null hodnotám — invertory s menej ako 4 stringmi vracajú null pre nepoužité MPPT, čo vzorec počíta ako nulu
- **PV Production (MPPT 1–4)** — individuálne DC výkony pre každý FV string vstup vo wattoch

### Diagnostika na úrovni modulu

Hlavný skript modulu kontroluje stav invertora pri každom dopytovaní a hlási problémy:

- Stav **100** (Wait Mode) a **110** (Standby) vyvolávajú varovania v TapHome
- Stav **103** (Fault Mode) a **104** (Permanent Fault Mode) vyvolávajú chyby
- Ak API odpoveď indikuje zlyhanie, chybová správa z poľa `exception` je reportovaná

Na module sú dostupné dva servisné atribúty:

- **Inverter status** — mapuje stavové kódy 100–113 na čitateľné názvy (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** — mapuje kódy typov 1–23 na názvy modelov (X1-LX, X-Hybrid, X1-Boost/Air/Mini, X3-Hybrid-G4 atď.)

### Ďalšie možnosti

SolaX Cloud API tiež poskytuje výkon Meter 2 AC (`feedinpowerM2`), výkon EPS (Emergency Power Supply) pre tri fázy (`peps1`–`peps3`), časovú pečiatku nahratia dát, sériové číslo invertora a stav batérie. Tieto je možné pridať v budúcej aktualizácii šablóny.

## Riešenie problémov

### API vracia chybu alebo žiadne dáta

1. Overte, že invertor je online na SolaxCloud — prihláste sa na webový portál a skontrolujte stav zariadenia
2. Skontrolujte, či je tokenID správny a nebol regenerovaný (staré tokeny sa zneplatnia)
3. Uistite sa, že parameter `sn` je **registračné číslo komunikačného donglu**, nie sériové číslo invertora
4. Skontrolujte, či má komunikačný dongle aktívne internetové pripojenie

### Zastarané alebo oneskorené hodnoty

SolaX Cloud API vracia najnovšie dáta nahrané komunikačným donglom. Aktuálnosť dát závisí od intervalu nahrávania donglu (zvyčajne každých 5 minút). Šablóna dopytuje API každých 20 sekúnd, ale podkladové dáta sa môžu aktualizovať menej často.

### Chyby limitov API

API povoľuje maximálne 10 požiadaviek za minútu a 10 000 požiadaviek za deň. Šablóna dopytuje v 20-sekundových intervaloch (približne 3 požiadavky za minútu), čo je v rámci limitov. Ak viacero systémov (TapHome, Home Assistant, iné nástroje) zdieľa rovnaký tokenID, kombinovaný počet požiadaviek môže prekročiť limit.

> [!WARNING]
> SolaX Cloud API vyžaduje aktívne internetové pripojenie a závisí od dostupnosti serverov SolaX Cloud. Počas výpadkov cloudu alebo prerušenia internetu šablóna nebude prijímať aktualizované dáta. Pre inštalácie vyžadujúce garantované lokálne riadenie zvážte namiesto toho [šablónu Modbus RTU](https://taphome.com/sk/compatibility/solax-hybrid-x3-gen-4/).

## Dostupné zariadenia 11

Tieto zariadenia sa po importe zobrazia v TapHome.

SolaX Inverter Modul

Servisné atribúty

|                |                                                                                                                                                                |
|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Stav invertora | Aktuálny prevádzkový režim — Wait, Check, Normal, Fault, Permanent Fault, Update, EPS Check, EPS, Self-Test, Idle, Standby, Pv Wake Up Bat, Gen Check, Gen Run |
| Typ invertora  | Pripojený model invertora — identifikuje nainštalovanú sériu SolaX (X1, X3, A1, J1) a generáciu                                                                |

Vlastné premenné

|                    |                                                                           |
|--------------------|---------------------------------------------------------------------------|
| `tokenID` (string) | Token ID SolaX Cloud API (získajte na stránke API vášho účtu SolaX Cloud) |
| `sn` (string)      | Sériové číslo komunikačného modulu SolaX (Registration No.)               |

Čítanie (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
```

Servisné atribúty

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 výstup Elektromer Len na čítanie

Celková a denná produkcia AC energie (kWh) s aktuálnym výstupným výkonom (kW)

numeric Jednotka: kWh / kW JSON parsejson()

Servisné atribúty

|                                     |                                                |
|-------------------------------------|------------------------------------------------|
| Inverter.AC.energy.out.daily \[kWh] | Denný výnos AC energie — resetuje sa o polnoci |

Čítanie celkovej spotreby

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

Čítanie odberu

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

Servisné atribúty

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

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

SOC batérie Analógový vstup Len na čítanie

Stav nabitia batérie v percentách — 0 % (prázdna) až 100 % (plná)

numeric Jednotka: % JSON parsejson()

Čítanie vstupnej úrovne

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

Výkon batérie Premenná Len na čítanie

Okamžitý výkon batérie vo wattoch — kladný pri nabíjaní, záporný pri vybíjaní

numeric Jednotka: W JSON parsejson()

Čítanie

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

Odber zo siete Elektromer Len na čítanie

Energia spotrebovaná zo siete — celková spotreba (kWh) a aktuálny výkon odberu (kW)

numeric Jednotka: kWh / kW JSON parsejson()

Čítanie celkovej spotreby

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

Čítanie odberu

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

Výkon siete Premenná Len na čítanie

Obojsmerný výkon siete vo wattoch — kladný pri exporte, záporný pri odbere

numeric Jednotka: W JSON parsejson()

Čítanie

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

FV výroba (celková) Premenná Len na čítanie

Kombinovaný DC výkon zo všetkých MPPT vstupov — automaticky sčíta dostupné stringy

numeric Jednotka: W JSON parsejson()

Čítanie

```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 výroba (MPPT 1) Premenná Len na čítanie

numeric Jednotka: W JSON parsejson()

Čítanie

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

FV výroba (MPPT 2) Premenná Len na čítanie

numeric Jednotka: W JSON parsejson()

Čítanie

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

FV výroba (MPPT 3) Premenná Len na čítanie

numeric Jednotka: W JSON parsejson()

Čítanie (modul)

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

FV výroba (MPPT 4) Premenná Len na čítanie

numeric Jednotka: W JSON parsejson()

Čítanie (modul)

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

Dodávka do siete Elektromer Len na čítanie

Energia exportovaná do siete — celková energia dodaná do siete (kWh) a aktuálny výkon dodávky (kW)

numeric Jednotka: kWh / kW JSON parsejson()

Čítanie celkovej spotreby

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

Čítanie odberu

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

**Pripojenie:** Packet Parser → HTTP

Možné vylepšenia (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

## Parametre importu

Tieto hodnoty zadáte pri importe XML.

| Pýta sa v aplikácii                     | Predvolené         |
|-----------------------------------------|--------------------|
| Token ID                                | Zadáte pri importe |
| Registration No. (communication module) | Zadáte pri importe |

## Zdroje

- 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

Dokumenty výrobcov sú © ich príslušných vlastníkov. Poskytujeme ich tak, ako ich zverejnil výrobca, len na informačné účely.

## Súvisiaca dokumentácia

- [Integrácia Packet Parser](https://taphome.com/sk/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/)
- [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/)
- [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/)