@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
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsPreflightError, } from './errors.js';
|
|
2
2
|
import { newHpsTransactionId } from './transaction-id.js';
|
|
3
|
-
import { hpsCodeInfo, hpsCodeReason, isApproved, isCanceled, isConclusive, isConclusiveAsStatus, isHostUncertain, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, needsReversal, NOT_ABORTABLE_CODE, NOT_FOUND_CODE, TECHNICAL_ERROR_CODE, TRANSACTION_CANCELED_CODE, } from './transaction-response.js';
|
|
3
|
+
import { APPROVED_CODE, hpsCodeInfo, hpsCodeReason, isApproved, isCanceled, isConclusive, isConclusiveAsStatus, isHostUncertain, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, needsReversal, NOT_ABORTABLE_CODE, NOT_FOUND_CODE, TECHNICAL_ERROR_CODE, TRANSACTION_CANCELED_CODE, } from './transaction-response.js';
|
|
4
4
|
/** Teiler, mit dem das Abbruchbudget aus [HpsPaymentsOptions.resolveBudgetMs] entsteht. */
|
|
5
5
|
const ABORT_BUDGET_DIVISOR = 6;
|
|
6
6
|
/**
|
|
@@ -8,6 +8,39 @@ const ABORT_BUDGET_DIVISOR = 6;
|
|
|
8
8
|
* Vorgabe 30 s. Ein Storno geht ueber den Host und darf Sekunden brauchen.
|
|
9
9
|
*/
|
|
10
10
|
const REVERSAL_BUDGET_DIVISOR = 3;
|
|
11
|
+
/**
|
|
12
|
+
* Gruende, die ein Storno als NICHT ausgefuehrt ausweisen -- Teil der
|
|
13
|
+
* Positivliste in [stornoAbgewiesen], jeder Eintrag einzeln begruendet:
|
|
14
|
+
* - `cancelDenied` (`9023` "Cancel Denied, TX already cleared", `9222`
|
|
15
|
+
* "Offline Tx Cancellation Denied"): TECS lehnt genau diese Aufhebung ab.
|
|
16
|
+
* - `amountInvalid` (`9003`, `100019` gemessen an Zahlungen, `9012`, `9026`,
|
|
17
|
+
* `13`, `64`, `87`, `3031` dokumentiert): der Vorgang ueber diesen Betrag
|
|
18
|
+
* wird abgewiesen und nicht ausgefuehrt.
|
|
19
|
+
*/
|
|
20
|
+
const STORNO_ABGEWIESEN_GRUENDE = new Set(['cancelDenied', 'amountInvalid']);
|
|
21
|
+
/**
|
|
22
|
+
* `true` nur, wenn die Antwort auf das Storno nach einer AUSDRUECKLICHEN
|
|
23
|
+
* Positivliste sagt, dass es nicht ausgefuehrt wurde:
|
|
24
|
+
*
|
|
25
|
+
* - jeder schluessige Code mit `rejectsRequest` -- die Anfrage selbst wurde
|
|
26
|
+
* abgewiesen (Form, TID, Vorgangstyp, Geraetezustand, `100998`/`8014`
|
|
27
|
+
* "beschaeftigt"), bevor etwas geschah. Gemessen ist davon `9002` "Invalid
|
|
28
|
+
* Transaction" auf eine unbekannte Kennung (27.08.2026); die uebrigen stehen
|
|
29
|
+
* so in der Codeliste von hobex bzw. TECS.
|
|
30
|
+
* - jeder Code mit einem Grund aus [STORNO_ABGEWIESEN_GRUENDE].
|
|
31
|
+
*
|
|
32
|
+
* Alles andere kann gewirkt haben, ausdruecklich auch ein Code, der selbst
|
|
33
|
+
* "storniert" oder "aufgehoben" heisst (`8009` "Technical cancellation",
|
|
34
|
+
* `100029`, `3053`-`3063` "Reversed internally", `9032` "reversed
|
|
35
|
+
* automatically", `9011`), ein Abbruch-Code (`100002`, `17`, `8004`), eine
|
|
36
|
+
* Host-Ablehnung (etwa `05`) und jeder unbekannte Code.
|
|
37
|
+
*/
|
|
38
|
+
function stornoAbgewiesen(res) {
|
|
39
|
+
const info = hpsCodeInfo(res.responseCode);
|
|
40
|
+
if (info === undefined || !info.conclusive || info.code === APPROVED_CODE)
|
|
41
|
+
return false;
|
|
42
|
+
return info.rejectsRequest || STORNO_ABGEWIESEN_GRUENDE.has(info.reason);
|
|
43
|
+
}
|
|
11
44
|
export function createHpsPayments(client, target, options = {}) {
|
|
12
45
|
const resolveBudgetMs = options.resolveBudgetMs ?? 90_000;
|
|
13
46
|
const maxBackoffMs = options.maxBackoffMs ?? 10_000;
|
|
@@ -318,9 +351,10 @@ export function createHpsPayments(client, target, options = {}) {
|
|
|
318
351
|
return doubled > maxBackoffMs ? maxBackoffMs : doubled;
|
|
319
352
|
}
|
|
320
353
|
/**
|
|
321
|
-
*
|
|
322
|
-
*
|
|
323
|
-
*
|
|
354
|
+
* Schickt den Abbruch GENAU EINMAL und haelt im Nachweis fest, was das
|
|
355
|
+
* Terminal darauf sagt. Entscheidet NIE ueber den Ausgang -- auch nicht mit
|
|
356
|
+
* `'0'`, siehe Klassendoku, "Ein quittierter Abbruch ist keine Aussage". Der
|
|
357
|
+
* Aufrufer fragt danach immer den Status ab.
|
|
324
358
|
*/
|
|
325
359
|
async function tryAbort(id, steps, elapsedMs) {
|
|
326
360
|
let res;
|
|
@@ -335,32 +369,42 @@ export function createHpsPayments(client, target, options = {}) {
|
|
|
335
369
|
+ 'oder den Abbruch-Endpunkt nicht; beides sagt nichts ueber die Zahlung, Ausgang wird abgefragt'
|
|
336
370
|
: `Abbruch nicht bestaetigt (${describe(e)}) -- ob er wirkte, ist offen, Ausgang wird abgefragt`);
|
|
337
371
|
noteUnexpected(e, id);
|
|
338
|
-
return
|
|
372
|
+
return;
|
|
339
373
|
}
|
|
374
|
+
steps.push(abbruchQuittung(res));
|
|
375
|
+
}
|
|
376
|
+
/** Nachweistext zur Antwort auf den Abbruch -- keiner davon schliesst auf den Ausgang. */
|
|
377
|
+
function abbruchQuittung(res) {
|
|
340
378
|
if (res.responseCode === undefined) {
|
|
341
|
-
|
|
342
|
-
return null;
|
|
379
|
+
return 'Abbruch ohne Ergebniscode quittiert -- das beweist nichts, Ausgang wird abgefragt';
|
|
343
380
|
}
|
|
344
|
-
if (res
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
: `Abbruch abgelehnt (${res.responseCode}) -- Grund unbekannt, Ausgang wird abgefragt`);
|
|
348
|
-
return null;
|
|
381
|
+
if (isApproved(res)) {
|
|
382
|
+
return `Abbruch angenommen (${APPROVED_CODE}) -- das sagt nicht, ob belastet wurde (am 10.11.2026 `
|
|
383
|
+
+ 'endete eine Zahlung nach angenommenem Abbruch genehmigt), Ausgang wird abgefragt';
|
|
349
384
|
}
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
385
|
+
if (isNotAbortable(res)) {
|
|
386
|
+
return `Abbruch abgelehnt (${NOT_ABORTABLE_CODE}) -- der Vorgang ist nicht mehr abbrechbar, Ausgang wird abgefragt`;
|
|
387
|
+
}
|
|
388
|
+
return `Abbruch abgelehnt (${res.responseCode}) -- Grund unbekannt, Ausgang wird abgefragt`;
|
|
353
389
|
}
|
|
354
390
|
/**
|
|
355
391
|
* Schickt zu einer Zahlung, deren Host-Antwort ausblieb ([anlass] traegt
|
|
356
|
-
* `sendReversal`), GENAU EINMAL ein Storno
|
|
357
|
-
*
|
|
358
|
-
*
|
|
392
|
+
* `sendReversal`), GENAU EINMAL ein Storno ueber [amountCents] nach
|
|
393
|
+
* (Betrag samt Trinkgeld) und haelt im Nachweis fest, was das Terminal
|
|
394
|
+
* darauf sagt. Entscheidet NIE ueber den Ausgang, siehe Klassendoku,
|
|
395
|
+
* "Storno nach ausbleibender Host-Antwort".
|
|
396
|
+
*
|
|
397
|
+
* Liefert, was das Storno bewirkt haben kann ([StornoAusgang]).
|
|
398
|
+
* `nichtGesendet` bei einem [HpsPreflightError]: Connect hat es vor jedem
|
|
399
|
+
* Terminal-Kontakt abgewiesen, beweisbar ist nichts hinausgegangen (siehe
|
|
400
|
+
* `errors.ts`). `abgewiesen` bei HTTP 409: das Terminal nimmt waehrend
|
|
401
|
+
* eines anderen Vorgangs keine Anfrage an (gemessen, ohne Spur; dieselbe
|
|
402
|
+
* Lesart wie fuer die erzeugende Anfrage in [fromTerminalBusy]).
|
|
359
403
|
*/
|
|
360
404
|
async function sendReversal(id, steps, elapsedMs, amountCents, anlass) {
|
|
361
405
|
if (amountCents === undefined) {
|
|
362
406
|
steps.push('Kein Storno nachgeschickt -- die Aufhebung einer Gutschrift laesst TECS nicht zu');
|
|
363
|
-
return
|
|
407
|
+
return 'nichtGesendet';
|
|
364
408
|
}
|
|
365
409
|
emit('resolving', `Storno wird nachgeschickt (${anlass.responseCode})`, id);
|
|
366
410
|
let res;
|
|
@@ -368,19 +412,33 @@ export function createHpsPayments(client, target, options = {}) {
|
|
|
368
412
|
res = await withinBudget(elapsedMs, () => client.cancel({ ...target, transactionId: id, amountCents }), reversalBudgetMs);
|
|
369
413
|
}
|
|
370
414
|
catch (e) {
|
|
415
|
+
if (e instanceof HpsPreflightError) {
|
|
416
|
+
steps.push(`Storno nicht gesendet (${describe(e)}) -- Kasseneck Connect hat es vor dem Terminal abgewiesen, `
|
|
417
|
+
+ 'es kann nicht gewirkt haben, Ausgang wird abgefragt');
|
|
418
|
+
return 'nichtGesendet';
|
|
419
|
+
}
|
|
420
|
+
if (e instanceof HpsConnectTerminalError && e.isTerminalBusy) {
|
|
421
|
+
steps.push('Storno nicht angenommen (HTTP 409) -- das Terminal war beschaeftigt, es kann nicht gewirkt haben, '
|
|
422
|
+
+ 'Ausgang wird abgefragt');
|
|
423
|
+
return 'abgewiesen';
|
|
424
|
+
}
|
|
371
425
|
steps.push(`Storno nachgeschickt, aber nicht bestaetigt (${describe(e)}) -- ob es wirkte, ist offen, Ausgang wird abgefragt`);
|
|
372
426
|
noteUnexpected(e, id);
|
|
373
|
-
return
|
|
427
|
+
return 'kannGewirkt';
|
|
374
428
|
}
|
|
375
|
-
if (
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
return null;
|
|
429
|
+
if (isApproved(res)) {
|
|
430
|
+
steps.push(`Storno nachgeschickt und quittiert (${APPROVED_CODE}) -- das allein beweist nicht, dass die Zahlung `
|
|
431
|
+
+ 'aufgehoben ist, Ausgang wird abgefragt');
|
|
432
|
+
return 'kannGewirkt';
|
|
380
433
|
}
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
434
|
+
const titel = hpsCodeInfo(res.responseCode)?.title;
|
|
435
|
+
const code = `${res.responseCode ?? 'ohne Ergebniscode'}${titel === undefined ? '' : ` "${titel}"`}`;
|
|
436
|
+
if (stornoAbgewiesen(res)) {
|
|
437
|
+
steps.push(`Storno abgewiesen (${code}) -- es wurde nicht ausgefuehrt, Ausgang wird abgefragt`);
|
|
438
|
+
return 'abgewiesen';
|
|
439
|
+
}
|
|
440
|
+
steps.push(`Storno nachgeschickt, nicht bestaetigt (${code}) -- ob es wirkte, ist offen, Ausgang wird abgefragt`);
|
|
441
|
+
return 'kannGewirkt';
|
|
384
442
|
}
|
|
385
443
|
/**
|
|
386
444
|
* Klaert einen offenen Ausgang: erst abbrechen, dann abfragen -- bis das
|
|
@@ -393,6 +451,10 @@ export function createHpsPayments(client, target, options = {}) {
|
|
|
393
451
|
* [ausGeschlossenerAntwort]. Meldet sie eine Stoerung beim Host
|
|
394
452
|
* ([isHostUncertain]), bekommt `9027` diesen Aussagewert gerade NICHT --
|
|
395
453
|
* siehe Klassendoku, "Stoerung beim Host".
|
|
454
|
+
*
|
|
455
|
+
* [stornoCents] ist, was ein nachgeschicktes Storno aufheben muss: Betrag
|
|
456
|
+
* samt Trinkgeld der Zahlung. Nur [pay] setzt ihn; ohne ihn wird kein
|
|
457
|
+
* Storno gesendet.
|
|
396
458
|
*/
|
|
397
459
|
async function resolve(id, steps, antwort, stornoCents) {
|
|
398
460
|
emit('resolving', 'Ausgang offen, Klaerung laeuft', id);
|
|
@@ -403,25 +465,26 @@ export function createHpsPayments(client, target, options = {}) {
|
|
|
403
465
|
// Statusabfrage sie nennt und danach 9027 kommt.
|
|
404
466
|
let stoerungsAntwort = antwort && isHostUncertain(antwort) ? antwort : undefined;
|
|
405
467
|
let letzteAntwort = antwort;
|
|
406
|
-
// Das Storno wird hoechstens einmal erwogen;
|
|
468
|
+
// Das Storno wird hoechstens einmal erwogen; versucht wird es nur mit
|
|
469
|
+
// Betrag, also nur fuer eine Zahlung.
|
|
407
470
|
let stornoErwogen = false;
|
|
408
|
-
let
|
|
471
|
+
let stornoVersucht = false;
|
|
472
|
+
// Was das Storno bewirkt haben kann; `kannGewirkt` nimmt auch einer
|
|
473
|
+
// Genehmigung in der Statusabfrage die Aussage.
|
|
474
|
+
let storno;
|
|
409
475
|
if (stoerungsAntwort === undefined) {
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
return aborted;
|
|
476
|
+
// Entscheidet nichts, beendet nur einen noch wartenden Kartenfluss.
|
|
477
|
+
await tryAbort(id, steps, elapsedMs);
|
|
413
478
|
}
|
|
414
479
|
else {
|
|
415
480
|
// Der Vorgang ist am Terminal schon beendet -- mit einer Stoerung beim
|
|
416
|
-
// Host.
|
|
417
|
-
//
|
|
481
|
+
// Host. Es gibt nichts mehr abzubrechen, und eine Quittung saehe
|
|
482
|
+
// ohnehin nur das Terminal, nicht den Host.
|
|
418
483
|
steps.push('Kein Abbruchversuch -- das Terminal hat den Vorgang mit einer Stoerung beim hobex-Host beendet');
|
|
419
484
|
if (needsReversal(stoerungsAntwort)) {
|
|
420
485
|
stornoErwogen = true;
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
if (storniert)
|
|
424
|
-
return storniert;
|
|
486
|
+
stornoVersucht = stornoCents !== undefined;
|
|
487
|
+
storno = await sendReversal(id, steps, elapsedMs, stornoCents, stoerungsAntwort);
|
|
425
488
|
}
|
|
426
489
|
}
|
|
427
490
|
let wait = 0;
|
|
@@ -457,30 +520,46 @@ export function createHpsPayments(client, target, options = {}) {
|
|
|
457
520
|
if (isHostUncertain(status))
|
|
458
521
|
stoerungsAntwort ??= status;
|
|
459
522
|
const hostUngewiss = stoerungsAntwort !== undefined;
|
|
460
|
-
if (
|
|
461
|
-
|
|
462
|
-
|
|
523
|
+
if (stornoVersucht && isCanceled(status)) {
|
|
524
|
+
// Aufgehoben ist aufgehoben. Wer es war, behauptet der Nachweis nur so
|
|
525
|
+
// weit, wie es feststeht: hat das Storno nachweislich nicht gewirkt,
|
|
526
|
+
// war es ein anderer Vorgang, und der Grund ist `canceled`.
|
|
527
|
+
const durchsStorno = storno === 'kannGewirkt';
|
|
528
|
+
steps.push(durchsStorno
|
|
529
|
+
? `Status: Zahlung aufgehoben (${TRANSACTION_CANCELED_CODE}) nach dem nachgeschickten Storno -- `
|
|
530
|
+
+ 'es ist nichts belastet'
|
|
531
|
+
: `Status: Zahlung aufgehoben (${TRANSACTION_CANCELED_CODE}), obwohl das nachgeschickte Storno nicht `
|
|
532
|
+
+ 'ausgefuehrt wurde -- es ist nichts belastet');
|
|
463
533
|
emit('resolved', steps[steps.length - 1], id);
|
|
464
|
-
return {
|
|
534
|
+
return {
|
|
535
|
+
outcome: 'declined',
|
|
536
|
+
transactionId: id,
|
|
537
|
+
response: status,
|
|
538
|
+
reason: durchsStorno ? 'voidedAfterHostFault' : 'canceled',
|
|
539
|
+
steps: [...steps],
|
|
540
|
+
};
|
|
465
541
|
}
|
|
466
542
|
if (!stornoErwogen && needsReversal(status)) {
|
|
467
543
|
// Die Zahlung selbst kam ohne Antwort zurueck, erst die Statusabfrage
|
|
468
544
|
// nennt die ausgebliebene Host-Antwort -- dasselbe Storno wie oben.
|
|
469
545
|
steps.push(statusOhneErgebnis(status));
|
|
470
546
|
stornoErwogen = true;
|
|
471
|
-
|
|
472
|
-
|
|
473
|
-
if (storniert)
|
|
474
|
-
return storniert;
|
|
547
|
+
stornoVersucht = stornoCents !== undefined;
|
|
548
|
+
storno = await sendReversal(id, steps, elapsedMs, stornoCents, status);
|
|
475
549
|
wait = nextWait(wait);
|
|
476
550
|
continue;
|
|
477
551
|
}
|
|
552
|
+
// Nach einem Storno, das gewirkt haben kann, sagt auch '0' nichts: das
|
|
553
|
+
// Storno kann noch unterwegs sein oder nicht gegriffen haben. Es zaehlt
|
|
554
|
+
// unten als "nichts Neues" -- siehe Klassendoku, "Storno nach
|
|
555
|
+
// ausbleibender Host-Antwort".
|
|
556
|
+
const genehmigtTrotzStorno = storno === 'kannGewirkt' && isApproved(status);
|
|
478
557
|
// Auf die Statusabfrage entscheidet nur ein Code, der den gesuchten
|
|
479
558
|
// Vorgang beschreibt -- nicht einer, der diese Abfrage abweist
|
|
480
559
|
// ([isConclusiveAsStatus]). Nach einer Stoerung beim Host entscheidet nur
|
|
481
560
|
// noch eine Genehmigung: jede andere Aussage des Terminals betrifft seinen
|
|
482
561
|
// Speicher, nicht den des Hosts.
|
|
483
|
-
if (hostUngewiss ? isApproved(status) : isConclusiveAsStatus(status)) {
|
|
562
|
+
if (!genehmigtTrotzStorno && (hostUngewiss ? isApproved(status) : isConclusiveAsStatus(status))) {
|
|
484
563
|
const settled = fromResponse(status, id, steps);
|
|
485
564
|
if (settled)
|
|
486
565
|
return settled;
|
|
@@ -497,9 +576,12 @@ export function createHpsPayments(client, target, options = {}) {
|
|
|
497
576
|
ohneAuskunft = 0;
|
|
498
577
|
}
|
|
499
578
|
// Nach einer Stoerung ist jede Antwort ausser '0' (die oben schon
|
|
500
|
-
// entschieden hat) "nichts Neues".
|
|
579
|
+
// entschieden hat) "nichts Neues" -- nach einem Storno auch '0'.
|
|
501
580
|
stoerungOhneNeues = hostUngewiss ? stoerungOhneNeues + 1 : 0;
|
|
502
|
-
steps.push(
|
|
581
|
+
steps.push(genehmigtTrotzStorno
|
|
582
|
+
? `Status: Zahlung steht unveraendert (${APPROVED_CODE}) -- das nachgeschickte Storno kann noch `
|
|
583
|
+
+ 'unterwegs sein oder nicht gegriffen haben, keine Aussage'
|
|
584
|
+
: statusOhneErgebnis(status) ?? 'Status: noch kein Ergebniscode');
|
|
503
585
|
if (stoerungOhneNeues >= 2) {
|
|
504
586
|
// Siehe Klassendoku, "Stoerung beim Host": das Terminal weiss es
|
|
505
587
|
// nicht, und es wird es auch nicht wissen, wenn wir weiterfragen.
|
|
@@ -525,7 +607,7 @@ export function createHpsPayments(client, target, options = {}) {
|
|
|
525
607
|
* wurde uns gerade geantwortet. Uebrig bleibt "beendet und nicht genehmigt".
|
|
526
608
|
*
|
|
527
609
|
* **Gegenprobe** (28.08.2026, TID 3600335, jeweils nach abgeschlossenem
|
|
528
|
-
* Vorgang): genehmigt
|
|
610
|
+
* Vorgang): genehmigt -> Statusabfrage `0`, dreimal
|
|
529
611
|
* wiederholt; abgelehnt mit `100003` -> `9027`, zweimal; abgelehnt mit
|
|
530
612
|
* `9003` -> `9027`. Eine genehmigte Zahlung antwortet also nicht `9027`.
|
|
531
613
|
*
|
|
@@ -676,7 +758,8 @@ export function createHpsPayments(client, target, options = {}) {
|
|
|
676
758
|
return settled;
|
|
677
759
|
steps.push(offeneAntwort(res));
|
|
678
760
|
}
|
|
679
|
-
|
|
761
|
+
// Ein Storno hebt auf, was das Terminal belastet hat: Betrag UND Trinkgeld.
|
|
762
|
+
return resolve(id, steps, res, paymentOptions.amountCents + (paymentOptions.tipCents ?? 0));
|
|
680
763
|
}
|
|
681
764
|
/**
|
|
682
765
|
* Gutschrift mit geklaertem Ausgang -- EXAKT derselbe Klaerweg wie [pay]
|
|
@@ -718,8 +801,9 @@ export function createHpsPayments(client, target, options = {}) {
|
|
|
718
801
|
steps.push(offeneAntwort(res));
|
|
719
802
|
}
|
|
720
803
|
// Dieselbe Klaerfunktion wie [pay]: die Kennung ist die des NEUEN
|
|
721
|
-
// Vorgangs, eine Statusabfrage darauf liefert also genau dessen Ausgang
|
|
722
|
-
//
|
|
804
|
+
// Vorgangs, eine Statusabfrage darauf liefert also genau dessen Ausgang.
|
|
805
|
+
// Der Abbruch entscheidet hier so wenig wie bei einer Zahlung, und ohne
|
|
806
|
+
// Betrag schickt die Klaerung kein Storno nach.
|
|
723
807
|
return resolve(id, steps, res);
|
|
724
808
|
}
|
|
725
809
|
/**
|
|
@@ -120,7 +120,7 @@ function verbunden(teile) {
|
|
|
120
120
|
* (models/hobex-receipt.ts) — Datum, TID, Genehmigungsnummer, Karte, PAN,
|
|
121
121
|
* Antwortcode. Bei CVM "1" verlangt die Karte eine Unterschrift; dafuer
|
|
122
122
|
* bekommt der Bon eine Linie. Der PAN haengt beim HPS das Ablaufdatum mit
|
|
123
|
-
* Unterstrich an ("…
|
|
123
|
+
* Unterstrich an ("…0021_2912") — gedruckt wird nur die maskierte Nummer.
|
|
124
124
|
*/
|
|
125
125
|
function hobexBlock(daten) {
|
|
126
126
|
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 {
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
// Erzeugt von scripts/stored-vokabular.mjs aus fixtures/v3/v3-vokabular.json.
|
|
2
2
|
// Nicht von Hand aendern: test/stored.test.ts vergleicht mit dem Vertrag.
|
|
3
3
|
/** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
|
|
4
|
-
export const VOKABULAR_QUELLE = "
|
|
4
|
+
export const VOKABULAR_QUELLE = "3c10f47f66f048d8b25adb8996414674261ec8eb4c55f82a1d2a239be13d289f";
|
|
5
5
|
/** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
|
|
6
6
|
export const SCHEMAS = {
|
|
7
7
|
"getReceipt": {
|
package/dist/esm/version.d.ts
CHANGED
package/dist/esm/version.js
CHANGED