Unterpositionen ermöglichen es, einen Hauptartikel auf einem Beleg aus mehreren Teilen zusammenzusetzen. Ein typisches Beispiel ist ein Menü, das als ein Artikel verkauft wird, aber z. B. Burger, Pommes und Getränk enthält. Der Hauptartikel hat einen Gesamtpreis und die SubItems werden mit eigenen Preisen, Steuersätzen und Bestandsinformationen erfasst.
1. Technische Struktur und wichtige Felder
Hauptposition (Parent Item)
Die Hauptposition ist ein Position-Objekt mit Type: 0 (Item). Für Subitems sind folgende Felder erforderlich:
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| useSubItemVatCalculation | boolean | (Verpflichtend) Auf true setzen, damit Steuerwerte aus den Subitems übernommen werden. |
| VatIdentification | integer | (Verpflichtend) Muss 0 sein, wenn useSubItemVatCalculation aktiv ist. |
| VatPercent | decimal | (Verpflichtend) Muss 0 sein, wenn useSubItemVatCalculation aktiv ist. |
| subItems | Array<SubItem> | (Verpflichtend) Enthält die Unterpositionen mit eigenen Preis- und Steuerangaben. |
Hinweis: NetValue, GrossValue und TaxValue der Hauptposition müssen den Summen der Unterpositionen entsprechen.
Unterpositionen (Subitems)
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| type | string | (Verpflichtend) Muss "SubItem" sein. |
| Quantity | decimal | (Verpflichtend) Menge der Unterposition. |
| VatIdentification | integer | (Verpflichtend) Steuer-ID der Unterposition. |
| VatPercent | decimal | (Verpflichtend) Steuersatz der Unterposition. |
| NetValue, TaxValue, GrossValue | decimal | (Verpflichtend) Preisangaben je Unterposition. GrossValue = NetValue + TaxValue. |
2. Beispiel: Vollständiger Payload
Die folgende storeDocument-Anfrage enthält eine Hauptposition („Testartikel 1 (Menü)“) mit zwei Unterpositionen:
{
"fiscalDocumentNumber": "2",
"fiscalDocumentStartTime": 1755507048,
"FiscalDocumentRevision": 1,
"ModelVersion": "1.4.0",
"UniqueClientId": "8ccedd62-9f72-4cda-b101-7e5e62fb37dc",
"AutomaticVatCalculation": 1,
"DocumentGuid": "08679cec-0df2-4ee0-a138-7ddf55ed2372",
"DocumentId": "08679cec-0df2-4ee0-a138-7ddf55ed2372",
"documentNumber": "08679cec-0df2-4ee0-a138-7ddf55ed2372",
"AllowedVatDeviation": 0.01,
"isTraining": true,
"CreateDate": "2025-08-18T08:52:37Z",
"BookDate": "2025-08-18T08:52:37Z",
"DocumentType": 0,
"positionCount": 2,
"User": {
"Id": "test",
"Caption": "test"
},
"Positions": [
{
"PositionNumber": 0,
"ItemCaption": "Testartikel 1 (Menü)",
"Type": 0,
"InHouse": false,
"Quantity": 1,
"ItemId": "Artikel1",
"VatIdentification": 0,
"VatPercent": 0,
"BusinessTransactionType": 0,
"BaseNetValue": 0.84,
"BaseGrossValue": 1,
"BaseTaxValue": 0.16,
"Discounts": [],
"NetValue": 0.84,
"GrossValue": 1,
"TaxValue": 0.16,
"useSubItemVatCalculation": true,
"subItems": [
{
"type": "SubItem",
"positionNumber": 1,
"ItemCaption": "Unterposition 1.1",
"ItemId": "SubArtikel1-1",
"Quantity": 1,
"VatIdentification": "1",
"VatPercent": 19,
"BusinessTransactionType": 0,
"NetValue": 0.50,
"GrossValue": 0.60,
"TaxValue": 0.10
},
{
"type": "SubItem",
"positionNumber": 2,
"ItemCaption": "Unterposition 1.2",
"ItemId": "SubArtikel1-2",
"Quantity": 1,
"VatIdentification": "1",
"VatPercent": 19,
"BusinessTransactionType": 0,
"NetValue": 0.34,
"GrossValue": 0.40,
"TaxValue": 0.06
}
]
},
{
"PositionNumber": 1,
"ItemCaption": "Testartikel 2",
"Type": 0,
"InHouse": false,
"Quantity": 1,
"ItemId": "Artikel2",
"VatIdentification": "1",
"VatPercent": 19,
"BusinessTransactionType": 0,
"BaseNetValue": 0.84,
"BaseGrossValue": 1,
"BaseTaxValue": 0.16,
"Discounts": [],
"NetValue": 0.84,
"GrossValue": 1,
"TaxValue": 0.16
}
],
"Payments": [
{
"Amount": 2,
"CurrencyIsoCode": "EUR",
"paymentType": "cash",
"caption": "Barzahlung",
"uniqueReadablePaymentIdentifier": "CASH/EUR",
"ExternalIdentifier": []
}
]
}
3. Checkliste
✓ Hauptposition enthält "subItems".
✓ "useSubItemVatCalculation": true ist gesetzt.
✓ VatIdentification und VatPercent der Hauptposition sind 0.
✓ Jede Unterposition hat "type": "SubItem".
✓ Unterpositionen besitzen eigene Steuer- und Preisinformationen.
✓ Summen der Unterpositionen entsprechen den Werten der Hauptposition.
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.