@kreiseck/kasseneck-api 0.26.0 → 0.27.1

package/CHANGELOG.md

@@ -4,6 +4,32 @@ Was vor 0.7.0 geschah, steht in der Commit-Historie (`git log`); ab hier wird
 es hier geführt. Ein Eintrag nennt die Änderung **und ihren Grund** —
 nur der Grund überlebt den nächsten Umbau.
 
+## 0.27.1
+
+- Drei Beispiele zum Mikropreis in `fixtures/rechnung-api-beispiele/`: der Sub-Cent-Fall
+  (3.500.000 × 0,000004 € = 14,00 € netto), beide Preise gesetzt und kein Preis gesetzt. Sie sind
+  zugleich die Prüfvektoren, die Server und Dart-Zwilling gegen ihre eigene Prüfung fahren — ein
+  Beispiel, das nur in der Doku steht, veraltet unbemerkt.
+
+## 0.27.0
+
+- **Rechnungs-API: der Einzelpreis einer Position darf in Mikro-Euro stehen** (`unitPriceMicros`,
+  10⁻⁶ €). Genau eines von `unitPriceCents` und `unitPriceMicros` — beide Felder sind dafür
+  optional, und die neue Genau-eins-Regel am Positions-Objekt wird im JSON Schema zu
+  `oneOf: [{required:['unitPriceCents']}, {required:['unitPriceMicros']}]`. Grund: Preise unterhalb
+  eines Cents (Verbrauchsabrechnung, Stückpreise im Zehntelcent) mussten bisher schon beim
+  Einreichen gerundet werden; der Rundungsfehler steckte danach in jeder Zeile.
+  **Bricht die Form:** wer den Typ `IssueInvoiceItem` selbst baut, bekommt `unitPriceCents` jetzt
+  als optionales Feld. Anfragen, die es setzen, bleiben unverändert gültig.
+- Der Mikropreis deckt denselben Betragsbereich wie die Cent-Angabe (10¹² Mikro-Euro = 10⁸ Cent =
+  10.000.000,00 €). Eine eigene Obergrenze wäre eine stille Bereichsänderung, je nachdem welches
+  Feld ein Aufrufer benutzt.
+- Die Menge reicht bis 10⁹ statt 10⁶, passend zu `quantityMilli` der gespeicherten Form.
+- **Noch nicht enthalten:** `rechnungSummen` rechnet weiterhin wie bisher, nicht über den exakten
+  Kern. Das gehört zum Stichtag der Umstellung (Schalter `ganzzahlPflicht`): solange der Server
+  eine Rechnung nach dem alten Weg ausstellt, darf eine Vorschau im Aufrufer nicht schon exakt
+  runden — sie zeigte sonst an Halbcent-Grenzen einen anderen Cent als die Rechnung.
+
 ## 0.26.0
 
 - Beleg: Am Ende steht das Kasseneck-Logo als Bild statt der Zeile „erstellt mit Kasseneck".

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

@@ -18,4 +18,4 @@ export type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, Cred
 export { RECHNUNG_TEXTE, rechnungText, type RechnungTextSchluessel } from './texte.js';
 export { rechnungSummen, STEUERFREIE_FAELLE, type SummenPosition } from './summen.js';
 export { anteiligerPreis, BETRAG_GRENZE_CENTS, positionAusEuro, preisText, RechenFehler, rechnungRechnen, rund, satzSchluessel, satzText, type RechenErgebnis, type RechenFehlerCode, type RechenOptionen, type RechenPosition, type SatzSumme, type Umwandlung, type UmwandlungsGrund, type ZeilenBetrag, } from './rechnen.js';
-export { RECHNUNG_VERTRAG_VERSION, RECHNUNG_AUFRUFE, INVOICE_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, INVOICE_LANGUAGES, INVOICE_PAYMENT_METHODS, ITEM_KINDS, REVERSE_CHARGE_REASONS, INVOICE_NOTICE_CODES, INVOICE_UNITS, RECHNUNG_EINHEITEN_CODES, INVOICE_SETUP_REQUIREMENTS, KUNDE_FELDER, POSITION_FELDER, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, type RechnungAufruf, type InvoiceErrorCode, type CreditNoteReason, type TaxScheme, type PriceMode, type VatRatePercent, type CustomerType, type InvoiceListStatus, type DocType, type EInvoiceFormat, type InvoiceLanguage, type InvoicePaymentMethod, type ItemKind, type ReverseChargeReason, type InvoiceNoticeCode, type InvoiceUnit, type InvoiceSetupRequirement, type Format, type Feld, } from './vertrag.js';
+export { RECHNUNG_VERTRAG_VERSION, RECHNUNG_AUFRUFE, INVOICE_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, INVOICE_LANGUAGES, INVOICE_PAYMENT_METHODS, ITEM_KINDS, REVERSE_CHARGE_REASONS, INVOICE_NOTICE_CODES, INVOICE_UNITS, RECHNUNG_EINHEITEN_CODES, INVOICE_SETUP_REQUIREMENTS, KUNDE_FELDER, POSITION_FELDER, POSITION_PREIS_GENAU_EINS, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, type RechnungAufruf, type InvoiceErrorCode, type CreditNoteReason, type TaxScheme, type PriceMode, type VatRatePercent, type CustomerType, type InvoiceListStatus, type DocType, type EInvoiceFormat, type InvoiceLanguage, type InvoicePaymentMethod, type ItemKind, type ReverseChargeReason, type InvoiceNoticeCode, type InvoiceUnit, type InvoiceSetupRequirement, type Format, type Feld, } from './vertrag.js';

package/dist/cjs/rechnung/index.js

@@ -13,7 +13,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.INVOICE_UNITS = exports.INVOICE_NOTICE_CODES = exports.REVERSE_CHARGE_REASONS = exports.ITEM_KINDS = exports.INVOICE_PAYMENT_METHODS = exports.INVOICE_LANGUAGES = 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_ERROR_CODES = exports.RECHNUNG_AUFRUFE = exports.RECHNUNG_VERTRAG_VERSION = exports.satzText = exports.satzSchluessel = exports.rund = exports.rechnungRechnen = exports.RechenFehler = exports.preisText = exports.positionAusEuro = exports.BETRAG_GRENZE_CENTS = exports.anteiligerPreis = exports.STEUERFREIE_FAELLE = exports.rechnungSummen = exports.rechnungText = exports.RECHNUNG_TEXTE = 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.rechnungFeldFehler = exports.rechnungFehlerCode = exports.istRechnungFehler = exports.rechnungKeyAuth = exports.createRechnungApi = void 0;
-exports.RECHNUNG_MINDESTENS_EINS = exports.RECHNUNG_GENAU_EINS = exports.RECHNUNG_ANFRAGEN = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.INVOICE_SETUP_REQUIREMENTS = exports.RECHNUNG_EINHEITEN_CODES = void 0;
+exports.RECHNUNG_MINDESTENS_EINS = exports.RECHNUNG_GENAU_EINS = exports.RECHNUNG_ANFRAGEN = exports.POSITION_PREIS_GENAU_EINS = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.INVOICE_SETUP_REQUIREMENTS = exports.RECHNUNG_EINHEITEN_CODES = void 0;
 var api_js_1 = require("./api.js");
 Object.defineProperty(exports, "createRechnungApi", { enumerable: true, get: function () { return api_js_1.createRechnungApi; } });
 var auth_js_1 = require("./auth.js");
@@ -76,6 +76,7 @@ Object.defineProperty(exports, "RECHNUNG_EINHEITEN_CODES", { enumerable: true, g
 Object.defineProperty(exports, "INVOICE_SETUP_REQUIREMENTS", { enumerable: true, get: function () { return vertrag_js_1.INVOICE_SETUP_REQUIREMENTS; } });
 Object.defineProperty(exports, "KUNDE_FELDER", { enumerable: true, get: function () { return vertrag_js_1.KUNDE_FELDER; } });
 Object.defineProperty(exports, "POSITION_FELDER", { enumerable: true, get: function () { return vertrag_js_1.POSITION_FELDER; } });
+Object.defineProperty(exports, "POSITION_PREIS_GENAU_EINS", { enumerable: true, get: function () { return vertrag_js_1.POSITION_PREIS_GENAU_EINS; } });
 Object.defineProperty(exports, "RECHNUNG_ANFRAGEN", { enumerable: true, get: function () { return vertrag_js_1.RECHNUNG_ANFRAGEN; } });
 Object.defineProperty(exports, "RECHNUNG_GENAU_EINS", { enumerable: true, get: function () { return vertrag_js_1.RECHNUNG_GENAU_EINS; } });
 Object.defineProperty(exports, "RECHNUNG_MINDESTENS_EINS", { enumerable: true, get: function () { return vertrag_js_1.RECHNUNG_MINDESTENS_EINS; } });

package/dist/cjs/rechnung/typen.d.ts

@@ -73,8 +73,16 @@ export interface InvoiceItemInput {
     unit?: InvoiceUnit;
     /** Ware oder Leistung; ohne Angabe `goods`. Entscheidet ueber den Steuerfall. */
     kind?: ItemKind;
-    /** Einzelpreis in ganzen Cent, im `priceMode` der Rechnung (netto oder brutto). */
-    unitPriceCents: number;
+    /**
+     * Einzelpreis in ganzen Cent, im `priceMode` der Rechnung (netto oder
+     * brutto). Genau eines von `unitPriceCents` und `unitPriceMicros`.
+     */
+    unitPriceCents?: number;
+    /**
+     * Einzelpreis in Mikro-Euro (10⁻⁶ €), fuer Preise unterhalb eines Cents.
+     * Genau eines von `unitPriceCents` und `unitPriceMicros`.
+     */
+    unitPriceMicros?: number;
     vatRate: VatRatePercent;
     /** Zeilenrabatt in Prozent, hoechstens zwei Nachkommastellen. */
     discountPct?: number;
@@ -246,7 +254,15 @@ export interface InvoiceItem {
     unit: string;
     /** Ware oder Leistung — Altbestand ohne Angabe zaehlt als `goods`. */
     kind: ItemKind;
+    /**
+     * Einzelpreis in ganzen Cent — eine ANZEIGEHILFE: kaufmaennisch aus
+     * `unitPriceMicros` gerundet, und damit 0, sobald der Preis unter einem
+     * halben Cent liegt. Verbindlich sind `unitPriceMicros` und die Betraege je
+     * Position (§ 9.3).
+     */
     unitPriceCents: number;
+    /** Einzelpreis in Mikro-Euro (10⁻⁶ €) — der verbindliche Preis. */
+    unitPriceMicros?: number;
     vatRate: number;
     discountPct: number;
 }

package/dist/cjs/rechnung/vertrag.d.ts

@@ -204,6 +204,17 @@ export type Feld = {
     typ: 'object';
     pflicht: boolean;
     felder: Readonly<Record<string, Feld>>;
+    /**
+     * Feldgruppen, von denen GENAU EINE gesetzt sein muss (§ 9.1). Jede Gruppe
+     * ist eine Liste von Feldnamen; im JSON Schema wird daraus
+     * `oneOf: [{ required: [...] }, ...]`.
+     *
+     * Gebraucht fuer den Preis einer Position: `unitPriceCents` ODER
+     * `unitPriceMicros`, nie beides und nie keines. Als zwei Pflichtfelder
+     * liesse sich das nicht ausdruecken, und als zwei optionale waere eine
+     * Position ohne Preis gueltig.
+     */
+    genauEins?: readonly (readonly string[])[];
 } | {
     typ: 'list';
     pflicht: boolean;
@@ -219,8 +230,19 @@ export type Feld = {
 };
 /** Kunde, wie das Fremdsystem ihn schickt. `vatId` ist die UID-Nummer. */
 export declare const KUNDE_FELDER: Readonly<Record<string, Feld>>;
-/** Eine Rechnungs- oder Gutschriftsposition. Preise in ganzen Cent. */
+/**
+ * Eine Rechnungs- oder Gutschriftsposition.
+ *
+ * Der Preis steht in ganzen Cent (`unitPriceCents`) ODER in Mikro-Euro
+ * (`unitPriceMicros`, 10⁻⁶ €) — genau eines von beiden (§ 9.1). Der Mikropreis
+ * loest denselben Bereich feiner auf: 10¹² Mikro-Euro sind dieselben
+ * 10.000.000,00 €, die 10⁸ Cent ausdruecken. Er ist noetig fuer Preise
+ * unterhalb eines Cents (Verbrauchsabrechnung, Stueckpreise im Zehntelcent),
+ * die bisher gerundet eingereicht werden mussten.
+ */
 export declare const POSITION_FELDER: Readonly<Record<string, Feld>>;
+/** Genau einer der beiden Preise je Position (§ 9.1). */
+export declare const POSITION_PREIS_GENAU_EINS: readonly (readonly string[])[];
 /**
  * Eine Zahlung zu einer Rechnung. Ohne `amountCents` gilt der volle
  * Bruttobetrag, ohne `paidAt` der heutige Wiener Tag. `reference` ist die

package/dist/cjs/rechnung/vertrag.js

@@ -19,7 +19,7 @@
  * Nummer, Summen — ist bewusst **nicht** setzbar.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RECHNUNG_MINDESTENS_EINS = exports.RECHNUNG_GENAU_EINS = exports.RECHNUNG_ANFRAGEN = exports.PAYMENT_FELDER = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.INVOICE_SETUP_REQUIREMENTS = exports.RECHNUNG_EINHEITEN_CODES = exports.INVOICE_UNITS = exports.INVOICE_NOTICE_CODES = exports.INVOICE_PAYMENT_METHODS = exports.INVOICE_LANGUAGES = 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_ERROR_CODES = exports.RECHNUNG_AUFRUFE = exports.RECHNUNG_VERTRAG_VERSION = void 0;
+exports.RECHNUNG_MINDESTENS_EINS = exports.RECHNUNG_GENAU_EINS = exports.RECHNUNG_ANFRAGEN = exports.PAYMENT_FELDER = exports.POSITION_PREIS_GENAU_EINS = exports.POSITION_FELDER = exports.KUNDE_FELDER = exports.INVOICE_SETUP_REQUIREMENTS = exports.RECHNUNG_EINHEITEN_CODES = exports.INVOICE_UNITS = exports.INVOICE_NOTICE_CODES = exports.INVOICE_PAYMENT_METHODS = exports.INVOICE_LANGUAGES = 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_ERROR_CODES = exports.RECHNUNG_AUFRUFE = exports.RECHNUNG_VERTRAG_VERSION = void 0;
 exports.RECHNUNG_VERTRAG_VERSION = 1;
 exports.RECHNUNG_AUFRUFE = [
     'createCustomer',
@@ -335,20 +335,45 @@ exports.KUNDE_FELDER = Object.freeze({
 });
 /** Beim Aendern ist jedes Kundenfeld optional. */
 const KUNDE_PATCH = Object.freeze(Object.fromEntries(Object.entries(exports.KUNDE_FELDER).map(([name, feld]) => [name, { ...feld, pflicht: false }])));
-/** Eine Rechnungs- oder Gutschriftsposition. Preise in ganzen Cent. */
+/**
+ * Eine Rechnungs- oder Gutschriftsposition.
+ *
+ * Der Preis steht in ganzen Cent (`unitPriceCents`) ODER in Mikro-Euro
+ * (`unitPriceMicros`, 10⁻⁶ €) — genau eines von beiden (§ 9.1). Der Mikropreis
+ * loest denselben Bereich feiner auf: 10¹² Mikro-Euro sind dieselben
+ * 10.000.000,00 €, die 10⁸ Cent ausdruecken. Er ist noetig fuer Preise
+ * unterhalb eines Cents (Verbrauchsabrechnung, Stueckpreise im Zehntelcent),
+ * die bisher gerundet eingereicht werden mussten.
+ */
 exports.POSITION_FELDER = Object.freeze({
     description: text(300, true),
     subtitle: text(1000),
-    quantity: { typ: 'number', pflicht: true, min: 0, exklusivMin: true, max: 1_000_000, nachkomma: 3 },
+    quantity: { typ: 'number', pflicht: true, min: 0, exklusivMin: true, max: 1_000_000_000, nachkomma: 3 },
     /** Einheit aus `INVOICE_UNITS`; ohne Angabe `piece`. */
     unit: { typ: 'enum', pflicht: false, werte: exports.INVOICE_UNITS },
     /** Ware oder Leistung; ohne Angabe `goods`. Entscheidet ueber den Steuerfall. */
     kind: { typ: 'enum', pflicht: false, werte: exports.ITEM_KINDS },
-    unitPriceCents: { typ: 'integer', pflicht: true, min: 0, max: 100_000_000 },
+    /** Einzelpreis in ganzen Cent. Alternative zu `unitPriceMicros`. */
+    unitPriceCents: { typ: 'integer', pflicht: false, min: 0, max: 100_000_000 },
+    /** Einzelpreis in Mikro-Euro (10⁻⁶ €). Alternative zu `unitPriceCents`. */
+    unitPriceMicros: { typ: 'integer', pflicht: false, min: 0, max: 1_000_000_000_000 },
     vatRate: { typ: 'enum', pflicht: true, werte: exports.VAT_RATES },
     discountPct: { typ: 'number', pflicht: false, min: 0, max: 100, nachkomma: 2 },
 });
-const positionen = { typ: 'list', pflicht: true, min: 1, max: 500, eintrag: { typ: 'object', pflicht: true, felder: exports.POSITION_FELDER } };
+/** Genau einer der beiden Preise je Position (§ 9.1). */
+exports.POSITION_PREIS_GENAU_EINS = Object.freeze([
+    Object.freeze(['unitPriceCents']),
+    Object.freeze(['unitPriceMicros']),
+]);
+const positionen = {
+    typ: 'list',
+    pflicht: true,
+    min: 1,
+    max: 500,
+    eintrag: {
+        typ: 'object', pflicht: true, felder: exports.POSITION_FELDER, genauEins: exports.POSITION_PREIS_GENAU_EINS,
+    },
+};
 /**
  * Eine Zahlung zu einer Rechnung. Ohne `amountCents` gilt der volle
  * Bruttobetrag, ohne `paidAt` der heutige Wiener Tag. `reference` ist die

package/dist/esm/rechnung/index.d.ts

@@ -18,4 +18,4 @@ export type { Brand, CancelInvoiceRequest, CancelResult, CreditNoteRequest, Cred
 export { RECHNUNG_TEXTE, rechnungText, type RechnungTextSchluessel } from './texte.js';
 export { rechnungSummen, STEUERFREIE_FAELLE, type SummenPosition } from './summen.js';
 export { anteiligerPreis, BETRAG_GRENZE_CENTS, positionAusEuro, preisText, RechenFehler, rechnungRechnen, rund, satzSchluessel, satzText, type RechenErgebnis, type RechenFehlerCode, type RechenOptionen, type RechenPosition, type SatzSumme, type Umwandlung, type UmwandlungsGrund, type ZeilenBetrag, } from './rechnen.js';
-export { RECHNUNG_VERTRAG_VERSION, RECHNUNG_AUFRUFE, INVOICE_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, INVOICE_LANGUAGES, INVOICE_PAYMENT_METHODS, ITEM_KINDS, REVERSE_CHARGE_REASONS, INVOICE_NOTICE_CODES, INVOICE_UNITS, RECHNUNG_EINHEITEN_CODES, INVOICE_SETUP_REQUIREMENTS, KUNDE_FELDER, POSITION_FELDER, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, type RechnungAufruf, type InvoiceErrorCode, type CreditNoteReason, type TaxScheme, type PriceMode, type VatRatePercent, type CustomerType, type InvoiceListStatus, type DocType, type EInvoiceFormat, type InvoiceLanguage, type InvoicePaymentMethod, type ItemKind, type ReverseChargeReason, type InvoiceNoticeCode, type InvoiceUnit, type InvoiceSetupRequirement, type Format, type Feld, } from './vertrag.js';
+export { RECHNUNG_VERTRAG_VERSION, RECHNUNG_AUFRUFE, INVOICE_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, INVOICE_LANGUAGES, INVOICE_PAYMENT_METHODS, ITEM_KINDS, REVERSE_CHARGE_REASONS, INVOICE_NOTICE_CODES, INVOICE_UNITS, RECHNUNG_EINHEITEN_CODES, INVOICE_SETUP_REQUIREMENTS, KUNDE_FELDER, POSITION_FELDER, POSITION_PREIS_GENAU_EINS, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, type RechnungAufruf, type InvoiceErrorCode, type CreditNoteReason, type TaxScheme, type PriceMode, type VatRatePercent, type CustomerType, type InvoiceListStatus, type DocType, type EInvoiceFormat, type InvoiceLanguage, type InvoicePaymentMethod, type ItemKind, type ReverseChargeReason, type InvoiceNoticeCode, type InvoiceUnit, type InvoiceSetupRequirement, type Format, type Feld, } from './vertrag.js';

package/dist/esm/rechnung/index.js

@@ -17,4 +17,4 @@ export { cancelInvoice, createCreditNote, createCustomer, getCustomer, getInvoic
 export { RECHNUNG_TEXTE, rechnungText } from './texte.js';
 export { rechnungSummen, STEUERFREIE_FAELLE } from './summen.js';
 export { anteiligerPreis, BETRAG_GRENZE_CENTS, positionAusEuro, preisText, RechenFehler, rechnungRechnen, rund, satzSchluessel, satzText, } from './rechnen.js';
-export { RECHNUNG_VERTRAG_VERSION, RECHNUNG_AUFRUFE, INVOICE_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, INVOICE_LANGUAGES, INVOICE_PAYMENT_METHODS, ITEM_KINDS, REVERSE_CHARGE_REASONS, INVOICE_NOTICE_CODES, INVOICE_UNITS, RECHNUNG_EINHEITEN_CODES, INVOICE_SETUP_REQUIREMENTS, KUNDE_FELDER, POSITION_FELDER, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, } from './vertrag.js';
+export { RECHNUNG_VERTRAG_VERSION, RECHNUNG_AUFRUFE, INVOICE_ERROR_CODES, CREDIT_NOTE_REASONS, TAX_SCHEMES, PRICE_MODES, VAT_RATES, CUSTOMER_TYPES, INVOICE_LIST_STATUS, DOC_TYPES, EINVOICE_FORMATS, INVOICE_LANGUAGES, INVOICE_PAYMENT_METHODS, ITEM_KINDS, REVERSE_CHARGE_REASONS, INVOICE_NOTICE_CODES, INVOICE_UNITS, RECHNUNG_EINHEITEN_CODES, INVOICE_SETUP_REQUIREMENTS, KUNDE_FELDER, POSITION_FELDER, POSITION_PREIS_GENAU_EINS, RECHNUNG_ANFRAGEN, RECHNUNG_GENAU_EINS, RECHNUNG_MINDESTENS_EINS, } from './vertrag.js';

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

@@ -73,8 +73,16 @@ export interface InvoiceItemInput {
     unit?: InvoiceUnit;
     /** Ware oder Leistung; ohne Angabe `goods`. Entscheidet ueber den Steuerfall. */
     kind?: ItemKind;
-    /** Einzelpreis in ganzen Cent, im `priceMode` der Rechnung (netto oder brutto). */
-    unitPriceCents: number;
+    /**
+     * Einzelpreis in ganzen Cent, im `priceMode` der Rechnung (netto oder
+     * brutto). Genau eines von `unitPriceCents` und `unitPriceMicros`.
+     */
+    unitPriceCents?: number;
+    /**
+     * Einzelpreis in Mikro-Euro (10⁻⁶ €), fuer Preise unterhalb eines Cents.
+     * Genau eines von `unitPriceCents` und `unitPriceMicros`.
+     */
+    unitPriceMicros?: number;
     vatRate: VatRatePercent;
     /** Zeilenrabatt in Prozent, hoechstens zwei Nachkommastellen. */
     discountPct?: number;
@@ -246,7 +254,15 @@ export interface InvoiceItem {
     unit: string;
     /** Ware oder Leistung — Altbestand ohne Angabe zaehlt als `goods`. */
     kind: ItemKind;
+    /**
+     * Einzelpreis in ganzen Cent — eine ANZEIGEHILFE: kaufmaennisch aus
+     * `unitPriceMicros` gerundet, und damit 0, sobald der Preis unter einem
+     * halben Cent liegt. Verbindlich sind `unitPriceMicros` und die Betraege je
+     * Position (§ 9.3).
+     */
     unitPriceCents: number;
+    /** Einzelpreis in Mikro-Euro (10⁻⁶ €) — der verbindliche Preis. */
+    unitPriceMicros?: number;
     vatRate: number;
     discountPct: number;
 }

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

@@ -204,6 +204,17 @@ export type Feld = {
     typ: 'object';
     pflicht: boolean;
     felder: Readonly<Record<string, Feld>>;
+    /**
+     * Feldgruppen, von denen GENAU EINE gesetzt sein muss (§ 9.1). Jede Gruppe
+     * ist eine Liste von Feldnamen; im JSON Schema wird daraus
+     * `oneOf: [{ required: [...] }, ...]`.
+     *
+     * Gebraucht fuer den Preis einer Position: `unitPriceCents` ODER
+     * `unitPriceMicros`, nie beides und nie keines. Als zwei Pflichtfelder
+     * liesse sich das nicht ausdruecken, und als zwei optionale waere eine
+     * Position ohne Preis gueltig.
+     */
+    genauEins?: readonly (readonly string[])[];
 } | {
     typ: 'list';
     pflicht: boolean;
@@ -219,8 +230,19 @@ export type Feld = {
 };
 /** Kunde, wie das Fremdsystem ihn schickt. `vatId` ist die UID-Nummer. */
 export declare const KUNDE_FELDER: Readonly<Record<string, Feld>>;
-/** Eine Rechnungs- oder Gutschriftsposition. Preise in ganzen Cent. */
+/**
+ * Eine Rechnungs- oder Gutschriftsposition.
+ *
+ * Der Preis steht in ganzen Cent (`unitPriceCents`) ODER in Mikro-Euro
+ * (`unitPriceMicros`, 10⁻⁶ €) — genau eines von beiden (§ 9.1). Der Mikropreis
+ * loest denselben Bereich feiner auf: 10¹² Mikro-Euro sind dieselben
+ * 10.000.000,00 €, die 10⁸ Cent ausdruecken. Er ist noetig fuer Preise
+ * unterhalb eines Cents (Verbrauchsabrechnung, Stueckpreise im Zehntelcent),
+ * die bisher gerundet eingereicht werden mussten.
+ */
 export declare const POSITION_FELDER: Readonly<Record<string, Feld>>;
+/** Genau einer der beiden Preise je Position (§ 9.1). */
+export declare const POSITION_PREIS_GENAU_EINS: readonly (readonly string[])[];
 /**
  * Eine Zahlung zu einer Rechnung. Ohne `amountCents` gilt der volle
  * Bruttobetrag, ohne `paidAt` der heutige Wiener Tag. `reference` ist die

package/dist/esm/rechnung/vertrag.js

@@ -332,20 +332,45 @@ export const KUNDE_FELDER = Object.freeze({
 });
 /** Beim Aendern ist jedes Kundenfeld optional. */
 const KUNDE_PATCH = Object.freeze(Object.fromEntries(Object.entries(KUNDE_FELDER).map(([name, feld]) => [name, { ...feld, pflicht: false }])));
-/** Eine Rechnungs- oder Gutschriftsposition. Preise in ganzen Cent. */
+/**
+ * Eine Rechnungs- oder Gutschriftsposition.
+ *
+ * Der Preis steht in ganzen Cent (`unitPriceCents`) ODER in Mikro-Euro
+ * (`unitPriceMicros`, 10⁻⁶ €) — genau eines von beiden (§ 9.1). Der Mikropreis
+ * loest denselben Bereich feiner auf: 10¹² Mikro-Euro sind dieselben
+ * 10.000.000,00 €, die 10⁸ Cent ausdruecken. Er ist noetig fuer Preise
+ * unterhalb eines Cents (Verbrauchsabrechnung, Stueckpreise im Zehntelcent),
+ * die bisher gerundet eingereicht werden mussten.
+ */
 export const POSITION_FELDER = Object.freeze({
     description: text(300, true),
     subtitle: text(1000),
-    quantity: { typ: 'number', pflicht: true, min: 0, exklusivMin: true, max: 1_000_000, nachkomma: 3 },
+    quantity: { typ: 'number', pflicht: true, min: 0, exklusivMin: true, max: 1_000_000_000, nachkomma: 3 },
     /** Einheit aus `INVOICE_UNITS`; ohne Angabe `piece`. */
     unit: { typ: 'enum', pflicht: false, werte: INVOICE_UNITS },
     /** Ware oder Leistung; ohne Angabe `goods`. Entscheidet ueber den Steuerfall. */
     kind: { typ: 'enum', pflicht: false, werte: ITEM_KINDS },
-    unitPriceCents: { typ: 'integer', pflicht: true, min: 0, max: 100_000_000 },
+    /** Einzelpreis in ganzen Cent. Alternative zu `unitPriceMicros`. */
+    unitPriceCents: { typ: 'integer', pflicht: false, min: 0, max: 100_000_000 },
+    /** Einzelpreis in Mikro-Euro (10⁻⁶ €). Alternative zu `unitPriceCents`. */
+    unitPriceMicros: { typ: 'integer', pflicht: false, min: 0, max: 1_000_000_000_000 },
     vatRate: { typ: 'enum', pflicht: true, werte: VAT_RATES },
     discountPct: { typ: 'number', pflicht: false, min: 0, max: 100, nachkomma: 2 },
 });
-const positionen = { typ: 'list', pflicht: true, min: 1, max: 500, eintrag: { typ: 'object', pflicht: true, felder: POSITION_FELDER } };
+/** Genau einer der beiden Preise je Position (§ 9.1). */
+export const POSITION_PREIS_GENAU_EINS = Object.freeze([
+    Object.freeze(['unitPriceCents']),
+    Object.freeze(['unitPriceMicros']),
+]);
+const positionen = {
+    typ: 'list',
+    pflicht: true,
+    min: 1,
+    max: 500,
+    eintrag: {
+        typ: 'object', pflicht: true, felder: POSITION_FELDER, genauEins: POSITION_PREIS_GENAU_EINS,
+    },
+};
 /**
  * Eine Zahlung zu einer Rechnung. Ohne `amountCents` gilt der volle
  * Bruttobetrag, ohne `paidAt` der heutige Wiener Tag. `reference` ist die

package/fixtures/hobex-hps-codes.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.26.0",
+  "version": "0.27.1",
   "gemessenAn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

package/fixtures/kasse-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.26.0",
+  "version": "0.27.1",
   "meldungen": {
     "netz.keine_verbindung": {
       "text": "Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen."

package/fixtures/oberflaeche.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.26.0",
+  "version": "0.27.1",
   "aufrufe": [
     "activateCashregister",
     "cancelInvoice",

package/fixtures/rechnung-api-beispiele/issue-fehler-preis-beide.json

@@ -0,0 +1,26 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Beide Preisfelder gesetzt: genau eines ist erlaubt. Der Feldpfad zeigt auf das zuletzt hinzugekommene.",
+  "anfrage": {
+    "idempotencyKey": "bsp-mikro-2",
+    "customerId": "kunde_beispiel",
+    "priceMode": "net",
+    "serviceStart": "2026-09-14",
+    "items": [
+      {
+        "description": "Strom",
+        "quantity": 1,
+        "unitPriceCents": 100,
+        "unitPriceMicros": 1000000,
+        "vatRate": 20
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "items[0].unitPriceMicros"
+    ]
+  }
+}

package/fixtures/rechnung-api-beispiele/issue-fehler-preis-fehlt.json

@@ -0,0 +1,24 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Kein Preis: der Feldpfad zeigt auf unitPriceCents, den gewohnten Pflichtfehler.",
+  "anfrage": {
+    "idempotencyKey": "bsp-mikro-3",
+    "customerId": "kunde_beispiel",
+    "priceMode": "net",
+    "serviceStart": "2026-09-14",
+    "items": [
+      {
+        "description": "Strom",
+        "quantity": 1,
+        "vatRate": 20
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": false,
+    "code": "validation",
+    "fields": [
+      "items[0].unitPriceCents"
+    ]
+  }
+}

package/fixtures/rechnung-api-beispiele/issue-mikropreis.json

@@ -0,0 +1,27 @@
+{
+  "aufruf": "issueInvoice",
+  "beschreibung": "Preis unter einem Cent: 3.500.000 x 0,000004 EUR = 14,00 EUR netto. In ganzen Cent waere der Einzelpreis 0 und die Rechnung leer.",
+  "anfrage": {
+    "idempotencyKey": "bsp-mikro-1",
+    "customerId": "kunde_beispiel",
+    "taxScheme": "normal",
+    "priceMode": "net",
+    "serviceStart": "2026-09-14",
+    "items": [
+      {
+        "description": "Strom",
+        "quantity": 3500000,
+        "unitPriceMicros": 4,
+        "vatRate": 20
+      }
+    ]
+  },
+  "erwartet": {
+    "ok": true,
+    "totals": {
+      "netCents": 1400,
+      "vatCents": 280,
+      "grossCents": 1680
+    }
+  }
+}

package/fixtures/rechnung-api.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "Kasseneck Rechnungs-API",
   "version": 1,
-  "paket": "0.26.0",
+  "paket": "0.27.1",
   "aufrufe": {
     "createCustomer": {
       "anfrage": {
@@ -376,7 +376,7 @@
                 "quantity": {
                   "type": "number",
                   "exclusiveMinimum": 0,
-                  "maximum": 1000000,
+                  "maximum": 1000000000,
                   "x-decimals": 3
                 },
                 "unit": {
@@ -443,6 +443,11 @@
                   "minimum": 0,
                   "maximum": 100000000
                 },
+                "unitPriceMicros": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 1000000000000
+                },
                 "vatRate": {
                   "enum": [
                     0,
@@ -461,9 +466,20 @@
               "required": [
                 "description",
                 "quantity",
-                "unitPriceCents",
                 "vatRate"
               ],
+              "oneOf": [
+                {
+                  "required": [
+                    "unitPriceCents"
+                  ]
+                },
+                {
+                  "required": [
+                    "unitPriceMicros"
+                  ]
+                }
+              ],
               "additionalProperties": false
             }
           },
@@ -619,7 +635,7 @@
                 "quantity": {
                   "type": "number",
                   "exclusiveMinimum": 0,
-                  "maximum": 1000000,
+                  "maximum": 1000000000,
                   "x-decimals": 3
                 },
                 "unit": {
@@ -686,6 +702,11 @@
                   "minimum": 0,
                   "maximum": 100000000
                 },
+                "unitPriceMicros": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 1000000000000
+                },
                 "vatRate": {
                   "enum": [
                     0,
@@ -704,9 +725,20 @@
               "required": [
                 "description",
                 "quantity",
-                "unitPriceCents",
                 "vatRate"
               ],
+              "oneOf": [
+                {
+                  "required": [
+                    "unitPriceCents"
+                  ]
+                },
+                {
+                  "required": [
+                    "unitPriceMicros"
+                  ]
+                }
+              ],
               "additionalProperties": false
             }
           }

package/fixtures/rechnung-texte.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.26.0",
+  "version": "0.27.1",
   "sprachen": [
     "de",
     "en"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kreiseck/kasseneck-api",
-  "version": "0.26.0",
+  "version": "0.27.1",
   "description": "RKSV-Registrierkasse fuer JavaScript und TypeScript: signierte Belege, Storno, Kartenzahlung, Bondruck. Austrian fiscal cash register (RKSV) API client.",
   "license": "Apache-2.0",
   "author": "Kreiseck",