Mit "subItems" können Set-Artikel, Menü-Artikel oder ähnliches in RetailForce abgebildet werden. Beispielsweise, wenn ein Produkt zusammen mit einer Dienstleistung als ein Produkt verkauft wird oder etwa ein Menü zu einem Preis, welches sich aus Vor-, Haupt- und Nachspeise (Dessert) zusammensetzt.
Die jeweiligen Sub-Artikel (subItems) befinden sich immer innerhalb der jeweiligen Position, im Element "subItems" und werden durch den "type": "[1] = SubItem" des "positions"-Elementes definiert.
Die Struktur der einzelnen SubItems entspricht den der Item-positionen ("type": "[0] = Item"), darf allerdings das Property "UseSubItemVatCalculation" NICHT enthalten.
automaticVatCalculation
Die Einstellung über die Eigenschaft "automaticVatCalculation" greift ebenfalls auf die SubItems durch. Je nachdem, welche Berechnungsmethode gewählt wurde,
- "NoCalculation" = 0
- "NetValueCalculation" = 1
- "GrossValueCalculation" = 2
müssen entweder alle Elemente vorhanden sein, oder es können bestimmte Werte weggelassen werden. Die Elemente "vatPercent" (bzw. "vatPercent2") und "vatIdentification" müssen immer angegeben werden.
| Berechnungsart | "netValue" | "grossValue" | "taxValue" ("taxValue2") |
| "NoCalculation" | Pflichtfeld | Pflichtfeld | Pflichtfeld |
| "NetValueCalculation" | wird berechnet | Pflichtfeld | wird berechnet |
| "GrossValueCalculation" | Pflichtfeld | wird berechnet | wird berechnet |
Weitere Einzelheiten zur Berechnung der Werte für Unterpositionen finden Sie im Artikel "Eigenschaft 'UseSubItemVatCalculation'".
Nummerierung von subItem Positionen
Die Nummerierung der SubItems kann beliebig erfolgen.
Beispiele für zulässige Nummerierungsschemata für SubItems:
- gleiche Nummerierung wie bei Items - Durchnummerierung der SubItem Positionen von 0-n
- Nummerierung beginnend mit {Nummer der Item Position}.{Laufende Nummer des Subitems}: z.B. 0.1, 0.2, 0.3
Die Nummerierung muss aber innerhalb der jeweiligen Position konsistent sein. Dies bedeutet, dass innerhalb jeder Position die Nummerierung der SubItems von Vorne beginnen muss und die gleichen Nummerierungsmechanismen verwendet werden sollen.
Beispiel für SubItems
Das folgende Beispiel zeigt lediglich das Element „positions“ und kein vollständiges Dokument!
"Positions": [
{
"PositionNumber": 0,
"ItemCaption": "Mittagsmenü",
"ItemShortCaption": "MM-DO",
"ItemSerialNumber": null,
"Type": 0,
"Quantity": 2.0,
"QuantityUnit": {
"Id": "STK"
},
"ItemType": 0,
"ItemId": "MM-DO",
"ItemTaxType": 0,
"useSubItemVatCalculation": false,
"InHouse": true,
"ItemGroupId": "1000",
"ItemGroupCaption": "Hauptspeisen",
"BusinessTransactionType": 0,
"CostPrice": 10.00,
"BaseNetValue": 28.91,
"BaseGrossValue": 31.80,
"BaseTaxValue": 2.89,
"Discounts": [],
"VatIdentification": 0,
"VatPercent": 0,
"NetValue": 28.91,
"GrossValue": 31.80,
"TaxValue": 2.89,
"AdditionalFields": {},
"ExternalIdentifier": [],
"subItems": [
{
"PositionNumber": 0,
"ItemCaption": "Knoblauchcreme Suppe",
"ItemShortCaption": "KC-Suppe",
"ItemSerialNumber": null,
"Type": 1,
"Quantity": 2.0,
"QuantityUnit": {
"Id": "STK"
},
"ItemType": 0,
"ItemId": "Wiener",
"ItemTaxType": 0,
"InHouse": true,
"ItemGroupId": "2000",
"ItemGroupCaption": "Vorspeisen",
"BusinessTransactionType": 0,
"CostPrice": 3.80,
"BaseNetValue": 6.91,
"BaseGrossValue": 7.60,
"BaseTaxValue": 0.69,
"Discounts": [
{
"Identifier": "MM-R",
"Caption": "Mittagsmenü-Rabatt",
"Type": 1,
"DiscountOrder": 0,
"DiscountValue": 1.2920,
"TypeValue": 17
}
],
"VatIdentification": 2,
"VatPercent": 10.0,
"NetValue": 5.74,
"GrossValue": 6.31,
"TaxValue": 0.57,
"AdditionalFields": {},
"ExternalIdentifier": []
},
{
"PositionNumber": 1,
"ItemCaption": "Wiener Schnitzel",
"ItemShortCaption": "Wiener",
"ItemSerialNumber": null,
"Type": 1,
"Quantity": 2.0,
"QuantityUnit": {
"Id": "STK"
},
"ItemType": 0,
"ItemId": "Wiener",
"ItemTaxType": 0,
"InHouse": true,
"ItemGroupId": "1000",
"ItemGroupCaption": "Hauptspeisen",
"BusinessTransactionType": 0,
"CostPrice": 12.00,
"BaseNetValue": 21.82,
"BaseGrossValue": 24.00,
"BaseTaxValue": 2.18,
"Discounts": [
{
"Identifier": "MM-R",
"Caption": "Mittagsmenü-Rabatt",
"Type": 1,
"DiscountOrder": 0,
"DiscountValue": 4.3200,
"TypeValue": 18
}
],
"VatIdentification": 2,
"VatPercent": 10.0,
"NetValue": 17.89,
"GrossValue": 19.68,
"TaxValue": 1.79,
"AdditionalFields": {},
"ExternalIdentifier": []
},
{
"PositionNumber": 2,
"ItemCaption": "Eisbecher gemischt",
"ItemShortCaption": "EB-gem",
"ItemSerialNumber": null,
"Type": 1,
"Quantity": 2.0,
"QuantityUnit": {
"Id": "STK"
},
"ItemType": 0,
"ItemId": "EB-gem",
"ItemTaxType": 0,
"InHouse": true,
"ItemGroupId": "5000",
"ItemGroupCaption": "Nachspeisen",
"BusinessTransactionType": 0,
"CostPrice": 3.50,
"BaseNetValue": 6.36,
"BaseGrossValue": 7.00,
"BaseTaxValue": 0.64,
"Discounts": [
{
"Identifier": "MM-R",
"Caption": "Mittagsmenü-Rabatt",
"Type": 1,
"DiscountOrder": 0,
"DiscountValue": 1.1900,
"TypeValue": 17
}
],
"VatIdentification": 2,
"VatPercent": 10.0,
"NetValue": 5.28,
"GrossValue": 5.81,
"TaxValue": 0.53,
"AdditionalFields": {},
"ExternalIdentifier": []
}
]
},
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.