@kreiseck/kasseneck-api 1.4.0 → 1.5.1

package/dist/esm/inventory/vertrag.js

@@ -1,14 +1,17 @@
 /**
- * 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.
  */
-/** Die 14 Endpunkte, in der Reihenfolge von `endpoints.public`. */
+/** Die 27 Endpunkte (14 aus 5a, 13 aus 5b), in der Reihenfolge von `endpoints.public`. */
 export const INVENTORY_ENDPOINTS = [
     'getArticle',
     'listArticles',
@@ -24,6 +27,19 @@ export const INVENTORY_ENDPOINTS = [
     'sendWebhookTest',
     'rotateWebhookSecret',
     'listWebhookDeliveries',
+    'createArticle',
+    'updateArticle',
+    'deactivateArticle',
+    'receiveGoods',
+    'transferStock',
+    'recordStockLoss',
+    'changeStockCondition',
+    'reverseStockMovement',
+    'createReservation',
+    'extendReservation',
+    'releaseReservation',
+    'getReservation',
+    'listReservations',
 ];
 /** Art eines Standorts (Katalog `STANDORT_TYP`). */
 export const LOCATION_TYPES = ['warehouse', 'store', 'vehicle', 'other'];
@@ -31,6 +47,8 @@ export const 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`.
  */
 export const STOCK_MOVEMENT_TYPES = [
     'sale',
@@ -47,6 +65,7 @@ export const STOCK_MOVEMENT_TYPES = [
     'reversal',
     'revaluation',
     'method_change',
+    'reservation',
 ];
 /**
  * Woher eine Bewegung kommt (Katalog `BEWEGUNG_QUELLE`); zugleich der Filter
@@ -89,8 +108,11 @@ export const STOCK_CHANGE_CAUSES = [
 /** Stand einer Zustellung (Katalog `ZUSTELLUNG`, derselbe wie bei Partner-Webhooks). */
 export const 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`).
  */
 export const INVENTORY_WEBHOOK_EVENTS = [
     'stock.changed',
@@ -98,6 +120,9 @@ export const 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
@@ -110,10 +135,21 @@ export const INVENTORY_WEBHOOK_LIMIT = 5;
 /** Groesstes `limit` einer Liste; ohne Angabe liefert der Server 50. */
 export const 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` …
  */
 export const INVENTORY_ERROR_CODES = [
     'validation',
@@ -128,6 +164,55 @@ export const 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,
@@ -161,3 +246,43 @@ export const 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.
+ */
+export const 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`).
+ */
+export const STOCK_KINDS = ['quantity', 'serial'];
+/** Grund eines Abgangs (`recordStockLoss.reason`, Katalog `LAGER_ABGANG_GRUND`). `other` braucht `note`. */
+export const 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. */
+export const WITHDRAWAL_TYPES = ['private', 'staff', 'gift', 'sample'];
+/** Art von Nebenkosten eines Wareneingangs (`landedCosts[].type`, Katalog `LAGER_NEBENKOSTEN_ART`). */
+export const LANDED_COST_TYPES = ['freight', 'customs', 'insurance', 'other', 'discount', 'cash_discount'];
+/** Verteilung der Nebenkosten (`allocation`, Katalog `LAGER_VERTEILUNG`); Vorgabe des Servers `value`. */
+export const 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).
+ */
+export const RESERVATION_STATUSES = ['active', 'redeemed', 'released', 'expired'];
+/** Laengster `idempotencyKey` (Zeichen); laenger weist der Server ab, er schneidet nie ab. */
+export const INVENTORY_IDEMPOTENCY_KEY_MAX = 120;
+/** Kuerzeste und laengste Haltedauer einer Reservierung in Minuten (`expiresInMinutes`, 30 Tage). */
+export const RESERVATION_MINUTES_MIN = 5;
+export const RESERVATION_MINUTES_MAX = 43_200;

package/dist/esm/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/esm/inventory/webhook.js

@@ -15,7 +15,7 @@
  */
 import { KasseneckValidationError } from '../client/errors.js';
 import { verifyWebhookSignature as pruefeSignatur } from '../partner/webhook-signatur.js';
-import { artikel, bestandGeaendert, objekt, unterMindestbestand } from './lesen.js';
+import { artikel, bestandGeaendert, objekt, reservierung, unterMindestbestand } from './lesen.js';
 import { INVENTORY_WEBHOOK_EVENTS } from './vertrag.js';
 export { WEBHOOK_SIGNATURE_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_TOLERANCE_SEC, } from '../partner/webhook-signatur.js';
 /**
@@ -56,8 +56,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'`).
  *
@@ -95,6 +97,10 @@ export function parseInventoryWebhookEvent(rawBody) {
             return { ...huelle, type: huelle.type, data: bestandGeaendert(ort, data) };
         case 'stock.below_minimum':
             return { ...huelle, type: huelle.type, data: unterMindestbestand(ort, data) };
+        case 'reservation.expired':
+        case 'reservation.released':
+        case 'reservation.redeemed':
+            return { ...huelle, type: huelle.type, data: reservierung(ort, data) };
         default:
             return { ...huelle, type: huelle.type, data: artikel(ort, data) };
     }

package/dist/esm/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/esm/invoice/endpunkte.js

@@ -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'`.
@@ -93,7 +99,10 @@ export async function searchCustomers(transport, search) {
 }
 // ---- Rechnungen -------------------------------------------------------------
 export 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,
@@ -114,7 +123,9 @@ export async function issueInvoice(transport, request) {
  * Probelauf und Ausstellen kann sich der Kunde oder das Konto aendern.
  */
 export 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/esm/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/esm/invoice/index.js

@@ -17,4 +17,4 @@ export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoic
 export { INVOICE_TEXTS, invoiceText } from './texte.js';
 export { computeInvoiceTotals, ZERO_RATED_TAX_SCHEMES } from './summen.js';
 export { proratedPriceMicros, MAX_AMOUNT_CENTS, itemFromEuro, formatUnitPrice, CalcError, calculateInvoice, roundDiv, vatRateMapKey, formatVatRate, } 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, } 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, } from './vertrag.js';

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/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/esm/pos/texte.js

@@ -368,12 +368,17 @@ export 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.
  */
 export const CALLS_WITH_EFFECT = Object.freeze([
     'createReceipt',

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 = "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 {

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 = "79931a40ccaea45777da4713bba475c2f74e1fe7d6264f294cecd321964f9ded";
+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 = {