@kreiseck/kasseneck-api 1.11.1 → 1.12.0

package/fixtures/receipts/voucher-cancellation.json

@@ -0,0 +1,76 @@
+{
+  "company": {
+    "companyName": "Melisse Nails e.U.",
+    "street": "Melissenweg 7",
+    "zip": "1070",
+    "city": "Wien",
+    "phone": "+43 1 2345678",
+    "vatId": "ATU12345675",
+    "taxNumber": "",
+    "isSmallBusiness": false,
+    "footer1": "Danke für Ihren Besuch",
+    "footer2": "",
+    "thanksMessage": [],
+    "showKreiseckLogo": false
+  },
+  "receipt": {
+    "receiptId": "AT0-KASSE1-77",
+    "cashregisterId": "KASSE1",
+    "timeStamp": "2026-10-19T10:15:30",
+    "items": [
+      {
+        "name": "Maniküre",
+        "quantity": 1,
+        "unitPriceCents": -3500,
+        "vatRate": 20
+      },
+      {
+        "name": "Gutschein ····-9DWT",
+        "quantity": 1,
+        "unitPriceCents": 3050,
+        "vatRate": 20,
+        "kind": "voucher"
+      }
+    ],
+    "vouchers": [
+      {
+        "action": "redeem",
+        "type": "single_purpose",
+        "voucherType": "single_purpose",
+        "amountCents": 3050,
+        "vatRateBp": 2000,
+        "name": "Gutschein",
+        "code": "····-····-9DWT",
+        "codeSuffix": "9DWT",
+        "voucherId": "gez1"
+      }
+    ],
+    "paymentMethod": "cash",
+    "payments": [
+      {
+        "id": "p1",
+        "method": "cash",
+        "amountCents": -450,
+        "refundOf": "p1"
+      }
+    ],
+    "turnoverCounterAES256ICM": "UMSATZ",
+    "signaturePreviousReceipt": "VORGAENGER",
+    "certificateSerialNumber": "5A1C3E07",
+    "receiptType": "cancellation",
+    "sig": "eyJhbGciOiJFUzI1NiJ9.QVQx.SIGNATURWERT",
+    "qr": "_R1-AT1_KASSE1_AT0-KASSE1-77_2026-10-19T10:15:30_-4,50_0,00_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR",
+    "fullReceiptId": "VOLL",
+    "customerDetails": [],
+    "legalMessage": [],
+    "cancellationOf": {
+      "receiptId": "AT0-KASSE1-70",
+      "fullReceiptId": null,
+      "timeStamp": "2026-10-19T10:15:30"
+    },
+    "cancellationReason": "customer_cancelled"
+  },
+  "options": {
+    "paperSize": "mm80"
+  }
+}

package/fixtures/receipts/voucher-multi-purpose-redeem.json

@@ -0,0 +1,62 @@
+{
+  "company": {
+    "companyName": "Melisse Nails e.U.",
+    "street": "Melissenweg 7",
+    "zip": "1070",
+    "city": "Wien",
+    "phone": "+43 1 2345678",
+    "vatId": "ATU12345675",
+    "taxNumber": "",
+    "isSmallBusiness": false,
+    "footer1": "Danke für Ihren Besuch",
+    "footer2": "",
+    "thanksMessage": [],
+    "showKreiseckLogo": false
+  },
+  "receipt": {
+    "receiptId": "AT0-KASSE1-73",
+    "cashregisterId": "KASSE1",
+    "timeStamp": "2026-10-19T10:15:30",
+    "items": [
+      {
+        "name": "Gelnägel",
+        "quantity": 1,
+        "unitPriceCents": 2240,
+        "vatRate": 20
+      }
+    ],
+    "vouchers": [
+      {
+        "action": "redeem",
+        "type": "value",
+        "voucherType": "multi_purpose",
+        "valueCents": 1750,
+        "name": "Gutschein",
+        "code": "····-····-5KNZ",
+        "codeSuffix": "5KNZ",
+        "voucherId": "gmz1",
+        "balanceAfterCents": 3250
+      }
+    ],
+    "paymentMethod": "cash",
+    "payments": [
+      {
+        "id": "p1",
+        "method": "cash",
+        "amountCents": 490
+      }
+    ],
+    "turnoverCounterAES256ICM": "UMSATZ",
+    "signaturePreviousReceipt": "VORGAENGER",
+    "certificateSerialNumber": "5A1C3E07",
+    "receiptType": "standard",
+    "sig": "eyJhbGciOiJFUzI1NiJ9.QVQx.SIGNATURWERT",
+    "qr": "_R1-AT1_KASSE1_AT0-KASSE1-73_2026-10-19T10:15:30_22,40_0,00_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR",
+    "fullReceiptId": "VOLL",
+    "customerDetails": [],
+    "legalMessage": []
+  },
+  "options": {
+    "paperSize": "mm80"
+  }
+}

package/fixtures/receipts/voucher-multi-purpose-sale.json

@@ -0,0 +1,63 @@
+{
+  "company": {
+    "companyName": "Melisse Nails e.U.",
+    "street": "Melissenweg 7",
+    "zip": "1070",
+    "city": "Wien",
+    "phone": "+43 1 2345678",
+    "vatId": "ATU12345675",
+    "taxNumber": "",
+    "isSmallBusiness": false,
+    "footer1": "Danke für Ihren Besuch",
+    "footer2": "",
+    "thanksMessage": [],
+    "showKreiseckLogo": false
+  },
+  "receipt": {
+    "receiptId": "AT0-KASSE1-74",
+    "cashregisterId": "KASSE1",
+    "timeStamp": "2026-10-19T10:15:30",
+    "items": [
+      {
+        "name": "Mehrzweckgutschein",
+        "quantity": 1,
+        "unitPriceCents": 3000,
+        "vatRate": 0,
+        "kind": "voucher_float"
+      }
+    ],
+    "vouchers": [
+      {
+        "action": "sell",
+        "type": "value",
+        "voucherType": "multi_purpose",
+        "valueCents": 3000,
+        "name": "Mehrzweckgutschein",
+        "code": "····-····-NNNY",
+        "codeSuffix": "NNNY",
+        "voucherId": "gmz2",
+        "zeroRateBucket": true
+      }
+    ],
+    "paymentMethod": "cash",
+    "payments": [
+      {
+        "id": "p1",
+        "method": "cash",
+        "amountCents": 3000
+      }
+    ],
+    "turnoverCounterAES256ICM": "UMSATZ",
+    "signaturePreviousReceipt": "VORGAENGER",
+    "certificateSerialNumber": "5A1C3E07",
+    "receiptType": "standard",
+    "sig": "eyJhbGciOiJFUzI1NiJ9.QVQx.SIGNATURWERT",
+    "qr": "_R1-AT1_KASSE1_AT0-KASSE1-74_2026-10-19T10:15:30_0,00_0,00_0,00_30,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR",
+    "fullReceiptId": "VOLL",
+    "customerDetails": [],
+    "legalMessage": []
+  },
+  "options": {
+    "paperSize": "mm58"
+  }
+}

package/fixtures/receipts/voucher-payout.json

@@ -0,0 +1,65 @@
+{
+  "company": {
+    "companyName": "Melisse Nails e.U.",
+    "street": "Melissenweg 7",
+    "zip": "1070",
+    "city": "Wien",
+    "phone": "+43 1 2345678",
+    "vatId": "ATU12345675",
+    "taxNumber": "",
+    "isSmallBusiness": false,
+    "footer1": "Danke für Ihren Besuch",
+    "footer2": "",
+    "thanksMessage": [],
+    "showKreiseckLogo": false
+  },
+  "receipt": {
+    "receiptId": "AT0-KASSE1-76",
+    "cashregisterId": "KASSE1",
+    "timeStamp": "2026-10-19T10:15:30",
+    "items": [
+      {
+        "name": "Auszahlung Gutschein ····-9DWT",
+        "quantity": 1,
+        "unitPriceCents": -1200,
+        "vatRate": 0,
+        "kind": "voucher_float"
+      }
+    ],
+    "vouchers": [
+      {
+        "action": "payout",
+        "type": "value",
+        "voucherType": "multi_purpose",
+        "valueCents": 1200,
+        "name": "Auszahlung Gutschein",
+        "code": "····-····-9DWT",
+        "codeSuffix": "9DWT",
+        "voucherId": "gmz3",
+        "balanceAfterCents": 0,
+        "reason": "Kundin zieht weg",
+        "zeroRateBucket": true
+      }
+    ],
+    "paymentMethod": "cash",
+    "payments": [
+      {
+        "id": "p1",
+        "method": "cash",
+        "amountCents": -1200
+      }
+    ],
+    "turnoverCounterAES256ICM": "UMSATZ",
+    "signaturePreviousReceipt": "VORGAENGER",
+    "certificateSerialNumber": "5A1C3E07",
+    "receiptType": "standard",
+    "sig": "eyJhbGciOiJFUzI1NiJ9.QVQx.SIGNATURWERT",
+    "qr": "_R1-AT1_KASSE1_AT0-KASSE1-76_2026-10-19T10:15:30_0,00_0,00_0,00_-12,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR",
+    "fullReceiptId": "VOLL",
+    "customerDetails": [],
+    "legalMessage": []
+  },
+  "options": {
+    "paperSize": "mm80"
+  }
+}

package/fixtures/receipts/voucher-service-redeem.json

@@ -0,0 +1,82 @@
+{
+  "company": {
+    "companyName": "Melisse Nails e.U.",
+    "street": "Melissenweg 7",
+    "zip": "1070",
+    "city": "Wien",
+    "phone": "+43 1 2345678",
+    "vatId": "ATU12345675",
+    "taxNumber": "",
+    "isSmallBusiness": false,
+    "footer1": "Danke für Ihren Besuch",
+    "footer2": "",
+    "thanksMessage": [],
+    "showKreiseckLogo": false
+  },
+  "receipt": {
+    "receiptId": "AT0-KASSE1-72",
+    "cashregisterId": "KASSE1",
+    "timeStamp": "2026-10-19T10:15:30",
+    "items": [
+      {
+        "name": "Maniküre",
+        "quantity": 1,
+        "unitPriceCents": 3500,
+        "vatRate": 20
+      },
+      {
+        "name": "Kaffee",
+        "quantity": 1,
+        "unitPriceCents": 320,
+        "vatRate": 20
+      },
+      {
+        "name": "Gutschein ····-RRRF",
+        "quantity": 1,
+        "unitPriceCents": -3500,
+        "vatRate": 20,
+        "kind": "voucher"
+      }
+    ],
+    "vouchers": [
+      {
+        "action": "redeem",
+        "type": "service",
+        "voucherType": "service",
+        "articleId": "manicure",
+        "quantity": 1,
+        "positions": [
+          0
+        ],
+        "amountCents": 3500,
+        "vatRateBp": 2000,
+        "remainingQuantityAfter": 9,
+        "taxedWith": "K1-ID-4712",
+        "name": "Gutschein",
+        "code": "····-····-RRRF",
+        "codeSuffix": "RRRF",
+        "voucherId": "gls1"
+      }
+    ],
+    "paymentMethod": "cash",
+    "payments": [
+      {
+        "id": "p1",
+        "method": "cash",
+        "amountCents": 320
+      }
+    ],
+    "turnoverCounterAES256ICM": "UMSATZ",
+    "signaturePreviousReceipt": "VORGAENGER",
+    "certificateSerialNumber": "5A1C3E07",
+    "receiptType": "standard",
+    "sig": "eyJhbGciOiJFUzI1NiJ9.QVQx.SIGNATURWERT",
+    "qr": "_R1-AT1_KASSE1_AT0-KASSE1-72_2026-10-19T10:15:30_3,20_0,00_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR",
+    "fullReceiptId": "VOLL",
+    "customerDetails": [],
+    "legalMessage": []
+  },
+  "options": {
+    "paperSize": "mm58"
+  }
+}

package/fixtures/receipts/voucher-single-purpose-redeem-exempt.json

@@ -0,0 +1,86 @@
+{
+  "company": {
+    "companyName": "Melisse Nails e.U.",
+    "street": "Melissenweg 7",
+    "zip": "1070",
+    "city": "Wien",
+    "phone": "+43 1 2345678",
+    "vatId": "ATU12345675",
+    "taxNumber": "",
+    "isSmallBusiness": false,
+    "footer1": "Danke für Ihren Besuch",
+    "footer2": "",
+    "thanksMessage": [],
+    "showKreiseckLogo": false
+  },
+  "receipt": {
+    "receiptId": "AT0-KASSE1-71",
+    "cashregisterId": "KASSE1",
+    "timeStamp": "2026-10-19T10:15:30",
+    "items": [
+      {
+        "name": "Nagellack",
+        "quantity": 1,
+        "unitPriceCents": 1200,
+        "vatRate": 20
+      },
+      {
+        "name": "Handcreme",
+        "quantity": 1,
+        "unitPriceCents": 800,
+        "vatRate": 10
+      },
+      {
+        "name": "Gutschein ····-7KQM",
+        "quantity": 1,
+        "unitPriceCents": -900,
+        "vatRate": 20,
+        "kind": "voucher"
+      },
+      {
+        "name": "Gutschein ····-7KQM",
+        "quantity": 1,
+        "unitPriceCents": -600,
+        "vatRate": 10,
+        "kind": "voucher"
+      }
+    ],
+    "vouchers": [
+      {
+        "action": "redeem",
+        "type": "single_purpose",
+        "voucherType": "single_purpose",
+        "amountCents": 1500,
+        "vatRateBp": 0,
+        "balanceAfterCents": 500,
+        "exempt": true,
+        "name": "Gutschein",
+        "code": "····-····-7KQM",
+        "codeSuffix": "7KQM",
+        "voucherId": "gez2"
+      }
+    ],
+    "paymentMethod": "cash",
+    "payments": [
+      {
+        "id": "p1",
+        "method": "cash",
+        "amountCents": 500,
+        "tenderedCents": 1000,
+        "changeCents": 500
+      }
+    ],
+    "turnoverCounterAES256ICM": "UMSATZ",
+    "signaturePreviousReceipt": "VORGAENGER",
+    "certificateSerialNumber": "5A1C3E07",
+    "receiptType": "standard",
+    "sig": "eyJhbGciOiJFUzI1NiJ9.QVQx.SIGNATURWERT",
+    "qr": "_R1-AT1_KASSE1_AT0-KASSE1-71_2026-10-19T10:15:30_3,00_2,00_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR",
+    "fullReceiptId": "VOLL",
+    "customerDetails": [],
+    "legalMessage": []
+  },
+  "options": {
+    "paperSize": "mm58"
+  }
+}

package/fixtures/receipts/voucher-single-purpose-redeem.json

@@ -0,0 +1,71 @@
+{
+  "company": {
+    "companyName": "Melisse Nails e.U.",
+    "street": "Melissenweg 7",
+    "zip": "1070",
+    "city": "Wien",
+    "phone": "+43 1 2345678",
+    "vatId": "ATU12345675",
+    "taxNumber": "",
+    "isSmallBusiness": false,
+    "footer1": "Danke für Ihren Besuch",
+    "footer2": "",
+    "thanksMessage": [],
+    "showKreiseckLogo": false
+  },
+  "receipt": {
+    "receiptId": "AT0-KASSE1-70",
+    "cashregisterId": "KASSE1",
+    "timeStamp": "2026-10-19T10:15:30",
+    "items": [
+      {
+        "name": "Maniküre",
+        "quantity": 1,
+        "unitPriceCents": 3500,
+        "vatRate": 20
+      },
+      {
+        "name": "Gutschein ····-9DWT",
+        "quantity": 1,
+        "unitPriceCents": -3050,
+        "vatRate": 20,
+        "kind": "voucher"
+      }
+    ],
+    "vouchers": [
+      {
+        "action": "redeem",
+        "type": "single_purpose",
+        "voucherType": "single_purpose",
+        "amountCents": 3050,
+        "vatRateBp": 2000,
+        "balanceAfterCents": 1950,
+        "taxedWith": "K1-ID-4711",
+        "name": "Gutschein",
+        "code": "····-····-9DWT",
+        "codeSuffix": "9DWT",
+        "voucherId": "gez1"
+      }
+    ],
+    "paymentMethod": "cash",
+    "payments": [
+      {
+        "id": "p1",
+        "method": "cash",
+        "amountCents": 450
+      }
+    ],
+    "turnoverCounterAES256ICM": "UMSATZ",
+    "signaturePreviousReceipt": "VORGAENGER",
+    "certificateSerialNumber": "5A1C3E07",
+    "receiptType": "standard",
+    "sig": "eyJhbGciOiJFUzI1NiJ9.QVQx.SIGNATURWERT",
+    "qr": "_R1-AT1_KASSE1_AT0-KASSE1-70_2026-10-19T10:15:30_4,50_0,00_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR",
+    "fullReceiptId": "VOLL",
+    "customerDetails": [],
+    "legalMessage": []
+  },
+  "options": {
+    "paperSize": "mm80"
+  }
+}

package/fixtures/receipts/voucher-single-purpose-sale.json

@@ -0,0 +1,88 @@
+{
+  "company": {
+    "companyName": "Melisse Nails e.U.",
+    "street": "Melissenweg 7",
+    "zip": "1070",
+    "city": "Wien",
+    "phone": "+43 1 2345678",
+    "vatId": "ATU12345675",
+    "taxNumber": "",
+    "isSmallBusiness": false,
+    "footer1": "Danke für Ihren Besuch",
+    "footer2": "",
+    "thanksMessage": [],
+    "showKreiseckLogo": false
+  },
+  "receipt": {
+    "receiptId": "AT0-KASSE1-75",
+    "cashregisterId": "KASSE1",
+    "timeStamp": "2026-10-19T10:15:30",
+    "items": [
+      {
+        "name": "Einzweckgutschein 20 %",
+        "quantity": 1,
+        "unitPriceCents": 5000,
+        "vatRate": 20,
+        "kind": "voucher"
+      },
+      {
+        "name": "Leistungsgutschein 10× Maniküre",
+        "quantity": 1,
+        "unitPriceCents": 35000,
+        "vatRate": 20,
+        "kind": "voucher"
+      }
+    ],
+    "vouchers": [
+      {
+        "action": "sell",
+        "type": "single_purpose",
+        "voucherType": "single_purpose",
+        "amountCents": 5000,
+        "vatRateBp": 2000,
+        "name": "Einzweckgutschein 20 %",
+        "code": "····-····-JJJ2",
+        "codeSuffix": "JJJ2",
+        "voucherId": "gez3"
+      },
+      {
+        "action": "sell",
+        "type": "service",
+        "voucherType": "service",
+        "amountCents": 35000,
+        "vatRateBp": 2000,
+        "article": {
+          "id": "manicure",
+          "name": "Maniküre",
+          "vatRateBp": 2000,
+          "priceCents": 3500
+        },
+        "quantity": 10,
+        "name": "Leistungsgutschein 10× Maniküre",
+        "code": "····-····-RRRF",
+        "codeSuffix": "RRRF",
+        "voucherId": "gls1"
+      }
+    ],
+    "paymentMethod": "cash",
+    "payments": [
+      {
+        "id": "p1",
+        "method": "cash",
+        "amountCents": 40000
+      }
+    ],
+    "turnoverCounterAES256ICM": "UMSATZ",
+    "signaturePreviousReceipt": "VORGAENGER",
+    "certificateSerialNumber": "5A1C3E07",
+    "receiptType": "standard",
+    "sig": "eyJhbGciOiJFUzI1NiJ9.QVQx.SIGNATURWERT",
+    "qr": "_R1-AT1_KASSE1_AT0-KASSE1-75_2026-10-19T10:15:30_400,00_0,00_0,00_0,00_0,00_UMSATZ_VORGAENGER_5A1C3E07_SIGNATUR",
+    "fullReceiptId": "VOLL",
+    "customerDetails": [],
+    "legalMessage": []
+  },
+  "options": {
+    "paperSize": "mm80"
+  }
+}