Entwurf
Diese Seite ist noch nicht freigegeben und nicht am Bildschirm geprüft. Bezeichnungen und Abläufe können noch abweichen.
Technische Voraussetzungen¶
Was ein Betrieb für SOPHA NG bereitstellt. Was SOPHA NG ist, steht im Überblick; die Einrichtung selbst beschreibt die Installation (nicht in der Online-Fassung).
Was der Betrieb bereitstellt¶
- einen Server mit Windows, der durchgehend läuft, mit fester IP-Adresse oder DHCP-Reservierung,
- ein lokales Netz und einen Namen für den Server im lokalen DNS,
- Arbeitsplätze mit aktuellem Browser,
- Drucker mit Treiber, an der Kasse einen Bondrucker für 80 mm,
- eine Swissbit USB-TSE und eine freie USB-Buchse am Server,
- eine Datensicherung und deren Kopie außer Haus,
- dringend empfohlen: Zeitabgleich per NTP und eine unterbrechungsfreie Stromversorgung (USV) für den Server,
- für die E-Rechnung (in Vorbereitung) Java auf dem Server,
- wahlweise einen Internetzugang (Kurse, KI, E-Mail, Fernwartung) und Handys oder Tablets für Warenfotos.
Server¶
Betriebssystem: Windows 11 oder Windows Server 2022 oder neuer, 64 Bit. Ein Server unter Linux ist in Version 1.2.0 nicht lieferbar. Das Betriebssystem muss vom Hersteller noch gepflegt werden (Sicherheitsupdates); das verlangt auch der Hersteller der TSE.
Betrieb: Der Server läuft durchgehend. Die SOPHA-Dienste starten mit Windows, ohne dass sich jemand anmeldet. Die Uhr des Servers muss stimmen; nach ihr stellt SOPHA NG auch die Zeit der TSE. Dringend empfohlen sind deshalb ein Zeitabgleich per NTP und eine unterbrechungsfreie Stromversorgung (USV), damit ein Stromausfall Datenbank und TSE nicht mitten in einem Vorgang trifft.
Leistung: Die Mindestwerte für Prozessor, Arbeitsspeicher und Platte werden bei der Generalprobe mit dem Release-Build gemessen und dann hier genannt. Den Platzbedarf bestimmen vor allem die Fotos zu Pfändern und Artikeln, die Protokolle und die Sicherungen.
Software auf dem Server:
| Software | Fassung | Hinweis |
|---|---|---|
| PostgreSQL | 18 oder neuer | Datenbank; eine Datenbank je Installation. Die Kommandozeilen-Werkzeuge müssen auf dem SOPHA-Server im Systempfad liegen, auch wenn die Datenbank auf einem anderen Rechner läuft; Sicherung und Rücksicherung nehmen sie aus derselben Installation |
| Python | 3.14, 64 Bit | für das Installationsprogramm und die Prüfungen; die nötigen Pakete liegen dem Lieferpaket bei. Python 3.12 oder neuer geht nur mit Internet bei der Installation |
| Microsoft Visual C++ Redistributable | x64, 2015–2022 | für die TSE und die Datenbankanbindung; kommt mit PostgreSQL, wenn es auf demselben Server installiert wird |
| Java | 11 oder neuer, 64 Bit | für die E-Rechnung (Zusammenführen und Prüfen; die E-Rechnung ist in Vorbereitung); eine lizenzfreie Ausgabe, z. B. Eclipse Temurin. Stellt der Betrieb bereit, das Installationsprogramm prüft sie |
| mitgeliefert | — | Proxy (Caddy), Maildienst, SOPHADruckagent mit SumatraPDF, Werkzeug für die E-Rechnung (Mustang) |
Für die Installation braucht der Techniker Administratorrechte am Server. Bei der Übernahme aus dem bisherigen SOPHA braucht er während der Installation Lesezugriff auf dessen Datenbank (Microsoft SQL Server).
Datenbank auf eigenem Rechner: Üblich ist alles auf einem Server. PostgreSQL kann auch auf einem eigenen Rechner im privaten Netz laufen, auch unter Linux. Der Datenbank-Port (Vorgabe 54018) ist dann nur für den SOPHA-Server offen.
Netz, Name und Ports¶
Adresse des Servers: eine feste IP-Adresse oder eine DHCP-Reservierung im Router. Der Name zeigt auf diese Adresse.
Name des Servers: sopha.<ihre-domain>, ohne eigene Domain <betrieb>.internal. Der Name muss im lokalen Netz
aufgelöst werden: im DNS des Routers oder des Active Directory, an einzelnen PCs notfalls über die hosts-Datei. Handys und
Tablets kennen keine hosts-Datei; für sie braucht es den Eintrag im Router- oder AD-DNS. Nicht jeder Router kann frei
gewählte Namen vergeben. Kein Name auf .local. Der Name ist eine Dauerentscheidung: Browserdaten und die Bindung der
Arbeitsplätze hängen an ihm.
Filialen an anderen Standorten: Beide Wege sind Standard. Entweder steht der Server im Haus, und die Filialen erreichen ihn über ein VPN oder eine Standleitung. Oder der Server läuft in einem Rechenzentrum bzw. in der Cloud.
| Port | Richtung | Zweck |
|---|---|---|
| 443/TCP | Netz → Server | HTTPS: Oberfläche, Schnittstelle, Live-Aktualisierung (WebSocket) |
| 80/TCP | Netz → Server | Umleitung auf HTTPS und Abruf des Stammzertifikats |
| 6080–6099/TCP | nur auf dem Server | SOPHA-Dienste; die Firewall sperrt sie nach außen |
| 54018/TCP (Vorgabe) | nur auf dem Server bzw. Server → Datenbankrechner | PostgreSQL |
| 443/TCP ausgehend | Server → preise.sopha.online |
SOPHA-Kursdienst (Vorgabe der Kursdienst-Adresse) |
| 443/TCP ausgehend | Server → Internet | KI, Zertifikat über Ihre Domain, Microsoft 365 (alles wahlweise) |
| 587/TCP (STARTTLS) oder 465/TCP (TLS), ausgehend | Server → Ihr Mailserver | E-Mail-Versand |
| noch offen | ausgehend → Fernwartungsserver von SOPHA | Fernwartung mit SOPHA-Support.exe; Adresse und Ports werden noch genannt |
Die Regeln der Windows-Firewall setzt das Installationsprogramm. UDP 443 (HTTP/3) bleibt zu.
HTTPS im lokalen Netz¶
SOPHA NG läuft auch im Laden nur über HTTPS. Kamera im Browser, Fotos vom Handy und die Bindung der Arbeitsplätze gehen nur so, und Kennwörter laufen nie im Klartext durchs Netz. Ein Zertifikat gilt für einen Namen, nicht für eine IP-Adresse.
| Weg | Wann | Was nötig ist |
|---|---|---|
| Eigene Zertifizierungsstelle (Standard) | Server ohne direkte Internetanbindung | Der Proxy legt bei der Einrichtung eine eigene Zertifizierungsstelle an (Stammzertifikat rund 10 Jahre gültig). Ihr Stammzertifikat kommt auf jedes Gerät: Windows per Skript oder Gruppenrichtlinie, Firefox über die Unternehmenszertifikate, Android und iOS von Hand. Paket und Anleitung zum Ausdrucken liefert SOPHA. Kein Internet nötig |
| Ihre Domain mit Let's Encrypt | Internetanbindung und eine Domain bei einem DNS-Anbieter mit Schnittstelle | Zugangsschlüssel zur DNS-Schnittstelle, eng gefasst (nur diese Zone, nur TXT-Einträge). Kein öffentlicher Eintrag auf den Server nötig. Ausgehend Internet alle 60–90 Tage zur Erneuerung. An den Geräten nichts zu tun |
| Zertifikat aus Ihrer IT | Ihre IT betreibt eine eigene Zertifizierungsstelle, z. B. im Active Directory | Ein Zertifikat für den Namen des Servers samt Zwischenzertifikaten und den Schlüssel dazu, beides als PEM-Datei, der Schlüssel ohne Kennwort. Das Installationsprogramm prüft beides und bindet es ein. Den Geräten vertraut Ihre IT ihre Zertifizierungsstelle selbst an. Vor dem Ablauf liefert Ihre IT ein neues Zertifikat, der Techniker übernimmt es |
Arbeitsplätze und Browser¶
- Browser, zugesagt: Firefox ESR (unsere Empfehlung als Standard), Edge, Chrome und Safari, auch auf dem iPad. Mindestfassungen: Chrome und Edge 107, Firefox 104, Safari 16 (iOS und iPadOS 16); ältere werden nicht unterstützt.
- Browser, die funktionieren sollten: andere aktuelle Browser wie Brave, Vivaldi oder Opera. Sie werden nicht eigens geprüft.
- Betriebssystem des Arbeitsplatzes: beliebig, solange der Browser aktuell ist. Für den Druck siehe unten.
- Stammzertifikat auf jedem Gerät, wenn die eigene Zertifizierungsstelle genutzt wird.
- Kamera (wahlweise): Webcam am Arbeitsplatz oder Handy bzw. Tablet über einen QR-Code. Das Handy braucht dafür den Namen im Router- oder AD-DNS und, bei eigener Zertifizierungsstelle, das Stammzertifikat.
Drucker und SOPHADruckagent¶
Gedruckt wird nur über den SOPHADruckagent, nicht aus dem Browser.
- Ein Druckagent je Drucker. Ein Tresen mit Bon- und A4-Drucker hat zwei Druckagenten auf demselben PC.
- System: Windows, dort liegt SumatraPDF als Druckprogramm bei. Unter Linux und macOS sollte der Druckagent funktionieren; zugesagt ist Windows.
- Sitzung: Der Druckagent läuft in der Sitzung des angemeldeten Benutzers und startet unter Windows mit der Anmeldung. Gedruckt wird, solange am PC jemand angemeldet ist.
- Einrichtung durch den Techniker auf einer lokalen Seite: Server-Adresse, Drucker, Einmal-Code (30 Minuten gültig), Testdruck mit Maßlinie.
- Netz: HTTPS 443 zum Server; der PC vertraut dem Stammzertifikat.
- Drucker: jeder Drucker mit Treiber des Betriebssystems. Formate A4, A5 und Bon 80 mm, gedruckt wird 1:1 ohne Skalierung.
- Nicht in 1.2.0: Etiketten- und Sonderdrucker, Kassenlade am Bondrucker.
TSE¶
Die Anbindung der Swissbit-TSE und der Export der TSE-Daten sind in Vorbereitung. Bis dahin arbeitet eine Installation mit einem Simulator, der nicht echt signiert. Die Angaben unten gelten für den Betrieb mit der echten TSE.
- Gerät: Swissbit USB-TSE (Hardware). Sie steckt am SOPHA-Server und erscheint dort als Laufwerk.
- Server: Microsoft Visual C++ Redistributable x64 (2015–2022). Die Treiberbibliothek von Swissbit liefert SOPHA mit und installiert sie mit.
- Zugangsdaten: PIN und PUK der TSE hält der Betreiber bereit; der Techniker trägt sie bei der Inbetriebnahme einmal ein.
- Meldung: Inbetriebnahme, Tausch und Außerbetriebnahme meldet der Betreiber dem Finanzamt (§ 146a Abs. 4 AO, über ELSTER). Den Ausdruck der Angaben dafür liefert SOPHA NG (in Vorbereitung).
- Laufzeit: Das Zertifikat einer TSE ist befristet. Danach wird sie getauscht, und der Tausch ist meldepflichtig.
- Uhrzeit: SOPHA NG stellt die Zeit der TSE nach dem Server; dessen Uhr muss stimmen.
- Nicht in 1.2.0: Cloud-TSE.
Internet: wofür nötig, was ohne geht¶
| Wofür | Internet nötig? | Ohne Internet |
|---|---|---|
| Pfand, Kasse, TSE, Druck, Berichte | nein | läuft im lokalen Netz |
| Edelmetall- und Devisenkurse | ja, täglicher Abruf beim SOPHA-Kursdienst (nachts, https://preise.sopha.online) |
Ein bereits geholter Kurs gilt bis zu 7 Tage weiter (Einstellung). Kurswerte lassen sich von Hand setzen |
| KI-Hilfe | ja, zum KI-Anbieter (heute Anthropic, Modelle „Claude“) | KI-Funktionen stehen nicht bereit, alles andere läuft |
| ja, außer der Mailserver steht im eigenen Netz | kein Versand; die Mails warten in der Warteschlange, alles andere läuft | |
| Fernwartung durch SOPHA | ja, zum Fernwartungsserver von SOPHA | keine Fernwartung, alles andere läuft |
| Zertifikat über Ihre Domain | ja, alle 60–90 Tage | rund 30 Tage Reserve bis zum Ablauf; bei eigener Zertifizierungsstelle nie nötig |
| Namensauflösung im Laden | nie | — |
Für die KI-Hilfe schließt der Betrieb selbst den Vertrag mit dem KI-Anbieter, einschließlich der Vereinbarung zur Auftragsverarbeitung.
Fernwartung: SOPHA nutzt eine eigene RustDesk-Lizenz mit einem Server bei SOPHA. Das Programm „SOPHA-Support.exe“ ist ein RustDesk-Client. Adresse und Ports des Fernwartungsservers werden noch genannt.
Datensicherung¶
Was gesichert wird:
- die Datenbank; dort liegen auch die Dokumente und Bilder, außer sie werden ausdrücklich als Dateien abgelegt,
- die Schlüsseldateien der Installation. Ohne sie ist eine Sicherung der Datenbank nicht mehr nutzbar, und kein SOPHA-Dienst startet,
- die Zertifizierungsstelle des Proxys (bei eigener Zertifizierungsstelle). Ohne sie müssen nach einer Wiederherstellung alle Geräte neu eingerichtet werden,
- die Einstellungen des Maildienstes samt seinem eigenen Schlüssel,
- die Exporte der TSE,
- als Dateien abgelegte Dokumente.
Wie: SOPHA NG bringt ein Sicherungs- und ein Rücksicherungsprogramm mit. Die Sicherung legt je Lauf einen Ordner mit Datum und Uhrzeit auf dem Server an, mit Datenbank, Schlüsseldatei, Zertifizierungsstelle, Maildienst und TSE-Exporten, und behält eine einstellbare Zahl von Generationen. Sie läuft auch ohne Eingriff in der Aufgabenplanung von Windows; diese Aufgabe richtet Ihre IT ein. Als Dateien abgelegte Dokumente sind darin nicht enthalten.
Kopie außer Haus: Die Sicherung auf dem Server schützt nicht vor Brand, Diebstahl oder Verschlüsselung durch Schadsoftware. Die Kopie außer Haus ist Sache Ihrer IT. Eine Sicherung enthält Schlüssel und ist geheim; sie gehört an einen geschützten Ort.
Gilt für SOPHA NG 1.0 · Stand 2026-10-26