====== kassensichv.types ======

→ [[lyx_-_programmiersprache:units:kassensichv|Zurück zur KassenSichV-Übersicht]]

Zentrale Typdefinitionen der KassenSichV-Bibliothek. Diese Unit enthält ausschließlich Structs, Konstanten und Hilfsfunktionen für Speicherverwaltung — keine TSE-Kommunikationslogik.

===== Import =====

<code lyx>
import kassensichv.types;
</code>

===== Typen =====

==== BelegDaten ====

Eingangsdaten eines Kassenbons für die TSE-Signierung.

<code lyx>
pub type BelegDaten = struct {
    transId:      int64;   // pchar — wird von TseOpenBeleg/TseProcessBeleg gesetzt
    prozessTyp:   int64;   // pchar — z.B. PROZESSTYP_KASSENBELEG
    prozessDaten: int64;   // pchar — DSFinV-K-konformer Payload
    kassenNr:     int64;   // pchar — Geräte-ID laut DSFinV-K
    umsatz:       int64;   // Eurocent (Ganzzahl, keine Fließkomma-Rundungsfehler)
    startZeit:    int64;   // Unix-Zeitstempel (UTC) — von TSE gesetzt
    endZeit:      int64;   // Unix-Zeitstempel (UTC) — von TSE gesetzt
}
</code>

^ Feld ^ Typ ^ Beschreibung ^
| ''transId'' | ''int64'' (pchar) | Interne Vorgangs-ID — wird von ''TseOpenBeleg'' / ''TseProcessBeleg'' befüllt |
| ''prozessTyp'' | ''int64'' (pchar) | BSI-Prozesstyp — Konstante aus dieser Unit verwenden |
| ''prozessDaten'' | ''int64'' (pchar) | Strukturierter Payload im DSFinV-K-Format |
| ''kassenNr'' | ''int64'' (pchar) | Geräteseriennummer der Kasse laut DSFinV-K |
| ''umsatz'' | ''int64'' | Kumulierter Bruttoumsatz in **Eurocent** (kein Double — Rundungsfehler!) |
| ''startZeit'' | ''int64'' | Unix-Zeitstempel UTC — wird von der TSE gesetzt |
| ''endZeit'' | ''int64'' | Unix-Zeitstempel UTC — wird von der TSE gesetzt |

**Hinweis zu ''umsatz'':** Der Betrag ''2,50 EUR'' wird als ''250'' gespeichert (Eurocent). Das entspricht dem Verhalten von DSFinV-K, das BCD-Arithmetik ohne Fließkomma vorschreibt.

==== SigErgebnis ====

Steuerliche Pflichtangaben für den Bondruck nach KassenSichV / BSI TR-03153. Alle 7 Pflichtfelder laut TR-03153 Anhang A.

<code lyx>
pub type SigErgebnis = struct {
    tseSerial:   int64;   // pchar — Seriennummer der zertifizierten TSE (Pflichtfeld)
    sigZaehler:  int64;   // fortlaufender TSE-Vorgangszähler (Pflichtfeld)
    anzahlTrans: int64;   // Gesamtzähler aller Transaktionen dieser TSE
    sigWert:     int64;   // pchar — ECDSA/SHA-256, Base64-kodiert (Pflichtfeld)
    qrCode:      int64;   // pchar — BSI TR-03153 Anhang A QR-Code-String (Pflichtfeld)
    startZeit:   int64;   // Unix-Zeitstempel UTC laut TSE (Pflichtfeld)
    endZeit:     int64;   // Unix-Zeitstempel UTC laut TSE (Pflichtfeld)
    success:     int64;   // 1 = signiert, 0 = Fehler
    errorMsg:    int64;   // pchar — Fehlermeldung (leer bei success=1)
}
</code>

^ Feld ^ Typ ^ Pflichtfeld auf Bon ^
| ''tseSerial'' | ''int64'' (pchar) | ja |
| ''sigZaehler'' | ''int64'' | ja |
| ''sigWert'' | ''int64'' (pchar) | ja — Base64-ECDSA/SHA-256 |
| ''qrCode'' | ''int64'' (pchar) | ja — vorformatiert, BSI TR-03153 Anhang A |
| ''startZeit'' | ''int64'' | ja — UTC |
| ''endZeit'' | ''int64'' | ja — UTC |
| ''anzahlTrans'' | ''int64'' | im QR-Code enthalten |
| ''success'' | ''int64'' | nein — intern für Fehlerprüfung |
| ''errorMsg'' | ''int64'' (pchar) | nein — nur bei ''success=0'' relevant |

Alle ''pchar''-Felder in ''SigErgebnis'' sind allokiert. Nach der Verwendung ''SigErgebnisFree()'' aufrufen.

===== Konstanten =====

==== Prozesstypen (BSI TR-03153) ====

<code lyx>
pub const PROZESSTYP_KASSENBELEG: pchar = "Kassenbeleg-V1";
pub const PROZESSTYP_STORNO:      pchar = "Kassenbeleg-V1-Storno";
pub const PROZESSTYP_TRAINING:    pchar = "Training";
pub const PROZESSTYP_BESTELLUNG:  pchar = "Bestellung-V1";
</code>

^ Konstante ^ Bedeutung ^
| ''PROZESSTYP_KASSENBELEG'' | Normaler Kassenbon (Verkauf, Einnahme) |
| ''PROZESSTYP_STORNO'' | Stornierter Vorgang — eigener Bon mit negativem Betrag |
| ''PROZESSTYP_TRAINING'' | Trainingsbetrieb — kein Steuerbezug, kein Finanzamt-Export |
| ''PROZESSTYP_BESTELLUNG'' | Bestellvorgang ohne sofortige Zahlung (z.B. Restaurant) |

==== Sonstige Konstanten ====

<code lyx>
pub const TSE_QR_PREFIX:       pchar = "V0";
pub const DSFINVK_VERSION:     pchar = "2.3";
pub const TSE_DEFAULT_TIMEOUT: int64 = 5000;     // ms
pub const KASSENSICHV_VERSION: pchar = "1.0.0";
</code>

===== Speicherverwaltung =====

<code lyx>
// Gibt alle allokierten Strings in SigErgebnis frei
pub fn SigErgebnisFree(sig: int64): void;

// Gibt alle allokierten Strings in BelegDaten frei (nur wenn selbst allokiert)
pub fn BelegDatenFree(beleg: int64): void;
</code>

**Faustregel:** ''BelegDaten''-Felder zeigen in der Regel auf String-Literale im Programmcode und müssen nicht freigegeben werden. ''SigErgebnis'' kommt von der TSE — immer ''SigErgebnisFree()'' aufrufen.

===== DSFinV-K-Datenformat =====

Das Feld ''prozessDaten'' folgt dem DSFinV-K 2.3-Schema. Für einfache Kassenbons ist das Format:

<code>
{Artikel};{Betrag_normal}_{Betrag_ermäßigt}_{Betrag_Null}_{Betrag_besonders}_{Sonstiges}
</code>

Beispiele:
<code lyx>
// Kaffee 2,50 EUR (normaler Steuersatz 19%)
beleg.prozessDaten := "Kaffee;2.50_0.00_0.00_0.00_0.00"c;

// Buch 15,00 EUR (ermäßigter Steuersatz 7%)
beleg.prozessDaten := "Buch;0.00_15.00_0.00_0.00_0.00"c;

// Mehrere Artikel
beleg.prozessDaten := "Kaffee+Wasser;2.50_0.00_0.00_0.00_0.00;Leitungswasser;0.00_0.00_0.50_0.00_0.00"c;
</code>

Für komplexe DSFinV-K-Anforderungen (Mehrwertsteuerausweise, Bonpflicht-Details) gilt die offizielle DSFinV-K 2.3-Spezifikation des BMF.

-----

Letzte Aktualisierung: 2026-06-12