SubItems omogočajo sestavo glavne postavke na računu iz več delov. Tipičen primer je meni, ki se prodaja kot ena postavka, vendar vsebuje na primer burger, krompirček in pijačo. Nadrejena postavka ima skupno ceno, SubItems pa so evidentirani s svojimi cenami, davčnimi stopnjami in informacijami o zalogi.
1. Tehnična struktura in ključna polja
Glavni artikel
Glavni artikel je Position objekt z Type: 0 (Postavka). Za SubItems so obvezna naslednja polja:
| Lastnost | Tip | Opis |
|---|---|---|
| UseSubItemVatCalculation | boolean | (Obvezno) Mora biti nastavljeno na true , da se davčne vrednosti izpeljejo iz SubItems. |
| VatIdentification | celo število | (Obvezno) Mora biti 0, kadar je UseSubItemVatCalculation aktivno. |
| VatPercent | decimal | (Obvezno) Mora biti 0, kadar je UseSubItemVatCalculation aktivna. |
| SubItems | Array<SUBITEM> | (Obvezno) Vsebuje SubItems z njihovimi cenami in davčnimi podatki. |
Opomba: NetValue, GrossValue in TaxValue nadrejenega elementa morata biti enaki vsotama SubItems.
SubItems
| Lastnost | Tip | Opis |
|---|---|---|
| tip | string | (Obvezno) Mora biti "SubItem" . |
| Količina | decimal | (Obvezno) Količina podpostavke. |
| VatIdentification | celo število | (Obvezno) ID DDV podpostavke. |
| VatPercent | decimal | (Obvezno) Davčna stopnja podpostavke. |
| NetValue , TaxValue , GrossValue | decimal | (Obvezno) Podatki o ceni za posamezno postavko. GrossValue = NetValue + TaxValue . |
2. Primer: Celotna payload
Naslednja storeDocument zahteva vsebuje nadrejeni element („Test item 1 (Menu)“) z dvema 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. Seznam za preverjanje
✓ Nadrejeni element vsebuje "subItems".
✓ "useSubItemVatCalculation": true je nastavljen.
✓ VatIdentification in VatPercent nadrejenega elementa so 0.
✓ Vsaka podpostavka ima "type": "SubItem".
✓ SubItems imajo svoje podatke o davku in ceni.
✓ Seštevki SubItems se ujemajo z vrednostmi nadrejenega elementa.
Ta članek je bil samodejno preveden.
Komentar
0 komentarjev
Za dodajanje komentarja prosimo kliknite Vpis.