@kreiseck/kasseneck-api 1.3.0 → 1.5.0

package/dist/esm/invoice/typen.d.ts

@@ -89,7 +89,20 @@ export interface InvoiceItemInput {
     /** Artikel aus dem Artikelstamm; bestandsgefuehrt bucht das Ausstellen ihn vom Lager ab. */
     articleId?: string;
 }
-/** Eine Gutschriftsposition: wie eine Rechnungsposition, dazu die Rueckgabe-Wahl. */
+/**
+ * Eine Position beim Ausstellen (`issueInvoice`): dazu optional die
+ * Reservierung aus der Lager-API, die diese Position einloest.
+ */
+export interface IssueInvoiceItemInput extends InvoiceItemInput {
+    /**
+     * Kennung aus `createReservation` (`./inventory`); braucht `articleId`.
+     * Geprueft beim Ausstellen (`reservation_not_found`, `reservation_mismatch`,
+     * `reservation_not_active`; abgelaufen = Hinweis `reservation_expired`),
+     * eingeloest beim Buchen der Rechnung am Lagerstandort der Rechnung.
+     */
+    reservationId?: string;
+}
+/** Eine Gutschriftsposition: wie eine Rechnungsposition (ohne Reservierung), dazu die Rueckgabe-Wahl. */
 export interface CreditNoteItemInput extends InvoiceItemInput {
     /** Wohin die Ware dieser Position geht; fehlt = Vorgabe des Aufrufs bzw. `restock`. */
     returnDisposition?: ReturnDisposition;
@@ -115,7 +128,7 @@ export interface IssueInvoiceRequest {
     paymentReference?: string;
     girocode?: boolean;
     tracking?: boolean;
-    items: InvoiceItemInput[];
+    items: IssueInvoiceItemInput[];
     /** Eigene Merkmale (hoechstens 20), nie gedruckt. */
     metadata?: Record<string, string>;
     /** Sprache dieser Rechnung; sonst die des Kunden, sonst `de`. Eine Rechnung, eine Nummer, eine Sprache. */
@@ -130,6 +143,15 @@ export interface IssueInvoiceRequest {
      * Zahlungsinformationen und keinen Giro-QR.
      */
     payment?: PaymentInput;
+    /**
+     * Nur fuer Rechnungen ohne Steuer, die die UID des Kunden verlangen (ig.
+     * Lieferung, Reverse Charge): hat die UID-Pruefung noch kein Ergebnis
+     * (`vat_id_check_pending`), stellt `true` trotzdem aus. Der Aussteller traegt
+     * dann das Risiko, die Rechnung traegt `vatIdRisk`. Eine ungueltige UID
+     * (`vat_id_invalid`) sperrt auch damit. Gehoert nicht zur Anfrage im Sinn der
+     * Idempotenz: dieselbe Anfrage mit und ohne das Feld ist dieselbe Rechnung.
+     */
+    acceptVatIdRisk?: boolean;
 }
 /** Eine Zahlung, wie das Fremdsystem sie meldet. */
 export interface PaymentInput {
@@ -168,6 +190,8 @@ export interface InvoicePayment {
 export interface InvoiceNotice {
     code: InvoiceNoticeCode;
     message: string;
+    /** Bei `reservation_expired`: die abgelaufene Reservierung. */
+    reservationId?: string;
 }
 export interface RecordPaymentResult {
     invoice: Invoice;
@@ -238,6 +262,26 @@ export interface Invoice {
     paidCents: number;
     /** Was noch offen ist; `0` heisst bezahlt. */
     openCents: number;
+    /** Beim Festschreiben eingefrorener UID-Nachweis des Kunden; sonst `null`. */
+    vatIdProof: InvoiceVatIdProof | null;
+    /** Ohne Ergebnis der UID-Pruefung mit `acceptVatIdRisk` ausgestellt; sonst `null`. */
+    vatIdRisk: InvoiceVatIdRisk | null;
+}
+/** UID-Nachweis an einer Rechnung: gueltige Pruefung der Kunden-UID, hoechstens 30 Tage vor dem Festschreiben. */
+export interface InvoiceVatIdProof {
+    /** Wiener Tag der Pruefung (`YYYY-MM-DD`). */
+    checkedOn: string;
+    /** Wer geprueft hat: FinanzOnline (Stufe 2 mit Name und Anschrift) oder VIES. */
+    source: 'finanzonline' | 'vies';
+    /** Stufe der Pruefung: 1 = nur UID, 2 = UID mit Name und Anschrift. */
+    level: 1 | 2;
+    /** Pruefcode fuer die oeffentliche Pruefseite (auf dem PDF als QR); `null`, wenn keiner vergeben wurde. */
+    code: string | null;
+}
+/** Ausgestellt ohne Ergebnis der UID-Pruefung, das Risiko traegt der Aussteller. */
+export interface InvoiceVatIdRisk {
+    /** Wiener Tag der Bestaetigung (`YYYY-MM-DD`). */
+    acceptedOn: string;
 }
 /** Eine Marke des Kontos (Logo, Farbe, Absender) — `id` geht als `brandId` in `issueInvoice`. */
 export interface Brand {

package/dist/esm/invoice/vertrag.d.ts

@@ -27,7 +27,7 @@ export type InvoiceEndpoint = (typeof INVOICE_ENDPOINTS)[number];
  * Stabile Fehlercodes. Das Fremdsystem verzweigt am Code, der Text darf sich
  * aendern. `validation` traegt zusaetzlich `errors: [{ field, message }]`.
  */
-export declare const INVOICE_ERROR_CODES: readonly ["validation", "idempotency_conflict", "module_inactive", "customer_not_found", "customer_exists", "short_code_taken", "short_code_immutable", "recipient_required", "invoice_requirements_missing", "invoice_not_found", "invoice_ambiguous", "not_cancellable", "partial_credit_exists", "credit_exceeds_invoice", "einvoice_incomplete", "invoice_api_not_enabled", "invoice_setup_incomplete", "language_not_allowed", "brand_not_found", "not_payable", "payment_exceeds_invoice", "tax_scheme_mismatch", "vat_rate_not_in_country", "reverse_charge_reason_required", "reverse_charge_threshold", "mixed_supply_not_allowed", "oss_not_enabled", "einvoice_unavailable", "amount_too_large"];
+export declare const INVOICE_ERROR_CODES: readonly ["validation", "idempotency_conflict", "module_inactive", "customer_not_found", "customer_exists", "short_code_taken", "short_code_immutable", "recipient_required", "invoice_requirements_missing", "invoice_not_found", "invoice_ambiguous", "not_cancellable", "partial_credit_exists", "credit_exceeds_invoice", "einvoice_incomplete", "invoice_api_not_enabled", "invoice_setup_incomplete", "language_not_allowed", "brand_not_found", "not_payable", "payment_exceeds_invoice", "tax_scheme_mismatch", "vat_rate_not_in_country", "reverse_charge_reason_required", "reverse_charge_threshold", "mixed_supply_not_allowed", "oss_not_enabled", "einvoice_unavailable", "amount_too_large", "vat_id_invalid", "vat_id_check_pending", "reservation_not_found", "reservation_mismatch", "reservation_not_active"];
 export type InvoiceErrorCode = (typeof INVOICE_ERROR_CODES)[number];
 /**
  * Codes, die Anmeldung und Rand auf jedem Rechnungsaufruf erzeugen koennen,
@@ -170,7 +170,7 @@ export type InvoicePaymentMethod = (typeof INVOICE_PAYMENT_METHODS)[number];
  * Hinweise, die eine erfolgreiche Antwort zusaetzlich tragen kann (`data.notice`).
  * Sie sind keine Fehler: der Aufruf hat gewirkt, es gibt nur etwas zu wissen.
  */
-export declare const INVOICE_NOTICE_CODES: readonly ["cash_receipt_required", "recapitulative_statement_due", "place_of_supply_check"];
+export declare const INVOICE_NOTICE_CODES: readonly ["cash_receipt_required", "recapitulative_statement_due", "place_of_supply_check", "reservation_expired"];
 export type InvoiceNoticeCode = (typeof INVOICE_NOTICE_CODES)[number];
 /**
  * Einheiten einer Position. Die API nimmt nur diese Schluessel an; gedruckt
@@ -270,12 +270,26 @@ export declare const CUSTOMER_FIELDS: Readonly<Record<string, Field>>;
  * die bisher gerundet eingereicht werden mussten.
  */
 export declare const ITEM_FIELDS: Readonly<Record<string, Field>>;
+/**
+ * Eine Rechnungsposition beim Ausstellen: die gemeinsamen Positionsfelder plus
+ * `reservationId` (seit 1.5.0). Die Reservierung aus der Lager-API
+ * (`createReservation`) wird beim Ausstellen geprueft und beim Buchen der
+ * Rechnung eingeloest; die Position braucht dazu `articleId`. Unbekannt =
+ * `reservation_not_found`, schon eingeloest oder freigegeben =
+ * `reservation_not_active`, kein offener Rest dieses Artikels am Lagerstandort
+ * der Rechnung (`stockLocationId`, sonst der Standard-Standort) =
+ * `reservation_mismatch`; abgelaufen ist kein Fehler, sondern der Hinweis
+ * `reservation_expired`. Weniger verkauft als reserviert gibt den Rest frei.
+ * Gutschriften kennen das Feld nicht (`validation`).
+ */
+export declare const INVOICE_ITEM_FIELDS: Readonly<Record<string, Field>>;
 /** Genau einer der beiden Preise je Position (§ 9.1). */
 export declare const ITEM_PRICE_EXACTLY_ONE: readonly (readonly string[])[];
 /**
- * Eine Gutschriftsposition: die Rechnungsposition plus `returnDisposition`
- * (wohin die zurueckgenommene Ware geht). An einer Rechnungsposition weist der
- * Server das Feld als unbekannt ab.
+ * Eine Gutschriftsposition: die gemeinsamen Positionsfelder plus
+ * `returnDisposition` (wohin die zurueckgenommene Ware geht), ohne
+ * `reservationId`. An einer Rechnungsposition weist der Server
+ * `returnDisposition` als unbekannt ab.
  */
 export declare const CREDIT_NOTE_ITEM_FIELDS: Readonly<Record<string, Field>>;
 /**

package/dist/esm/invoice/vertrag.js

@@ -70,6 +70,13 @@ export const INVOICE_ERROR_CODES = [
     'oss_not_enabled',
     'einvoice_unavailable', // zu dieser Rechnung entsteht keine E-Rechnung, Grund in `reason`
     'amount_too_large', // Betrag ueber der Grenze des Ganzzahlkerns; erst ab dessen Umstieg gesendet
+    // Seit 1.5.0 (0.x: 0.33.0): UID-Pruefung beim Ausstellen ohne Steuer.
+    'vat_id_invalid', // UID des Kunden laut FinanzOnline/VIES ungueltig, sperrt auch mit acceptVatIdRisk
+    'vat_id_check_pending', // noch kein Ergebnis der UID-Pruefung; `retryAfter` in Sekunden, oder acceptVatIdRisk
+    // Seit 1.5.0: Position mit `reservationId` (nur `issueInvoice`), geprueft beim Ausstellen.
+    'reservation_not_found', // unbekannt oder einem anderen Konto
+    'reservation_mismatch', // keine offene Position mit gleichem Artikel am Lagerstandort der Rechnung
+    'reservation_not_active', // schon eingeloest oder freigegeben
 ];
 /**
  * Codes, die Anmeldung und Rand auf jedem Rechnungsaufruf erzeugen koennen,
@@ -227,6 +234,10 @@ export const INVOICE_NOTICE_CODES = [
     /** Leistung an eine Privatperson im Drittland: der Leistungsort haengt von der
      *  Art der Leistung ab — wir nehmen den oesterreichischen Fall an. */
     'place_of_supply_check',
+    /** Die Reservierung einer Position war beim Ausstellen schon abgelaufen: die
+     *  Rechnung entsteht trotzdem, verkauft wird ohne Reservierung (seit 1.5.0).
+     *  Der Hinweis nennt `reservationId`, je Reservierung einmal. */
+    'reservation_expired',
 ];
 /**
  * Einheiten einer Position. Die API nimmt nur diese Schluessel an; gedruckt
@@ -429,6 +440,19 @@ export const ITEM_FIELDS = Object.freeze({
      */
     articleId: id,
 });
+/**
+ * Eine Rechnungsposition beim Ausstellen: die gemeinsamen Positionsfelder plus
+ * `reservationId` (seit 1.5.0). Die Reservierung aus der Lager-API
+ * (`createReservation`) wird beim Ausstellen geprueft und beim Buchen der
+ * Rechnung eingeloest; die Position braucht dazu `articleId`. Unbekannt =
+ * `reservation_not_found`, schon eingeloest oder freigegeben =
+ * `reservation_not_active`, kein offener Rest dieses Artikels am Lagerstandort
+ * der Rechnung (`stockLocationId`, sonst der Standard-Standort) =
+ * `reservation_mismatch`; abgelaufen ist kein Fehler, sondern der Hinweis
+ * `reservation_expired`. Weniger verkauft als reserviert gibt den Rest frei.
+ * Gutschriften kennen das Feld nicht (`validation`).
+ */
+export const INVOICE_ITEM_FIELDS = Object.freeze({ ...ITEM_FIELDS, reservationId: id });
 /** Genau einer der beiden Preise je Position (§ 9.1). */
 export const ITEM_PRICE_EXACTLY_ONE = Object.freeze([
     Object.freeze(['unitPriceCents']),
@@ -440,15 +464,16 @@ const positionen = {
     min: 1,
     max: 500,
     item: {
-        type: 'object', required: true, fields: ITEM_FIELDS, exactlyOne: ITEM_PRICE_EXACTLY_ONE,
+        type: 'object', required: true, fields: INVOICE_ITEM_FIELDS, exactlyOne: ITEM_PRICE_EXACTLY_ONE,
     },
 };
 /** Rueckgabe-Wahl einer Gutschrift: Vorgabe des Aufrufs oder je Position. */
 const returnDisposition = { type: 'enum', required: false, values: RETURN_DISPOSITIONS };
 /**
- * Eine Gutschriftsposition: die Rechnungsposition plus `returnDisposition`
- * (wohin die zurueckgenommene Ware geht). An einer Rechnungsposition weist der
- * Server das Feld als unbekannt ab.
+ * Eine Gutschriftsposition: die gemeinsamen Positionsfelder plus
+ * `returnDisposition` (wohin die zurueckgenommene Ware geht), ohne
+ * `reservationId`. An einer Rechnungsposition weist der Server
+ * `returnDisposition` als unbekannt ab.
  */
 export const CREDIT_NOTE_ITEM_FIELDS = Object.freeze({ ...ITEM_FIELDS, returnDisposition });
 const gutschriftPositionen = {
@@ -545,6 +570,13 @@ export const INVOICE_REQUESTS = Object.freeze({
          * Idempotenz-Eintrag. Die Antwort traegt `preview` statt `invoice`.
          */
         dryRun: { type: 'boolean', required: false },
+        /**
+         * Rechnung ohne Steuer, deren UID-Pruefung (FinanzOnline, sonst VIES) noch
+         * kein Ergebnis hat: `true` stellt trotzdem aus. Der Aussteller traegt das
+         * Risiko, die Rechnung steht dann mit `vatIdRisk`. Eine ungueltige UID
+         * (`vat_id_invalid`) sperrt auch damit.
+         */
+        acceptVatIdRisk: { type: 'boolean', required: false },
     },
     cancelInvoice: {
         idempotencyKey: idempotencyKey(true),

package/dist/esm/stored/vokabular.d.ts

@@ -1,5 +1,5 @@
 /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
-export declare const VOKABULAR_QUELLE = "b1049e2f65e9261cf8f729481d9ce1e5afda2cf620333f38ae6bf1afb36c8712";
+export declare const VOKABULAR_QUELLE = "d351a778c02888291e325068f96156ad1346859f6ff97bae27f91089e9619e8c";
 /** Schema-Notation des Vertrags: Blatt 'aussen': 'innen', Objekt { __: 'innen', ... }, Liste [ { __: 'innen', ... } ]. */
 export type SchemaEintrag = string | SchemaObjekt | readonly [SchemaObjekt];
 export interface SchemaObjekt {

package/dist/esm/stored/vokabular.js

@@ -1,7 +1,7 @@
 // Erzeugt von scripts/stored-vokabular.mjs aus fixtures/v3/v3-vokabular.json.
 // Nicht von Hand aendern: test/stored.test.ts vergleicht mit dem Vertrag.
 /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
-export const VOKABULAR_QUELLE = "b1049e2f65e9261cf8f729481d9ce1e5afda2cf620333f38ae6bf1afb36c8712";
+export const VOKABULAR_QUELLE = "d351a778c02888291e325068f96156ad1346859f6ff97bae27f91089e9619e8c";
 /** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
 export const SCHEMAS = {
     "getReceipt": {
@@ -220,7 +220,8 @@ export const SCHEMAS = {
                         "visible": "sichtbar",
                         "sort": "sort"
                     },
-                    "stockLocationIds": "standorte"
+                    "stockLocationIds": "standorte",
+                    "minStockByLocation": "mindestJeStandort"
                 }
             ]
         },
@@ -258,7 +259,8 @@ export const ARTIKEL_FELDER = [
     "active",
     "groupId",
     "tile",
-    "stockLocationIds"
+    "stockLocationIds",
+    "minStockByLocation"
 ];
 /** Wertkataloge innen (deutsch) -> aussen (englisch). */
 export const KATALOGE = {

package/dist/esm/version.d.ts

@@ -4,4 +4,4 @@
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-export declare const PACKAGE_VERSION = "1.3.0";
+export declare const PACKAGE_VERSION = "1.5.0";

package/dist/esm/version.js

@@ -4,4 +4,4 @@
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-export const PACKAGE_VERSION = '1.3.0';
+export const PACKAGE_VERSION = '1.5.0';

package/fixtures/hobex-hps-codes.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3.0",
+  "version": "1.5.0",
   "measuredOn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

package/fixtures/invoice-api-examples/credit-error-reservation.json

@@ -0,0 +1,26 @@
+{
+  "endpoint": "createCreditNote",
+  "description": "Eine Reservierung wird nur beim Ausstellen eingeloest, nie an einer Gutschrift",
+  "request": {
+    "idempotencyKey": "ex-21",
+    "invoiceId": "invoice_example",
+    "reason": "return",
+    "items": [
+      {
+        "description": "Kaisersemmel",
+        "quantity": 1,
+        "unitPriceCents": 65,
+        "vatRate": 10,
+        "articleId": "kaisersemmel",
+        "reservationId": "res_example"
+      }
+    ]
+  },
+  "expected": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "items[0].reservationId"
+    ]
+  }
+}

package/fixtures/invoice-api-examples/issue-error-reservation-article.json

@@ -0,0 +1,25 @@
+{
+  "endpoint": "issueInvoice",
+  "description": "Eine Reservierung gehoert zu einem Artikel: ohne articleId keine reservationId",
+  "request": {
+    "idempotencyKey": "ex-20",
+    "priceMode": "gross",
+    "serviceStart": "2026-10-06",
+    "items": [
+      {
+        "description": "Kaisersemmel",
+        "quantity": 6,
+        "unitPriceCents": 65,
+        "vatRate": 10,
+        "reservationId": "res_example"
+      }
+    ]
+  },
+  "expected": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "items[0].articleId"
+    ]
+  }
+}

package/fixtures/invoice-api-examples/issue-error-vat-id-risk.json

@@ -0,0 +1,26 @@
+{
+  "endpoint": "issueInvoice",
+  "description": "acceptVatIdRisk ist ein Wahrheitswert, kein Text",
+  "request": {
+    "idempotencyKey": "ex-vat-id-2",
+    "customerId": "customer_example",
+    "priceMode": "net",
+    "serviceStart": "2026-10-06",
+    "acceptVatIdRisk": "yes",
+    "items": [
+      {
+        "description": "Beratung",
+        "quantity": 1,
+        "unitPriceCents": 1000,
+        "vatRate": 20
+      }
+    ]
+  },
+  "expected": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "acceptVatIdRisk"
+    ]
+  }
+}

package/fixtures/invoice-api-examples/issue-reservation.json

@@ -0,0 +1,24 @@
+{
+  "endpoint": "issueInvoice",
+  "description": "Shop-Bestellung: die Position loest eine Reservierung der Lager-API ein",
+  "request": {
+    "idempotencyKey": "ex-19",
+    "priceMode": "gross",
+    "serviceStart": "2026-10-06",
+    "orderReference": "Bestellung 1001",
+    "stockLocationId": "haupt",
+    "items": [
+      {
+        "description": "Kaisersemmel",
+        "quantity": 6,
+        "unitPriceCents": 65,
+        "vatRate": 10,
+        "articleId": "kaisersemmel",
+        "reservationId": "res_example"
+      }
+    ]
+  },
+  "expected": {
+    "ok": true
+  }
+}

package/fixtures/invoice-api-examples/issue-vat-id-risk.json

@@ -0,0 +1,28 @@
+{
+  "endpoint": "issueInvoice",
+  "description": "Innergemeinschaftliche Lieferung, Risiko einer noch offenen UID-Prüfung übernommen",
+  "request": {
+    "idempotencyKey": "ex-vat-id-1",
+    "customerId": "customer_example",
+    "taxScheme": "intraCommunitySupply",
+    "priceMode": "net",
+    "serviceStart": "2026-10-06",
+    "acceptVatIdRisk": true,
+    "items": [
+      {
+        "description": "Ware",
+        "quantity": 2,
+        "unitPriceCents": 5000,
+        "vatRate": 0
+      }
+    ]
+  },
+  "expected": {
+    "ok": true,
+    "totals": {
+      "netCents": 10000,
+      "vatCents": 0,
+      "grossCents": 10000
+    }
+  }
+}

package/fixtures/invoice-api.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "Kasseneck Rechnungs-API",
   "version": 2,
-  "package": "1.3.0",
+  "package": "1.5.0",
   "endpoints": {
     "createCustomer": {
       "request": {
@@ -466,6 +466,11 @@
                   "type": "string",
                   "minLength": 1,
                   "maxLength": 128
+                },
+                "reservationId": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 128
                 }
               },
               "required": [
@@ -552,6 +557,9 @@
           },
           "dryRun": {
             "type": "boolean"
+          },
+          "acceptVatIdRisk": {
+            "type": "boolean"
           }
         },
         "required": [
@@ -999,7 +1007,12 @@
     "mixed_supply_not_allowed",
     "oss_not_enabled",
     "einvoice_unavailable",
-    "amount_too_large"
+    "amount_too_large",
+    "vat_id_invalid",
+    "vat_id_check_pending",
+    "reservation_not_found",
+    "reservation_mismatch",
+    "reservation_not_active"
   ],
   "creditNoteReasons": [
     "cancellation",

package/fixtures/invoice-texts.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3.0",
+  "version": "1.5.0",
   "languages": [
     "de",
     "en"

package/fixtures/pos-texts.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3.0",
+  "version": "1.5.0",
   "messages": {
     "network.no_connection": {
       "text": "Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen."