Subpozicijos leidžia sudaryti pagrindinį prekių vienetą sąskaitoje iš kelių dalių. Tipiškas pavyzdys – meniu, kuris parduodamas kaip viena prekė, bet apima, pvz., mėsainį, bulvytes ir gėrimą. Pagrindinė prekė turi bendrą kainą, o subprekės įrašomos su atskiromis kainomis, mokesčių tarifais ir atsargų informacija.
1. Techninė struktūra ir svarbūs laukeliai
Pagrindinė pozicija (Parent Item)
Pagrindinė pozicija yra Positionobjektas su Type: 0 (prekė). Papildomoms prekėms reikalingi šie laukai:
| Savybė | Tipas | Aprašymas |
|---|---|---|
| useSubItemVatCalculation | boolean | (Privaloma) Nustatykite true , kad mokesčių vertės būtų perimtos iš pakatalogių. |
| VatIdentification | integer | (Privaloma) Turi būti 0 , jei useSubItemVatCalculation yra aktyvuota. |
| VatPercent | decimal | (Privaloma) Turi būti 0 , jei useSubItemVatCalculation yra aktyvuota. |
| subItems | Array<SubItem> | (Privaloma) Apima papunkčius su atskirais kainos ir mokesčių duomenimis. |
Pastaba: NetValue, GrossValue ir TaxValue pagrindinės pozicijos turi atitikti pakaitinių pozicijų sumas.
Subpozicijos (Subitems)
| Savybė | Tipas | Aprašymas |
|---|---|---|
| type | string | (Privaloma) Turi būti „SubItem “. |
| Kiekis | decimal | (Privaloma) Papunkčio kiekis. |
| PVM identifikatorius | integer | (Privaloma) Subpozicijos mokesčių identifikatorius. |
| PVM procentas | decimal | (Privaloma) Subpozicijos mokesčio tarifas. |
| NetValue , TaxValue , GrossValue | decimal | (Privaloma) Kainos duomenys pagal kiekvieną papunktį. GrossValue = NetValue + TaxValue . |
2. Pavyzdys: pilnas duomenų paketas
Šiame storeDocumentužklausa apima pagrindinę poziciją („Testinis straipsnis 1 (meniu)“) su dviem papunkčiais:
{
"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. Kontrolinis sąrašas
✓ Pagrindinėje pozicijoje yra "subItems".
✓ "useSubItemVatCalculation": true yra pažymėta.
✓ VatIdentification ir VatPercent pagrindinėje pozicijoje yra 0.
✓ Kiekviena papunkčio pozicija turi "type": "SubItem".
✓ Papildomos pozicijos turi savo mokesčių ir kainų informaciją.
✓ Papildomų pozicijų sumos atitinka pagrindinės pozicijos vertes.
Komentarai
0 komentarų
Tam, kad paliktumėte komentarus prisijunkite