reportMyTerminalAddress method

Future<ReportedTerminalAddress> reportMyTerminalAddress({
  1. required String ownerUid,
  2. required String deviceId,
  3. required String deviceSecret,
  4. required String tid,
  5. required String host,
  6. required int port,
})

Meldet still, dass das Kartenterminal der Kasse unter einer neuen Adresse antwortet (nur Kassenweg /api/v3; Ausweis des Geräts wie bei listRegisterUsersForDevice, keine Sitzung einer Person nötig; Zwilling von npm 1.39.0).

Der Server schreibt genau zwei Felder (IP und Port des Terminals) und nur, wenn die TID zur Einrichtung dieses Geräts passt; jede Änderung steht im Kassen-Protokoll. Antwort: changed ist true, wenn er die Adresse geändert hat, false, wenn sie schon so gespeichert war. Wiederholen ist gefahrlos. Die Kasse zeigt dazu nichts an.

Fehlercodes: terminal_id_mismatch, invalid_terminal_address, too_many_changes (heute zu oft geändert), dazu device_not_paired. Geprüft wird hier nur die Form; die Adresse beurteilt der Server.

Implementation

Future<ReportedTerminalAddress> reportMyTerminalAddress({
  required String ownerUid,
  required String deviceId,
  required String deviceSecret,
  required String tid,
  required String host,
  required int port,
}) async {
  const name = Aufrufe.reportMyTerminalAddress;
  _ausweisPflicht(name, ownerUid, deviceId, deviceSecret);
  _pflicht(name, 'tid', tid);
  _pflicht(name, 'host', host);
  if (port < 1 || port > 65535) {
    throw const KasseneckValidationError(name, 'port muss eine ganze Zahl von 1 bis 65535 sein', 'request');
  }
  final daten = await _rufen(name, {
    'ownerUid': ownerUid,
    'deviceId': deviceId,
    'deviceSecret': deviceSecret,
    'tid': tid,
    'host': host,
    'port': port,
  });
  final geaendert = daten['changed'];
  if (geaendert is! bool) {
    throw const KasseneckValidationError(name, 'Antwort enthaelt kein changed', 'response');
  }
  return ReportedTerminalAddress(changed: geaendert);
}