---
title: "Shelly 3EM Gen3"
description: "Shelly 3EM Gen3 contatore di energia trifase con Wi-Fi. Monitora potenza, tensione, corrente ed energia su tutte e tre le fasi via HTTP da TapHome."
url: "https://taphome.com/it/compatibility/shelly-3em-gen3/"
language: it
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["http","electric-meter","3-phase","wifi","energy-metering","mdns"]
  questions: ["Come integrare lo Shelly 3EM Gen3 con TapHome?","Cosa misura il template Shelly 3EM Gen3 in TapHome?","Come collegare lo Shelly 3EM Gen3 via HTTP a TapHome?","TapHome può monitorare le singole fasi con lo Shelly 3EM Gen3?","Come usare il nome host mDNS per lo Shelly 3EM Gen3 in TapHome?","Perché lo Shelly 3EM Gen3 mostra l'errore ct_type_not_set?"]
---

# Shelly 3EM Gen3

Comunicazione: Packet Parser → HTTP

- [Pagina prodotto Shelly 3EM Gen3](https://www.shelly.com/en/products/shop/shelly-3em-gen3)

> Indirizzo di rete
> 
> TapHome raggiunge il dispositivo all'indirizzo inserito durante l'importazione. Assegna al dispositivo un indirizzo fisso — una prenotazione IP nel router, oppure il suo nome mDNS se lo supporta —, altrimenti l'integrazione smette di funzionare quando il router cambia l'indirizzo.
> 
> [Preparazione della rete](https://taphome.com/it/docs/setup/network-preparation/)

## Guida all'integrazione

Lo Shelly 3EM Gen3 è un contatore di energia trifase su guida DIN con trasformatori di corrente integrati (fino a 63 A per fase). Si connette alla rete locale tramite Wi-Fi e fornisce misurazioni in tempo reale attraverso l'API HTTP RPC Gen2+/Gen3. TapHome interroga il dispositivo via HTTP sulla porta 80 — non è necessaria alcuna connessione cloud.

Il template fornisce quattro dispositivi contatore di energia: un contatore totale combinato e tre contatori per le singole fasi (A, B, C). Ogni contatore mostra la potenza attiva istantanea e il consumo energetico cumulativo, mentre i contatori delle singole fasi forniscono anche tensione, corrente, fattore di potenza e frequenza di rete come attributi di servizio.

## Collegamento hardware

Lo Shelly 3EM Gen3 è disponibile in due varianti — 3EM-63W (modello a cavo) e 3EM-63T (modello a morsetti piatti). Entrambi si montano sopra o sotto gli interruttori automatici su guida DIN.

Il dispositivo richiede un collegamento Y (stella) a 4 fili:

- **LA, LB, LC** — tre ingressi di fase, uno per fase
- **N** — neutro
- L'alimentazione è prelevata tra la fase LA e il neutro (220-240 V~ 50/60 Hz)

La protezione esterna dovrebbe essere dimensionata a 63 A con caratteristica B o C e potere di interruzione di 6 kA.

> [!WARNING]
> La tensione operativa massima sicura è 280 V per fase. L'intervallo di corrente è 0-63 A con saturazione a 130 A. Il superamento di questi limiti può danneggiare il dispositivo.

## Configurazione

Lo Shelly 3EM Gen3 si connette tramite Wi-Fi. Durante l'importazione del template in TapHome, inserisci l'indirizzo IP del dispositivo (segnaposto predefinito `192.168.0.1`).

### Autenticazione

TapHome non supporta l'HTTP Digest Authentication. Assicurati che l'autenticazione sia **disabilitata** sul dispositivo Shelly prima di aggiungerlo a TapHome. Questa impostazione si configura nell'interfaccia web Shelly in Settings → Authentication.

### Selezione del profilo

Lo Shelly 3EM Gen3 supporta due profili — **Triphase** (predefinito) e **Monophase**. Il template TapHome è progettato per il profilo Triphase, che espone un singolo componente EM (`em:0`) con letture per fase e totali. Assicurati che il dispositivo sia impostato sul profilo Triphase (impostazione di fabbrica).

### Modalità ECO

Se la modalità ECO è abilitata sul dispositivo Shelly, può causare timeout di comunicazione a causa dell'intervallo di polling di 3 secondi del modulo TapHome. Disabilita la modalità ECO per un funzionamento affidabile.

## Funzionalità del dispositivo

### Misurazione energetica totale

Il dispositivo Contatore energia totale fornisce una vista combinata di tutte e tre le fasi:

- **Potenza attiva** — `total_act_power` da `EM.GetStatus`, convertita da W a kW (diviso per 1000)
- **Energia cumulativa** — `total_act` da `EMData.GetStatus`, convertita da Wh a kWh (diviso per 1000)
- **Corrente elettrica** (attributo di servizio) — somma della corrente su tutte e tre le fasi

### Misurazione energetica per fase

Tre contatori individuali per fase (Fase A, Fase B, Fase C) forniscono misurazioni dettagliate per ogni fase. Ogni contatore di fase mostra:

- **Potenza attiva** — potenza istantanea in kW (convertita da W)
- **Energia cumulativa** — consumo energetico totale in kWh (convertito da Wh)

Ogni contatore di fase espone anche quattro attributi di servizio:

- **Corrente elettrica** — corrente di fase in A
- **Tensione elettrica** — tensione di fase in V
- **Fattore di potenza** — rapporto adimensionale tra potenza attiva e apparente
- **Frequenza di rete** — frequenza di rete in Hz

I contatori per fase utilizzano un intervallo di polling di 15 secondi (rispetto ai 3 secondi del modulo), sufficiente per il monitoraggio energetico.

### Diagnostica del modulo

Il template espone quattro attributi di servizio a livello di modulo:

- **Wifi** — SSID della rete Wi-Fi connessa
- **Indirizzo IP** — indirizzo IP del dispositivo sulla rete locale
- **Potenza del segnale** — Wi-Fi RSSI in dBm
- **MAC** — indirizzo MAC del dispositivo

Sono disponibili due azioni di servizio:

- **Aggiornamento FW** — avvia un aggiornamento firmware all'ultima versione stabile
- **Riavvio** — avvia un riavvio del dispositivo

Lo script di lettura del modulo verifica anche la disponibilità di aggiornamenti firmware e le richieste di riavvio in sospeso, mostrando avvisi in TapHome quando viene rilevata una di queste condizioni.

### Funzionalità aggiuntive

Lo Shelly 3EM Gen3 espone anche la potenza apparente per fase e totale, la corrente del neutro e i contatori di energia restituita (immessa in rete) per fase e totale. Il rilevamento degli errori di sequenza delle fasi e l'archiviazione dei dati storici con risoluzione di 1 minuto sono disponibili nativamente. Queste funzionalità potranno essere aggiunte in un futuro aggiornamento del template.

## Risoluzione dei problemi

### Il dispositivo non risponde

1. Verifica che lo Shelly sia connesso al Wi-Fi e abbia un indirizzo IP valido
2. Prova a usare il nome host mDNS (`Shelly3EM63G3-XXXXXXXXXXXX.local`) invece dell'indirizzo IP — l'IP potrebbe essere cambiato dopo un rinnovo DHCP
3. Apri `http://{device-ip}/rpc/Shelly.GetDeviceInfo` nel browser — se risponde con JSON, il dispositivo è raggiungibile
4. Controlla che TapHome Core e Shelly siano sulla stessa rete / VLAN

### Errore ct_type_not_set

Se il componente EM segnala un errore `ct_type_not_set`, il tipo di trasformatore di corrente non è stato configurato. Imposta il tipo CT tramite l'interfaccia web Shelly o chiamando `EM.SetConfig` con il valore `ct_type` appropriato. Usa `EM.GetCTTypes` per elencare i tipi supportati.

### Errore sequenza fasi

Se l'errore `phase_sequence` appare in `EM.GetStatus`, le fasi sono collegate in ordine inverso (A-C-B invece di A-B-C). Ricollega le fasi nell'ordine corretto oppure disabilita `monitor_phase_sequence` nella configurazione EM per sopprimere l'errore se l'ordine inverso è intenzionale.

> [!NOTE]
> I dispositivi Shelly Gen2+/Gen3 supportano fino a **6 connessioni HTTP simultanee**. Questo è più dei dispositivi Gen1 (2 connessioni), ma tieni presente che ogni sistema di polling (TapHome, Home Assistant, ecc.) consuma connessioni. Evita di eseguire troppe integrazioni contemporaneamente sullo stesso dispositivo.

## Come installare in TapHome

### Prerequisiti

- Dispositivo Shelly installato e acceso
- Rete Wi-Fi locale (2,4 GHz)
- TapHome CCU sulla stessa rete

### Passaggio 1 — Collegare Shelly al Wi-Fi

**Opzione A — App Shelly (consigliata):**

1. Scarica l'[app Shelly](https://www.shelly.com/en/support/shelly-app) (iOS / Android)
2. Tocca **+** → **Add Device** e segui la procedura guidata di associazione Bluetooth
3. Inserisci le credenziali Wi-Fi quando richiesto

**Opzione B — Modalità AP (senza app):**

1. Al primo avvio il dispositivo crea un hotspot: `ShellyXXX-AABBCCDDEE`
2. Collega il tuo telefono/PC a questo hotspot
3. Apri `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client**
4. Inserisci SSID e password → **Save**

> [!NOTE]
> Shelly supporta solo reti a **2,4 GHz**. Le reti a 5 GHz non appariranno nella scansione.

### Passaggio 2 — Trovare l'indirizzo IP

Dopo la connessione al Wi-Fi, trova l'indirizzo IP assegnato tramite uno di questi metodi:

- **App Shelly:** Dettaglio dispositivo → **Device info** → Indirizzo IP
- **Interfaccia web Shelly:** Connettiti all'AP del dispositivo prima della configurazione Wi-Fi — l'IP viene mostrato dopo il salvataggio
- **Tabella DHCP del router:** Cerca un hostname come `shelly1pm-AABBCCDDEE`
- **mDNS:** Esegui il ping di `shelly<model>-<mac>.local` (es. `shelly1pm-AABBCCDDEE.local`) dalla stessa rete

> [!TIP]
> Assegna un **IP statico** (prenotazione DHCP) nel tuo router per il dispositivo Shelly per evitare che l'indirizzo cambi dopo un riavvio del router.

### Passaggio 3 — Configurazione in TapHome

1. In TapHome, aggiungi un nuovo modulo **Packet Parser (HTTP)**
2. **IP Address:** inserisci l'IP dal passaggio 2 (es. `192.168.1.50`)
3. **Port:** `80` (predefinito, nessuna modifica necessaria)
4. Importa il template — TapHome interrogherà periodicamente `/status` per leggere lo stato del dispositivo

> [!NOTE]
> L'autenticazione HTTP è disabilitata per impostazione predefinita sui dispositivi Shelly. Se hai abilitato la protezione con accesso, TapHome attualmente non supporta HTTP Basic Auth — mantieni l'autenticazione disabilitata per l'integrazione con TapHome.

## Dispositivi disponibili 4

Questi dispositivi compaiono in TapHome dopo l'importazione.

Shelly 3EM Gen3 Modulo

Attributi di servizio

|                     |
|---------------------|
| Wifi                |
| Indirizzo IP        |
| Potenza del segnale |
| MAC                 |

Azioni di servizio

|                  |                                                             |
|------------------|-------------------------------------------------------------|
| Aggiornamento FW | Avvia un aggiornamento firmware all'ultima versione stabile |
| Riavvio          |                                                             |

Variabili personalizzate

Lettura (modulo)

```taphome
VAR response := SENDHTTPREQUEST("/rpc/Sys.GetStatus");
IF response.IsSuccess
    Sys.GetStatus := response.Content;
END

response := SENDHTTPREQUEST("/rpc/Sys.GetConfig");
IF response.IsSuccess
    Sys.GetConfig := response.Content;
END

response := SENDHTTPREQUEST("/rpc/WiFi.GetStatus");
IF response.IsSuccess
    WiFi.GetStatus := response.Content;
END

response := SENDHTTPREQUEST("/rpc/EM.GetStatus?id=0");
IF response.IsSuccess
    EM.GetStatus := response.Content;
END

response := SENDHTTPREQUEST("/rpc/EMData.GetStatus?id=0");
IF response.IsSuccess
    EMData.GetStatus := response.Content;
END

if ! ISNULL(parsejson(Sys.GetStatus, "available_updates.stable", true))
    addwarning("New firmware update is available");
end

if parsejson(Sys.GetStatus, "restart_required", true)
    addwarning("Restart required");
end
```

Attributi di servizio

Wifi

```taphome
PARSEJSON(WiFi.GetStatus, "ssid")
```

${ipAddress}

```taphome
PARSEJSON(WiFi.GetStatus, "sta_ip")
```

${xml\_signal\_strength} \[dB]

```taphome
PARSEJSON(WiFi.GetStatus, "rssi")
```

MAC

```taphome
PARSEJSON(Sys.GetStatus, "mac")
```

Azioni di servizio

${xml\_update\_fw}

```taphome
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Update?stage=\"stable\"");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END

```

Reboot

```taphome
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Reboot");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END
```

Contatore energia totale Contatore elettrico Solo lettura

Potenza attiva trifase combinata (kW) e consumo energetico cumulativo totale (kWh)

numeric Unità: kW / kWh json\_path

Attributi di servizio

|                    |                                             |
|--------------------|---------------------------------------------|
| Corrente elettrica | Somma della corrente su tutte e tre le fasi |

Variabile: `EM.GetStatus`

Lettura consumo totale

```taphome
return(parsejson(EMData.GetStatus,"total_act")/1000);
```

Lettura domanda

```taphome
return(parsejson(EM.GetStatus,"total_act_power")/1000);
```

Attributi di servizio

${electric\_current} \[A]

```taphome
return(parsejson(EM.GetStatus,"total_current"));
```

Contatore energia fase A Contatore elettrico Solo lettura

Potenza attiva fase A (kW), energia cumulativa (kWh), tensione, corrente, fattore di potenza e frequenza

numeric Unità: kW / kWh json\_path

Attributi di servizio

|                    |
|--------------------|
| Corrente elettrica |
| Tensione elettrica |
| Fattore di potenza |
| Frequenza di rete  |

Lettura consumo totale

```taphome
return(parsejson(EMData.GetStatus,"a_total_act_energy")/1000);
```

Lettura domanda

```taphome
return(parsejson(EM.GetStatus,"a_act_power")/1000);
```

Attributi di servizio

${electric\_current} \[A]

```taphome
return(parsejson(EM.GetStatus,"a_current"));
```

${electric\_voltage} \[V]

```taphome
return(parsejson(EM.GetStatus,"a_voltage"));
```

${power\_factor}

```taphome
return(parsejson(EM.GetStatus,"a_pf"));
```

${grid\_frequency} \[Hz]

```taphome
return(parsejson(EM.GetStatus,"a_freq"));
```

Contatore energia fase B Contatore elettrico Solo lettura

Potenza attiva fase B (kW), energia cumulativa (kWh), tensione, corrente, fattore di potenza e frequenza

numeric Unità: kW / kWh json\_path

Attributi di servizio

|                    |
|--------------------|
| Corrente elettrica |
| Tensione elettrica |
| Fattore di potenza |
| Frequenza di rete  |

Lettura consumo totale

```taphome
return(parsejson(EMData.GetStatus,"b_total_act_energy")/1000);
```

Lettura domanda

```taphome
return(parsejson(EM.GetStatus,"b_act_power")/1000);
```

Attributi di servizio

${electric\_current} \[A]

```taphome
return(parsejson(EM.GetStatus,"b_current"));
```

${electric\_voltage} \[V]

```taphome
return(parsejson(EM.GetStatus,"b_voltage"));
```

${power\_factor}

```taphome
return(parsejson(EM.GetStatus,"b_pf"));
```

${grid\_frequency} \[Hz]

```taphome
return(parsejson(EM.GetStatus,"b_freq"));
```

Contatore energia fase C Contatore elettrico Solo lettura

Potenza attiva fase C (kW), energia cumulativa (kWh), tensione, corrente, fattore di potenza e frequenza

numeric Unità: kW / kWh json\_path

Attributi di servizio

|                    |
|--------------------|
| Corrente elettrica |
| Tensione elettrica |
| Fattore di potenza |
| Frequenza di rete  |

Lettura consumo totale

```taphome
return(parsejson(EMData.GetStatus,"c_total_act_energy")/1000);
```

Lettura domanda

```taphome
return(parsejson(EM.GetStatus,"c_act_power")/1000);
```

Attributi di servizio

${electric\_current} \[A]

```taphome
return(parsejson(EM.GetStatus,"c_current"));
```

${electric\_voltage} \[V]

```taphome
return(parsejson(EM.GetStatus,"c_voltage"));
```

${power\_factor}

```taphome
return(parsejson(EM.GetStatus,"c_pf"));
```

${grid\_frequency} \[Hz]

```taphome
return(parsejson(EM.GetStatus,"c_freq"));
```

**Connessione:** Packet Parser → HTTP • Hostname: `Shelly3EM63G3-{MAC}.local`

Possibili miglioramenti (8)

- Phase A Apparent Power — Apparent power in VA, available per phase — could complement active power
- Total Apparent Power — Sum of apparent power on all phases \[VA]
- Neutral Current — Current on neutral conductor \[A]
- Total Returned Energy — Total active returned energy \[Wh] — relevant for solar/grid feed-in
- Phase A Returned Energy — Per-phase returned energy \[Wh] — same available for B and C
- Uptime — Seconds since last reboot, available in Sys.GetStatus
- Free RAM — Available RAM in bytes
- Phase Sequence Monitoring — Enable/disable phase sequence error detection via EM.SetConfig

## Parametri di importazione

Inserisci questi valori quando importi l'XML.

| Richiesto nell'app | Predefinito   |
|--------------------|---------------|
| Indirizzo IP       | `192.168.0.1` |

## Fonti

- Shelly Gen2+ RPC API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-03-27
- Shelly Gen2+ Sys Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Sys/) 2026-03-27
- Shelly Gen2+ WiFi Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/WiFi/) 2026-03-27
- Home Assistant Shelly Integration (Gen2+)
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-27
- Shelly 3EM-63 Gen3 Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-3em-63-gen3) 2026-03-27
- Shelly Gen2+ EM Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/EM/) 2026-03-27
- Shelly Gen2+ EMData Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/EMData/) 2026-03-27

## Documentazione correlata

- [Integrazione Packet Parser](https://taphome.com/it/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/it/docs/integration/packet-parser/)
- [Funzioni Packet parser](https://taphome.com/it/docs/script/packet-parser/)
- [Funzioni di parsing](https://taphome.com/it/docs/script/parsing-functions/)