ETRON POS-Integration | BuchhaltGenie Docs

ETRON ist eine etablierte österreichische Kassenlösung mit Fokus auf Zuverlässigkeit, RKSV-Compliance und professionelle Funktionen. Die Integration mit BuchhaltGenie ermöglicht automatischen Import aller Kassendaten direkt in Ihre Buchhaltung.

Anbieter-Übersicht

Voraussetzungen

Tarif-Anforderungen

Technische Voraussetzungen

• ✅ ETRON-Kassensystem (Version 3.0 oder höher)
• ✅ API-Zugang aktiviert (in ETRON-Admin-Panel)
• ✅ Feste IP-Adresse oder DynDNS (bei On-Premise Installation)
• ✅ Port-Freigabe (für Webhooks, meist Port 443/HTTPS)

Verbindung einrichten

https://buchhaltgenie.at/api/webhooks/pos/etron/[IHR-BUSINESS-ID]

Webhook-Konfiguration

Unterstützte Events

BuchhaltGenie verarbeitet folgende ETRON-Events:

Webhook-Authentifizierung

Jeder Webhook enthält einen Signatur-Header:

X-ETRON-Signature: sha256=b9e4a1f2c3d5...
X-ETRON-Timestamp: 2026-01-30T18:00:00+01:00

BuchhaltGenie verifiziert:

1. Signatur: HMAC-SHA256 mit Webhook-Secret
2. Timestamp: Nicht älter als 5 Minuten (Replay-Schutz)
3. Payload: Zod-Validierung (SEC-006)

Beispiel-Payload (Tagesabschluss)

{
  "event": "tagesabschluss.erstellt",
  "timestamp": "2026-01-30T18:00:00+01:00",
  "filiale": {
    "id": "001",
    "name": "Hauptfiliale Wien"
  },
  "data": {
    "abschluss_id": "ET-2026-01-30-001",
    "datum": "2026-01-30",
    "kassierer": "Max Mustermann",
    "umsatz": {
      "brutto": 3256.40,
      "netto": 2751.34,
      "ust_20": 458.56,
      "ust_13": 32.50,
      "ust_10": 14.00
    },
    "zahlungen": {
      "bargeld": 1200.00,
      "karte": 1856.40,
      "gutschein": 200.00
    },
    "transaktionen_anzahl": 68,
    "rksv_signatur": "U1RBUlQtQkVMRUcxMjM0..."
  }
}

Automatische Synchronisation

Synchronisations-Frequenz

Retry-Mechanismus

Falls ein Webhook fehlschlägt:

1. Automatischer Retry (ETRON-seitig):

   • 1. Versuch: Nach 2 Minuten
   • 2. Versuch: Nach 10 Minuten
   • 3. Versuch: Nach 60 Minuten

2. BuchhaltGenie Fallback:

   • Bei fehlendem Tagesabschluss: Automatischer API-Abruf am Folgetag
   • Lücken-Erkennung: Warnung im Dashboard

Synchronisations-Status

Überwachen Sie unter Integrationen → ETRON → Status:

Kategorisierung mit EKR

Sophie’s automatische Zuordnung

Ich ordne ETRON-Verkäufe automatisch dem Einheitlichen Kontenrahmen (EKR) zu:

ETRON-Warengruppen-Mapping

Optimieren Sie die Zuordnung:

1. Einstellungen → ETRON-Integration → Warengruppen-Mapping
2. Sehen Sie alle ETRON-Warengruppen
3. Passen Sie die EKR-Zuordnung an (falls nötig)
4. ✅ Speichern – gilt ab sofort für alle neuen Importe

Beispiel:

ETRON Warengruppe 150 "Werkzeuge" → EKR 4000 "Warenverkauf"
ETRON Warengruppe 151 "Ersatzteile" → EKR 4010 "Warenverkauf Material"

Umsatzsteuer-Auswertung (UStG §11)

Automatische USt-Erfassung

ETRON berechnet die USt bereits in der Kasse. BuchhaltGenie übernimmt diese Werte:

UVA-Export

Alle Kassendaten fließen automatisch in die Umsatzsteuervoranmeldung (UVA):

• Kennzahl 000: Umsätze 20% (aus ust_20)
• Kennzahl 029: Umsätze 13% (aus ust_13)
• Kennzahl 006: Umsätze 10% (aus ust_10)
• Kennzahl 021: Steuerfreie Umsätze (aus ust_0)

Export: Berichte → UVA → XML-Download (für FinanzOnline)

Fehlerbehandlung

Häufige Fehler und Lösungen

ETRON-spezifische Probleme

Problem: RKSV-Signatur fehlt

Falls rksv_signatur im Webhook leer ist:

• ⚠️ Warnung: BuchhaltGenie importiert trotzdem, markiert aber als “RKSV-unklar”
• Ursache: ETRON-Kasse nicht RKSV-aktiviert
• Lösung: RKSV in ETRON aktivieren (Einstellungen → RKSV → Aktivieren)

Problem: Zahlungsarten-Zuordnung

ETRON unterscheidet viele Zahlungsarten. BuchhaltGenie fasst zusammen:

Falls Sie eine spezifischere Zuordnung benötigen, kontaktieren Sie den Support.

FAQ

Funktioniert die Integration mit ETRON Cloud und On-Premise?

✅ Ja, beides!

• ETRON Cloud: Sofort einsatzbereit, keine Firewall-Konfiguration
• ETRON On-Premise: Erfordert Port-Freigabe (HTTPS/443) für eingehende Webhooks

Welche ETRON-Version wird benötigt?

Mindestversion: ETRON 3.0 oder höher (Release: 2018)

Ältere Versionen haben keine REST-API. Kontaktieren Sie ETRON für ein kostenloses Update.

Werden ETRON-Filialen unterstützt?

✅ Ja! Sie können mehrere Filialen verbinden:

• Pro: 1 Filiale
• Business: 3 Filialen
• Enterprise: Unbegrenzt

Jede Filiale benötigt eine eigene Webhook-Konfiguration in ETRON.

Wie lange dauert der historische Import?

Richtwerte (abhängig von Transaktionsvolumen):

• 1 Monat: ~10 Minuten
• 6 Monate: ~45 Minuten
• 2 Jahre: ~2-3 Stunden

Der Import läuft im Hintergrund – Sie können währenddessen weiterarbeiten.

Was passiert bei einem ETRON-Server-Ausfall?

Automatisches Fallback:

1. ETRON speichert alle Daten lokal (RKSV-konform)
2. Nach Server-Wiederherstellung: Automatischer Webhook-Retry
3. BuchhaltGenie erkennt Lücken und holt fehlende Abschlüsse nach

Kein Datenverlust dank redundanter Speicherung!

Kostet die ETRON-API-Nutzung extra?

Nein! Die API ist ab dem ETRON Professional-Tarif kostenlos enthalten. BuchhaltGenie berechnet ebenfalls keine zusätzlichen Kosten (POS-Integration in Pro+ Tarifen inkludiert).

Wie sicher ist die Verbindung?

Höchste Sicherheit:

• 🔐 TLS 1.3 Verschlüsselung (HTTPS)
• 🔑 HMAC-SHA256 Webhook-Signatur (SEC-005)
• 🛡️ IP-Whitelist (optional, für On-Premise)
• 📋 Zod-Validierung aller Daten (SEC-006)
• ⏱️ Rate Limiting (SEC-003): 100 Requests/15 Min
• ✅ DSGVO Art. 32 konform

Weiterführende Links

• ETRON Website 
• ETRON API-Dokumentation 
• ETRON Support-Hotline: +43 1 234 567 89
• BuchhaltGenie Kassenbuch-Guide
• EKR-Kontenrahmen

Verwandte POS-Systeme

💡 Sophie’s Tipp: ETRON ist besonders zuverlässig und professionell. Nach der Einrichtung läuft die Integration vollautomatisch – Sie müssen sich um nichts mehr kümmern! Bei Fragen steht Ihnen sowohl ETRON- als auch BuchhaltGenie-Support zur Verfügung. 🚀