Element „SubItems” może służyć do przedstawiania pozycji zestawów, pozycji menu lub podobnych elementów w systemie RetailForce. Na przykład w przypadku sprzedaży produktu wraz z usługą jako pojedynczego produktu lub zestawu menu w jednej cenie, składającego się z przystawki, dania głównego i deseru.
Odpowiednie pozycje podrzędne znajdują się zawsze w ramach danej pozycji, w elemencie „SubItems” JSON payload, i są definiowane przez atrybut „type”: „[1] = SubItem” elementu „positions”.
Struktura poszczególnych elementów „SubItems” odpowiada strukturze pozycji pozycji („type”: „[0] = Item”), ale NIE może zawierać właściwości „UseSubItemVatCalculation”.
automaticVatCalculation
Ustawienie za pomocą właściwości „automaticVatCalculation” ma również zastosowanie do SubItems. W zależności od wybranej metody obliczania:
- „NoCalculation” = 0
- „NetValueCalculation” = 1
- „GrossValueCalculation” = 2
wszystkie elementy muszą być obecne lub niektóre wartości mogą zostać pominięte. Elementy „VatPercent” (odpowiednio „VatPercent2”) oraz „VatIdentification” muszą być zawsze podane.
| Rodzaj obliczeń | „NetValue” | „GrossValue” | „TaxValue” („TaxValue2”) |
| „NoCalculation” | Pole obowiązkowe | Pole obowiązkowe | Pole obowiązkowe |
| „NetValueCalculation” | jest obliczana | Pole obowiązkowe | jest obliczana |
| „GrossValueCalculation” | Pole obowiązkowe | jest obliczane | jest obliczane |
Więcej szczegółów dotyczących obliczania wartości dla pozycji podrzędnych można znaleźć w artykule „Właściwość »UseSubItemVatCalculation«”.
Numeracja pozycji SubItems
Pozycje SubItems można numerować według własnego uznania.
Przykłady dopuszczalnych schematów numeracji pozycji podrzędnych:
- takie samo numerowanie jak w przypadku pozycji – numeracja kolejna pozycji SubItems od 0 do n
- numeracja rozpoczynająca się od {numer pozycji pozycji}.{numer porządkowy pozycji SubItems}: np. 0.1, 0.2, 0.3
Numeracja musi jednak być spójna w obrębie każdej pozycji. Oznacza to, że w obrębie każdej pozycji numeracja SubItems musi rozpoczynać się od początku i należy stosować te same konwencje numeracji.
Przykład SubItems
Poniższy przykład przedstawia wyłącznie element „positions”, a nie kompletny dokument!
"Positions": [
{
"PositionNumber": 0,
"ItemCaption": "Lunch menu",
"ItemShortCaption": "MM-DO",
"ItemSerialNumber": null,
"Type": 0,
"Quantity": 2.0,
"QuantityUnit": {
"Id": "STK"
},
"ItemType": 0,
"ItemId": "MM-DO",
"ItemTaxType": 0,
"useSubItemVatCalculation": true,
"InHouse": true,
"ItemGroupId": "1000",
"ItemGroupCaption": "Set menu",
"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": "Cream of Garlic Soup",
"ItemShortCaption": "KC-Soup",
"ItemSerialNumber": null,
"Type": 1,
"Quantity": 2.0,
"QuantityUnit": {
"Id": "STK"
},
"ItemType": 0,
"ItemId": "KC-Soup",
"ItemTaxType": 0,
"InHouse": true,
"ItemGroupId": "2000",
"ItemGroupCaption": "Starters",
"BusinessTransactionType": 0,
"CostPrice": 3.80,
"BaseNetValue": 6.91,
"BaseGrossValue": 7.60,
"BaseTaxValue": 0.69,
"Discounts": [
{
"Identifier": "MM-R",
"Caption": "Lunch menu discount",
"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": "Viennese Schnitzel",
"ItemShortCaption": "VienneseS",
"ItemSerialNumber": null,
"Type": 1,
"Quantity": 2.0,
"QuantityUnit": {
"Id": "STK"
},
"ItemType": 0,
"ItemId": "VienneseS",
"ItemTaxType": 0,
"InHouse": true,
"ItemGroupId": "1000",
"ItemGroupCaption": "Main courses",
"BusinessTransactionType": 0,
"CostPrice": 12.00,
"BaseNetValue": 21.82,
"BaseGrossValue": 24.00,
"BaseTaxValue": 2.18,
"Discounts": [
{
"Identifier": "MM-R",
"Caption": "Lunch menu discount",
"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": "Mixed ice cream sundae",
"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": "Deserts",
"BusinessTransactionType": 0,
"CostPrice": 3.50,
"BaseNetValue": 6.36,
"BaseGrossValue": 7.00,
"BaseTaxValue": 0.64,
"Discounts": [
{
"Identifier": "MM-R",
"Caption": "Lunch menu discount",
"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": []
}
]
},
Ten artykuł został przetłumaczony automatycznie.
Komentarze
Komentarze: 0
Zaloguj się, aby dodać komentarz.