# Wie nutze ich die envelio-App? Source: https://help.epilot.cloud/de/integrationen-api/wie-nutze-ich-die-envelio-app Last updated: 2026-10-26 *** Mit der **envelio-App** prüfst du Anmeldungen von Erzeugungs- und Verbrauchsanlagen direkt aus epilot heraus in der **envelio Intelligent Grid Platform (IGP)**. Die App übergibt die angemeldeten Anlagen als Anschlussanfrage an envelio, envelio berechnet die Netzverträglichkeit, und das Ergebnis landet automatisch wieder an der Opportunity in epilot. So musst du keine Anlagendaten mehr von Hand in envelio übertragen und siehst das Ergebnis der Netzverträglichkeitsprüfung dort, wo du die Anmeldung ohnehin bearbeitest. Dieser Artikel zeigt dir, wie du die App einrichtest, im Workflow nutzt und das Ergebnis liest. **Voraussetzung** Du brauchst einen Zugang zur envelio IGP. Für die Verbindung benötigst du den Namen eures envelio-Clusters (z. B. `meinnetz` aus `https://meinnetz.envelio.de`), einen API-Token sowie die Cloudflare-Access-Zugangsdaten (Client ID und Client Secret). Diese Daten erhältst du von deiner Ansprechperson bei envelio. Empfohlen ist außerdem der Blueprint [Anmeldung von Erzeugungs- und Verbrauchsanlagen](https://marketplace.epilot.cloud/blueprints/anmeldung-von-erzeugungs). Die App ist auf dessen Felder abgestimmt und funktioniert damit ohne weitere Zuordnung. ## App installieren und mit envelio verbinden [#app-installieren-und-mit-envelio-verbinden] 1. Navigiere zu **Konfiguration → Integration → Apps** und installiere im Tab **Marketplace** die App **envelio**. 2. Öffne die App unter **Installierte Apps** und trage im Bereich **Komponenten** die Zugangsdaten ein: **envelio Cluster**, **envelio API Token**, **Cloudflare Access Client ID** und **Cloudflare Access Client Secret**. 3. Speichere die Konfiguration. Die Zugangsdaten hinterlegst du nur einmal zentral. Sie sind weder in Workflows noch im Browser sichtbar. Konfiguration Nach der Installation stehen dir folgende Komponenten zur Verfügung: | Komponente | Wofür du sie brauchst | | ----------------------------------- | -------------------------------------------------------------------------------------------------------- | | **envelio Netzanschlussprüfung** | Aktion, die die Anschlussanfrage in envelio anlegt und die Prüfung startet. | | **envelio Variante reservieren** | Aktion, die die Netzkapazität für eine bestandene Variante reserviert, wenn du ohne FastTrack arbeitest. | | **envelio Reservierung stornieren** | Aktion, die reservierte Netzkapazität wieder freigibt, z. B. wenn eine Anmeldung zurückgezogen wird. | | **envelio Status** | Bereich an der Opportunity mit Status, Terminen, Reservierung und allen berechneten Varianten. | | **envelio Status-Synchronisierung** | Läuft automatisch alle 30 Minuten und holt den aktuellen Stand offener Anfragen aus envelio. | ## Netzanschlussprüfung im Workflow einbauen [#netzanschlussprüfung-im-workflow-einbauen] 1. Öffne den Workflow, mit dem du Anmeldungen von Erzeugungs- und Verbrauchsanlagen bearbeitest. 2. Füge eine automatisierte Aufgabe an der Stelle hinzu, an der die Anmeldung vollständig ist und die technischen Daten geprüft sind. 3. Wähle als Aktion **envelio Netzanschlussprüfung** und lege die Einstellungen fest (siehe Tabelle). 4. Speichere den Workflow. | Einstellung | Bedeutung | | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Anfragetyp** | **Verbindlich** für eine echte Anschlussanfrage, **Unverbindlich** für eine Vorabprüfung. | | **FastTrack** | Standardmäßig aktiv. envelio prüft die Anfrage automatisch und reserviert direkt eine bestandene Variante. Ohne FastTrack wird nur die Anfrage angelegt, die Reservierung erfolgt später in envelio oder über die Aktion **envelio Variante reservieren**. | | **Testlauf** | Prüft nur, ob alle nötigen Daten vorhanden und gültig sind. In envelio wird nichts angelegt und nichts reserviert. | | **Attribut-Zuordnung** | Nur nötig, wenn deine Felder anders heißen als im Blueprint. Du kannst für jeden Wert, z. B. die Leistung der Wärmepumpe, ein anderes Feld auswählen. Mit dem Blueprint musst du hier nichts ändern. | **Tipp** Starte mit aktiviertem **Testlauf** an einer Beispiel-Anmeldung. So siehst du, ob alle Daten passen, bevor die erste echte Anfrage bei envelio landet. ## Welche Anlagen an envelio übergeben werden [#welche-anlagen-an-envelio-übergeben-werden] Die App liest die angemeldeten Anlagen aus der Opportunity und übergibt sie gemeinsam als **eine** Anschlussanfrage an envelio. Jede Anlage wird mit ihrer Leistung als eigener Netzteilnehmer geprüft. | Angemeldete Anlage | So wird sie in envelio geprüft | Verwendete Leistung | | ---------------------------------------------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------ | | **Erzeugungsanlage PV** | Photovoltaikanlage | Gesamtleistung der Wechselrichter | | **Erzeugungsanlage Wind** | Windkraftanlage | Wirk- bzw. Scheinleistung des Generators | | **Erzeugungsanlage KWK, Biomasse, Wasserkraft, Sonstige** | KWK-Anlage | Wirk- bzw. Scheinleistung des Generators | | **Speicher** | Batteriespeicher | Entladeleistung, Ladeleistung und nutzbare Speicherkapazität | | **Wärmepumpe** | Wärmepumpe | Netzbezugsleistung inkl. Heizstab | | **Ladeeinrichtung** | Ladepunkt, getrennt nach privater und öffentlicher Nutzung | Gesamt-Netzentnahmeleistung | | **Raumkühlung, elektrische Wärmeerzeuger, sonstige Verbraucher** | Allgemeine Last | Elektrische Gesamtleistungsaufnahme | Der **Standort** der Anlage kommt aus der Adresse der Opportunity, bevorzugt aus der Lieferadresse. Als **Dossiernummer** in envelio wird die Nummer der Opportunity verwendet. So findest du die Anfrage in envelio schnell wieder. ## Ergebnis an der Opportunity [#ergebnis-an-der-opportunity] envelio braucht für die Netzberechnung meist einen Moment. Die App fragt deshalb alle 30 Minuten automatisch den aktuellen Stand aller offenen Anfragen ab und aktualisiert die Opportunity. Du musst dafür nichts tun. ### Bereich envelio Status [#bereich-envelio-status] An der Opportunity siehst du im Bereich **envelio Status**: * **Anschlussanfrage:** Status, Dossiernummer, Anfragetyp, Netzgebiet und Adresse * **Reservierung:** gewählte Variante, Ablaufdatum der Reservierung und ob ein Netzausbau erforderlich ist * **Termine:** Eingangsdatum, Fälligkeitsdatum, Zeitpunkt der Reservierung bzw. Stornierung und der letzten Synchronisierung * **Varianten:** alle von envelio berechneten Anschlussvarianten mit CR-Prüfung, N-1-Prüfung, Anschlussart, CAPEX, Aufnahmekapazität, Leitungslänge und Grenzwertverletzungen. Die gewählte Variante ist markiert. Solange noch keine Anfrage angelegt wurde, ist der Bereich leer. ### Ergebnis der Netzverträglichkeitsprüfung [#ergebnis-der-netzverträglichkeitsprüfung] Zusätzlich füllt die App zwei Felder aus der Blueprint-Gruppe **Daten der Netzverträglichkeitsprüfung**: | Feld | Inhalt | | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Benötigte Anschlussleistung in kW** | Summe der Leistungen aller übergebenen Anlagen. Wird beim Anlegen der Anfrage gesetzt. | | **Ergebnis der Netzverträglichkeitsprüfung** | „Netzverträglichkeitsprüfung erfolgreich“, sobald eine Variante reserviert ist. „Netzverträglichkeitsprüfung nicht uneingeschränkt positiv“, wenn die Berechnung abgeschlossen ist, aber keine Variante bestanden hat. | Diese Felder kannst du wie gewohnt weiterverwenden, zum Beispiel als Bedingung für eine Verzweigung im Workflow oder als Variable in E-Mail- und Dokumentvorlagen. ## Mit oder ohne FastTrack arbeiten [#mit-oder-ohne-fasttrack-arbeiten] | Modus | So läuft es ab | | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Mit FastTrack** (Standard) | envelio prüft automatisch und reserviert die erste bestandene Variante selbst. Du musst nichts weiter tun. | | **Ohne FastTrack** | envelio legt nur die Anfrage an und berechnet die Varianten. Du entscheidest selbst, wann reserviert wird: direkt in envelio oder über eine automatisierte Aufgabe mit **envelio Variante reservieren**. Diese Aktion reserviert die erste Variante, die die CR-Prüfung bestanden hat. | ## Reservierung stornieren [#reservierung-stornieren] Zieht ein Antragsteller seine Anmeldung zurück oder wird der Vorgang abgebrochen, gibst du mit der Aktion **envelio Reservierung stornieren** die reservierte Netzkapazität wieder frei. Die Anfrage selbst bleibt in envelio erhalten und kann bei Bedarf erneut reserviert werden. **Tipp** Baue diese Aktion in den Abbruch-Zweig deines Workflows ein. So bleibt keine Netzkapazität unnötig blockiert. ## Häufige Fragen [#häufige-fragen] **Warum wurde die Aktion übersprungen?** Die Aktion wird übersprungen, wenn an der Opportunity keine Anlage angemeldet ist, zum Beispiel weil der Workflow an einer Opportunity aus einem anderen Teil der Anmeldung lief. Sie wird auch übersprungen, wenn für diese Opportunity bereits eine Anfrage in envelio existiert. So entstehen keine doppelten Anfragen. **Warum ist die Aktion fehlgeschlagen?** Häufig fehlt die Leistung einer angemeldeten Anlage. Die Fehlermeldung nennt dir das fehlende Feld. Ergänze es und starte die Aufgabe erneut. Ohne Adresse an der Opportunity legt die App ebenfalls keine Anfrage an. Prüfe außerdem, ob die envelio-Zugangsdaten in der App noch gültig sind. Den zuletzt aufgetretenen Fehler siehst du auch im Bereich **envelio Status**. **Warum ist der Status an der Opportunity noch nicht aktuell?** Die Synchronisierung läuft alle 30 Minuten. Änderungen aus envelio können also bis zu einer halben Stunde brauchen, bis sie an der Opportunity sichtbar sind. **Unsere Felder heißen anders als im Blueprint. Funktioniert die App trotzdem?** Ja. In der Aktion **envelio Netzanschlussprüfung** wählst du unter **Attribut-Zuordnung** für jeden Wert ein eigenes Feld aus. Alles, was du nicht überschreibst, nutzt weiterhin die Blueprint-Felder. **Ändert die App etwas an unserem Netzmodell in envelio?** Nein. Die App legt nur Anschlussanfragen an, reserviert bzw. storniert Varianten und liest den Status zurück. Netzmodell und Stammdaten in envelio bleiben unverändert. **Wieso zeigt die Opportunity keinen envelio Status an?** Füge im Entity-Builder die Envelio Capability hinzu. Diese erstellt eine Gruppe mit der von envelio bereitgestellten Daten. ## Verwandte Artikel [#verwandte-artikel] * [Wie installiere ich Apps in epilot?](https://help.epilot.cloud/de/integrationen-api/wie-installiere-ich-apps-in-epilot) * Workflow starten und Aufgaben bearbeiten * Was ist ein Workflow? Überblick und Voraussetzungen