SubItems lehetővé teszik, hogy egy nyugta fő tételét több részből állítsák össze. Tipikus példa erre egy menü, amelyet egyetlen tételként adnak el, de amely például egy hamburgert, sült krumplit és egy italt tartalmaz. A fő tételnek van egy összára, az alelemeket pedig saját áraikkal, adókulcsaikkal és készletadatokkal rögzítik.
1. Műszaki felépítés és kulcsmezők
Fő tétel
A fő tétel egy Position objektum Type: 0 (Item). Az SubItems esetében a következő mezők kötelezőek:
| Tulajdonság | Típus | Leírás |
|---|---|---|
| UseSubItemVatCalculation | boolean | (Kötelező) Be kell állítani true értékre, hogy az adóértékek a SubItems-ből származtathatók legyenek. |
| VatIdentification | integer | (Kötelező) Értéke 0 kell legyen, ha a UseSubItemVatCalculation beállítás aktív. |
| VatPercent | tizedes | (Kötelező) Értéke 0 kell legyen, ha a UseSubItemVatCalculation aktív. |
| SubItems | Array<SUBITEM> | (Kötelező) Tartalmazza a SubItems-eket saját árukkal és adóadataikkal együtt. |
Megjegyzés: NetValue, GrossValue és TaxValue a szülőelemnek meg kell egyeznie a SubItems összegével.
SubItems
| Tulajdonság | Típus | Leírás |
|---|---|---|
| típus | string | (Kötelező) A következőnek kell lennie: "SubItem" . |
| Mennyiség | decimális | (Kötelező) Az alelem mennyisége. |
| VatIdentification | egész | (Kötelező) Az alelem Vat-ID-je. |
| VatPercent | tizedes | (Kötelező) Az alelem adókulcsa. |
| NetValue , TaxValue , GrossValue | tizedes | (Kötelező) A SubItemre vonatkozó árinformáció. GrossValue = NetValue + TaxValue . |
2. Példa: Teljes payload
A következő storeDocument kérés egy szülőelemet („1. tesztelem (Menü)”) tartalmaz, amelynek két SubItem-je van:
{
"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. Ellenőrzőlista
✓ A szülőelem "subItems".
✓ "useSubItemVatCalculation": true be van állítva.
✓ VatIdentification és VatPercent a szülőelem 0.
✓ Minden SubItem rendelkezik "type": "SubItem".
✓ The SubItems have their own tax and price information.
✓ A SubItems összegei megegyeznek a szülőelem értékeivel.
Ezt a cikket automatikusan lefordították.
Hozzászólások
0 hozzászólás
Hozzászólások írásához jelentkezzen be.