Fragenkatalog für SOLVIT/Solved Meeting
Erstellt: 25.02.2026 (ProcesslyAI) | Meeting: Solve-Weekly, Montag 03.03.2026, 13:00 Uhr (mit Janin)
Zweck: Effizientes erstes Meeting — alle technischen Fragen vorab klären
Kontext: Wir bauen die STARQstrom-Middleware als zentrale Datendrehscheibe. Dafür brauchen wir eine erweiterte API-Anbindung an SOLVIT/wattform.
Hintergrund für SOLVIT
Wir (ProcesslyAI, im Auftrag von STARQstrom) entwickeln eine neue Middleware-Plattform, die als zentrale Datendrehscheibe zwischen Website, HubSpot CRM, SOLVIT und weiteren Systemen fungiert. Aktuell:
- Die Website (starqstrom.de) nutzt bereits die Wattform API (7 Endpoints, produktiv)
- Die bestehende DM-Middleware synct Daten zu HubSpot
- Ziel: Alle Datenflüsse über eine neue, zentrale Middleware leiten — mit voller Transparenz
A. Bestehende Wattform API
Wir haben die bestehende API aus dem Code der Website analysiert (Server-Analyse 25.02.2026).
A1. Bestätigung der bestehenden Endpoints
Wir sehen aktuell 7 produktive Endpoints unter wechselprozess.services/solvreg/resources:
| # | Endpoint | Status |
|---|---|---|
| 1 | GET /tarife/{plz}/{city} |
Produktiv |
| 2 | POST /auftraege |
Produktiv |
| 3 | PLZ-Validierung | Produktiv |
| 4 | Straßen-Lookup | Produktiv |
| 5 | Rabattcode-Validierung | Produktiv |
| 6 | IBAN-Validierung | Produktiv |
| 7 | Vorversorger-Suche | Produktiv |
Fragen:
- Ist diese Liste vollständig oder gibt es weitere Endpoints, die wir nicht sehen?
- Gibt es eine API-Dokumentation (OpenAPI/Swagger)?
- Gibt es eine Sandbox/Testumgebung?
- Wie ist die SLA für diese Endpoints (Verfügbarkeit, Antwortzeiten)?
A2. Auth-Modell
Aktuell authentifiziert die Website sich mit:
- Header
Mandant: starqstrom - Header
Origin: https://starqstrom.de - Header
Referer: https://starqstrom.de/
Fragen:
- Kann unsere neue Middleware sich mit den gleichen Credentials authentifizieren?
- Oder brauchen wir eigene API-Keys / OAuth-Tokens?
- Gibt es Rate-Limits?
B. Benötigte neue Endpoints
B1. Status-Rückmeldung nach Auftragsanlage (SOLVIT → Middleware)
Problem: Nach POST /auftraege bekommen wir eine auftragsnummer zurück, aber danach keine Updates mehr. Wir wissen nicht, ob der Auftrag erfolgreich verarbeitet wurde oder ob es einen Klärfall gibt.
Fragen:
- Gibt es bereits ein System für Webhooks oder Callbacks?
- Wenn nicht: Können wir einen Webhook-Empfänger definieren, der bei Statusänderungen benachrichtigt wird?
- Welche Status-Übergänge gibt es in wattform nach Auftragseingang?
- z.B.: Eingegangen → In Bearbeitung → Bestätigt → Klärfall → Belieferung aktiv?
- Gibt es einen GET-Endpoint um den Status eines Auftrags abzufragen (z.B.
GET /auftraege/{auftragsnummer})?
B2. Netzentgelte & Umlagen
Problem: Für RLM-Kunden kommuniziert STARQstrom aktuell nur den Energiepreis, ohne Netzentgelte/Umlagen. Für die Gesamtkosten-Transparenz brauchen wir diese Daten.
Fragen:
- Nutzt SOLVIT ene't als Datenquelle für Netzentgelte/Umlagen?
- Gibt es einen bestehenden Endpoint oder Export für Netzentgelte pro PLZ / Marktlokation?
- Welche Daten können geliefert werden?
- Netznutzungsentgelt (ct/kWh)?
- Messstellenbetrieb (EUR/a)?
- KWK-Umlage, §19 StromNEV, Offshore-Umlage?
- Konzessionsabgabe?
- Stromsteuer?
- Falls kein API-Endpoint: Gibt es regelmäßige Datenexporte (CSV, Excel)?
B3. B2B-Verträge (RLM)
Problem: Aktuell werden RLM-Deals manuell per Excel von HubSpot zu SOLVIT übertragen. Das soll automatisiert werden.
Fragen:
- Kann der bestehende
POST /auftraege-Endpoint für RLM-Kunden erweitert werden?- Mehrere Zähler pro Vertrag (bis 10)
- Mehrere Lieferstellen (bis 9)
- Marktlokations-IDs
- Individuelle Preiskonditionen (Fix/Flex-Modell)
- Oder ist ein separater Endpoint für B2B geplant?
- Welche Daten braucht SOLVIT minimal für eine RLM-Vertragsanlage?
B4. Vertragsstatus-Abfrage
Fragen:
- Gibt es einen Endpoint um den Status bestehender Verträge abzufragen?
- Können wir eine Liste aller aktiven Verträge für STARQstrom abrufen?
- Welche Vertragsdetails sind über API verfügbar (Laufzeit, Preise, Status)?
B5. Kundenservice-Tickets
Problem: SOLVIT übernimmt L1+L2 Kundenservice. STARQstrom hat keinen Überblick über laufende Tickets.
Fragen:
- Gibt es ein Ticket-System in wattform (.cpm)?
- Können wir Tickets über API abrufen (zumindest Status + Thema)?
- Gibt es Webhooks bei neuen/geschlossenen Tickets?
C. Datenfluss & Frequenzen
C1. Abrechnungsdaten
Fragen:
- In welcher Frequenz liefert SOLVIT Abrechnungsdaten an STARQstrom?
- Monatlich? Pro Abrechnungszyklus?
- Welches Format (CSV, XML, API)?
- Können wir diese Daten automatisiert abholen (Pull) oder werden sie geliefert (Push)?
- Welche Felder enthalten die Abrechnungsdaten?
- Verbrauch (kWh), Kosten, Netzentgelte, Umlagen?
C2. Marktkommunikation (GPKE)
Fragen:
- SOLVIT führt die EDIFACT-Marktkommunikation. Können wir den Status laufender Prozesse sehen?
- Lieferantenwechsel: Angemeldet → Bestätigt → Aktiv?
- Ein-/Auszüge?
- Kündigungen?
- Gibt es eine API oder zumindest ein Dashboard für STARQstrom?
- In welchem Rhythmus erhalten wir Statusupdates?
C3. Ist-Verbräuche
Fragen:
- Wir bekommen aktuell monatliche Ist-Verbräuche. Können wir perspektivisch 15-Minuten-Daten (RLM) bekommen?
- Welcher Aufwand wäre das auf SOLVIT-Seite?
- Über welchen Kanal (API, SFTP, E-Mail)?
D. Technische Rahmenbedingungen
D1. API-Architektur
Fragen:
- REST + JSON? Oder gibt es auch SOAP/XML-Endpoints?
- Versionierung der API (v1, v2)?
- Gibt es eine Staging-Umgebung für Tests?
- Wie sieht der Deployment-Zyklus für API-Änderungen aus?
D2. Sicherheit
Fragen:
- Welche Auth-Methode für neue Endpoints (API-Key, OAuth 2.0, mTLS)?
- IP-Whitelisting nötig?
- HTTPS mit TLS 1.2+ (vermutlich ja, aber bestätigen)?
D3. Kapazität & Performance
Fragen:
- Rate-Limits (Requests/Minute)?
- Maximale Payload-Größe bei POST?
- Erwartete Antwortzeiten?
E. Zusammenarbeit & Zeitplan
E1. Entwicklung neuer Endpoints
Fragen:
- Wie ist der typische Zeitrahmen für die Entwicklung neuer API-Endpoints bei SOLVIT?
- Wer ist der technische Ansprechpartner für API-Entwicklung?
- Gibt es ein Ticket-System oder Requirement-Prozess?
- Können wir ein gemeinsames API-Design-Dokument (OpenAPI Spec) aufsetzen?
E2. Sofort nutzbar
Fragen:
- Welche der bestehenden 7 Endpoints können wir sofort für die neue Middleware nutzen (gleiche Auth)?
- Gibt es „versteckte“ Endpoints, die bisher nicht von der Website genutzt werden, aber verfügbar sind?
E3. Zeitplan-Vorschlag
Unser Vorschlag für die Zusammenarbeit:
| Phase | Wann | Was |
|---|---|---|
| Jetzt | KW 10 | Bestehende API-Doku austauschen, Fragen klären |
| Q1 | März–April | API-Design für neue Endpoints gemeinsam definieren |
| Q1–Q2 | April–Mai | Entwicklung + Test der neuen Endpoints |
| Q2 | Juni | Produktivgang erweiterte API |
Passt dieser Zeitrahmen zu SOLVITs Kapazitäten?
F. Kontext-Dokumente (haben wir vorbereitet)
Für das Meeting haben wir folgende Dokumente bereit:
- SOLVIT API-Anforderungen v1.1 — Vollständiges Anforderungsdokument mit Datenmodell
- Server-Analyse — Analyse des bestehenden Systems inkl. Wattform API-Details
- Middleware Masterplan v1.5 — Gesamtarchitektur und Roadmap
Diese können wir vorab an Janin schicken, wenn gewünscht.