SubItems επιτρέπουν τη σύνθεση ενός κύριου στοιχείου σε μια απόδειξη από πολλά μέρη. Ένα τυπικό παράδειγμα είναι ένα μενού που πωλείται ως ένα στοιχείο, αλλά περιέχει, για παράδειγμα, ένα μπέργκερ, πατάτες τηγανητές και ένα ποτό. Το γονικό στοιχείο έχει μια συνολική τιμή, και τα SubItems καταγράφονται με τις δικές τους τιμές, τους φορολογικούς συντελεστές και τις πληροφορίες αποθέματος.
1. Τεχνική δομή και βασικά πεδία
Κύριο είδος
Το γονικό στοιχείο είναι ένα Position αντικείμενο με Type: 0 (Item). Για τα SubItems, απαιτούνται τα ακόλουθα πεδία:
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
| UseSubItemVatCalculation | boolean | (Υποχρεωτικό) Πρέπει να οριστεί σε true ώστε οι φορολογικές τιμές να προκύπτουν από τα SubItems. |
| VatIdentification | ακέραιος | (Υποχρεωτικό) Πρέπει να είναι 0 όταν το UseSubItemVatCalculation είναι ενεργό. |
| VatPercent | δεκαδικό | (Υποχρεωτικό) Πρέπει να είναι 0 όταν το UseSubItemVatCalculation είναι ενεργό. |
| SubItems | Πίνακας<SUBITEM> | (Υποχρεωτικό) Περιέχει τα SubItems με τις δικές τους πληροφορίες τιμής και φόρου. |
Σημείωση: NetValue, GrossValue και TaxValue του γονικού στοιχείου πρέπει να ισούνται με τα αθροίσματα των SubItems.
SubItems
| Ιδιότητα | Τύπος | Περιγραφή |
|---|---|---|
| τύπος | string | (Υποχρεωτικό) Πρέπει να είναι "SubItem" . |
| Ποσότητα | δεκαδικό | (Υποχρεωτικό) Ποσότητα του υποστοιχείου. |
| VatIdentification | ακέραιος | (Υποχρεωτικό) ID ΦΠΑ του υποστοιχείου. |
| VatPercent | δεκαδικό | (Υποχρεωτικό) Φορολογικός συντελεστής του SubItems. |
| NetValue , TaxValue , GrossValue | δεκαδικό | (Υποχρεωτικό) Πληροφορίες τιμής ανά SubItem. GrossValue = NetValue + TaxValue . |
2. Παράδειγμα: Πλήρες Payload
Η ακόλουθη storeDocument αίτημα περιέχει ένα γονικό στοιχείο («Test item 1 (Menu)») με δύο 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. Λίστα ελέγχου
✓ Το γονικό στοιχείο περιέχει "subItems".
✓ "useSubItemVatCalculation": true έχει οριστεί.
✓ VatIdentification και VatPercent του γονικού στοιχείου είναι 0.
✓ Κάθε SubItem έχει "type": "SubItem".
✓ Τα SubItems έχουν τις δικές τους πληροφορίες για τον φόρο και την τιμή.
✓ Τα σύνολα των SubItems αντιστοιχούν στις τιμές του γονικού στοιχείου.
Αυτό το άρθρο μεταφράστηκε αυτόματα.
Σχόλια
0 σχόλια
Πραγματοποιήστε είσοδο για να αφήσετε ένα σχόλιο.