”SubItems” kan användas för att beskriva paket, menyalternativ eller liknande i RetailForce. Till exempel när en produkt säljs tillsammans med en tjänst som en enda produkt, eller en fast meny till ett enda pris som består av en förrätt, en huvudrätt och en efterrätt.
De respektive delartiklarna finns alltid inom den relevanta artikeln, i elementet ”SubItems” i JSON payloaden, och definieras av ”type”: ”[1] = SubItem” i elementet ”positions”.
Strukturen för de enskilda SubItems motsvarar den för artikelpositionerna (”type”: ”[0] = Item”), men får INTE innehålla egenskapen ”UseSubItemVatCalculation”.
automaticVatCalculation
Inställningen via egenskapen ”automaticVatCalculation” gäller även för SubItems. Beroende på vilken beräkningsmetod som har valts gäller följande:
- "NoCalculation" = 0
- "NetValueCalculation" = 1
- "GrossValueCalculation" = 2
måste antingen alla element finnas med, eller så kan vissa värden utelämnas. Elementen ”VatPercent” (respektive ”VatPercent2”) och ”VatIdentification” måste alltid anges.
| Beräkningstyp | "NetValue" | "GrossValue" | "taxValue" ("taxValue2") |
| "NoCalculation" | Obligatoriskt fält | Obligatoriskt fält | Obligatoriskt fält |
| "NetValueCalculation" | beräknas | Obligatoriskt fält | beräknas |
| "GrossValueCalculation" | Obligatoriskt fält | beräknas | beräknas |
Mer information om beräkningen av värden för underposter finns i artikeln Egenskapen ”UseSubItemVatCalculation”.
Numrering av SubItems-positionerna
SubItems kan numreras efter önskemål.
Exempel på tillåtna numreringsscheman för underposter:
- samma numrering som för artiklar – löpande numrering av SubItems-positionerna från 0 till n
- numrering som börjar med {postens positionsnummer}.{SubItems-löpnummer}: t.ex. 0.1, 0.2, 0.3
Numreringen måste dock vara konsekvent inom varje punkt. Detta innebär att numreringen av SubItems inom varje punkt måste börja från början och att samma numreringskonventioner måste användas.
Exempel på SubItems
Följande exempel visar endast elementet ”positions” och inte ett komplett 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": []
}
]
},
Den här artikeln har översatts automatiskt.
Kommentarer
0 kommentarer
logga in för att lämna en kommentar.