callRaw method
Wie call, liefert aber die Antwort selbst statt der gelesenen Huelle:
fuer Aufrufe, die eine Datei oder eine Huelle senden
(getDepExportFile). Gleiche Anmeldung, gleiche Pruefungen vor dem
Senden, gleiche Pruefung des Kopfs (HTTP 200, Kennzeichen v3, keine
HTML-Seite; siehe v3Post); den Rumpf liest der Aufrufer. Eine
Fehlerhuelle mit HTTP 200 wirft hier nicht.
Implementation
Future<http.Response> callRaw(
String name, {
Map<String, dynamic> params = const {},
Duration? timeout,
}) async {
// Beides frisch — siehe Klassenkommentar.
final token = await idToken();
final sitzung = await sessionId();
if (token == null || token.isEmpty) {
throw KasseneckValidationError(name, 'idToken lieferte kein Token', 'request');
}
if (sitzung == null || sitzung.isEmpty) {
throw KasseneckValidationError(name, 'sessionId lieferte keine Sitzung', 'request');
}
final nutzlast = <String, dynamic>{'cashregisterId': cashregisterId};
params.forEach((schluessel, wert) {
if (wert != null) nutzlast[schluessel] = wert;
});
// Ausserhalb des Sendens: ein nicht serialisierbarer Parameter ist ein
// Programmierfehler und keine Netzstoerung. Sonst haette ihn der
// Sammelfang als `network` gemeldet — ein Fehler, der nie am Netz lag,
// saehe aus wie einer, nach dem ein Beleg entstanden sein koennte.
final String rumpf = jsonEncode({'params': nutzlast});
// Zeitlimit getrennt vom Netzfehler: die Anfrage war draussen, ueber
// `createReceipt` kann der Beleg laengst signiert sein. Nur der Typ der
// Ursache, nie die Meldung: die kann eine Adresse tragen.
return v3Post(
_http,
functionName: name,
basis: baseUrl,
name: name,
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer $token',
'register-session': sitzung,
},
kasseneck: _kopf,
body: rumpf,
timeout: timeout ?? _timeout,
);
}