@kreiseck/kasseneck-api 1.4.0 → 1.5.1

package/dist/cjs/inventory/vertrag.js

@@ -1,17 +1,20 @@
 "use strict";
 /**
- * Der Vertrag der Lager-API (Backend Stufe 5a) als Daten: Endpunkte,
- * Wertkataloge, Ereignisse und Fehlercodes, englisch wie am Draht `/v3`.
+ * Der Vertrag der Lager-API (Backend Stufe 5a lesen, 5b schreiben und
+ * reservieren) als Daten: Endpunkte, Wertkataloge, Ereignisse, Fehler- und
+ * Hinweiscodes, englisch wie am Draht `/v3`.
  *
  * Quelle ist der Vertrags-Export des Backends (`fixtures/v3/v3-vokabular.json`):
  * `endpoints.public`, die Kataloge `STANDORT_TYP`, `BEWEGUNG_ART`,
- * `BEWEGUNG_QUELLE`, `LAGER_ZUSTAND`, `LAGER_URSACHE`, `ZUSTELLUNG` und
- * `events`. `test/inventory.test.ts` haelt jede Liste deckungsgleich mit
- * dieser Datei; nichts hier wird geraten.
+ * `BEWEGUNG_QUELLE`, `LAGER_ZUSTAND`, `LAGER_URSACHE`, `ZUSTELLUNG`,
+ * `LAGER_ABGANG_GRUND`, `LAGER_ENTNAHME_ART`, `LAGER_NEBENKOSTEN_ART`,
+ * `LAGER_VERTEILUNG`, `RESERVIERUNG_STATUS`, dazu `events`, `errorCodes.inventory`
+ * und `warningCodes.inventory`. `test/inventory.test.ts` haelt jede Liste
+ * deckungsgleich mit dieser Datei; nichts hier wird geraten.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.INVENTORY_REQUEST_ERROR_CODES = exports.INVENTORY_ERROR_CODES = exports.INVENTORY_LIST_LIMIT_MAX = exports.INVENTORY_WEBHOOK_LIMIT = exports.INVENTORY_WEBHOOK_ENVELOPE_FIELDS = exports.INVENTORY_WEBHOOK_EVENTS = exports.WEBHOOK_DELIVERY_STATUSES = exports.STOCK_CHANGE_CAUSES = exports.STOCK_CONDITIONS = exports.STOCK_MOVEMENT_SOURCES = exports.STOCK_MOVEMENT_TYPES = exports.LOCATION_TYPES = exports.INVENTORY_ENDPOINTS = void 0;
-/** Die 14 Endpunkte, in der Reihenfolge von `endpoints.public`. */
+exports.RESERVATION_MINUTES_MAX = exports.RESERVATION_MINUTES_MIN = exports.INVENTORY_IDEMPOTENCY_KEY_MAX = exports.RESERVATION_STATUSES = exports.LANDED_COST_ALLOCATIONS = exports.LANDED_COST_TYPES = exports.WITHDRAWAL_TYPES = exports.STOCK_LOSS_REASONS = exports.STOCK_KINDS = exports.INVENTORY_WARNING_CODES = exports.INVENTORY_REQUEST_ERROR_CODES = exports.INVENTORY_ERROR_CODES = exports.INVENTORY_LIST_LIMIT_MAX = exports.INVENTORY_WEBHOOK_LIMIT = exports.INVENTORY_WEBHOOK_ENVELOPE_FIELDS = exports.INVENTORY_WEBHOOK_EVENTS = exports.WEBHOOK_DELIVERY_STATUSES = exports.STOCK_CHANGE_CAUSES = exports.STOCK_CONDITIONS = exports.STOCK_MOVEMENT_SOURCES = exports.STOCK_MOVEMENT_TYPES = exports.LOCATION_TYPES = exports.INVENTORY_ENDPOINTS = void 0;
+/** Die 27 Endpunkte (14 aus 5a, 13 aus 5b), in der Reihenfolge von `endpoints.public`. */
 exports.INVENTORY_ENDPOINTS = [
     'getArticle',
     'listArticles',
@@ -27,6 +30,19 @@ exports.INVENTORY_ENDPOINTS = [
     'sendWebhookTest',
     'rotateWebhookSecret',
     'listWebhookDeliveries',
+    'createArticle',
+    'updateArticle',
+    'deactivateArticle',
+    'receiveGoods',
+    'transferStock',
+    'recordStockLoss',
+    'changeStockCondition',
+    'reverseStockMovement',
+    'createReservation',
+    'extendReservation',
+    'releaseReservation',
+    'getReservation',
+    'listReservations',
 ];
 /** Art eines Standorts (Katalog `STANDORT_TYP`). */
 exports.LOCATION_TYPES = ['warehouse', 'store', 'vehicle', 'other'];
@@ -34,6 +50,8 @@ exports.LOCATION_TYPES = ['warehouse', 'store', 'vehicle', 'other'];
  * Art einer Lagerbewegung (Katalog `BEWEGUNG_ART`); zugleich der Filter `type`.
  * `goods_receipt` ist der Wareneingang, `takeover` der uebernommene Anfangsbestand
  * (auch per Import). `receipt` gibt es hier nicht: das ist der Kassenbeleg (Quelle).
+ * `reservation` (seit 1.5.0) aendert nur `reserved`: `quantityDelta` ist 0, die
+ * Menge steht in `reservedDelta`.
  */
 exports.STOCK_MOVEMENT_TYPES = [
     'sale',
@@ -50,6 +68,7 @@ exports.STOCK_MOVEMENT_TYPES = [
     'reversal',
     'revaluation',
     'method_change',
+    'reservation',
 ];
 /**
  * Woher eine Bewegung kommt (Katalog `BEWEGUNG_QUELLE`); zugleich der Filter
@@ -92,8 +111,11 @@ exports.STOCK_CHANGE_CAUSES = [
 /** Stand einer Zustellung (Katalog `ZUSTELLUNG`, derselbe wie bei Partner-Webhooks). */
 exports.WEBHOOK_DELIVERY_STATUSES = ['delivered', 'pending', 'failed', 'dropped'];
 /**
- * Die Ereignisse, die ein Konto-Webhook abonnieren kann (Stufe 5a). Spaetere
- * Stufen ergaenzen `reservation.*` und `variant_group.*`.
+ * Die Ereignisse, die ein Konto-Webhook abonnieren kann, in der Reihenfolge von
+ * `listWebhooks().events`. `reservation.*` (seit 1.5.0) tragen die Reservierung
+ * wie `getReservation`, mit dem Status danach: `reservation.released` und
+ * `reservation.redeemed` kommen bei jeder wirksamen Freigabe bzw. Einloesung,
+ * auch einer teilweisen (dann bleibt der Status `active`).
  */
 exports.INVENTORY_WEBHOOK_EVENTS = [
     'stock.changed',
@@ -101,6 +123,9 @@ exports.INVENTORY_WEBHOOK_EVENTS = [
     'article.created',
     'article.updated',
     'article.deactivated',
+    'reservation.expired',
+    'reservation.released',
+    'reservation.redeemed',
 ];
 /**
  * Die Felder der Huelle jeder Zustellung, in der Reihenfolge am Draht. Statt
@@ -113,10 +138,21 @@ exports.INVENTORY_WEBHOOK_LIMIT = 5;
 /** Groesstes `limit` einer Liste; ohne Angabe liefert der Server 50. */
 exports.INVENTORY_LIST_LIMIT_MAX = 200;
 /**
- * Die Codes, die die Lager-Endpunkte selbst senden. `validation` traegt
- * `errors: [{ field, message }]`, `rate_limited` traegt `retryAfterSec`
- * (dazu die Kopfzeile `Retry-After`) – auch bei `sendWebhookTest` nach 20
- * Probesendungen je Wiener Kalendertag (dann bis Mitternacht in Wien).
+ * Die Codes, die die Lager-Endpunkte selbst senden (`errorCodes.inventory`;
+ * `register_user_not_allowed` steht bei [INVENTORY_REQUEST_ERROR_CODES]).
+ * `validation` traegt `errors: [{ field, message }]`, `rate_limited` traegt
+ * `retryAfterSec` (dazu die Kopfzeile `Retry-After`) – auch bei
+ * `sendWebhookTest` nach 20 Probesendungen je Wiener Kalendertag (dann bis
+ * Mitternacht in Wien).
+ *
+ * Seit 1.5.0 hinten angehaengt, in der Reihenfolge des Vertrags: die Codes
+ * der schreibenden Endpunkte. `idempotency_key_required` (Schluessel fehlt),
+ * `idempotency_conflict` (derselbe Schluessel mit anderem Inhalt),
+ * `exceeds_stock` (Abgang, Umbuchung und Zustandswechsel ueberziehen nie),
+ * `insufficient_available` (Reservierung; `data.details[]`, siehe
+ * [inventoryShortfalls]), `code_taken` und `external_id_taken` (mit `field` und
+ * `articleId` des Artikels, dem der Code gehoert), `stock_kind_locked`,
+ * `reservation_not_found`, `reservation_not_active` …
  */
 exports.INVENTORY_ERROR_CODES = [
     'validation',
@@ -131,6 +167,55 @@ exports.INVENTORY_ERROR_CODES = [
     'module_inactive',
     'rate_limited',
     'server_error',
+    'idempotency_key_required',
+    'idempotency_conflict',
+    'location_not_found',
+    'location_inactive',
+    'invalid_location',
+    'invalid_locations',
+    'invalid_transfer',
+    'operation_not_found',
+    'already_reversed',
+    'reversal_not_possible',
+    'reversal_not_supported',
+    'exceeds_stock',
+    'no_positions',
+    'too_many_positions',
+    'invalid_step',
+    'invalid_quantity',
+    'invalid_amount',
+    'invalid_price',
+    'negative_value',
+    'invalid_reason',
+    'note_required',
+    'withdrawal_type_required',
+    'invalid_method',
+    'invalid_stock_kind',
+    'invalid_minimum',
+    'invalid_dimensions',
+    'weight_missing',
+    'invalid_landed_cost',
+    'invalid_distribution',
+    'landed_costs_mismatch',
+    'return_totals_mismatch',
+    'lot_not_found',
+    'invalid_serial',
+    'serial_required',
+    'serial_not_allowed',
+    'serial_already_exists',
+    'serial_not_in_stock',
+    'code_taken',
+    'external_id_taken',
+    'group_not_found',
+    'revenue_group_not_found',
+    'stock_kind_locked',
+    'article_inactive',
+    'invalid_position',
+    'invalid_condition',
+    'reason_required',
+    'insufficient_available',
+    'reservation_not_found',
+    'reservation_not_active',
 ];
 /**
  * Codes, die Anmeldung und Rand auf jedem Lager-Aufruf erzeugen koennen,
@@ -164,3 +249,43 @@ exports.INVENTORY_REQUEST_ERROR_CODES = [
     'user_verification_failed',
     'route_missing',
 ];
+// ---- Schreiben und Reservierung (Backend Stufe 5b, seit 1.5.0) -----------------
+/**
+ * Hinweise einer Buchung (`warnings[].code`, `warningCodes.inventory`). Sie sind
+ * keine Fehler: die Buchung hat gewirkt. `insufficient_stock` gibt es nur beim
+ * Verkauf (Abgang, Umbuchung und Zustandswechsel weisen mit `exceeds_stock` ab),
+ * `below_minimum` misst am verfuegbaren Bestand (`onHand − reserved`) gegen den
+ * Mindestbestand des Standorts, `reservation_exceeded` meldet eine Rechnung, die
+ * mehr verkauft als reserviert war.
+ */
+exports.INVENTORY_WARNING_CODES = [
+    'insufficient_stock',
+    'below_minimum',
+    'return_exceeds_sale',
+    'reservation_exceeded',
+];
+/**
+ * Bestandsart eines Artikels (`stockKind`): `quantity` = Menge, `serial` =
+ * Einzelstueck mit Seriennummer. Kein Katalog des Vokabulars, der Server
+ * uebersetzt das Feld selbst; nach der ersten Bewegung fest (`stock_kind_locked`).
+ */
+exports.STOCK_KINDS = ['quantity', 'serial'];
+/** Grund eines Abgangs (`recordStockLoss.reason`, Katalog `LAGER_ABGANG_GRUND`). `other` braucht `note`. */
+exports.STOCK_LOSS_REASONS = ['breakage', 'shrinkage', 'theft', 'expired', 'withdrawal', 'disposal', 'other'];
+/** Art einer Entnahme (`withdrawalType`, Katalog `LAGER_ENTNAHME_ART`); Pflicht bei `reason: 'withdrawal'`, sonst nicht erlaubt. */
+exports.WITHDRAWAL_TYPES = ['private', 'staff', 'gift', 'sample'];
+/** Art von Nebenkosten eines Wareneingangs (`landedCosts[].type`, Katalog `LAGER_NEBENKOSTEN_ART`). */
+exports.LANDED_COST_TYPES = ['freight', 'customs', 'insurance', 'other', 'discount', 'cash_discount'];
+/** Verteilung der Nebenkosten (`allocation`, Katalog `LAGER_VERTEILUNG`); Vorgabe des Servers `value`. */
+exports.LANDED_COST_ALLOCATIONS = ['value', 'quantity', 'weight', 'manual'];
+/**
+ * Stand einer Reservierung (Katalog `RESERVIERUNG_STATUS`). Nur `active` haelt
+ * Ware zurueck; die drei anderen sind endgueltig: `redeemed` (ueber eine
+ * Rechnung eingeloest), `released` (freigegeben), `expired` (abgelaufen).
+ */
+exports.RESERVATION_STATUSES = ['active', 'redeemed', 'released', 'expired'];
+/** Laengster `idempotencyKey` (Zeichen); laenger weist der Server ab, er schneidet nie ab. */
+exports.INVENTORY_IDEMPOTENCY_KEY_MAX = 120;
+/** Kuerzeste und laengste Haltedauer einer Reservierung in Minuten (`expiresInMinutes`, 30 Tage). */
+exports.RESERVATION_MINUTES_MIN = 5;
+exports.RESERVATION_MINUTES_MAX = 43_200;

package/dist/cjs/inventory/webhook.d.ts

@@ -39,8 +39,10 @@ export declare function verifyInventoryWebhookSignature(secret: string | readonl
  * Liest eine Zustellung als typisiertes Ereignis. Vorher die Signatur pruefen
  * ([verifyInventoryWebhookSignature]).
  *
- * - Ein Ereignis, das diese Paketversion nicht kennt (etwa `reservation.*`
+ * - Ein Ereignis, das diese Paketversion nicht kennt (etwa `variant_group.*`
  *   einer spaeteren Stufe), ergibt `null`: mit 2xx antworten und uebergehen.
+ * - `reservation.expired|released|redeemed` tragen die Reservierung wie
+ *   `getReservation`, mit dem Status nach dem Vorgang (seit 1.5.0).
  * - Ein Rumpf, der keine Huelle ist, oder eine Bruchzahl in einer Menge wirft
  *   `KasseneckValidationError` (`scope: 'response'`).
  *

package/dist/cjs/inventory/webhook.js

@@ -65,8 +65,10 @@ function kaputt(grund) {
  * Liest eine Zustellung als typisiertes Ereignis. Vorher die Signatur pruefen
  * ([verifyInventoryWebhookSignature]).
  *
- * - Ein Ereignis, das diese Paketversion nicht kennt (etwa `reservation.*`
+ * - Ein Ereignis, das diese Paketversion nicht kennt (etwa `variant_group.*`
  *   einer spaeteren Stufe), ergibt `null`: mit 2xx antworten und uebergehen.
+ * - `reservation.expired|released|redeemed` tragen die Reservierung wie
+ *   `getReservation`, mit dem Status nach dem Vorgang (seit 1.5.0).
  * - Ein Rumpf, der keine Huelle ist, oder eine Bruchzahl in einer Menge wirft
  *   `KasseneckValidationError` (`scope: 'response'`).
  *
@@ -104,6 +106,10 @@ function parseInventoryWebhookEvent(rawBody) {
             return { ...huelle, type: huelle.type, data: (0, lesen_js_1.bestandGeaendert)(ort, data) };
         case 'stock.below_minimum':
             return { ...huelle, type: huelle.type, data: (0, lesen_js_1.unterMindestbestand)(ort, data) };
+        case 'reservation.expired':
+        case 'reservation.released':
+        case 'reservation.redeemed':
+            return { ...huelle, type: huelle.type, data: (0, lesen_js_1.reservierung)(ort, data) };
         default:
             return { ...huelle, type: huelle.type, data: (0, lesen_js_1.artikel)(ort, data) };
     }

package/dist/cjs/invoice/endpunkte.d.ts

@@ -12,6 +12,12 @@
  * **Nicht automatisch wiederholen.** Wer nach einem Zeitlimit erneut
  * ausstellt, tut das mit **demselben** `idempotencyKey`: dann kommt die schon
  * ausgestellte Rechnung zurueck (`replayed: true`) statt einer zweiten.
+ * Jeder Aufruf mit Wirkung (ausstellen, stornieren, gutschreiben, Zahlung
+ * nachtragen, Kunde anlegen oder aendern) meldet nach Zeitlimit, Netzfehler,
+ * HTTP 5xx oder unlesbarer Antwort `outcome: 'unknown'`: er kann gewirkt
+ * haben. Mit Schluessel denselben Schluessel erneut senden, ohne Schluessel
+ * (`updateCustomer`, `createCustomer` ohne) erst nachlesen. Lesen und der
+ * Probelauf (`previewInvoice`) bleiben `'rejected'`.
  *
  * Nach dem Senden wird nichts hart gecastet: fehlt ein zugesagtes Feld, wirft
  * der Aufruf `KasseneckValidationError` mit `scope:'response'`.

package/dist/cjs/invoice/endpunkte.js

@@ -13,6 +13,12 @@
  * **Nicht automatisch wiederholen.** Wer nach einem Zeitlimit erneut
  * ausstellt, tut das mit **demselben** `idempotencyKey`: dann kommt die schon
  * ausgestellte Rechnung zurueck (`replayed: true`) statt einer zweiten.
+ * Jeder Aufruf mit Wirkung (ausstellen, stornieren, gutschreiben, Zahlung
+ * nachtragen, Kunde anlegen oder aendern) meldet nach Zeitlimit, Netzfehler,
+ * HTTP 5xx oder unlesbarer Antwort `outcome: 'unknown'`: er kann gewirkt
+ * haben. Mit Schluessel denselben Schluessel erneut senden, ohne Schluessel
+ * (`updateCustomer`, `createCustomer` ohne) erst nachlesen. Lesen und der
+ * Probelauf (`previewInvoice`) bleiben `'rejected'`.
  *
  * Nach dem Senden wird nichts hart gecastet: fehlt ein zugesagtes Feld, wirft
  * der Aufruf `KasseneckValidationError` mit `scope:'response'`.
@@ -110,7 +116,10 @@ async function searchCustomers(transport, search) {
 }
 // ---- Rechnungen -------------------------------------------------------------
 async function issueInvoice(transport, request) {
-    const daten = await transport('issueInvoice', nutzlast(request));
+    const params = nutzlast(request);
+    // Ohne Typen kann `dryRun: true` hier ankommen: dann ist es ein Probelauf
+    // ohne Wirkung (sonst: `previewInvoice`).
+    const daten = await transport('issueInvoice', params, undefined, undefined, { hasEffect: params['dryRun'] !== true });
     const ergebnis = {
         invoice: pflichtObjekt('issueInvoice', daten, 'invoice'),
         replayed: objekt(daten)['replayed'] === true,
@@ -131,7 +140,9 @@ async function issueInvoice(transport, request) {
  * Probelauf und Ausstellen kann sich der Kunde oder das Konto aendern.
  */
 async function previewInvoice(transport, request) {
-    const daten = await transport('issueInvoice', { ...nutzlast(request), dryRun: true });
+    // Ein Probelauf schreibt nichts: nach einem Zeitlimit bleibt er `rejected`,
+    // obwohl `issueInvoice` sonst Wirkung hat.
+    const daten = await transport('issueInvoice', { ...nutzlast(request), dryRun: true }, undefined, undefined, { hasEffect: false });
     const ergebnis = { preview: pflichtObjekt('issueInvoice', daten, 'preview') };
     const notice = hinweise(daten);
     if (notice)

package/dist/cjs/invoice/index.d.ts

@@ -14,8 +14,8 @@ export { createInvoiceApi, type InvoiceApi, type InvoiceApiOptions } from './api
 export { invoiceKeyAuth, type InvoiceKeyAuthOptions } from './auth.js';
 export { isInvoiceError, isInvoiceErrorCode, invoiceErrorCode, invoiceFieldErrors, type InvoiceApiErrorCode, type InvoiceFieldError, } from './fehler.js';
 export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoice, getInvoicePdf, getInvoiceSetupStatus, getInvoiceXml, issueInvoice, listBrands, listInvoices, previewInvoice, recordInvoicePayment, searchCustomers, updateCustomer, } from './endpunkte.js';
-export type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteItemInput, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, EInvoiceStatus, Invoice, InvoiceDetail, InvoiceDetailPayment, InvoiceItem, InvoiceItemInput, InvoiceListQuery, InvoicePage, InvoiceRecipient, InvoiceSetupGap, InvoiceSetupStatus, InvoiceTotals, InvoiceXml, InvoiceNotice, InvoicePayment, InvoicePreview, InvoiceRateTotals, IssueInvoiceRequest, IssueResult, PaymentInput, PreviewResult, RecordPaymentRequest, RecordPaymentResult, } from './typen.js';
+export type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteItemInput, CreditNoteRequest, CreditNoteResult, Customer, CustomerInput, CustomerPage, CustomerSearch, EInvoiceStatus, Invoice, InvoiceDetail, InvoiceDetailPayment, InvoiceItem, InvoiceItemInput, IssueInvoiceItemInput, InvoiceListQuery, InvoicePage, InvoiceRecipient, InvoiceSetupGap, InvoiceSetupStatus, InvoiceTotals, InvoiceXml, InvoiceNotice, InvoicePayment, InvoicePreview, InvoiceRateTotals, InvoiceVatIdProof, InvoiceVatIdRisk, IssueInvoiceRequest, IssueResult, PaymentInput, PreviewResult, RecordPaymentRequest, RecordPaymentResult, } from './typen.js';
 export { INVOICE_TEXTS, invoiceText, type InvoiceTextKey } from './texte.js';
 export { computeInvoiceTotals, ZERO_RATED_TAX_SCHEMES, type TotalsItem } from './summen.js';
 export { proratedPriceMicros, MAX_AMOUNT_CENTS, itemFromEuro, formatUnitPrice, CalcError, calculateInvoice, roundDiv, vatRateMapKey, formatVatRate, type CalcResult, type CalcErrorCode, type CalcOptions, type CalcItem, type RateTotal, type ItemConversion, type ConversionReason, type LineAmount, } from './calc.js';
-export { INVOICE_CONTRACT_VERSION, INVOICE_ENDPOINTS, INVOICE_ERROR_CODES, INVOICE_REQUEST_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, EINVOICE_MISSING_CODES, WRITE_OFF_REASON_CODES, INVOICE_LANGUAGES, INVOICE_PAYMENT_METHODS, ITEM_KINDS, REVERSE_CHARGE_REASONS, INVOICE_NOTICE_CODES, INVOICE_UNITS, INVOICE_UNIT_CODES, INVOICE_SETUP_REQUIREMENTS, CUSTOMER_FIELDS, ITEM_FIELDS, CREDIT_NOTE_ITEM_FIELDS, RETURN_DISPOSITIONS, ITEM_PRICE_EXACTLY_ONE, INVOICE_REQUESTS, INVOICE_EXACTLY_ONE, INVOICE_AT_LEAST_ONE, type InvoiceEndpoint, type InvoiceErrorCode, type InvoiceRequestErrorCode, type CreditNoteReason, type ReturnDisposition, type TaxScheme, type PriceMode, type VatRatePercent, type CustomerType, type InvoiceListStatus, type DocType, type EInvoiceFormat, type EInvoiceMissingCode, type WriteOffReasonCode, type InvoiceLanguage, type InvoicePaymentMethod, type ItemKind, type ReverseChargeReason, type InvoiceNoticeCode, type InvoiceUnit, type InvoiceSetupRequirement, type FieldFormat, type Field, } from './vertrag.js';
+export { INVOICE_CONTRACT_VERSION, INVOICE_ENDPOINTS, INVOICE_ERROR_CODES, INVOICE_REQUEST_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, EINVOICE_MISSING_CODES, WRITE_OFF_REASON_CODES, INVOICE_LANGUAGES, INVOICE_PAYMENT_METHODS, ITEM_KINDS, REVERSE_CHARGE_REASONS, INVOICE_NOTICE_CODES, INVOICE_UNITS, INVOICE_UNIT_CODES, INVOICE_SETUP_REQUIREMENTS, CUSTOMER_FIELDS, ITEM_FIELDS, INVOICE_ITEM_FIELDS, CREDIT_NOTE_ITEM_FIELDS, RETURN_DISPOSITIONS, ITEM_PRICE_EXACTLY_ONE, INVOICE_REQUESTS, INVOICE_EXACTLY_ONE, INVOICE_AT_LEAST_ONE, type InvoiceEndpoint, type InvoiceErrorCode, type InvoiceRequestErrorCode, type CreditNoteReason, type ReturnDisposition, type TaxScheme, type PriceMode, type VatRatePercent, type CustomerType, type InvoiceListStatus, type DocType, type EInvoiceFormat, type EInvoiceMissingCode, type WriteOffReasonCode, type InvoiceLanguage, type InvoicePaymentMethod, type ItemKind, type ReverseChargeReason, type InvoiceNoticeCode, type InvoiceUnit, type InvoiceSetupRequirement, type FieldFormat, type Field, } from './vertrag.js';

package/dist/cjs/invoice/index.js

@@ -13,7 +13,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.INVOICE_PAYMENT_METHODS = exports.INVOICE_LANGUAGES = exports.WRITE_OFF_REASON_CODES = exports.EINVOICE_MISSING_CODES = exports.EINVOICE_FORMATS = exports.DOC_TYPES = exports.INVOICE_LIST_STATUS = exports.CUSTOMER_TYPES = exports.VAT_RATES = exports.PRICE_MODES = exports.TAX_SCHEMES = exports.CREDIT_NOTE_REASONS = exports.INVOICE_REQUEST_ERROR_CODES = exports.INVOICE_ERROR_CODES = exports.INVOICE_ENDPOINTS = exports.INVOICE_CONTRACT_VERSION = exports.formatVatRate = exports.vatRateMapKey = exports.roundDiv = exports.calculateInvoice = exports.CalcError = exports.formatUnitPrice = exports.itemFromEuro = exports.MAX_AMOUNT_CENTS = exports.proratedPriceMicros = exports.ZERO_RATED_TAX_SCHEMES = exports.computeInvoiceTotals = exports.invoiceText = exports.INVOICE_TEXTS = exports.updateCustomer = exports.searchCustomers = exports.recordInvoicePayment = exports.previewInvoice = exports.listInvoices = exports.listBrands = exports.issueInvoice = exports.getInvoiceXml = exports.getInvoiceSetupStatus = exports.getInvoicePdf = exports.getInvoice = exports.getCustomer = exports.createCustomer = exports.createCreditNote = exports.cancelInvoice = exports.invoiceFieldErrors = exports.invoiceErrorCode = exports.isInvoiceErrorCode = exports.isInvoiceError = exports.invoiceKeyAuth = exports.createInvoiceApi = void 0;
-exports.INVOICE_AT_LEAST_ONE = exports.INVOICE_EXACTLY_ONE = exports.INVOICE_REQUESTS = exports.ITEM_PRICE_EXACTLY_ONE = exports.RETURN_DISPOSITIONS = exports.CREDIT_NOTE_ITEM_FIELDS = exports.ITEM_FIELDS = exports.CUSTOMER_FIELDS = exports.INVOICE_SETUP_REQUIREMENTS = exports.INVOICE_UNIT_CODES = exports.INVOICE_UNITS = exports.INVOICE_NOTICE_CODES = exports.REVERSE_CHARGE_REASONS = exports.ITEM_KINDS = void 0;
+exports.INVOICE_AT_LEAST_ONE = exports.INVOICE_EXACTLY_ONE = exports.INVOICE_REQUESTS = exports.ITEM_PRICE_EXACTLY_ONE = exports.RETURN_DISPOSITIONS = exports.CREDIT_NOTE_ITEM_FIELDS = exports.INVOICE_ITEM_FIELDS = exports.ITEM_FIELDS = exports.CUSTOMER_FIELDS = exports.INVOICE_SETUP_REQUIREMENTS = exports.INVOICE_UNIT_CODES = exports.INVOICE_UNITS = exports.INVOICE_NOTICE_CODES = exports.REVERSE_CHARGE_REASONS = exports.ITEM_KINDS = void 0;
 var api_js_1 = require("./api.js");
 Object.defineProperty(exports, "createInvoiceApi", { enumerable: true, get: function () { return api_js_1.createInvoiceApi; } });
 var auth_js_1 = require("./auth.js");
@@ -80,6 +80,7 @@ Object.defineProperty(exports, "INVOICE_UNIT_CODES", { enumerable: true, get: fu
 Object.defineProperty(exports, "INVOICE_SETUP_REQUIREMENTS", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_SETUP_REQUIREMENTS; } });
 Object.defineProperty(exports, "CUSTOMER_FIELDS", { enumerable: true, get: function () { return vertrag_js_1.CUSTOMER_FIELDS; } });
 Object.defineProperty(exports, "ITEM_FIELDS", { enumerable: true, get: function () { return vertrag_js_1.ITEM_FIELDS; } });
+Object.defineProperty(exports, "INVOICE_ITEM_FIELDS", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_ITEM_FIELDS; } });
 Object.defineProperty(exports, "CREDIT_NOTE_ITEM_FIELDS", { enumerable: true, get: function () { return vertrag_js_1.CREDIT_NOTE_ITEM_FIELDS; } });
 Object.defineProperty(exports, "RETURN_DISPOSITIONS", { enumerable: true, get: function () { return vertrag_js_1.RETURN_DISPOSITIONS; } });
 Object.defineProperty(exports, "ITEM_PRICE_EXACTLY_ONE", { enumerable: true, get: function () { return vertrag_js_1.ITEM_PRICE_EXACTLY_ONE; } });

package/dist/cjs/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/cjs/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/cjs/invoice/vertrag.js

@@ -19,7 +19,7 @@
  * Nummer, Summen — ist bewusst **nicht** setzbar.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.INVOICE_AT_LEAST_ONE = exports.INVOICE_EXACTLY_ONE = exports.INVOICE_REQUESTS = exports.PAYMENT_FIELDS = exports.CREDIT_NOTE_ITEM_FIELDS = exports.ITEM_PRICE_EXACTLY_ONE = exports.ITEM_FIELDS = exports.CUSTOMER_FIELDS = exports.INVOICE_SETUP_REQUIREMENTS = exports.INVOICE_UNIT_CODES = exports.INVOICE_UNITS = exports.INVOICE_NOTICE_CODES = exports.INVOICE_PAYMENT_METHODS = exports.INVOICE_LANGUAGES = exports.WRITE_OFF_REASON_CODES = exports.EINVOICE_MISSING_CODES = exports.EINVOICE_FORMATS = exports.DOC_TYPES = exports.INVOICE_LIST_STATUS = exports.CUSTOMER_TYPES = exports.VAT_RATES = exports.PRICE_MODES = exports.ITEM_KINDS = exports.REVERSE_CHARGE_REASONS = exports.TAX_SCHEMES = exports.CREDIT_NOTE_REASONS = exports.INVOICE_REQUEST_ERROR_CODES = exports.INVOICE_ERROR_CODES = exports.INVOICE_ENDPOINTS = exports.INVOICE_CONTRACT_VERSION = exports.RETURN_DISPOSITIONS = void 0;
+exports.INVOICE_AT_LEAST_ONE = exports.INVOICE_EXACTLY_ONE = exports.INVOICE_REQUESTS = exports.PAYMENT_FIELDS = exports.CREDIT_NOTE_ITEM_FIELDS = exports.ITEM_PRICE_EXACTLY_ONE = exports.INVOICE_ITEM_FIELDS = exports.ITEM_FIELDS = exports.CUSTOMER_FIELDS = exports.INVOICE_SETUP_REQUIREMENTS = exports.INVOICE_UNIT_CODES = exports.INVOICE_UNITS = exports.INVOICE_NOTICE_CODES = exports.INVOICE_PAYMENT_METHODS = exports.INVOICE_LANGUAGES = exports.WRITE_OFF_REASON_CODES = exports.EINVOICE_MISSING_CODES = exports.EINVOICE_FORMATS = exports.DOC_TYPES = exports.INVOICE_LIST_STATUS = exports.CUSTOMER_TYPES = exports.VAT_RATES = exports.PRICE_MODES = exports.ITEM_KINDS = exports.REVERSE_CHARGE_REASONS = exports.TAX_SCHEMES = exports.CREDIT_NOTE_REASONS = exports.INVOICE_REQUEST_ERROR_CODES = exports.INVOICE_ERROR_CODES = exports.INVOICE_ENDPOINTS = exports.INVOICE_CONTRACT_VERSION = exports.RETURN_DISPOSITIONS = void 0;
 const cancellation_js_1 = require("../models/cancellation.js");
 Object.defineProperty(exports, "RETURN_DISPOSITIONS", { enumerable: true, get: function () { return cancellation_js_1.RETURN_DISPOSITIONS; } });
 exports.INVOICE_CONTRACT_VERSION = 2;
@@ -73,6 +73,13 @@ exports.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,
@@ -230,6 +237,10 @@ exports.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
@@ -432,6 +443,19 @@ exports.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`).
+ */
+exports.INVOICE_ITEM_FIELDS = Object.freeze({ ...exports.ITEM_FIELDS, reservationId: id });
 /** Genau einer der beiden Preise je Position (§ 9.1). */
 exports.ITEM_PRICE_EXACTLY_ONE = Object.freeze([
     Object.freeze(['unitPriceCents']),
@@ -443,15 +467,16 @@ const positionen = {
     min: 1,
     max: 500,
     item: {
-        type: 'object', required: true, fields: exports.ITEM_FIELDS, exactlyOne: exports.ITEM_PRICE_EXACTLY_ONE,
+        type: 'object', required: true, fields: exports.INVOICE_ITEM_FIELDS, exactlyOne: exports.ITEM_PRICE_EXACTLY_ONE,
     },
 };
 /** Rueckgabe-Wahl einer Gutschrift: Vorgabe des Aufrufs oder je Position. */
 const returnDisposition = { type: 'enum', required: false, values: cancellation_js_1.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.
  */
 exports.CREDIT_NOTE_ITEM_FIELDS = Object.freeze({ ...exports.ITEM_FIELDS, returnDisposition });
 const gutschriftPositionen = {
@@ -548,6 +573,13 @@ exports.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/cjs/pos/texte.d.ts

@@ -661,12 +661,17 @@ export interface ErrorRuleDetail {
 export declare function findErrorRule(kind: ErrorKind, detail?: ErrorRuleDetail): ErrorRule;
 /**
  * Kassen-Aufrufe mit Wirkung, die sich nach einem Netzfehler nicht gefahrlos
- * wiederholen lassen: die sechs, deren Ausgang das Paket selbst als unklar
- * fuehrt (Beleg, auch Null- und Startbeleg ueber `createReceipt`, Storno,
- * FinanzOnline, die drei Geldwege), dazu der Druckjob (zweiter Bon) und die
- * Belegmail (zweite Mail). Ob die Anfrage vor dem Abriss schon draussen war,
- * sieht das Paket nicht (fetch wirft in beiden Faellen gleich); darum gilt
- * hier immer der vorsichtige Satz.
+ * wiederholen lassen: Beleg (auch Null- und Startbeleg ueber
+ * `createReceipt`), Storno, FinanzOnline, die drei Geldwege, der Druckjob
+ * (zweiter Bon) und die Belegmail (zweite Mail). Ob die Anfrage vor dem
+ * Abriss schon draussen war, sieht das Paket nicht (fetch wirft in beiden
+ * Faellen gleich); darum gilt hier immer der vorsichtige Satz, auch fuer
+ * einen Fehler, der vor dem Senden entstand.
+ *
+ * Seit 1.5.1 fuehrt der Transport jeden Aufruf mit Wirkung als unklar
+ * (`UNKNOWN_OUTCOME_CALLS`, eine Obermenge dieser Liste), und
+ * [messageOutcome] folgt zuerst ihm. Die Liste bleibt als Vertrag der
+ * Kassentexte (`callsWithEffect` in `fixtures/pos-texts.json`) unveraendert.
  */
 export declare const CALLS_WITH_EFFECT: readonly ["createReceipt", "cancelReceipt", "financeWebService", "hobexPayApi", "hobexRefundApi", "stripeCaptureIntent", "createPrintJob", "sendReceiptEmail"];
 /**

package/dist/cjs/pos/texte.js

@@ -378,12 +378,17 @@ function findErrorRule(kind, detail = {}) {
 }
 /**
  * Kassen-Aufrufe mit Wirkung, die sich nach einem Netzfehler nicht gefahrlos
- * wiederholen lassen: die sechs, deren Ausgang das Paket selbst als unklar
- * fuehrt (Beleg, auch Null- und Startbeleg ueber `createReceipt`, Storno,
- * FinanzOnline, die drei Geldwege), dazu der Druckjob (zweiter Bon) und die
- * Belegmail (zweite Mail). Ob die Anfrage vor dem Abriss schon draussen war,
- * sieht das Paket nicht (fetch wirft in beiden Faellen gleich); darum gilt
- * hier immer der vorsichtige Satz.
+ * wiederholen lassen: Beleg (auch Null- und Startbeleg ueber
+ * `createReceipt`), Storno, FinanzOnline, die drei Geldwege, der Druckjob
+ * (zweiter Bon) und die Belegmail (zweite Mail). Ob die Anfrage vor dem
+ * Abriss schon draussen war, sieht das Paket nicht (fetch wirft in beiden
+ * Faellen gleich); darum gilt hier immer der vorsichtige Satz, auch fuer
+ * einen Fehler, der vor dem Senden entstand.
+ *
+ * Seit 1.5.1 fuehrt der Transport jeden Aufruf mit Wirkung als unklar
+ * (`UNKNOWN_OUTCOME_CALLS`, eine Obermenge dieser Liste), und
+ * [messageOutcome] folgt zuerst ihm. Die Liste bleibt als Vertrag der
+ * Kassentexte (`callsWithEffect` in `fixtures/pos-texts.json`) unveraendert.
  */
 exports.CALLS_WITH_EFFECT = Object.freeze([
     'createReceipt',

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

@@ -1,5 +1,5 @@
 /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
-export declare const VOKABULAR_QUELLE = "79931a40ccaea45777da4713bba475c2f74e1fe7d6264f294cecd321964f9ded";
+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 {