Která Shelly to umí
Skripty mají zařízení Shelly Gen2 a novější: řada Plus (Plus Plug S, Plus 1, Plus 1PM, Plus 2PM), řada Pro (Pro 1, Pro 1PM, Pro 2, Pro 2PM, Pro 4PM) a zařízení Gen3 a Gen4 (třeba Plug S Gen3, 1PM Gen3).
- Jak poznat generaci: ve webovém rozhraní zařízení je vlevo položka
Scripts. Když tam není, jde o starší generaci. Generace je uvedená i v aplikaci Shelly v informacích o zařízení a na štítku (Plus, Pro, Gen3, Gen4 = skripty ano). - Shelly Gen1 (Shelly 1, 1PM, 2.5, Plug S první generace) skripty nemá. Připojte ho přes Home Assistant, Node-RED nebo Loxone, které ITexSpot přečtou a relé sepnou samy.
- Zařízení potřebuje Wi-Fi s internetem, nastavený čas (NTP, v Shelly výchozí) a časové pásmo
Europe/Prague. Podle místního času jede záložní okno a okno nabíjení; skript na jiné pásmo upozorní v konzoli.
Skripty ke stažení
Vyberte variantu podle toho, co chcete řídit. Každý skript má nahoře blok KONFIGURACE, kde se vyplní klíč a parametry; zbytek se nemění.
| Skript | K čemu | Úroveň klíče | Dotazů denně |
|---|---|---|---|
| bojler.js | Bojler a ohřev: nejlevnější hodiny dne | plná verze (beta zdarma) | 24 |
| nabijeni.js | Nabíjení a spotřebič do termínu | plná verze (beta zdarma) | 13 |
| odlehceni.js | Odlehčení: vypnout v nejdražších hodinách | plná verze (beta zdarma) | 24 |
| pretoky.js | Omezení přetoků při záporném výkupu | plná verze (beta zdarma) | 24 |
| levno-ted.js | Nejjednodušší: levno teď | i Zdarma | 96 |
Rozvrh (schedule.json) a omezení přetoků (export.json) patří k plné verzi API; v betě jsou zdarma. Klíč úrovně Zdarma dostane u těchto skriptů chybu 403 a skript to vypíše do konzole. Rozdíl úrovní je v tabulce úrovní přístupu. S klíčem Zdarma funguje skript levno-ted.js.
Postup krok za krokem
- Otevřete webové rozhraní Shelly: do prohlížeče napište IP adresu zařízení ve vaší síti.
- V nastavení zkontrolujte časové pásmo Europe/Prague a že zařízení ukazuje správný čas.
- V levém menu zvolte Scripts a klikněte na Create script.
- Pojmenujte skript (třeba ITexSpot bojler) a vložte do editoru celý obsah staženého souboru.
- V bloku KONFIGURACE nahoře doplňte svůj klíč a případně upravte parametry.
- Klikněte na Save a potom na Start. Pod editorem se v konzoli objeví první hlášky.
- Zapněte Run on startup, aby se skript spustil sám i po výpadku proudu.
V konzoli pak uvidíte třeba ITexSpot: rozvrh načten na 48 h. a při každé změně ITexSpot: relé ZAP (levná hodina). Skript nic nezapisuje do plánů zařízení (Schedules): rozvrh drží ve své paměti (KVS) a relé přepíná sám, jednou za minutu se podívá, jaká je hodina.
Klíč v adrese a jeho bezpečnost
Skript se ptá na adresu s klíčem v cestě, například:
https://api.itexservices.cz/v1/k/its_VASKLIC/schedule.json?hodin=4&tvar=shelly- Klíč je jen ke čtení: přečte ceny, nic nezmění a k účtu se s ním nikdo nepřihlásí. Když unikne, v účtu ho zrušíte a vytvoříte nový.
- Klíč je uložený v kódu skriptu v zařízení. Kdo má přístup do webového rozhraní Shelly, uvidí ho. Rozhraní proto chraňte heslem (v nastavení zařízení) a skript s klíčem nikam nesdílejte.
- Parametr
tvar=shellyzkrátí odpověď na necelých 100 bajtů: skript má v Shelly jen kolem 7 kB paměti a běžná odpověď API by se do ní nevešla. Rozvrh přijde jako řetězec nul a jedniček, jedna číslice za každou hodinu (1= vybraná hodina), popis polí je v referenci API. - Skripty se ptají jednou za hodinu (
levno-ted.jsá 15 minut). Limit na klíč je 60 dotazů za hodinu a 300 až 500 denně podle úrovně, takže se vejde i několik skriptů naráz. Častější dotazy nic nepřinesou, data se mění několikrát denně.
Bojler a ohřev: nejlevnější hodiny dne
Relé sepne v N nejlevnějších hodinách každého dne, volitelně navíc vždy, když cena klesne pod zadaný práh. Rozvrh na 48 hodin si skript uloží do paměti zařízení, takže bojler hřeje podle cen i bez internetu a po restartu.
Stáhnout: bojler.js · ptá se na schedule.json?hodin=4&tvar=shelly · plná verze (beta zdarma)
| Parametr | Výchozí | Význam |
|---|---|---|
KLIC | "its_VASKLIC" | váš klíč ITexSpot API |
HODIN | 4 | kolik nejlevnějších hodin denně (1–24) |
POD | null | navíc každá hodina pod touto cenou v Kč/kWh (např. 1.5); null = nepoužít |
RELE | 0 | číslo relé: 0 = první, u Pro 2PM / 4PM 0–3 |
ZALOZNI_OD | 1 | záložní okno bez dat: od (místní hodina) |
ZALOZNI_DO | 4 | záložní okno bez dat: do |
OBNOVA_MIN | 60 | jak často se ptát API (minuty) |
MAX_STARI_H | 36 | starší data se berou jako výpadek (hodiny) |
Bez internetu nebo bez platných dat: Spíná dál podle uloženého rozvrhu (až 36 h). Potom záložní okno (výchozí 1:00–4:00).
Nejlevnější hodiny se vybírají z celého dne, i z hodin, které už proběhly. Když skript spustíte odpoledne, bojler tedy nedohřívá „za zbytek dne“, ale počká na levné hodiny dalšího dne. Stejně se chová odlehceni.js.
Nabíjení a spotřebič do termínu
Každý večer vybere nejlevnější hodiny tak, aby spotřebič dostal zadané kWh do rána: auto, baterie přes stykač, myčka. Jakmile nabíjení začne, výběr se do termínu nemění.
Stáhnout: nabijeni.js · ptá se na schedule.json?kwh=20&kw=3.7&ucinnost=0.9&do_h=7&tvar=shelly · plná verze (beta zdarma)
| Parametr | Výchozí | Význam |
|---|---|---|
KLIC | "its_VASKLIC" | váš klíč ITexSpot API |
KWH | 20 | kolik energie dodat za noc (kWh) |
KW | 3.7 | výkon nabíjení (kW) |
UCINNOST | 0.9 | účinnost nabíjení (0,5–1) |
OD_HODINA | 18 | plánovat od (místní hodina, spotřebič už je připojený) |
DO_HODINA | 7 | hotovo do (místní hodina ráno) |
RELE | 0 | číslo relé: 0 = první, u Pro 2PM / 4PM 0–3 |
ZALOZNI_OD | 1 | záložní okno bez dat: od |
ZALOZNI_DO | 6 | záložní okno bez dat: do |
OBNOVA_MIN | 60 | jak často se ptát, dokud nabíjení nezačne (minuty) |
MAX_STARI_H | 24 | starší uložený výběr se nepoužije (hodiny) |
Bez internetu nebo bez platných dat: Spíná podle výběru uloženého v zařízení. Když výběr chybí, záložní okno této noci (výchozí 1:00–6:00).
Termín se do adresy doplňuje sám jako místní hodina (do_h=7). Wallbox spínejte jen přes vstup, který k tomu výrobce určil (povolení nabíjení), ne přerušováním proudu pod zátěží. Větší výkon vždy přes stykač.
Odlehčení: vypnout v nejdražších hodinách
Opak bojleru: relé je normálně zapnuté a v N nejdražších hodinách dne se vypne. Pro spotřebiče, které chvíli počkají: akumulační topení, filtrace bazénu, sušička.
Stáhnout: odlehceni.js · ptá se na schedule.json?hodin=3&smer=drahe&tvar=shelly · plná verze (beta zdarma)
| Parametr | Výchozí | Význam |
|---|---|---|
KLIC | "its_VASKLIC" | váš klíč ITexSpot API |
HODIN | 3 | kolik nejdražších hodin denně vypnout (1–24) |
RELE | 0 | číslo relé: 0 = první, u Pro 2PM / 4PM 0–3 |
OBNOVA_MIN | 60 | jak často se ptát API (minuty) |
MAX_STARI_H | 36 | starší data se berou jako výpadek (hodiny) |
Bez internetu nebo bez platných dat: Relé zůstane zapnuté (běžný provoz), nic se nevypíná.
Omezení přetoků při záporném výkupu
V hodinách, kdy je výkupní cena (spot − poplatek výkupce) pod prahem, dá relé signál „omezit“: na digitální vstup střídače, nebo zapne spotřebič, který přebytek spotřebuje doma. Ve výchozím nastavení jen podle vyhlášených cen.
Stáhnout: pretoky.js · ptá se na export.json?poplatek=0.3&prah=0&tvar=shelly · plná verze (beta zdarma)
| Parametr | Výchozí | Význam |
|---|---|---|
KLIC | "its_VASKLIC" | váš klíč ITexSpot API |
POPLATEK | 0.3 | poplatek výkupce v Kč/kWh; null = podle tarifu u klíče |
PRAH | 0 | omezit, když je výkupní cena pod tímto prahem (Kč/kWh) |
RELE | 0 | číslo relé: 0 = první, u Pro 2PM / 4PM 0–3 |
OMEZIT_ZAP | true | true = při omezení relé sepne; false = obráceně |
JEN_VYHLASENE | true | true = jen podle vyhlášených cen; false = i podle předpovědi |
OBNOVA_MIN | 60 | jak často se ptát API (minuty) |
MAX_STARI_H | 30 | starší data se berou jako výpadek (hodiny) |
Bez internetu nebo bez platných dat: Spíná dál podle uložených vyhlášených cen. Bez nich nechá relé v poloze „neomezovat“.
Bezpečnost na prvním místě
- Zapojení do střídače (digitální vstup, řízení výkonu) smí udělat jen elektrikář podle návodu výrobce střídače. Shelly nikdy nespíná silový obvod fotovoltaiky.
- Výpadek API ani internetu nesmí nic ohrozit: bez platných dat skript nechá relé v poloze „neomezovat“.
- V aplikaci Shelly nastavte stav relé po zapnutí napájení na vypnuto, ať po výpadku proudu nic neomezuje.
- Ve výchozím nastavení se omezuje jen podle vyhlášených cen, ne podle předpovědi.
Nejjednodušší: levno teď
Každých 15 minut se zeptá, jestli je teď levno, a podle toho sepne nebo vypne relé. Dobré na vyzkoušení. Funguje i s klíčem Zdarma.
Stáhnout: levno-ted.js · ptá se na ted.json?tvar=shelly · funguje i s klíčem Zdarma
| Parametr | Výchozí | Význam |
|---|---|---|
KLIC | "its_VASKLIC" | váš klíč ITexSpot API |
PODLE | "levno" | "levno" = levná nebo záporná hodina; "n" = mezi N nejlevnějšími hodinami dne |
N | 4 | pro PODLE = "n": kolik nejlevnějších hodin (1–24) |
RELE | 0 | číslo relé: 0 = první, u Pro 2PM / 4PM 0–3 |
ZALOZNI_OD | 1 | záložní okno bez dat: od |
ZALOZNI_DO | 4 | záložní okno bez dat: do |
INTERVAL_MIN | 15 | jak často se ptát (minuty) |
VYPADEK_MIN | 60 | po kolika minutách bez dat přepnout na záložní okno |
Bez internetu nebo bez platných dat: Podle cen bez internetu nespíná. Po hodině bez odpovědi jede záložní okno (výchozí 1:00–4:00).
Tenhle skript si rozvrh dopředu neukládá, takže bez internetu podle cen nespíná. Na vyzkoušení je ideální, pro bojler, který má hřát spolehlivě, použijte bojler.js.
Co se děje při výpadku internetu nebo API
- Skripty s rozvrhem (bojler, nabíjení, odlehčení, přetoky) si rozvrh na 48 hodin uloží do paměti zařízení (KVS). Relé spíná podle něj i bez internetu, dokud stažená data platí.
- Když data zestárnou (bojler a odlehčení po 36 hodinách, přetoky po 30) nebo API odpoví chybou, skript přejde do bezpečného stavu: bojler na záložní okno, odlehčení na „relé zapnuté“, přetoky na „neomezovat“.
- Stav dat hlídá pole
s: cokoli jiného než0(například stará data, kdy se nová nepočítají déle než 30 hodin) skript nevezme a jede dál podle dosavadního rozvrhu. - Po chybě sítě se skript zeptá znovu za 15 minut, po chybě 429 nebo 503 podle hlavičky Retry-After.
- Po restartu zařízení skript načte rozvrh z KVS a spíná podle něj hned, i když internet ještě není. Je proto důležité zapnout Run on startup.
Bezpečné chování při výpadku API
API může chvíli neodpovídat, odpovědět chybou nebo vrátit stará data. Řízení u vás doma s tím musí počítat — postavte ho tak, aby výpadek nic nerozbil:
- Relé zůstane v posledním bezpečném stavu. Bez platných dat nic nezapínejte kvůli „levné hodině“. Vraťte zařízení do chování, které by měl i dům bez ITexSpotu (bojler podle časového programu, střídač bez omezení přetoků, baterie v běžném režimu).
- Záložní okno. Pro spotřebiče, které běžet musí (bojler, nabíjení), mějte pevné okno v obvykle levných hodinách, například 1–5 h. Když data platná nejsou, jede se podle něj.
- Poznejte, že data neplatí. Vždy kontrolujte stav dat. V JSON je to
stav(ok,stara_data,limit,neplatny_klic,nedostupne), v textu pro Loxonestav_kod: 0 = v pořádku, 1 = stará data, 401 klíč, 429 limit, 503 výpadek. Dálestari_min: data se mění třikrát denně, takže přes noc je běžně stará až kolem 16 hodin. Hodnota nad 1 800 minut (30 h) znamená, že se nové nepočítají. - Výpadek spojení se nemusí projevit v hodnotách. Loxone i další systémy při nedostupném serveru drží poslední přečtenou hodnotu.
stari_minale s každým úspěšným dotazem roste. Když se přestane měnit, dotazy neprocházejí. - Při chybě 429 nebo 503 počkejte, kolik říká hlavička
Retry-After, a neopakujte dotaz hned.
Bezpečnost: bojler, legionela a výkon relé
- Termostat a pojistky bojleru zůstávají zapojené. Skript jen pouští proud v levných hodinách, teplotu hlídá termostat bojleru.
- Legionela. Voda v bojleru se má pravidelně ohřát aspoň na 60 °C. Když bojler hřeje jen pár hodin denně, nastavte termostat dost vysoko a zvolte dost hodin, nebo jednou týdně nechte delší ohřev.
- Výkon relé. Zkontrolujte v návodu Shelly, jaký proud relé snese. Bojler, přímotop nebo nabíjení auta spínejte přes stykač; zásuvku Plus Plug S použijte jen pro spotřebiče, které se do ní vejdou.
- Nevypínejte nic, co vypnout nesmí: oběhové čerpadlo kotle, lednici, mrazák, čerpadlo v jímce.
- Instalaci do rozvaděče svěřte elektrikáři.
Řešení problémů
| Hláška v konzoli | Co to znamená a co dělat |
|---|---|
-104 | API neodpovědělo včas. Obvykle slabá Wi-Fi nebo výpadek internetu; skript to zkusí znovu za 15 minut. |
-108 | Odpověď je pro Shelly moc velká. Zkontrolujte, že adresa končí tvar=shelly (v našich skriptech je). |
-114 | Jiná chyba spojení: DNS, certifikát, nedostupný server, někdy i chybová odpověď API. Ověřte, že zařízení má internet a správný čas (bez času neprojde HTTPS). |
401 | Neplatný nebo zrušený klíč. Zkontrolujte KLIC v KONFIGURACI (its_ a 40 znaků). |
403 | Funkce patří k plné verzi a klíč má úroveň Zdarma. Použijte levno-ted.js, nebo klíč s plnou verzí. |
422 | Špatný parametr v KONFIGURACI. Hláška řekne, který. |
429 | Překročený limit dotazů. Běží víc skriptů nebo zařízení se stejným klíčem? Skript počká, kolik API řekne. |
| data nejsou čerstvá | API vrací stará data. Skript jede bezpečně (záložní okno), nic dělat nemusíte; když to trvá přes den, dejte nám vědět. |
| pásmo zařízení není Europe/Prague | Nastavte v Shelly časové pásmo Europe/Prague, jinak by záložní okno a okno nabíjení spínaly o hodinu vedle. |
| hodiny zařízení jdou pozadu | Zařízení má špatný čas. Zkontrolujte připojení k internetu a NTP v nastavení Shelly. |
out_of_memory | Skriptu došla paměť. Nespouštějte víc než dva skripty ITexSpot na jednom zařízení a nepoužívejte starší verze skriptů (před 19. 11. 2026); stáhněte aktuální. |
Skripty mají kolem 6 kB a za běhu si vezmou nejvýš kolem 5 kB z přibližně 7 kB paměti, kterou Shelly skriptu dá (změřeno na Plug S Gen3).
Vypnutí a odinstalace
Skript zastavte tlačítkem Stop, vypněte Run on startup a skript smažte. Do plánů zařízení (Schedules) nic nezapisuje, takže tam není co uklízet. Pokud jste používali verzi z 18. 11. 2026, která plány zapisovala, smažte v záložce Schedules plány, které vytvořila.