@kreiseck/kasseneck-api 1.34.0 → 1.35.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +22 -0
- package/README.md +11 -1
- package/dist/cjs/payments/hobex-hps/connect-client.d.ts +43 -1
- package/dist/cjs/payments/hobex-hps/connect-client.js +51 -1
- package/dist/cjs/payments/hobex-hps/outcome.d.ts +4 -3
- package/dist/cjs/payments/hobex-hps/payments.d.ts +85 -35
- package/dist/cjs/payments/hobex-hps/payments.js +137 -53
- package/dist/cjs/pos/drucker-katalog.d.ts +148 -0
- package/dist/cjs/pos/drucker-katalog.js +260 -0
- package/dist/cjs/pos/index.d.ts +1 -0
- package/dist/cjs/pos/index.js +8 -3
- package/dist/cjs/receipt/layout.js +1 -1
- package/dist/cjs/version.d.ts +1 -1
- package/dist/cjs/version.js +1 -1
- package/dist/esm/payments/hobex-hps/connect-client.d.ts +43 -1
- package/dist/esm/payments/hobex-hps/connect-client.js +50 -1
- package/dist/esm/payments/hobex-hps/outcome.d.ts +4 -3
- package/dist/esm/payments/hobex-hps/payments.d.ts +85 -35
- package/dist/esm/payments/hobex-hps/payments.js +138 -54
- package/dist/esm/pos/drucker-katalog.d.ts +148 -0
- package/dist/esm/pos/drucker-katalog.js +252 -0
- package/dist/esm/pos/index.d.ts +1 -0
- package/dist/esm/pos/index.js +3 -0
- package/dist/esm/receipt/layout.js +1 -1
- package/dist/esm/version.d.ts +1 -1
- package/dist/esm/version.js +1 -1
- package/fixtures/hobex-hps-cases.json +654 -0
- package/fixtures/hobex-hps-codes.json +1 -1
- package/fixtures/invoice-api.schema.json +1 -1
- package/fixtures/invoice-texts.json +1 -1
- package/fixtures/manifest.json +1 -1
- package/fixtures/pos-texts.json +1 -1
- package/fixtures/printer-catalog.json +1802 -0
- package/fixtures/receipts/card-hobex-hps.json +1 -1
- package/fixtures/surface.json +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1,260 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.PRINTER_CATALOG_PROBLEM_REASONS = exports.PRINTER_CATALOG = exports.PRINTER_CATALOG_VALUE_FIELDS = exports.PRINTER_CATALOG_QR_MODES = exports.PRINTER_CATALOG_CUTS = void 0;
|
|
4
|
+
exports.normalizePrinterModel = normalizePrinterModel;
|
|
5
|
+
exports.findPrinterCatalogEntry = findPrinterCatalogEntry;
|
|
6
|
+
exports.printerCatalogEntry = printerCatalogEntry;
|
|
7
|
+
exports.printerCatalogSettings = printerCatalogSettings;
|
|
8
|
+
exports.printerCatalogProblems = printerCatalogProblems;
|
|
9
|
+
const grid_js_1 = require("../receipt/grid.js");
|
|
10
|
+
const settings_js_1 = require("./settings.js");
|
|
11
|
+
/*
|
|
12
|
+
* Druckerkatalog der Kasse: bekannte Bondrucker mit den Druck-Einstellungen, die an ihnen im Geraetetest stimmen.
|
|
13
|
+
* Findet Kasseneck Connect ein bekanntes Modell, uebernimmt die Kasse diese Werte mit einem Klick; bei einem unbekannten
|
|
14
|
+
* Modell fragt sie nur die Papierbreite. Der Katalog liegt im Paket (nicht im Admin, nicht in Connect), damit Web-Kasse
|
|
15
|
+
* und Kassen-App offline dieselben Werte haben und jede Aenderung versioniert und getestet ausgeliefert wird.
|
|
16
|
+
*
|
|
17
|
+
* Vertrag ist fixtures/printer-catalog.json: dieselben Eintraege wie hier und die Prueffaelle, die der Dart-Zwilling
|
|
18
|
+
* (lib/src/kasse/drucker_katalog.dart) gegen dieselbe Datei rechnet. Die Daten unten prueft nur der Test
|
|
19
|
+
* (printerCatalogProblems); zur Laufzeit wird nichts still repariert oder verworfen.
|
|
20
|
+
*/
|
|
21
|
+
// ------------------------------------------------------------------ Wertemengen
|
|
22
|
+
/**
|
|
23
|
+
* Schnitt eines Eintrags: nur, was die Kasse unter „Papier abschneiden“ anbietet (Teilschnitt oder keiner). Die
|
|
24
|
+
* Einstellung kennt auch `full`, Bondrucker schneiden aber nie ganz durch; ein Katalogwert, den die Kasse nicht
|
|
25
|
+
* anzeigt, waere fuer den Chef nicht pruefbar.
|
|
26
|
+
*/
|
|
27
|
+
exports.PRINTER_CATALOG_CUTS = ['partial', 'none'];
|
|
28
|
+
/** QR-Weg eines Eintrags. `auto` heisst „noch niemand hat entschieden“ und ist darum keine Aussage ueber ein Modell. */
|
|
29
|
+
exports.PRINTER_CATALOG_QR_MODES = ['escpos', 'raster'];
|
|
30
|
+
/** Alle Wertfelder, in der Reihenfolge von [PrinterCatalogValues]; ein Test haelt sie vollstaendig. */
|
|
31
|
+
exports.PRINTER_CATALOG_VALUE_FIELDS = [
|
|
32
|
+
'paperSize', 'charsPerLine', 'cut', 'drawerKick', 'qrMode', 'codePage',
|
|
33
|
+
];
|
|
34
|
+
// ------------------------------------------------------------------ Daten
|
|
35
|
+
const eingefroren = (e) => {
|
|
36
|
+
const test = e.approval.deviceTest;
|
|
37
|
+
return Object.freeze({
|
|
38
|
+
...e,
|
|
39
|
+
matchNames: Object.freeze([...e.matchNames]),
|
|
40
|
+
paperSizes: Object.freeze([...e.paperSizes]),
|
|
41
|
+
values: Object.freeze({ ...e.values }),
|
|
42
|
+
approval: Object.freeze({
|
|
43
|
+
...e.approval,
|
|
44
|
+
deviceTest: test && Object.freeze({ ...test, checked: Object.freeze([...test.checked]), checkedPaperSizes: Object.freeze([...test.checkedPaperSizes]) }),
|
|
45
|
+
}),
|
|
46
|
+
});
|
|
47
|
+
};
|
|
48
|
+
/**
|
|
49
|
+
* Startbestand laut Spec connect-betrieb (Stufe 1), noch ohne Geraetetest und darum nicht freigegeben. Je Eintrag
|
|
50
|
+
* stehen die Werte ausgeschrieben, auch wo sie gleich sind: jeder ist eine eigene Aussage ueber ein Modell und wird
|
|
51
|
+
* einzeln freigegeben.
|
|
52
|
+
*
|
|
53
|
+
* Papierbreiten laut Epson-Datenblatt: TM-m30III, TM-m30II und TM-T20III lassen sich mit der beiliegenden
|
|
54
|
+
* Papierfuehrung auf 58 mm umstellen (dann 420 Punkte, Schrift A 35 Spalten; die Kasse setzt 32 Zeichen), der TM-m10
|
|
55
|
+
* kann nur 58 mm. Bestaetigt ist das erst mit dem Geraetetest.
|
|
56
|
+
*
|
|
57
|
+
* TM-T88VI und TM-T88VII drucken mit 180 dpi (512 Punkte auf 80 mm, Schrift A 42 Spalten); 48 Zeichen passen nicht.
|
|
58
|
+
* Sie bekommen darum das 58-mm-Layout der Kasse (32 Zeichen, die 384 Punkte von `GS W` passen in ihre 512), auch mit
|
|
59
|
+
* 80-mm-Papier, bis es eine Einstellung mit 42 Zeichen gibt.
|
|
60
|
+
*/
|
|
61
|
+
exports.PRINTER_CATALOG = Object.freeze([
|
|
62
|
+
{
|
|
63
|
+
id: 'epson-tm-m30iii', manufacturer: 'Epson', model: 'TM-m30III', matchNames: ['TM-M30III'],
|
|
64
|
+
paperSizes: ['mm58', 'mm80'], nativeCharsPerLine: 48,
|
|
65
|
+
values: { paperSize: 'mm80', charsPerLine: 48, cut: 'partial', drawerKick: true, qrMode: 'escpos', codePage: 'CP1252' },
|
|
66
|
+
approval: { approved: false, deviceTest: null },
|
|
67
|
+
},
|
|
68
|
+
{
|
|
69
|
+
id: 'epson-tm-m30ii', manufacturer: 'Epson', model: 'TM-m30II', matchNames: ['TM-M30II'],
|
|
70
|
+
paperSizes: ['mm58', 'mm80'], nativeCharsPerLine: 48,
|
|
71
|
+
values: { paperSize: 'mm80', charsPerLine: 48, cut: 'partial', drawerKick: true, qrMode: 'escpos', codePage: 'CP1252' },
|
|
72
|
+
approval: { approved: false, deviceTest: null },
|
|
73
|
+
},
|
|
74
|
+
{
|
|
75
|
+
id: 'epson-tm-t20iii', manufacturer: 'Epson', model: 'TM-T20III', matchNames: ['TM-T20III'],
|
|
76
|
+
paperSizes: ['mm58', 'mm80'], nativeCharsPerLine: 48,
|
|
77
|
+
values: { paperSize: 'mm80', charsPerLine: 48, cut: 'partial', drawerKick: true, qrMode: 'escpos', codePage: 'CP1252' },
|
|
78
|
+
approval: { approved: false, deviceTest: null },
|
|
79
|
+
},
|
|
80
|
+
{
|
|
81
|
+
id: 'epson-tm-t88vi', manufacturer: 'Epson', model: 'TM-T88VI', matchNames: ['TM-T88VI'],
|
|
82
|
+
paperSizes: ['mm58'], nativeCharsPerLine: 42,
|
|
83
|
+
values: { paperSize: 'mm58', charsPerLine: 32, cut: 'partial', drawerKick: true, qrMode: 'escpos', codePage: 'CP1252' },
|
|
84
|
+
approval: { approved: false, deviceTest: null },
|
|
85
|
+
},
|
|
86
|
+
{
|
|
87
|
+
id: 'epson-tm-t88vii', manufacturer: 'Epson', model: 'TM-T88VII', matchNames: ['TM-T88VII'],
|
|
88
|
+
paperSizes: ['mm58'], nativeCharsPerLine: 42,
|
|
89
|
+
values: { paperSize: 'mm58', charsPerLine: 32, cut: 'partial', drawerKick: true, qrMode: 'escpos', codePage: 'CP1252' },
|
|
90
|
+
approval: { approved: false, deviceTest: null },
|
|
91
|
+
},
|
|
92
|
+
{
|
|
93
|
+
id: 'epson-tm-m10', manufacturer: 'Epson', model: 'TM-m10', matchNames: ['TM-M10'],
|
|
94
|
+
paperSizes: ['mm58'], nativeCharsPerLine: 35,
|
|
95
|
+
values: { paperSize: 'mm58', charsPerLine: 32, cut: 'partial', drawerKick: true, qrMode: 'escpos', codePage: 'CP1252' },
|
|
96
|
+
approval: { approved: false, deviceTest: null },
|
|
97
|
+
},
|
|
98
|
+
].map(eingefroren));
|
|
99
|
+
// ------------------------------------------------------------------ Normierung
|
|
100
|
+
/** Trenner im normierten Namen. */
|
|
101
|
+
const TRENNER = '-';
|
|
102
|
+
/** Ein Zeichen ausserhalb von ASCII, das weder Satzzeichen noch Leerraum ist. */
|
|
103
|
+
const FREMDES_ZEICHEN = /[^\x00-\x7F\p{P}\p{Z}]/u;
|
|
104
|
+
/**
|
|
105
|
+
* Grossbuchstaben und Teile, oder `null` fuer einen Namen mit fremdem Zeichen.
|
|
106
|
+
*
|
|
107
|
+
* Gefaltet wird nur `a-z` zu `A-Z`: `toUpperCase` machte aus „ı“ ein I und aus „ff“ ein FF und damit aus einem fremden
|
|
108
|
+
* Namen womoeglich einen bekannten. Steht danach ein Zeichen ausserhalb von ASCII, das weder Satzzeichen noch
|
|
109
|
+
* Leerraum ist (Ï, é, ®), gilt der Name als unbekannt. Jede Folge anderer Zeichen als `A-Z`/`0-9` wird ein Trenner,
|
|
110
|
+
* am Rand keiner; Leerzeichen, Bindestrich, Unterstrich, Klammer und geschuetzter Bindestrich gelten dabei gleich,
|
|
111
|
+
* damit „tm m30iii“, „TM-m30III“ und „(EPSON TM-m30III)“ (IPP `product`) denselben Namen ergeben.
|
|
112
|
+
*
|
|
113
|
+
* Der Trenner bleibt als ein Zeichen stehen, statt zu verschwinden: TM-T20II-i ist ein eigenes Modell und darf nicht
|
|
114
|
+
* TM-T20III werden. Das traegt nur, wo der Name einen Trenner hat; „TM-T20IIi“ ohne Bindestrich ist von TM-T20III
|
|
115
|
+
* nicht zu unterscheiden (Prueffall).
|
|
116
|
+
*/
|
|
117
|
+
function inTeilen(text) {
|
|
118
|
+
const gross = text.replace(/[a-z]/g, (c) => c.toUpperCase());
|
|
119
|
+
if (FREMDES_ZEICHEN.test(gross))
|
|
120
|
+
return null;
|
|
121
|
+
return gross.split(/[^A-Z0-9]+/).filter((t) => t !== '').join(TRENNER);
|
|
122
|
+
}
|
|
123
|
+
/**
|
|
124
|
+
* Die Hersteller eines Katalogs als Vorsilben (`EPSON-`), laengste zuerst: „Star Micronics“ muss vor „Star“ greifen.
|
|
125
|
+
* Aus den Eintraegen selbst, damit ein neuer Hersteller keine zweite Liste braucht. Gleich lange Vorsilben koennen
|
|
126
|
+
* nicht beide vor demselben Namen stehen, ihre Reihenfolge ist darum gleichgueltig.
|
|
127
|
+
*/
|
|
128
|
+
function herstellerVorsilben(catalog) {
|
|
129
|
+
const vorsilben = new Set();
|
|
130
|
+
for (const e of catalog) {
|
|
131
|
+
const hersteller = inTeilen(e.manufacturer);
|
|
132
|
+
if (hersteller)
|
|
133
|
+
vorsilben.add(hersteller + TRENNER);
|
|
134
|
+
}
|
|
135
|
+
return [...vorsilben].sort((a, b) => b.length - a.length);
|
|
136
|
+
}
|
|
137
|
+
/** [inTeilen], dann ohne die erste passende Vorsilbe; `null` ohne Namen oder mit fremdem Zeichen. */
|
|
138
|
+
function normiert(model, vorsilben) {
|
|
139
|
+
if (typeof model !== 'string')
|
|
140
|
+
return null;
|
|
141
|
+
const name = inTeilen(model);
|
|
142
|
+
if (!name)
|
|
143
|
+
return null;
|
|
144
|
+
const vorsilbe = vorsilben.find((v) => name.startsWith(v));
|
|
145
|
+
return vorsilbe === undefined ? name : name.slice(vorsilbe.length);
|
|
146
|
+
}
|
|
147
|
+
/**
|
|
148
|
+
* Normierter Modellname, die Hersteller aus `catalog`. `EPSON TM-m30III`, `TM-M30III` und `tm m30iii` ergeben
|
|
149
|
+
* `TM-M30III`; der Hersteller allein (`EPSON`) bleibt stehen.
|
|
150
|
+
*/
|
|
151
|
+
function normalizePrinterModel(model, catalog = exports.PRINTER_CATALOG) {
|
|
152
|
+
return normiert(model, herstellerVorsilben(catalog));
|
|
153
|
+
}
|
|
154
|
+
// ------------------------------------------------------------------ Erkennen
|
|
155
|
+
/**
|
|
156
|
+
* Der freigegebene Eintrag aus `catalog`, an dem `model` erkannt wird, sonst `null`. Ein nicht freigegebener Eintrag
|
|
157
|
+
* verhaelt sich wie ein unbekanntes Modell. Das Ergebnis ist eindeutig, weil kein Name in zwei Eintraegen steht
|
|
158
|
+
* (Prueffall `match_name_ambiguous`).
|
|
159
|
+
*/
|
|
160
|
+
function findPrinterCatalogEntry(catalog, model) {
|
|
161
|
+
const name = normalizePrinterModel(model, catalog);
|
|
162
|
+
if (name === null)
|
|
163
|
+
return null;
|
|
164
|
+
return catalog.find((e) => e.approval.approved && e.matchNames.includes(name)) ?? null;
|
|
165
|
+
}
|
|
166
|
+
/**
|
|
167
|
+
* Der freigegebene Katalogeintrag zu einem Modellnamen, wie Connect ihn meldet (mDNS, `GS I`), oder `null` fuer ein
|
|
168
|
+
* unbekanntes Modell. Gross- und Kleinschreibung, ein vorangestelltes `EPSON` und die Art der Trenner zaehlen nicht.
|
|
169
|
+
* `undefined` ist erlaubt, weil Connect `model` im Fund weglaesst, wenn es keines kennt.
|
|
170
|
+
*/
|
|
171
|
+
function printerCatalogEntry(model) {
|
|
172
|
+
return findPrinterCatalogEntry(exports.PRINTER_CATALOG, model);
|
|
173
|
+
}
|
|
174
|
+
/** Was ein Eintrag beim Einrichten vorschlaegt; `drawerKick` wird zu `drawerEnabled`. */
|
|
175
|
+
function printerCatalogSettings(entry) {
|
|
176
|
+
const { paperSize, codePage, cut, qrMode, drawerKick } = entry.values;
|
|
177
|
+
return {
|
|
178
|
+
device: { paperSize, codePage, cut, qrMode, drawerEnabled: drawerKick },
|
|
179
|
+
paperSizeNeedsCheck: entry.paperSizes.some((p) => p !== paperSize),
|
|
180
|
+
};
|
|
181
|
+
}
|
|
182
|
+
// ------------------------------------------------------------------ Pruefung
|
|
183
|
+
/**
|
|
184
|
+
* Was an einem Katalog nicht stimmt. Jeder Grund gehoert zu genau einem Feld des Eintrags, darum traegt ein Fund kein
|
|
185
|
+
* eigenes Feld. Reihenfolge = Reihenfolge der Pruefung je Eintrag.
|
|
186
|
+
*/
|
|
187
|
+
exports.PRINTER_CATALOG_PROBLEM_REASONS = [
|
|
188
|
+
'duplicate_id',
|
|
189
|
+
'match_names_missing',
|
|
190
|
+
'match_name_not_normalized',
|
|
191
|
+
'match_name_ambiguous',
|
|
192
|
+
'model_not_matched',
|
|
193
|
+
'paper_sizes_invalid',
|
|
194
|
+
'paper_size_not_listed',
|
|
195
|
+
'paper_size_too_wide',
|
|
196
|
+
'cut_not_allowed',
|
|
197
|
+
'qr_mode_not_allowed',
|
|
198
|
+
'chars_per_line_mismatch',
|
|
199
|
+
'device_test_missing',
|
|
200
|
+
'device_test_incomplete',
|
|
201
|
+
];
|
|
202
|
+
/** Tag im Format `JJJJ-MM-TT`. */
|
|
203
|
+
const TAG = /^\d{4}-\d{2}-\d{2}$/;
|
|
204
|
+
/** Ein Geraetetest belegt den Eintrag ganz: Kopf ausgefuellt, jedes Wertfeld und jede Breite geprueft. */
|
|
205
|
+
const vollstaendig = (t, e) => TAG.test(t.date) && t.connectVersion !== '' && t.firmware !== '' && t.testedBy !== ''
|
|
206
|
+
&& exports.PRINTER_CATALOG_VALUE_FIELDS.every((f) => t.checked.includes(f))
|
|
207
|
+
&& e.paperSizes.every((p) => t.checkedPaperSizes.includes(p));
|
|
208
|
+
/**
|
|
209
|
+
* Alle Funde in einem Katalog; leer = gueltig. Die einzige Stelle, an der die Regeln stehen. Der Test ruft sie fuer den
|
|
210
|
+
* ausgelieferten Katalog und die Prueffaelle; ein Fund macht ihn rot, statt zur Laufzeit still zu wirken.
|
|
211
|
+
*/
|
|
212
|
+
function printerCatalogProblems(catalog) {
|
|
213
|
+
const probleme = [];
|
|
214
|
+
const vorsilben = herstellerVorsilben(catalog);
|
|
215
|
+
const ids = new Set();
|
|
216
|
+
/** Name -> Index des Eintrags, der ihn zuerst fuehrt. */
|
|
217
|
+
const namen = new Map();
|
|
218
|
+
catalog.forEach((e, index) => {
|
|
219
|
+
const melde = (reason) => { probleme.push({ id: e.id, reason }); };
|
|
220
|
+
if (ids.has(e.id))
|
|
221
|
+
melde('duplicate_id');
|
|
222
|
+
ids.add(e.id);
|
|
223
|
+
if (e.matchNames.length === 0)
|
|
224
|
+
melde('match_names_missing');
|
|
225
|
+
for (const name of e.matchNames) {
|
|
226
|
+
if (normiert(name, vorsilben) !== name)
|
|
227
|
+
melde('match_name_not_normalized');
|
|
228
|
+
const erster = namen.get(name);
|
|
229
|
+
if (erster === undefined)
|
|
230
|
+
namen.set(name, index);
|
|
231
|
+
else if (erster !== index)
|
|
232
|
+
melde('match_name_ambiguous');
|
|
233
|
+
}
|
|
234
|
+
// Der eigene Modellname muss den Eintrag finden; sonst passen Anzeige und Erkennung nicht zusammen (Tippfehler).
|
|
235
|
+
const eigenerName = normiert(e.model, vorsilben);
|
|
236
|
+
if (eigenerName === null || !e.matchNames.includes(eigenerName))
|
|
237
|
+
melde('model_not_matched');
|
|
238
|
+
// Eine feste Reihenfolge ohne Doppel haelt Vertrag und Vergleich eindeutig.
|
|
239
|
+
if (e.paperSizes.join() !== settings_js_1.PAPER_SIZE.filter((p) => e.paperSizes.includes(p)).join())
|
|
240
|
+
melde('paper_sizes_invalid');
|
|
241
|
+
if (!e.paperSizes.includes(e.values.paperSize))
|
|
242
|
+
melde('paper_size_not_listed');
|
|
243
|
+
// Eine Breite, deren Layout mehr Zeichen setzt, als der Drucker hat, bricht jede Zeile um (TM-T88: 48 auf 42).
|
|
244
|
+
if (e.paperSizes.some((p) => grid_js_1.CHARS_PER_PAPER_SIZE[p] > e.nativeCharsPerLine))
|
|
245
|
+
melde('paper_size_too_wide');
|
|
246
|
+
// Die Typen schliessen beides schon aus; die Pruefung gilt Daten, die als JSON kommen (Prueffaelle des Vertrags).
|
|
247
|
+
if (!exports.PRINTER_CATALOG_CUTS.includes(e.values.cut))
|
|
248
|
+
melde('cut_not_allowed');
|
|
249
|
+
if (!exports.PRINTER_CATALOG_QR_MODES.includes(e.values.qrMode))
|
|
250
|
+
melde('qr_mode_not_allowed');
|
|
251
|
+
if (grid_js_1.CHARS_PER_PAPER_SIZE[e.values.paperSize] !== e.values.charsPerLine)
|
|
252
|
+
melde('chars_per_line_mismatch');
|
|
253
|
+
const test = e.approval.deviceTest;
|
|
254
|
+
if (e.approval.approved && test === null)
|
|
255
|
+
melde('device_test_missing');
|
|
256
|
+
if (test !== null && !vollstaendig(test, e))
|
|
257
|
+
melde('device_test_incomplete');
|
|
258
|
+
});
|
|
259
|
+
return probleme;
|
|
260
|
+
}
|
package/dist/cjs/pos/index.d.ts
CHANGED
|
@@ -18,6 +18,7 @@ export { POS_ERROR_CODES, type PosErrorCode, isPosErrorCode, posErrorCode, isPos
|
|
|
18
18
|
export { distributeDiscount } from '../receipt/discount.js';
|
|
19
19
|
export { cancelScopeOf, receiptsScopeOf, stockViewOf, voucherPermsOf, depositReturnOf, type VoucherPerms, type RegisterScope, type RegisterUserPerms } from '../register/pairing.js';
|
|
20
20
|
export { type NetworkPrinter, type PrintJob, type PrintJobStatus, PRINT_JOB_STATUSES, type PrintJobSource, PRINT_JOB_SOURCES, isPrintJobFinished, type CreatePrintJobOptions, listMyPrinters, createPrintJob, getPrintJob, } from './drucker.js';
|
|
21
|
+
export { type PrinterCatalogEntry, type PrinterCatalogValues, type PrinterCatalogValueField, type PrinterCatalogApproval, type PrinterDeviceTest, type PrinterCatalogSettings, type PrinterCatalogDeviceSettings, type PrinterCatalogCut, type PrinterCatalogQrMode, printerCatalogEntry, printerCatalogSettings, } from './drucker-katalog.js';
|
|
21
22
|
export { listMyTipRecipients } from './trinkgeld.js';
|
|
22
23
|
export { posDiscountPresets, discountPresetChipText, discountChipsFromPresets, checkDiscountPresets, discountBlockLines, INVALID_DISCOUNT_PRESET, DISCOUNT_PRESETS_MAX, DISCOUNT_PRESET_NAME_MAX, DISCOUNT_PRESET_PERCENT_BP, DISCOUNT_PRESET_AMOUNT_CENTS, DISCOUNT_PRESET_MESSAGES, type DiscountPresetReason, type DiscountPresetError, type DiscountPresetsCheck, type DiscountBlockLine, type DiscountTotal, } from './rabatt-vorlagen.js';
|
|
23
24
|
export { depFolderName } from './dep.js';
|
package/dist/cjs/pos/index.js
CHANGED
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.SETTINGS_FONT_SIZE = exports.LOGO_SIZE = exports.QR_MODE = exports.DRAWER_AUTO_OPEN = exports.CUT = exports.CODE_PAGE = exports.PAPER_SIZE = exports.TERMINAL_TYPE = exports.TERMINAL_VIA = exports.PRINTER_TYPE = exports.TILE_HEIGHT = exports.CATEGORY_POSITION = exports.LAYOUT = exports.RECEIPT_OUTPUT = exports.CARD_PROVIDER = exports.CHECKOUT_MODE = exports.CART_WIDTH = exports.TIP_KEPT_MODE = exports.TIP_START = exports.TIP_KINDS = exports.TIP_MODE = exports.QUANTITY = exports.WATERMARK = exports.FONT_SIZE = exports.THEME = exports.posShortcutConflict = exports.POS_SHORTCUT_SHARED_PAIRS = exports.posSettingsChanges = exports.unknownPosSettingValues = exports.sanitizePosSettings = exports.mergePosSettings = exports.POS_DEVICE_VALUES = exports.POS_BUSINESS_VALUES = exports.posCartWidth = exports.posTipStart = exports.posTipKinds = exports.POS_BUSINESS_OPTIONAL_LISTS = exports.DISCOUNT_PRESET_KIND = exports.tipKeptFor = exports.posTipKeptMode = exports.posCustomDiscountAllowed = exports.posTipKeptByDefault = exports.POS_DEVICE_OPTIONAL_CHOICES = exports.POS_BUSINESS_OPTIONAL_CHOICES = exports.POS_BUSINESS_OPTIONAL_FIELDS = exports.POS_DEVICE_OPTIONAL_FIELDS = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.POS_SHORTCUT_DEFAULTS = exports.POS_SHORTCUT_ACTIONS = void 0;
|
|
4
4
|
exports.withDepositLines = exports.viennaDay = exports.depositAmountOn = exports.depositsFor = exports.cashRegisterDepositFromWire = exports.depositEntriesFromWire = exports.posDepositSettingsFromWire = exports.DEPOSIT_ON_PREMISES_DEFAULTS = exports.DEPOSIT_RETURN_MODES = exports.DEPOSIT_TYPES = exports.DEPOSIT_KINDS = exports.orderAddOnLines = exports.addOnDisplayOrder = exports.addOnRemap = exports.addOnsOfItem = exports.addOnReferencesValid = exports.addOnsFor = exports.isSelectableAddOn = exports.ADD_ON_BLOCK_REASONS = exports.ADD_ONS_MAX = exports.fromReferencePayload = exports.referenceLineName = exports.checkReference = exports.isDigitsOnlyPattern = exports.isValidReferencePattern = exports.cleanReferenceText = exports.REFERENCE_PATTERN_TEMPLATES = exports.REFERENCE_PATTERN_MAX = exports.REFERENCE_HINT_MAX = exports.REFERENCE_LABEL_MAX = exports.REFERENCE_INPUT_MAX = exports.REFERENCE_MODES = exports.tilePrompts = exports.isBookableArticle = exports.allowedQuantity = exports.quantityDefaults = exports.quantityRuleForUnit = exports.QUANTITY_RULES = exports.listMyArticles = exports.listMyArticleGroups = exports.fromPosArticlePayload = exports.fromArticleGroupPayload = exports.DONE_SCREEN_SECONDS = exports.WATERMARK_SCALE = exports.LOGO_SCALE = exports.WATERMARK_STRENGTH = exports.WATERMARK_SIDE = exports.DISCOUNT = exports.AUTO_LOGOUT_MINUTES = exports.TILE_STYLE = void 0;
|
|
5
|
-
exports.
|
|
6
|
-
exports.
|
|
7
|
-
exports.roundUpSuggestions = exports.receiptOutputLabel = exports.RETURN_DISPOSITION_LABELS = exports.labelText = exports.LABELS = exports.TIP_KEPT_MODE_LABELS = exports.EXTERNAL_VOUCHER_KIND_LABELS = exports.EXTERNAL_VOUCHERS_LABELS = exports.externalVoucherArticleErrorMessage = exports.EXTERNAL_VOUCHER_ARTICLE_MESSAGES = exports.EXTERNAL_VOUCHER_TILE_MESSAGES = exports.depositErrorMessage = exports.DEPOSIT_ERROR_MESSAGES = exports.voucherErrorMessage = exports.VOUCHER_ERROR_MESSAGES = exports.cancellationErrorMessage = exports.CANCELLATION_VOUCHER_ERROR_MESSAGES = exports.cancellationPaymentErrorMessage = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.receiptEmailErrorMessage = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.messageAppliesTo = exports.messageText = exports.messageOutcome = exports.findErrorRule = exports.CALLS_WITH_EFFECT = exports.ERROR_OUTCOME_RULES = exports.ERROR_CODE_RULES = exports.ERROR_RULES = exports.MESSAGES = exports.isReturnDisposition = exports.RETURN_DISPOSITIONS = void 0;
|
|
5
|
+
exports.inspectionInfoRows = exports.getRegisterInspectionInfo = exports.depFolderName = exports.DISCOUNT_PRESET_MESSAGES = exports.DISCOUNT_PRESET_AMOUNT_CENTS = exports.DISCOUNT_PRESET_PERCENT_BP = exports.DISCOUNT_PRESET_NAME_MAX = exports.DISCOUNT_PRESETS_MAX = exports.INVALID_DISCOUNT_PRESET = exports.discountBlockLines = exports.checkDiscountPresets = exports.discountChipsFromPresets = exports.discountPresetChipText = exports.posDiscountPresets = exports.listMyTipRecipients = exports.printerCatalogSettings = exports.printerCatalogEntry = exports.getPrintJob = exports.createPrintJob = exports.listMyPrinters = exports.isPrintJobFinished = exports.PRINT_JOB_SOURCES = exports.PRINT_JOB_STATUSES = exports.depositReturnOf = exports.voucherPermsOf = exports.stockViewOf = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.posFieldErrors = exports.isPosError = exports.posErrorCode = exports.isPosErrorCode = exports.POS_ERROR_CODES = exports.posSettingsFromWire = exports.setMyPosLogo = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = exports.getPosSettings = exports.OWN_VOUCHER_CODE_SHAPES = exports.ownVoucherCodeShape = exports.externalVoucherTileBlock = exports.checkExternalVoucherArticle = exports.checkExternalVoucherValue = exports.isArticleExternalVoucher = exports.EXTERNAL_VOUCHER_ARTICLE_REASONS = exports.ARTICLE_EXTERNAL_VOUCHER_VAT_RATES = exports.ARTICLE_EXTERNAL_VOUCHER_INVALID = exports.ARTICLE_EXTERNAL_VOUCHER_TYPES = exports.depositReturnLine = void 0;
|
|
6
|
+
exports.cashMovementLayout = exports.shiftReceiptLayout = exports.DIFFERENCE_PART_TYPES = exports.EXPECTED_PART_KEYS = exports.AFTER_COUNT_TYPES = exports.SHIFT_RECEIPT_KINDS = exports.MANUAL_OPENING_REASONS = exports.OPENING_REASONS = exports.CASH_LOCATIONS = exports.MANUAL_MOVEMENT_TYPES = exports.MOVEMENT_TYPES = exports.EUR_DENOMINATIONS = exports.durationText = exports.shiftTipLines = exports.newIdempotencyKey = exports.parseCentsAllowZero = exports.sumDenominations = exports.recordMyShiftCount = exports.closeMyShift = exports.getMyShiftReport = exports.logMyDrawerOpenings = exports.recordMyCashMovement = exports.openMyShift = exports.getMyDrawerState = exports.EXTERNAL_VOUCHERS = exports.VOUCHER_TYPE_VALIDITY_PATTERNS = exports.VOUCHER_AMOUNT_MODES = exports.VOUCHER_TYPE_KINDS = exports.VOUCHER_PAYOUTS = exports.posVoucherSettingsFromWire = exports.VOUCHER_SETTINGS_DEFAULTS = exports.reprintVoucherLabel = exports.checkVoucher = exports.VOUCHER_STATUSES = exports.VOUCHER_KINDS = exports.parseQuantityMilli = exports.voidMyStocktakeCount = exports.recordMyStocktakeCount = exports.listMyStocktakeCounts = exports.listMyStocktakeItems = exports.listMyStocktakes = exports.setMyCashregisterStockLocation = exports.listMyStock = exports.listMyStockLocations = exports.STOCK_LOCATION_TYPES = exports.matchReturnCode = exports.listReturnCodes = exports.learnReturnCode = exports.reportConnectState = exports.inspectionInfoLines = void 0;
|
|
7
|
+
exports.roundUpSuggestions = exports.receiptOutputLabel = exports.RETURN_DISPOSITION_LABELS = exports.labelText = exports.LABELS = exports.TIP_KEPT_MODE_LABELS = exports.EXTERNAL_VOUCHER_KIND_LABELS = exports.EXTERNAL_VOUCHERS_LABELS = exports.externalVoucherArticleErrorMessage = exports.EXTERNAL_VOUCHER_ARTICLE_MESSAGES = exports.EXTERNAL_VOUCHER_TILE_MESSAGES = exports.depositErrorMessage = exports.DEPOSIT_ERROR_MESSAGES = exports.voucherErrorMessage = exports.VOUCHER_ERROR_MESSAGES = exports.cancellationErrorMessage = exports.CANCELLATION_VOUCHER_ERROR_MESSAGES = exports.cancellationPaymentErrorMessage = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.receiptEmailErrorMessage = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.messageAppliesTo = exports.messageText = exports.messageOutcome = exports.findErrorRule = exports.CALLS_WITH_EFFECT = exports.ERROR_OUTCOME_RULES = exports.ERROR_CODE_RULES = exports.ERROR_RULES = exports.MESSAGES = exports.isReturnDisposition = exports.RETURN_DISPOSITIONS = exports.RECEIPT_OUTPUT_RESULTS = exports.RECEIPT_OUTPUT_KINDS = void 0;
|
|
8
8
|
/**
|
|
9
9
|
* Kachel-Kasse: Einstellungen, Artikelgruppen/Artikel fuer Kacheln,
|
|
10
10
|
* Rabattverteilung, Drucker, Trinkgeld-Empfaenger, Lager (Standorte, Bestand,
|
|
@@ -162,6 +162,11 @@ Object.defineProperty(exports, "isPrintJobFinished", { enumerable: true, get: fu
|
|
|
162
162
|
Object.defineProperty(exports, "listMyPrinters", { enumerable: true, get: function () { return drucker_js_1.listMyPrinters; } });
|
|
163
163
|
Object.defineProperty(exports, "createPrintJob", { enumerable: true, get: function () { return drucker_js_1.createPrintJob; } });
|
|
164
164
|
Object.defineProperty(exports, "getPrintJob", { enumerable: true, get: function () { return drucker_js_1.getPrintJob; } });
|
|
165
|
+
// Druckerkatalog (Connect-Einrichtung mit einem Klick): Normierung, Pruefung und der Katalog selbst bleiben im Modul,
|
|
166
|
+
// nach aussen gehen nur das Erkennen und die vorgeschlagenen Einstellungen.
|
|
167
|
+
var drucker_katalog_js_1 = require("./drucker-katalog.js");
|
|
168
|
+
Object.defineProperty(exports, "printerCatalogEntry", { enumerable: true, get: function () { return drucker_katalog_js_1.printerCatalogEntry; } });
|
|
169
|
+
Object.defineProperty(exports, "printerCatalogSettings", { enumerable: true, get: function () { return drucker_katalog_js_1.printerCatalogSettings; } });
|
|
165
170
|
var trinkgeld_js_1 = require("./trinkgeld.js");
|
|
166
171
|
Object.defineProperty(exports, "listMyTipRecipients", { enumerable: true, get: function () { return trinkgeld_js_1.listMyTipRecipients; } });
|
|
167
172
|
var rabatt_vorlagen_js_1 = require("./rabatt-vorlagen.js");
|
|
@@ -132,7 +132,7 @@ function verbunden(teile) {
|
|
|
132
132
|
* (models/hobex-receipt.ts) — Datum, TID, Genehmigungsnummer, Karte, PAN,
|
|
133
133
|
* Antwortcode. Bei CVM "1" verlangt die Karte eine Unterschrift; dafuer
|
|
134
134
|
* bekommt der Bon eine Linie. Der PAN haengt beim HPS das Ablaufdatum mit
|
|
135
|
-
* Unterstrich an ("…
|
|
135
|
+
* Unterstrich an ("…0021_2912") — gedruckt wird nur die maskierte Nummer.
|
|
136
136
|
*/
|
|
137
137
|
function hobexBlock(daten) {
|
|
138
138
|
const feld = (k) => kartenFeld(daten, k);
|
package/dist/cjs/version.d.ts
CHANGED
package/dist/cjs/version.js
CHANGED
|
@@ -23,9 +23,44 @@ export interface HpsConnectTarget {
|
|
|
23
23
|
host: string;
|
|
24
24
|
/** Vorgabe: `8080` (hobex-HPS-Standardport), siehe Connect. */
|
|
25
25
|
port?: number;
|
|
26
|
-
/**
|
|
26
|
+
/**
|
|
27
|
+
* Terminal-ID, gern so, wie sie am Geraet und auf dem Beleg steht (achtstellig
|
|
28
|
+
* mit fuehrender Null, `03600335`). Das HPS kennt sie nur OHNE fuehrende Null
|
|
29
|
+
* und weist jede andere Schreibweise mit `100108 "Invalid TID"` ab; dieser
|
|
30
|
+
* Client schreibt sie deshalb vor jedem Aufruf um, siehe [normalizeHpsTid].
|
|
31
|
+
*/
|
|
27
32
|
tid: string;
|
|
28
33
|
}
|
|
34
|
+
/**
|
|
35
|
+
* Die TID in der Form, die das hobex-HPS annimmt: Leerraum am Rand
|
|
36
|
+
* ([RAND_LEERRAUM]) und fuehrende Nullen fallen weg.
|
|
37
|
+
*
|
|
38
|
+
* Am 10.11.2026 gemessen (TID 3600335, HPS 1.14.4, Firmware 7.3.6): Diagnose
|
|
39
|
+
* und Zahlung mit `03600335` antworten sofort `100108 "Invalid TID"` (nichts
|
|
40
|
+
* belastet), mit `3600335` normal; `003600335`, `0360033` und `36003350` sind
|
|
41
|
+
* ebenfalls `Invalid TID`. Auf Beleg und Geraet steht die TID achtstellig mit
|
|
42
|
+
* fuehrender Null -- so wird sie auch eingetragen.
|
|
43
|
+
*
|
|
44
|
+
* Umgeschrieben wird NUR eine rein ziffrige TID mit mindestens einer Ziffer
|
|
45
|
+
* ungleich `0`. Alles andere geht UNVERAENDERT hinaus, auch die `0` der
|
|
46
|
+
* Erkennungsprobe von Connect und eine TID aus lauter Nullen: still etwas
|
|
47
|
+
* anderes daraus zu machen, hiesse ein anderes Terminal anzusprechen als das
|
|
48
|
+
* eingetragene. Bewusst kein Wurf: Connect weist eine nicht rein ziffrige TID
|
|
49
|
+
* selbst ab (`bad_request`, vor jedem Terminal-Kontakt, hier
|
|
50
|
+
* [HpsPreflightError]), und das HPS antwortet auf eine unbekannte mit
|
|
51
|
+
* `100108` -- in beiden Faellen geht kein Geld, und der Aufrufer bekommt den
|
|
52
|
+
* Grund auf dem Weg, den er fuer jede andere Abweisung auch auswertet.
|
|
53
|
+
*
|
|
54
|
+
* Kein Text (ein Aufrufer ohne Typpruefung uebergibt etwa eine Zahl) geht
|
|
55
|
+
* ebenso unveraendert hinaus: Connect weist ihn dann mit "Es fehlt die
|
|
56
|
+
* Terminal-ID" ab ([HpsPreflightError]), statt dass hier ein Wurf aus dem
|
|
57
|
+
* Zahlweg einen offenen Ausgang machte.
|
|
58
|
+
*
|
|
59
|
+
* Die einzige Stelle, an der die TID umgeschrieben wird: jeder Aufruf geht
|
|
60
|
+
* ueber `target`. Zwilling: `HpsClient` im Dart-Paket (`_normalizeTid`), Faelle
|
|
61
|
+
* in `fixtures/hobex-hps-cases.json`.
|
|
62
|
+
*/
|
|
63
|
+
export declare function normalizeHpsTid(tid: string): string;
|
|
29
64
|
export interface HpsConnectPaymentOptions extends HpsConnectTarget {
|
|
30
65
|
/** Kennung dieser Zahlung — MUSS vor diesem Aufruf feststehen, siehe `transaction-id.ts`. */
|
|
31
66
|
transactionId: string;
|
|
@@ -93,6 +128,13 @@ export interface HpsConnectClientOptions {
|
|
|
93
128
|
export interface HpsConnectClient {
|
|
94
129
|
payment(options: HpsConnectPaymentOptions): Promise<HpsTransactionResponse>;
|
|
95
130
|
status(options: HpsConnectTransactionOptions): Promise<HpsTransactionResponse>;
|
|
131
|
+
/**
|
|
132
|
+
* Abbruch eines laufenden Vorgangs. `responseCode '0'` heisst nur, dass das
|
|
133
|
+
* Terminal die Anfrage angenommen hat -- NICHT, dass der Vorgang abgebrochen
|
|
134
|
+
* ist: am 10.11.2026 endete eine Zahlung nach so einer Quittung genehmigt.
|
|
135
|
+
* Den Ausgang sagt die Antwort auf die Zahlung oder die Statusabfrage, siehe
|
|
136
|
+
* `payments.ts`.
|
|
137
|
+
*/
|
|
96
138
|
abort(options: HpsConnectTransactionOptions): Promise<HpsTransactionResponse>;
|
|
97
139
|
/** Gutschrift — ein Kartenfluss wie [payment], deshalb dieselbe lange Frist. */
|
|
98
140
|
refund(options: HpsConnectRefundOptions): Promise<HpsTransactionResponse>;
|
|
@@ -1,6 +1,55 @@
|
|
|
1
1
|
import { HpsConnectTerminalError, HpsConnectTransportError, HpsPreflightError, HpsTransactionIdError, PREFLIGHT_CONNECT_CODES, TERMINAL_UNREACHABLE_CONNECT_CODES, } from './errors.js';
|
|
2
2
|
import { isValidHpsTransactionId } from './transaction-id.js';
|
|
3
3
|
import { parseHpsTransactionResponse } from './transaction-response.js';
|
|
4
|
+
/** Nur eine rein ziffrige TID wird umgeschrieben. */
|
|
5
|
+
const NUR_ZIFFERN = /^[0-9]+$/;
|
|
6
|
+
const FUEHRENDE_NULLEN = /^0+/;
|
|
7
|
+
/**
|
|
8
|
+
* Leerraum am Rand, der wegfaellt: nur ASCII (Leerzeichen, Tab, Zeilenvorschub,
|
|
9
|
+
* Wagenruecklauf, vertikaler Tab, Seitenvorschub). Bewusst eine feste Liste
|
|
10
|
+
* statt `trim()`: JavaScript und Dart zaehlen Unicode-Leerraum verschieden
|
|
11
|
+
* (U+0085 trimmt Dart, JavaScript nicht), und die Zwillinge sollen dieselbe
|
|
12
|
+
* TID hinausschicken. Jedes andere Zeichen am Rand laesst die TID unveraendert.
|
|
13
|
+
*/
|
|
14
|
+
const RAND_LEERRAUM = /^[ \t\n\r\x0B\x0C]+|[ \t\n\r\x0B\x0C]+$/g;
|
|
15
|
+
/**
|
|
16
|
+
* Die TID in der Form, die das hobex-HPS annimmt: Leerraum am Rand
|
|
17
|
+
* ([RAND_LEERRAUM]) und fuehrende Nullen fallen weg.
|
|
18
|
+
*
|
|
19
|
+
* Am 10.11.2026 gemessen (TID 3600335, HPS 1.14.4, Firmware 7.3.6): Diagnose
|
|
20
|
+
* und Zahlung mit `03600335` antworten sofort `100108 "Invalid TID"` (nichts
|
|
21
|
+
* belastet), mit `3600335` normal; `003600335`, `0360033` und `36003350` sind
|
|
22
|
+
* ebenfalls `Invalid TID`. Auf Beleg und Geraet steht die TID achtstellig mit
|
|
23
|
+
* fuehrender Null -- so wird sie auch eingetragen.
|
|
24
|
+
*
|
|
25
|
+
* Umgeschrieben wird NUR eine rein ziffrige TID mit mindestens einer Ziffer
|
|
26
|
+
* ungleich `0`. Alles andere geht UNVERAENDERT hinaus, auch die `0` der
|
|
27
|
+
* Erkennungsprobe von Connect und eine TID aus lauter Nullen: still etwas
|
|
28
|
+
* anderes daraus zu machen, hiesse ein anderes Terminal anzusprechen als das
|
|
29
|
+
* eingetragene. Bewusst kein Wurf: Connect weist eine nicht rein ziffrige TID
|
|
30
|
+
* selbst ab (`bad_request`, vor jedem Terminal-Kontakt, hier
|
|
31
|
+
* [HpsPreflightError]), und das HPS antwortet auf eine unbekannte mit
|
|
32
|
+
* `100108` -- in beiden Faellen geht kein Geld, und der Aufrufer bekommt den
|
|
33
|
+
* Grund auf dem Weg, den er fuer jede andere Abweisung auch auswertet.
|
|
34
|
+
*
|
|
35
|
+
* Kein Text (ein Aufrufer ohne Typpruefung uebergibt etwa eine Zahl) geht
|
|
36
|
+
* ebenso unveraendert hinaus: Connect weist ihn dann mit "Es fehlt die
|
|
37
|
+
* Terminal-ID" ab ([HpsPreflightError]), statt dass hier ein Wurf aus dem
|
|
38
|
+
* Zahlweg einen offenen Ausgang machte.
|
|
39
|
+
*
|
|
40
|
+
* Die einzige Stelle, an der die TID umgeschrieben wird: jeder Aufruf geht
|
|
41
|
+
* ueber `target`. Zwilling: `HpsClient` im Dart-Paket (`_normalizeTid`), Faelle
|
|
42
|
+
* in `fixtures/hobex-hps-cases.json`.
|
|
43
|
+
*/
|
|
44
|
+
export function normalizeHpsTid(tid) {
|
|
45
|
+
if (typeof tid !== 'string')
|
|
46
|
+
return tid;
|
|
47
|
+
const ohneRand = tid.replace(RAND_LEERRAUM, '');
|
|
48
|
+
if (!NUR_ZIFFERN.test(ohneRand))
|
|
49
|
+
return tid;
|
|
50
|
+
const ohneNullen = ohneRand.replace(FUEHRENDE_NULLEN, '');
|
|
51
|
+
return ohneNullen === '' ? tid : ohneNullen;
|
|
52
|
+
}
|
|
4
53
|
const DEFAULT_BASE_URL = 'http://127.0.0.1:27182';
|
|
5
54
|
const DEFAULT_SHORT_TIMEOUT_MS = 30_000;
|
|
6
55
|
const DEFAULT_PAYMENT_TIMEOUT_MS = 4 * 60_000 + 30_000;
|
|
@@ -83,7 +132,7 @@ export function createHpsConnectClient(options) {
|
|
|
83
132
|
return value;
|
|
84
133
|
}
|
|
85
134
|
function target(t) {
|
|
86
|
-
return { host: t.host, port: t.port, tid: t.tid };
|
|
135
|
+
return { host: t.host, port: t.port, tid: normalizeHpsTid(t.tid) };
|
|
87
136
|
}
|
|
88
137
|
return {
|
|
89
138
|
async payment(o) {
|
|
@@ -40,9 +40,10 @@ export interface HpsPaymentResult {
|
|
|
40
40
|
* fuer den Bediener in `HPS_REASON_HINTS`.
|
|
41
41
|
*
|
|
42
42
|
* Gesetzt an der Stelle, die den Ausgang entschieden hat, nicht aus
|
|
43
|
-
* [response] abgeleitet: ein
|
|
44
|
-
*
|
|
45
|
-
* abgelehnt klaert, zaehlt der Code der
|
|
43
|
+
* [response] abgeleitet: ein quittiertes Storno nach einer Stoerung beim
|
|
44
|
+
* Host antwortet `'0'` und ist trotzdem `'voidedAfterHostFault'`, und wenn
|
|
45
|
+
* die Zwei-9027-Regel eine Zahlung als abgelehnt klaert, zaehlt der Code der
|
|
46
|
+
* ZAHLUNG, nicht das `9027` danach.
|
|
46
47
|
* Fehlt, wenn kein Code etwas erklaert (die Leitung riss ab, bevor das
|
|
47
48
|
* Terminal etwas sagte) und bei einer Aufhebung, die nicht gegriffen hat.
|
|
48
49
|
*/
|
|
@@ -15,49 +15,80 @@ import type { HpsPaymentResult } from './outcome.js';
|
|
|
15
15
|
*
|
|
16
16
|
* Regel, von der nicht abgewichen wird: `outcome: 'declined'` entsteht
|
|
17
17
|
* ausschliesslich aus einer POSITIVEN Aussage — einem GEMESSENEN Ergebniscode
|
|
18
|
-
* des Terminals ungleich `'0'` ([isConclusive])
|
|
19
|
-
*
|
|
20
|
-
* (
|
|
21
|
-
*
|
|
22
|
-
*
|
|
18
|
+
* des Terminals ungleich `'0'` ([isConclusive]) auf die Zahlung oder in der
|
|
19
|
+
* Statusabfrage, der Zwei-9027-Regel nach einer Antwort MIT Code
|
|
20
|
+
* ([ausGeschlossenerAntwort]), einem `9011` (aufgehoben) in der Statusabfrage
|
|
21
|
+
* nach einem nachgeschickten Storno, oder dem gemessenen "Terminal
|
|
22
|
+
* beschaeftigt"-Fall (HTTP 409 auf die ERZEUGENDE Anfrage, siehe
|
|
23
|
+
* `errors.ts`, `HpsConnectTerminalError.isTerminalBusy`). Ein
|
|
24
|
+
* Transportfehler, ein Zeitablauf, eine Wissensluecke, ein quittierter
|
|
25
|
+
* Abbruch und ein quittiertes Storno fuehren NIE dorthin: keines davon ist
|
|
23
26
|
* eine Aussage darueber, dass nichts belastet wurde. Genau diese
|
|
24
27
|
* Verwechslung hat am 24.08.2026 eine echte Belastung als unbelastet
|
|
25
28
|
* ausgewiesen und den Kunden ein zweites Mal belastet.
|
|
26
29
|
*
|
|
27
|
-
* ## Der Klaerweg
|
|
30
|
+
* ## Der Klaerweg
|
|
28
31
|
*
|
|
29
|
-
* Bleibt die Antwort auf eine Zahlung aus:
|
|
32
|
+
* Bleibt die Antwort auf eine Zahlung aus, oder sagt sie nichts:
|
|
30
33
|
*
|
|
31
|
-
* 1. [HpsConnectClient.abort] einmalig versuchen.
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
*
|
|
37
|
-
*
|
|
38
|
-
*
|
|
39
|
-
*
|
|
34
|
+
* 1. [HpsConnectClient.abort] einmalig versuchen. Die Absicht: ein
|
|
35
|
+
* Kartenfluss, der noch auf die Karte wartet, soll enden, damit nach der
|
|
36
|
+
* Klaerung keine spaet aufgelegte Karte mehr belastet wird. Eine Garantie
|
|
37
|
+
* ist das nicht -- ob der Abbruch greift, sagt seine Quittung nicht.
|
|
38
|
+
* 2. Die Antwort auf den Abbruch entscheidet NICHTS, auch `'0'` nicht (siehe
|
|
39
|
+
* "Ein quittierter Abbruch ist keine Aussage"). Sie steht nur im Nachweis.
|
|
40
|
+
* 3. Dann die Statusabfrage pollen: `'0'` -> `approved`, mit der Antwort des
|
|
41
|
+
* Status als Beleg; ein schluessiger Code (etwa `9011` aufgehoben) ->
|
|
42
|
+
* `declined`; `9027` ist KEIN Ergebnis, sondern ein Grund weiterzumachen
|
|
43
|
+
* -- ausser nach einer Antwort MIT Code auf die Zahlung, siehe
|
|
44
|
+
* [ausGeschlossenerAntwort].
|
|
45
|
+
* 4. Budget erschoepft -> `unresolved`.
|
|
40
46
|
*
|
|
41
|
-
* Der
|
|
42
|
-
*
|
|
43
|
-
*
|
|
44
|
-
* gedeckelt ([ABORT_BUDGET_DIVISOR]), sonst friesst ein haengender Abbruch
|
|
45
|
-
* die ganze Klaerung.
|
|
47
|
+
* Der Abbruchversuch ist auf einen Bruchteil des Klaerbudgets gedeckelt
|
|
48
|
+
* ([ABORT_BUDGET_DIVISOR]), sonst friesst ein haengender Abbruch die ganze
|
|
49
|
+
* Klaerung.
|
|
46
50
|
*
|
|
47
51
|
* Die Kennung ist in JEDEM Ergebnis gesetzt, auch bei `'unresolved'`.
|
|
48
52
|
*
|
|
53
|
+
* ## Ein quittierter Abbruch ist keine Aussage (10.11.2026)
|
|
54
|
+
*
|
|
55
|
+
* Bis 1.35.0 hiess `'0'` auf den Abbruch "der Vorgang war noch abbrechbar,
|
|
56
|
+
* es ist nichts belastet" -- geschlossen aus einer Messung vom 26.08.2026, bei
|
|
57
|
+
* der der Abbruch WAEHREND des Wartens auf die Karte kam und die Zahlung
|
|
58
|
+
* danach mit `100002` "Aborted" endete. Am 10.11.2026 widerlegt (TID 3600335,
|
|
59
|
+
* HPS 1.14.4, Firmware 7.3.6, Testsystem): Abbruch vier Sekunden nach dem
|
|
60
|
+
* Start einer Zahlung ueber 0,01 EUR, nach 0,18 s quittiert mit `'0'`
|
|
61
|
+
* "Authorized" -- und die laufende Zahlung endete trotzdem GENEHMIGT
|
|
62
|
+
* (kontaktlos), die Statusabfrage danach ebenso. `'0'`
|
|
63
|
+
* heisst also nur, dass das Terminal die Abbruch-Anfrage angenommen hat,
|
|
64
|
+
* nicht, dass die Zahlung abgebrochen ist. Als `declined` gelesen, haette die
|
|
65
|
+
* Kasse "nichts belastet, noch einmal versuchen" gemeldet: der Weg zur
|
|
66
|
+
* Doppelbelastung vom 24.08.2026.
|
|
67
|
+
*
|
|
68
|
+
* Auch ein `9027` kurz nach einem angenommenen Abbruch ist keine Aussage:
|
|
69
|
+
* solange eine Zahlung laeuft, antwortet die Statusabfrage `9027` (gemessen
|
|
70
|
+
* 26.08.2026), und dass sie nach einem angenommenen Abbruch weiterlaufen kann,
|
|
71
|
+
* zeigt die Messung oben. Wie lange danach noch eine Genehmigung kommen kann,
|
|
72
|
+
* ist ungemessen. Ohne Antwort mit Code auf die Zahlung endet ein Abbruch mit
|
|
73
|
+
* anhaltendem `9027` deshalb bei `unresolved`, nicht bei `declined`.
|
|
74
|
+
*
|
|
75
|
+
* Bricht die KASSE eine laufende Zahlung ab (eigener Aufruf von
|
|
76
|
+
* [HpsConnectClient.abort], waehrend [pay] noch auf die Antwort wartet),
|
|
77
|
+
* entscheidet die Antwort auf die Zahlung selbst -- `approved`, wenn sie
|
|
78
|
+
* genehmigt meldet, `declined` mit `100002`. [pay] liest die Quittung dieses
|
|
79
|
+
* fremden Abbruchs nicht.
|
|
80
|
+
*
|
|
49
81
|
* ## [refund] bekommt EXAKT denselben Klaerweg wie [pay]
|
|
50
82
|
*
|
|
51
|
-
* Abbruch eingeschlossen
|
|
52
|
-
*
|
|
53
|
-
*
|
|
54
|
-
*
|
|
55
|
-
*
|
|
56
|
-
*
|
|
57
|
-
*
|
|
58
|
-
*
|
|
59
|
-
*
|
|
60
|
-
* `9027` antwortet.
|
|
83
|
+
* Abbruch eingeschlossen. Die Kennung ist bei [refund] die des NEUEN Vorgangs
|
|
84
|
+
* (der Gutschrift selbst), eine Statusabfrage darauf liefert also genau deren
|
|
85
|
+
* Ausgang -- deshalb reicht dieselbe [resolve]-Funktion unveraendert. Am
|
|
86
|
+
* 26.08.2026 gemessen: `abort` auf eine LAUFENDE Gutschrift antwortet
|
|
87
|
+
* ebenfalls mit `responseCode '0'`, und die Gutschrift endete daraufhin mit
|
|
88
|
+
* `100002` "Aborted". Wie bei der Zahlung beweist die Quittung allein nichts:
|
|
89
|
+
* eine Gutschrift, die nach dem angenommenen Abbruch doch durchgeht, als
|
|
90
|
+
* `declined` zu melden, laedt zu einer zweiten Gutschrift ein. Bleibt die
|
|
91
|
+
* Statusabfrage danach bei `9027`, endet die Klaerung bei `unresolved`.
|
|
61
92
|
*
|
|
62
93
|
* ## [cancel] ist die Ausnahme, in beiden Richtungen
|
|
63
94
|
*
|
|
@@ -113,10 +144,29 @@ import type { HpsPaymentResult } from './outcome.js';
|
|
|
113
144
|
*
|
|
114
145
|
* Fuer einen Teil dieser Codes -- der Host hat nicht oder nicht brauchbar
|
|
115
146
|
* geantwortet, etwa `9908` -- gibt hobex vor, ein Storno nachzuschicken
|
|
116
|
-
* (`sendReversal`). [pay] tut das genau einmal, mit Kennung
|
|
117
|
-
*
|
|
118
|
-
*
|
|
119
|
-
*
|
|
147
|
+
* (`sendReversal`). [pay] tut das genau einmal, mit der Kennung der Zahlung
|
|
148
|
+
* und dem Betrag, den das Terminal belastet: Betrag UND Trinkgeld (wie die
|
|
149
|
+
* Rueckbuchung der Web-Kasse). Danach laeuft immer die Statusabfrage:
|
|
150
|
+
*
|
|
151
|
+
* - `9011` (aufgehoben) -> `declined`, die einzige Stelle, an der nach einem
|
|
152
|
+
* Storno ein Ausgang feststeht: mit `'voidedAfterHostFault'`, wenn das
|
|
153
|
+
* Storno gewirkt haben kann, sonst mit `'canceled'` -- dann hat etwas
|
|
154
|
+
* anderes die Zahlung aufgehoben.
|
|
155
|
+
* - Ist das Storno nicht sicher abgewiesen ([StornoAusgang]: quittiert mit
|
|
156
|
+
* `'0'`, abgerissen, ohne Code, mit einem unbekannten oder einem
|
|
157
|
+
* Storniert-Code wie `8009`), ist auch `'0'` in der Statusabfrage keine
|
|
158
|
+
* Aussage: das Storno kann noch unterwegs sein, oder es hat nicht
|
|
159
|
+
* gegriffen. Sie zaehlt dann wie `9027` als "nichts Neues", und nach zwei
|
|
160
|
+
* solchen Antworten endet die Klaerung als `unresolved`.
|
|
161
|
+
* - Nur wenn das Storno nach einer ausdruecklichen Positivliste NICHT
|
|
162
|
+
* ausgefuehrt wurde (nicht gesendet, nicht angenommen, abgewiesen -- siehe
|
|
163
|
+
* [stornoAbgewiesen]), ist `'0'` in der Statusabfrage `approved`. Gemessen
|
|
164
|
+
* ist davon nur `9002` auf eine unbekannte Kennung (27.08.2026); die
|
|
165
|
+
* uebrigen Eintraege stuetzen sich auf die Codeliste von hobex und TECS.
|
|
166
|
+
*
|
|
167
|
+
* Die Quittung `'0'` auf das Storno allein beweist nichts -- dieselbe Lehre
|
|
168
|
+
* wie beim Abbruch (10.11.2026). Am Geraet ungemessen sind das Storno nach
|
|
169
|
+
* einer Host-Stoerung und der Stornobetrag mit Trinkgeld, siehe
|
|
120
170
|
* Dart-Zwilling. [refund] schickt kein Storno nach (TECS: `9031`), [cancel]
|
|
121
171
|
* ist selbst eines.
|
|
122
172
|
*/
|