SubItems umožňujú zostaviť hlavnú položku na účtenke z viacerých častí. Typickým príkladom je menu predávané ako jedna položka, ktoré však obsahuje napríklad hamburger, hranolky a nápoj. Nadradená položka má celkovú cenu a SubItems sú zaznamenané s vlastnými cenami, daňovými sadzbami a informáciami o zásobách.
1. Technická štruktúra a kľúčové polia
Nadradená položka
Nadradená položka je Position objekt s Type: 0 (Položka). Pre SubItems sú povinné nasledujúce polia:
| Vlastnosť | Typ | Popis |
|---|---|---|
| UseSubItemVatCalculation | boolean | (Povinné) Musí byť nastavené na true , aby sa daňové hodnoty odvodili z SubItems. |
| VatIdentification | celé číslo | (Povinné) Musí byť 0, ak je aktívna funkcia UseSubItemVatCalculation . |
| VatPercent | desatinné číslo | (Povinné) Musí byť 0, ak je aktívna funkcia UseSubItemVatCalculation . |
| SubItems | Array<SUBITEM> | (Povinné) Obsahuje SubItems s ich vlastnými informáciami o cene a dani. |
Poznámka: NetValue, GrossValue a TaxValue nadradenej položky sa musia rovnať súčtom SubItems.
SubItems
| Vlastnosť | Typ | Popis |
|---|---|---|
| typ | string | (Povinné) Musí byť „SubItem “. |
| Množstvo | desatinné číslo | (Povinné) Množstvo podpoložky. |
| VatIdentification | celé číslo | (Povinné) ID DPH podpoložky. |
| VatPercent | desatinné číslo | (Povinné) Daňová sadzba podpoložky. |
| NetValue , TaxValue , GrossValue | desatinné číslo | (Povinné) Informácie o cene za SubItem. GrossValue = NetValue + TaxValue . |
2. Príklad: Kompletný payload
Nasledujúca storeDocument žiadosť obsahuje nadradenú položku („Test item 1 (Menu)“) s dvoma SubItems:
{
"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. Kontrolný zoznam
✓ Nadradená položka obsahuje "subItems".
✓ "useSubItemVatCalculation": true je nastavená.
✓ VatIdentification a VatPercent z nadradenej položky sú 0.
✓ Každá podpoložka má "type": "SubItem".
✓ SubItems majú vlastné informácie o dani a cene.
✓ Súčty SubItems zodpovedajú hodnotám nadradenej položky.
Tento článok bol preložený automaticky.
Príspevky
0 komentárov
Ak chcete napísať komentár, prihlásiť sa.