@kreiseck/kasseneck-api 1.35.0 → 1.36.0
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 +31 -9
- package/dist/cjs/client/api.d.ts +15 -1
- package/dist/cjs/client/api.js +4 -0
- package/dist/cjs/client/aufrufe.d.ts +2 -2
- package/dist/cjs/client/aufrufe.js +10 -0
- package/dist/cjs/client/auth.d.ts +9 -3
- package/dist/cjs/client/auth.js +5 -4
- package/dist/cjs/client/ewp.d.ts +125 -0
- package/dist/cjs/client/ewp.js +95 -0
- package/dist/cjs/client/index.d.ts +1 -0
- package/dist/cjs/client/index.js +4 -1
- package/dist/cjs/client/list-deposit-types.d.ts +3 -0
- package/dist/cjs/client/list-deposit-types.js +3 -0
- package/dist/cjs/client/receipts.d.ts +3 -3
- package/dist/cjs/index.d.ts +1 -1
- package/dist/cjs/index.js +4 -2
- package/dist/cjs/invoice/index.d.ts +2 -2
- package/dist/cjs/invoice/index.js +2 -1
- package/dist/cjs/invoice/texte.d.ts +5 -0
- package/dist/cjs/invoice/texte.js +10 -0
- package/dist/cjs/invoice/typen.d.ts +34 -1
- package/dist/cjs/invoice/vertrag.d.ts +13 -4
- package/dist/cjs/invoice/vertrag.js +29 -6
- 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/receipt/layout.js +1 -1
- package/dist/cjs/stored/vokabular.d.ts +1 -1
- package/dist/cjs/stored/vokabular.js +1 -1
- package/dist/cjs/version.d.ts +1 -1
- package/dist/cjs/version.js +1 -1
- package/dist/esm/client/api.d.ts +15 -1
- package/dist/esm/client/api.js +4 -0
- package/dist/esm/client/aufrufe.d.ts +2 -2
- package/dist/esm/client/aufrufe.js +10 -0
- package/dist/esm/client/auth.d.ts +9 -3
- package/dist/esm/client/auth.js +5 -4
- package/dist/esm/client/ewp.d.ts +125 -0
- package/dist/esm/client/ewp.js +89 -0
- package/dist/esm/client/index.d.ts +1 -0
- package/dist/esm/client/index.js +1 -0
- package/dist/esm/client/list-deposit-types.d.ts +3 -0
- package/dist/esm/client/list-deposit-types.js +3 -0
- package/dist/esm/client/receipts.d.ts +3 -3
- package/dist/esm/index.d.ts +1 -1
- package/dist/esm/index.js +1 -1
- package/dist/esm/invoice/index.d.ts +2 -2
- package/dist/esm/invoice/index.js +1 -1
- package/dist/esm/invoice/texte.d.ts +5 -0
- package/dist/esm/invoice/texte.js +10 -0
- package/dist/esm/invoice/typen.d.ts +34 -1
- package/dist/esm/invoice/vertrag.d.ts +13 -4
- package/dist/esm/invoice/vertrag.js +28 -5
- 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/receipt/layout.js +1 -1
- package/dist/esm/stored/vokabular.d.ts +1 -1
- package/dist/esm/stored/vokabular.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-examples/issue-error-deposit.json +39 -0
- package/fixtures/invoice-api-examples/issue-invoice-deposit.json +55 -0
- package/fixtures/invoice-api.schema.json +65 -2
- package/fixtures/invoice-texts.json +11 -1
- package/fixtures/manifest.json +1 -1
- package/fixtures/pos-texts.json +1 -1
- package/fixtures/receipts/card-hobex-hps.json +1 -1
- package/fixtures/surface.json +13 -4
- package/fixtures/v3/antworten/belege.json +1 -1
- package/fixtures/v3/antworten/belegmail.json +1 -1
- package/fixtures/v3/antworten/berichte.json +1 -1
- package/fixtures/v3/antworten/kasse-belege.json +1 -1
- package/fixtures/v3/antworten/kasse.json +2 -2
- package/fixtures/v3/antworten/lager.json +1 -1
- package/fixtures/v3/antworten/rechnungen.json +1 -1
- package/fixtures/v3/antworten/storno.json +1 -1
- package/fixtures/v3/stored/belege.json +1 -1
- package/fixtures/v3/stored/kasse.json +2 -2
- package/fixtures/v3/stored/rechnungen.json +1 -1
- package/fixtures/v3/v3-vokabular.json +358 -5
- package/fixtures/v3/zahlbetrag-faelle.json +1 -1
- package/package.json +1 -1
|
@@ -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
|
*/
|
|
@@ -11,6 +11,39 @@ const ABORT_BUDGET_DIVISOR = 6;
|
|
|
11
11
|
* Vorgabe 30 s. Ein Storno geht ueber den Host und darf Sekunden brauchen.
|
|
12
12
|
*/
|
|
13
13
|
const REVERSAL_BUDGET_DIVISOR = 3;
|
|
14
|
+
/**
|
|
15
|
+
* Gruende, die ein Storno als NICHT ausgefuehrt ausweisen -- Teil der
|
|
16
|
+
* Positivliste in [stornoAbgewiesen], jeder Eintrag einzeln begruendet:
|
|
17
|
+
* - `cancelDenied` (`9023` "Cancel Denied, TX already cleared", `9222`
|
|
18
|
+
* "Offline Tx Cancellation Denied"): TECS lehnt genau diese Aufhebung ab.
|
|
19
|
+
* - `amountInvalid` (`9003`, `100019` gemessen an Zahlungen, `9012`, `9026`,
|
|
20
|
+
* `13`, `64`, `87`, `3031` dokumentiert): der Vorgang ueber diesen Betrag
|
|
21
|
+
* wird abgewiesen und nicht ausgefuehrt.
|
|
22
|
+
*/
|
|
23
|
+
const STORNO_ABGEWIESEN_GRUENDE = new Set(['cancelDenied', 'amountInvalid']);
|
|
24
|
+
/**
|
|
25
|
+
* `true` nur, wenn die Antwort auf das Storno nach einer AUSDRUECKLICHEN
|
|
26
|
+
* Positivliste sagt, dass es nicht ausgefuehrt wurde:
|
|
27
|
+
*
|
|
28
|
+
* - jeder schluessige Code mit `rejectsRequest` -- die Anfrage selbst wurde
|
|
29
|
+
* abgewiesen (Form, TID, Vorgangstyp, Geraetezustand, `100998`/`8014`
|
|
30
|
+
* "beschaeftigt"), bevor etwas geschah. Gemessen ist davon `9002` "Invalid
|
|
31
|
+
* Transaction" auf eine unbekannte Kennung (27.08.2026); die uebrigen stehen
|
|
32
|
+
* so in der Codeliste von hobex bzw. TECS.
|
|
33
|
+
* - jeder Code mit einem Grund aus [STORNO_ABGEWIESEN_GRUENDE].
|
|
34
|
+
*
|
|
35
|
+
* Alles andere kann gewirkt haben, ausdruecklich auch ein Code, der selbst
|
|
36
|
+
* "storniert" oder "aufgehoben" heisst (`8009` "Technical cancellation",
|
|
37
|
+
* `100029`, `3053`-`3063` "Reversed internally", `9032` "reversed
|
|
38
|
+
* automatically", `9011`), ein Abbruch-Code (`100002`, `17`, `8004`), eine
|
|
39
|
+
* Host-Ablehnung (etwa `05`) und jeder unbekannte Code.
|
|
40
|
+
*/
|
|
41
|
+
function stornoAbgewiesen(res) {
|
|
42
|
+
const info = (0, transaction_response_js_1.hpsCodeInfo)(res.responseCode);
|
|
43
|
+
if (info === undefined || !info.conclusive || info.code === transaction_response_js_1.APPROVED_CODE)
|
|
44
|
+
return false;
|
|
45
|
+
return info.rejectsRequest || STORNO_ABGEWIESEN_GRUENDE.has(info.reason);
|
|
46
|
+
}
|
|
14
47
|
function createHpsPayments(client, target, options = {}) {
|
|
15
48
|
const resolveBudgetMs = options.resolveBudgetMs ?? 90_000;
|
|
16
49
|
const maxBackoffMs = options.maxBackoffMs ?? 10_000;
|
|
@@ -321,9 +354,10 @@ function createHpsPayments(client, target, options = {}) {
|
|
|
321
354
|
return doubled > maxBackoffMs ? maxBackoffMs : doubled;
|
|
322
355
|
}
|
|
323
356
|
/**
|
|
324
|
-
*
|
|
325
|
-
*
|
|
326
|
-
*
|
|
357
|
+
* Schickt den Abbruch GENAU EINMAL und haelt im Nachweis fest, was das
|
|
358
|
+
* Terminal darauf sagt. Entscheidet NIE ueber den Ausgang -- auch nicht mit
|
|
359
|
+
* `'0'`, siehe Klassendoku, "Ein quittierter Abbruch ist keine Aussage". Der
|
|
360
|
+
* Aufrufer fragt danach immer den Status ab.
|
|
327
361
|
*/
|
|
328
362
|
async function tryAbort(id, steps, elapsedMs) {
|
|
329
363
|
let res;
|
|
@@ -338,32 +372,42 @@ function createHpsPayments(client, target, options = {}) {
|
|
|
338
372
|
+ 'oder den Abbruch-Endpunkt nicht; beides sagt nichts ueber die Zahlung, Ausgang wird abgefragt'
|
|
339
373
|
: `Abbruch nicht bestaetigt (${describe(e)}) -- ob er wirkte, ist offen, Ausgang wird abgefragt`);
|
|
340
374
|
noteUnexpected(e, id);
|
|
341
|
-
return
|
|
375
|
+
return;
|
|
342
376
|
}
|
|
377
|
+
steps.push(abbruchQuittung(res));
|
|
378
|
+
}
|
|
379
|
+
/** Nachweistext zur Antwort auf den Abbruch -- keiner davon schliesst auf den Ausgang. */
|
|
380
|
+
function abbruchQuittung(res) {
|
|
343
381
|
if (res.responseCode === undefined) {
|
|
344
|
-
|
|
345
|
-
return null;
|
|
382
|
+
return 'Abbruch ohne Ergebniscode quittiert -- das beweist nichts, Ausgang wird abgefragt';
|
|
346
383
|
}
|
|
347
|
-
if (
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
: `Abbruch abgelehnt (${res.responseCode}) -- Grund unbekannt, Ausgang wird abgefragt`);
|
|
351
|
-
return null;
|
|
384
|
+
if ((0, transaction_response_js_1.isApproved)(res)) {
|
|
385
|
+
return `Abbruch angenommen (${transaction_response_js_1.APPROVED_CODE}) -- das sagt nicht, ob belastet wurde (am 10.11.2026 `
|
|
386
|
+
+ 'endete eine Zahlung nach angenommenem Abbruch genehmigt), Ausgang wird abgefragt';
|
|
352
387
|
}
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
388
|
+
if ((0, transaction_response_js_1.isNotAbortable)(res)) {
|
|
389
|
+
return `Abbruch abgelehnt (${transaction_response_js_1.NOT_ABORTABLE_CODE}) -- der Vorgang ist nicht mehr abbrechbar, Ausgang wird abgefragt`;
|
|
390
|
+
}
|
|
391
|
+
return `Abbruch abgelehnt (${res.responseCode}) -- Grund unbekannt, Ausgang wird abgefragt`;
|
|
356
392
|
}
|
|
357
393
|
/**
|
|
358
394
|
* Schickt zu einer Zahlung, deren Host-Antwort ausblieb ([anlass] traegt
|
|
359
|
-
* `sendReversal`), GENAU EINMAL ein Storno
|
|
360
|
-
*
|
|
361
|
-
*
|
|
395
|
+
* `sendReversal`), GENAU EINMAL ein Storno ueber [amountCents] nach
|
|
396
|
+
* (Betrag samt Trinkgeld) und haelt im Nachweis fest, was das Terminal
|
|
397
|
+
* darauf sagt. Entscheidet NIE ueber den Ausgang, siehe Klassendoku,
|
|
398
|
+
* "Storno nach ausbleibender Host-Antwort".
|
|
399
|
+
*
|
|
400
|
+
* Liefert, was das Storno bewirkt haben kann ([StornoAusgang]).
|
|
401
|
+
* `nichtGesendet` bei einem [HpsPreflightError]: Connect hat es vor jedem
|
|
402
|
+
* Terminal-Kontakt abgewiesen, beweisbar ist nichts hinausgegangen (siehe
|
|
403
|
+
* `errors.ts`). `abgewiesen` bei HTTP 409: das Terminal nimmt waehrend
|
|
404
|
+
* eines anderen Vorgangs keine Anfrage an (gemessen, ohne Spur; dieselbe
|
|
405
|
+
* Lesart wie fuer die erzeugende Anfrage in [fromTerminalBusy]).
|
|
362
406
|
*/
|
|
363
407
|
async function sendReversal(id, steps, elapsedMs, amountCents, anlass) {
|
|
364
408
|
if (amountCents === undefined) {
|
|
365
409
|
steps.push('Kein Storno nachgeschickt -- die Aufhebung einer Gutschrift laesst TECS nicht zu');
|
|
366
|
-
return
|
|
410
|
+
return 'nichtGesendet';
|
|
367
411
|
}
|
|
368
412
|
emit('resolving', `Storno wird nachgeschickt (${anlass.responseCode})`, id);
|
|
369
413
|
let res;
|
|
@@ -371,19 +415,33 @@ function createHpsPayments(client, target, options = {}) {
|
|
|
371
415
|
res = await withinBudget(elapsedMs, () => client.cancel({ ...target, transactionId: id, amountCents }), reversalBudgetMs);
|
|
372
416
|
}
|
|
373
417
|
catch (e) {
|
|
418
|
+
if (e instanceof errors_js_1.HpsPreflightError) {
|
|
419
|
+
steps.push(`Storno nicht gesendet (${describe(e)}) -- Kasseneck Connect hat es vor dem Terminal abgewiesen, `
|
|
420
|
+
+ 'es kann nicht gewirkt haben, Ausgang wird abgefragt');
|
|
421
|
+
return 'nichtGesendet';
|
|
422
|
+
}
|
|
423
|
+
if (e instanceof errors_js_1.HpsConnectTerminalError && e.isTerminalBusy) {
|
|
424
|
+
steps.push('Storno nicht angenommen (HTTP 409) -- das Terminal war beschaeftigt, es kann nicht gewirkt haben, '
|
|
425
|
+
+ 'Ausgang wird abgefragt');
|
|
426
|
+
return 'abgewiesen';
|
|
427
|
+
}
|
|
374
428
|
steps.push(`Storno nachgeschickt, aber nicht bestaetigt (${describe(e)}) -- ob es wirkte, ist offen, Ausgang wird abgefragt`);
|
|
375
429
|
noteUnexpected(e, id);
|
|
376
|
-
return
|
|
430
|
+
return 'kannGewirkt';
|
|
377
431
|
}
|
|
378
|
-
if (
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
return null;
|
|
432
|
+
if ((0, transaction_response_js_1.isApproved)(res)) {
|
|
433
|
+
steps.push(`Storno nachgeschickt und quittiert (${transaction_response_js_1.APPROVED_CODE}) -- das allein beweist nicht, dass die Zahlung `
|
|
434
|
+
+ 'aufgehoben ist, Ausgang wird abgefragt');
|
|
435
|
+
return 'kannGewirkt';
|
|
383
436
|
}
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
437
|
+
const titel = (0, transaction_response_js_1.hpsCodeInfo)(res.responseCode)?.title;
|
|
438
|
+
const code = `${res.responseCode ?? 'ohne Ergebniscode'}${titel === undefined ? '' : ` "${titel}"`}`;
|
|
439
|
+
if (stornoAbgewiesen(res)) {
|
|
440
|
+
steps.push(`Storno abgewiesen (${code}) -- es wurde nicht ausgefuehrt, Ausgang wird abgefragt`);
|
|
441
|
+
return 'abgewiesen';
|
|
442
|
+
}
|
|
443
|
+
steps.push(`Storno nachgeschickt, nicht bestaetigt (${code}) -- ob es wirkte, ist offen, Ausgang wird abgefragt`);
|
|
444
|
+
return 'kannGewirkt';
|
|
387
445
|
}
|
|
388
446
|
/**
|
|
389
447
|
* Klaert einen offenen Ausgang: erst abbrechen, dann abfragen -- bis das
|
|
@@ -396,6 +454,10 @@ function createHpsPayments(client, target, options = {}) {
|
|
|
396
454
|
* [ausGeschlossenerAntwort]. Meldet sie eine Stoerung beim Host
|
|
397
455
|
* ([isHostUncertain]), bekommt `9027` diesen Aussagewert gerade NICHT --
|
|
398
456
|
* siehe Klassendoku, "Stoerung beim Host".
|
|
457
|
+
*
|
|
458
|
+
* [stornoCents] ist, was ein nachgeschicktes Storno aufheben muss: Betrag
|
|
459
|
+
* samt Trinkgeld der Zahlung. Nur [pay] setzt ihn; ohne ihn wird kein
|
|
460
|
+
* Storno gesendet.
|
|
399
461
|
*/
|
|
400
462
|
async function resolve(id, steps, antwort, stornoCents) {
|
|
401
463
|
emit('resolving', 'Ausgang offen, Klaerung laeuft', id);
|
|
@@ -406,25 +468,26 @@ function createHpsPayments(client, target, options = {}) {
|
|
|
406
468
|
// Statusabfrage sie nennt und danach 9027 kommt.
|
|
407
469
|
let stoerungsAntwort = antwort && (0, transaction_response_js_1.isHostUncertain)(antwort) ? antwort : undefined;
|
|
408
470
|
let letzteAntwort = antwort;
|
|
409
|
-
// Das Storno wird hoechstens einmal erwogen;
|
|
471
|
+
// Das Storno wird hoechstens einmal erwogen; versucht wird es nur mit
|
|
472
|
+
// Betrag, also nur fuer eine Zahlung.
|
|
410
473
|
let stornoErwogen = false;
|
|
411
|
-
let
|
|
474
|
+
let stornoVersucht = false;
|
|
475
|
+
// Was das Storno bewirkt haben kann; `kannGewirkt` nimmt auch einer
|
|
476
|
+
// Genehmigung in der Statusabfrage die Aussage.
|
|
477
|
+
let storno;
|
|
412
478
|
if (stoerungsAntwort === undefined) {
|
|
413
|
-
|
|
414
|
-
|
|
415
|
-
return aborted;
|
|
479
|
+
// Entscheidet nichts, beendet nur einen noch wartenden Kartenfluss.
|
|
480
|
+
await tryAbort(id, steps, elapsedMs);
|
|
416
481
|
}
|
|
417
482
|
else {
|
|
418
483
|
// Der Vorgang ist am Terminal schon beendet -- mit einer Stoerung beim
|
|
419
|
-
// Host.
|
|
420
|
-
//
|
|
484
|
+
// Host. Es gibt nichts mehr abzubrechen, und eine Quittung saehe
|
|
485
|
+
// ohnehin nur das Terminal, nicht den Host.
|
|
421
486
|
steps.push('Kein Abbruchversuch -- das Terminal hat den Vorgang mit einer Stoerung beim hobex-Host beendet');
|
|
422
487
|
if ((0, transaction_response_js_1.needsReversal)(stoerungsAntwort)) {
|
|
423
488
|
stornoErwogen = true;
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
if (storniert)
|
|
427
|
-
return storniert;
|
|
489
|
+
stornoVersucht = stornoCents !== undefined;
|
|
490
|
+
storno = await sendReversal(id, steps, elapsedMs, stornoCents, stoerungsAntwort);
|
|
428
491
|
}
|
|
429
492
|
}
|
|
430
493
|
let wait = 0;
|
|
@@ -460,30 +523,46 @@ function createHpsPayments(client, target, options = {}) {
|
|
|
460
523
|
if ((0, transaction_response_js_1.isHostUncertain)(status))
|
|
461
524
|
stoerungsAntwort ??= status;
|
|
462
525
|
const hostUngewiss = stoerungsAntwort !== undefined;
|
|
463
|
-
if (
|
|
464
|
-
|
|
465
|
-
|
|
526
|
+
if (stornoVersucht && (0, transaction_response_js_1.isCanceled)(status)) {
|
|
527
|
+
// Aufgehoben ist aufgehoben. Wer es war, behauptet der Nachweis nur so
|
|
528
|
+
// weit, wie es feststeht: hat das Storno nachweislich nicht gewirkt,
|
|
529
|
+
// war es ein anderer Vorgang, und der Grund ist `canceled`.
|
|
530
|
+
const durchsStorno = storno === 'kannGewirkt';
|
|
531
|
+
steps.push(durchsStorno
|
|
532
|
+
? `Status: Zahlung aufgehoben (${transaction_response_js_1.TRANSACTION_CANCELED_CODE}) nach dem nachgeschickten Storno -- `
|
|
533
|
+
+ 'es ist nichts belastet'
|
|
534
|
+
: `Status: Zahlung aufgehoben (${transaction_response_js_1.TRANSACTION_CANCELED_CODE}), obwohl das nachgeschickte Storno nicht `
|
|
535
|
+
+ 'ausgefuehrt wurde -- es ist nichts belastet');
|
|
466
536
|
emit('resolved', steps[steps.length - 1], id);
|
|
467
|
-
return {
|
|
537
|
+
return {
|
|
538
|
+
outcome: 'declined',
|
|
539
|
+
transactionId: id,
|
|
540
|
+
response: status,
|
|
541
|
+
reason: durchsStorno ? 'voidedAfterHostFault' : 'canceled',
|
|
542
|
+
steps: [...steps],
|
|
543
|
+
};
|
|
468
544
|
}
|
|
469
545
|
if (!stornoErwogen && (0, transaction_response_js_1.needsReversal)(status)) {
|
|
470
546
|
// Die Zahlung selbst kam ohne Antwort zurueck, erst die Statusabfrage
|
|
471
547
|
// nennt die ausgebliebene Host-Antwort -- dasselbe Storno wie oben.
|
|
472
548
|
steps.push(statusOhneErgebnis(status));
|
|
473
549
|
stornoErwogen = true;
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
if (storniert)
|
|
477
|
-
return storniert;
|
|
550
|
+
stornoVersucht = stornoCents !== undefined;
|
|
551
|
+
storno = await sendReversal(id, steps, elapsedMs, stornoCents, status);
|
|
478
552
|
wait = nextWait(wait);
|
|
479
553
|
continue;
|
|
480
554
|
}
|
|
555
|
+
// Nach einem Storno, das gewirkt haben kann, sagt auch '0' nichts: das
|
|
556
|
+
// Storno kann noch unterwegs sein oder nicht gegriffen haben. Es zaehlt
|
|
557
|
+
// unten als "nichts Neues" -- siehe Klassendoku, "Storno nach
|
|
558
|
+
// ausbleibender Host-Antwort".
|
|
559
|
+
const genehmigtTrotzStorno = storno === 'kannGewirkt' && (0, transaction_response_js_1.isApproved)(status);
|
|
481
560
|
// Auf die Statusabfrage entscheidet nur ein Code, der den gesuchten
|
|
482
561
|
// Vorgang beschreibt -- nicht einer, der diese Abfrage abweist
|
|
483
562
|
// ([isConclusiveAsStatus]). Nach einer Stoerung beim Host entscheidet nur
|
|
484
563
|
// noch eine Genehmigung: jede andere Aussage des Terminals betrifft seinen
|
|
485
564
|
// Speicher, nicht den des Hosts.
|
|
486
|
-
if (hostUngewiss ? (0, transaction_response_js_1.isApproved)(status) : (0, transaction_response_js_1.isConclusiveAsStatus)(status)) {
|
|
565
|
+
if (!genehmigtTrotzStorno && (hostUngewiss ? (0, transaction_response_js_1.isApproved)(status) : (0, transaction_response_js_1.isConclusiveAsStatus)(status))) {
|
|
487
566
|
const settled = fromResponse(status, id, steps);
|
|
488
567
|
if (settled)
|
|
489
568
|
return settled;
|
|
@@ -500,9 +579,12 @@ function createHpsPayments(client, target, options = {}) {
|
|
|
500
579
|
ohneAuskunft = 0;
|
|
501
580
|
}
|
|
502
581
|
// Nach einer Stoerung ist jede Antwort ausser '0' (die oben schon
|
|
503
|
-
// entschieden hat) "nichts Neues".
|
|
582
|
+
// entschieden hat) "nichts Neues" -- nach einem Storno auch '0'.
|
|
504
583
|
stoerungOhneNeues = hostUngewiss ? stoerungOhneNeues + 1 : 0;
|
|
505
|
-
steps.push(
|
|
584
|
+
steps.push(genehmigtTrotzStorno
|
|
585
|
+
? `Status: Zahlung steht unveraendert (${transaction_response_js_1.APPROVED_CODE}) -- das nachgeschickte Storno kann noch `
|
|
586
|
+
+ 'unterwegs sein oder nicht gegriffen haben, keine Aussage'
|
|
587
|
+
: statusOhneErgebnis(status) ?? 'Status: noch kein Ergebniscode');
|
|
506
588
|
if (stoerungOhneNeues >= 2) {
|
|
507
589
|
// Siehe Klassendoku, "Stoerung beim Host": das Terminal weiss es
|
|
508
590
|
// nicht, und es wird es auch nicht wissen, wenn wir weiterfragen.
|
|
@@ -528,7 +610,7 @@ function createHpsPayments(client, target, options = {}) {
|
|
|
528
610
|
* wurde uns gerade geantwortet. Uebrig bleibt "beendet und nicht genehmigt".
|
|
529
611
|
*
|
|
530
612
|
* **Gegenprobe** (28.08.2026, TID 3600335, jeweils nach abgeschlossenem
|
|
531
|
-
* Vorgang): genehmigt
|
|
613
|
+
* Vorgang): genehmigt -> Statusabfrage `0`, dreimal
|
|
532
614
|
* wiederholt; abgelehnt mit `100003` -> `9027`, zweimal; abgelehnt mit
|
|
533
615
|
* `9003` -> `9027`. Eine genehmigte Zahlung antwortet also nicht `9027`.
|
|
534
616
|
*
|
|
@@ -679,7 +761,8 @@ function createHpsPayments(client, target, options = {}) {
|
|
|
679
761
|
return settled;
|
|
680
762
|
steps.push(offeneAntwort(res));
|
|
681
763
|
}
|
|
682
|
-
|
|
764
|
+
// Ein Storno hebt auf, was das Terminal belastet hat: Betrag UND Trinkgeld.
|
|
765
|
+
return resolve(id, steps, res, paymentOptions.amountCents + (paymentOptions.tipCents ?? 0));
|
|
683
766
|
}
|
|
684
767
|
/**
|
|
685
768
|
* Gutschrift mit geklaertem Ausgang -- EXAKT derselbe Klaerweg wie [pay]
|
|
@@ -721,8 +804,9 @@ function createHpsPayments(client, target, options = {}) {
|
|
|
721
804
|
steps.push(offeneAntwort(res));
|
|
722
805
|
}
|
|
723
806
|
// Dieselbe Klaerfunktion wie [pay]: die Kennung ist die des NEUEN
|
|
724
|
-
// Vorgangs, eine Statusabfrage darauf liefert also genau dessen Ausgang
|
|
725
|
-
//
|
|
807
|
+
// Vorgangs, eine Statusabfrage darauf liefert also genau dessen Ausgang.
|
|
808
|
+
// Der Abbruch entscheidet hier so wenig wie bei einer Zahlung, und ohne
|
|
809
|
+
// Betrag schickt die Klaerung kein Storno nach.
|
|
726
810
|
return resolve(id, steps, res);
|
|
727
811
|
}
|
|
728
812
|
/**
|
|
@@ -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);
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
|
|
2
|
-
export declare const VOKABULAR_QUELLE = "
|
|
2
|
+
export declare const VOKABULAR_QUELLE = "3c10f47f66f048d8b25adb8996414674261ec8eb4c55f82a1d2a239be13d289f";
|
|
3
3
|
/** Schema-Notation des Vertrags: Blatt 'aussen': 'innen', Objekt { __: 'innen', ... }, Liste [ { __: 'innen', ... } ]. */
|
|
4
4
|
export type SchemaEintrag = string | SchemaObjekt | readonly [SchemaObjekt];
|
|
5
5
|
export interface SchemaObjekt {
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
5
5
|
exports.ZUSATZ_KATALOGE = exports.KATALOGE = exports.ARTIKEL_FELDER = exports.SCHEMAS = exports.VOKABULAR_QUELLE = void 0;
|
|
6
6
|
/** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
|
|
7
|
-
exports.VOKABULAR_QUELLE = "
|
|
7
|
+
exports.VOKABULAR_QUELLE = "3c10f47f66f048d8b25adb8996414674261ec8eb4c55f82a1d2a239be13d289f";
|
|
8
8
|
/** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
|
|
9
9
|
exports.SCHEMAS = {
|
|
10
10
|
"getReceipt": {
|
package/dist/cjs/version.d.ts
CHANGED
package/dist/cjs/version.js
CHANGED
package/dist/esm/client/api.d.ts
CHANGED
|
@@ -6,6 +6,7 @@ import { type CashregisterReportPeriod, type ReportV2, type ReportV2Options } fr
|
|
|
6
6
|
import { type CashboxStatus, type SignatureStatus } from './status.js';
|
|
7
7
|
import { type CreateDepExportOptions, type CreateDepExportResult, type DepExport, type DepExportFile, type DepHandoverLink, type GetDepExportFileOptions, type RevokedDepHandoverLink, type WaitForDepExportOptions } from './dep-export.js';
|
|
8
8
|
import { type ClaimTerminalOptions, type GetTerminalAccessOptions, type RegisteredTerminalDevice, type RegisterTerminalDeviceOptions, type ReportTerminalLoginOptions, type RequestTerminalCodeOptions, type TerminalAccess, type TerminalAccessResult, type TerminalCode, type TerminalCodeRequest, type TerminalDeviceCredentials } from './terminal.js';
|
|
9
|
+
import { type EwpExtraQuantityInput, type EwpReport, type EwpReportFile } from './ewp.js';
|
|
9
10
|
import type { DepositSettings } from '../pos/pfand.js';
|
|
10
11
|
import { type ListedReceipt, type ListReceiptsOptions, type ListReceiptsPage, type ListReceiptsView } from './list-receipts.js';
|
|
11
12
|
import { type SendReceiptEmailOptions, type SendReceiptEmailResult, type LogReceiptOutputsOptions, type LogReceiptOutputsResult, type ListMyReceiptsOptions, type ReceiptList, type ReceiptWithCompany, type SellReceiptOptions, type CancelReceiptOptions, type CancelReceiptResult } from './receipts.js';
|
|
@@ -64,8 +65,21 @@ export interface KasseneckApi {
|
|
|
64
65
|
listReceipts<V extends ListReceiptsView = 'summary'>(options: ListReceiptsOptions<V>): Promise<ListReceiptsPage<V>>;
|
|
65
66
|
/** Alle Belege eines Tages oder Zeitraums, Seite fuer Seite geholt (hoechstens 100 Seiten). */
|
|
66
67
|
listAllReceipts<V extends ListReceiptsView = 'summary'>(options: ListReceiptsOptions<V>): AsyncGenerator<ListedReceipt<V>, void, undefined>;
|
|
67
|
-
/** Pfandarten des Betriebs (`listDepositTypes`, nur /v3
|
|
68
|
+
/** Pfandarten des Betriebs (`listDepositTypes`, nur /v3; braucht kein Kassen-Token); `null` = Pfand aus, dann keine Pfandzeilen senden. */
|
|
68
69
|
listDepositTypes(): Promise<DepositSettings | null>;
|
|
70
|
+
/** EWP-Meldung eines Monats (`getEwpReport`, nur /v3, Abfueller-Betrieb, ohne Kassen-Token): Zeilen je GTIN, Warnungen, Zusatzmengen. */
|
|
71
|
+
getEwpReport(options: {
|
|
72
|
+
month: string;
|
|
73
|
+
}): Promise<EwpReport>;
|
|
74
|
+
/** CSV der EWP-Meldung eines Monats (`getEwpReport` mit `format: 'csv'`); ein abgeschlossener Monat gilt danach als heruntergeladen. */
|
|
75
|
+
downloadEwpReport(options: {
|
|
76
|
+
month: string;
|
|
77
|
+
}): Promise<EwpReportFile>;
|
|
78
|
+
/** Zusatzmengen eines Monats ersetzen (`setEwpExtraQuantities`); eine leere Liste leert sie. Antwort ist die neue Meldung. */
|
|
79
|
+
setEwpExtraQuantities(options: {
|
|
80
|
+
month: string;
|
|
81
|
+
extraQuantities: EwpExtraQuantityInput[];
|
|
82
|
+
}): Promise<EwpReport>;
|
|
69
83
|
/** DEP-Export fuer die Kassennachschau einstellen (`createDepExport`, nur /v3); antwortet sofort, der Export laeuft im Hintergrund. */
|
|
70
84
|
createDepExport(options?: CreateDepExportOptions): Promise<CreateDepExportResult>;
|
|
71
85
|
/** Zustand, Kennzahlen, Befund und Pruefer-Links eines Exports (`getDepExport`). */
|
package/dist/esm/client/api.js
CHANGED
|
@@ -6,6 +6,7 @@ import { getCashboxStatus, getSignatureStatus } from './status.js';
|
|
|
6
6
|
import { createDepExport, createDepHandoverLink, getDepExport, getDepExportFile, revokeDepHandoverLink, waitForDepExport, } from './dep-export.js';
|
|
7
7
|
import { claimTerminal, getTerminalAccess, getTerminalCode, registerTerminalDevice, reportTerminalLogin, reportTerminalReady, requestTerminalCode, } from './terminal.js';
|
|
8
8
|
import { listDepositTypes } from './list-deposit-types.js';
|
|
9
|
+
import { downloadEwpReport, getEwpReport, setEwpExtraQuantities, } from './ewp.js';
|
|
9
10
|
import { listAllReceipts, listReceipts } from './list-receipts.js';
|
|
10
11
|
import { sellReceipt, sellReceiptWithCompany, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, sendReceiptEmail, logReceiptOutputs, } from './receipts.js';
|
|
11
12
|
import { listMyCashregisters } from './cashregisters.js';
|
|
@@ -43,6 +44,9 @@ export function createKasseneckApi(options) {
|
|
|
43
44
|
listReceipts: (o) => listReceipts(rufen, o),
|
|
44
45
|
listAllReceipts: (o) => listAllReceipts(rufen, o),
|
|
45
46
|
listDepositTypes: () => listDepositTypes(rufen),
|
|
47
|
+
getEwpReport: (o) => getEwpReport(rufen, o),
|
|
48
|
+
downloadEwpReport: (o) => downloadEwpReport(rufen, o),
|
|
49
|
+
setEwpExtraQuantities: (o) => setEwpExtraQuantities(rufen, o),
|
|
46
50
|
createDepExport: (o) => createDepExport(rufen, o),
|
|
47
51
|
getDepExport: (o) => getDepExport(rufen, o),
|
|
48
52
|
waitForDepExport: (o) => waitForDepExport(rufen, o),
|
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
* umhuellt, muss ihn weiterhin absetzen koennen.
|
|
14
14
|
*/
|
|
15
15
|
import type { FileOrData, FileOrDataCallOptions, PdfOrData, TransportBodyFields, TransportCallOptions } from './transport.js';
|
|
16
|
-
export declare const ALL_CALLS: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createDepExport", "createDepHandoverLink", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCashregisterReport", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getDepExport", "getDepExportFile", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "getReportV2", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listBrands", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyStock", "listMyStockLocations", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listReceipts", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "recordInvoicePayment", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "reportCustomerContract", "requestCustomerSignature", "revokeDepHandoverLink", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant", "createStocktake", "listStocktakes", "getStocktake", "listStocktakeItems", "recordStocktakeCount", "voidStocktakeCount", "listStocktakeCounts", "reviewStocktake", "recountStocktake", "closeStocktake", "cancelStocktake", "getStocktakePdf", "orderSignatureCard", "getSignatureCardOrder", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift", "recordMyShiftCount", "logReceiptOutputs", "getRegisterInspectionInfo", "reportConnectState", "learnMyLeergutCode", "listMyLeergutCodes", "registerTerminalDevice", "getTerminalAccess", "claimTerminal", "requestTerminalCode", "getTerminalCode", "reportTerminalLogin", "reportTerminalReady", "unfixTerminal", "listDepositTypes"];
|
|
16
|
+
export declare const ALL_CALLS: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createDepExport", "createDepHandoverLink", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCashregisterReport", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getDepExport", "getDepExportFile", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "getReportV2", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listBrands", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyStock", "listMyStockLocations", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listReceipts", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "recordInvoicePayment", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "reportCustomerContract", "requestCustomerSignature", "revokeDepHandoverLink", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant", "createStocktake", "listStocktakes", "getStocktake", "listStocktakeItems", "recordStocktakeCount", "voidStocktakeCount", "listStocktakeCounts", "reviewStocktake", "recountStocktake", "closeStocktake", "cancelStocktake", "getStocktakePdf", "orderSignatureCard", "getSignatureCardOrder", "listMyStocktakes", "listMyStocktakeItems", "listMyStocktakeCounts", "recordMyStocktakeCount", "voidMyStocktakeCount", "checkVoucher", "reprintVoucherLabel", "getMyDrawerState", "openMyShift", "recordMyCashMovement", "logMyDrawerOpenings", "getMyShiftReport", "closeMyShift", "recordMyShiftCount", "logReceiptOutputs", "getRegisterInspectionInfo", "reportConnectState", "learnMyLeergutCode", "listMyLeergutCodes", "registerTerminalDevice", "getTerminalAccess", "claimTerminal", "requestTerminalCode", "getTerminalCode", "reportTerminalLogin", "reportTerminalReady", "unfixTerminal", "listDepositTypes", "getEwpReport", "setEwpExtraQuantities"];
|
|
17
17
|
export type ApiCall = typeof ALL_CALLS[number];
|
|
18
18
|
/**
|
|
19
19
|
* Die oeffentlichen Endpunkte unter `/v3` (`https://api.kasseneck.at/v3/<name>`),
|
|
@@ -21,7 +21,7 @@ export type ApiCall = typeof ALL_CALLS[number];
|
|
|
21
21
|
* (`fixtures/v3/v3-vokabular.json`, `endpoints.public`, umbenannt nach
|
|
22
22
|
* `names`). Ein Test haelt beide Listen deckungsgleich.
|
|
23
23
|
*/
|
|
24
|
-
export declare const PUBLIC_CALLS: readonly ["createReceipt", "getReceipt", "cancelReceipt", "sendReceiptEmail", "generateFullReceiptId", "downloadReceipt", "getFirstReceiptDate", "getReportV2", "downloadReport", "downloadDailyReport", "getCashregisterReport", "createPaymentLinkStripe", "stripeCaptureIntent", "hobexPayApi", "hobexRefundApi", "hobexGetStatus", "financeWebService", "listMyTipRecipients", "getPartnerInfo", "createPartnerCustomer", "checkPartnerCustomerEmail", "listPartnerCustomers", "getPartnerCustomer", "sendPartnerCustomerFonLink", "createPartnerWebhook", "updatePartnerWebhook", "deletePartnerWebhook", "listPartnerWebhooks", "sendPartnerWebhookTest", "rotatePartnerWebhookSecret", "listPartnerWebhookDeliveries", "requestCustomerSignature", "getCustomerSignatureStatus", "createCustomerCashregister", "activateCashregister", "listCustomerCashregisters", "getCustomerCredentials", "reportCustomerContract", "getPartnerBilling", "getPartnerBillingMonth", "createCustomer", "getCustomer", "updateCustomer", "searchCustomers", "issueInvoice", "cancelInvoice", "createCreditNote", "getInvoice", "listInvoices", "getInvoicePdf", "getInvoiceXml", "getInvoiceSetupStatus", "listBrands", "recordInvoicePayment", "createInvoiceItem", "updateInvoiceItem", "withdrawInvoiceItem", "getInvoiceItem", "listInvoiceItems", "setCustomerMandate", "revokeCustomerMandate", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant", "createStocktake", "listStocktakes", "getStocktake", "listStocktakeItems", "recordStocktakeCount", "voidStocktakeCount", "listStocktakeCounts", "reviewStocktake", "recountStocktake", "closeStocktake", "cancelStocktake", "getStocktakePdf", "orderSignatureCard", "getSignatureCardOrder", "listReceipts", "createDepExport", "getDepExport", "getDepExportFile", "createDepHandoverLink", "revokeDepHandoverLink", "registerTerminalDevice", "getTerminalAccess", "claimTerminal", "requestTerminalCode", "getTerminalCode", "reportTerminalLogin", "reportTerminalReady", "unfixTerminal", "listDepositTypes"];
|
|
24
|
+
export declare const PUBLIC_CALLS: readonly ["createReceipt", "getReceipt", "cancelReceipt", "sendReceiptEmail", "generateFullReceiptId", "downloadReceipt", "getFirstReceiptDate", "getReportV2", "downloadReport", "downloadDailyReport", "getCashregisterReport", "createPaymentLinkStripe", "stripeCaptureIntent", "hobexPayApi", "hobexRefundApi", "hobexGetStatus", "financeWebService", "listMyTipRecipients", "getPartnerInfo", "createPartnerCustomer", "checkPartnerCustomerEmail", "listPartnerCustomers", "getPartnerCustomer", "sendPartnerCustomerFonLink", "createPartnerWebhook", "updatePartnerWebhook", "deletePartnerWebhook", "listPartnerWebhooks", "sendPartnerWebhookTest", "rotatePartnerWebhookSecret", "listPartnerWebhookDeliveries", "requestCustomerSignature", "getCustomerSignatureStatus", "createCustomerCashregister", "activateCashregister", "listCustomerCashregisters", "getCustomerCredentials", "reportCustomerContract", "getPartnerBilling", "getPartnerBillingMonth", "createCustomer", "getCustomer", "updateCustomer", "searchCustomers", "issueInvoice", "cancelInvoice", "createCreditNote", "getInvoice", "listInvoices", "getInvoicePdf", "getInvoiceXml", "getInvoiceSetupStatus", "listBrands", "recordInvoicePayment", "createInvoiceItem", "updateInvoiceItem", "withdrawInvoiceItem", "getInvoiceItem", "listInvoiceItems", "setCustomerMandate", "revokeCustomerMandate", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant", "createStocktake", "listStocktakes", "getStocktake", "listStocktakeItems", "recordStocktakeCount", "voidStocktakeCount", "listStocktakeCounts", "reviewStocktake", "recountStocktake", "closeStocktake", "cancelStocktake", "getStocktakePdf", "orderSignatureCard", "getSignatureCardOrder", "listReceipts", "createDepExport", "getDepExport", "getDepExportFile", "createDepHandoverLink", "revokeDepHandoverLink", "registerTerminalDevice", "getTerminalAccess", "claimTerminal", "requestTerminalCode", "getTerminalCode", "reportTerminalLogin", "reportTerminalReady", "unfixTerminal", "listDepositTypes", "getEwpReport", "setEwpExtraQuantities"];
|
|
25
25
|
/**
|
|
26
26
|
* Die Endpunkte des Kassenwegs (`https://kasse.kasseneck.at/api/v3/<name>`,
|
|
27
27
|
* Web-Kasse: gleicher Ursprung `/api/v3`), in der Reihenfolge von
|