A „SubItems” a RetailForce-ban készletek, menüelemek vagy hasonlóak ábrázolására használható. Például amikor egy terméket egy szolgáltatással együtt egyetlen termékként értékesítenek, vagy egy előételt, főételt és desszertet tartalmazó, egységes áron kínált menükészletet.
A megfelelő alelemek mindig a vonatkozó tételen belül, a JSON payload „SubItems” elemében találhatók, és a „positions” elem „type”: „[1] = SubItem” tulajdonságával vannak meghatározva.
Az egyes SubItems szerkezete megegyezik az elem pozícióinak szerkezetével („type”: „[0] = Item”), de NEM tartalmazhatja az „UseSubItemVatCalculation” tulajdonságot.
automaticVatCalculation
Az „automaticVatCalculation” tulajdonságon keresztül történő beállítás a SubItems-re is vonatkozik. Attól függően, hogy melyik számítási módszert választották,
- „NoCalculation” = 0
- „NetValueCalculation” = 1
- „GrossValueCalculation” = 2
vagy minden elemnek jelen kell lennie, vagy bizonyos értékek kihagyhatók. A „VatPercent” (illetve „VatPercent2”) és a „VatIdentification” elemeket mindig meg kell adni.
| Számítási típus | „NetValue” | „GrossValue” | „TaxValue” („TaxValue2”) |
| „NoCalculation” | Kötelező mező | Kötelező mező | Kötelező mező |
| „NetValueCalculation” | kiszámításra kerül | Kötelező mező | kiszámítva |
| „GrossValueCalculation” | Kötelező mező | kiszámításra kerül | kiszámításra kerül |
Az alelemek értékeinek kiszámításával kapcsolatos további részletek a „UseSubItemVatCalculation” tulajdonságról szóló cikkben találhatók.
Az SubItems sorszámozása
SubItems pozíciói tetszés szerint számozhatók.
Példák az alelemek megengedett számozási rendszereire:
- ugyanaz a számozás, mint a tételeknél – az alelemek pozícióinak egymást követő számozása 0-tól n-ig
- {tétel pozíciószáma}.{SubItem sorszáma} formában kezdődő számozás: pl. 0.1, 0.2, 0.3
A számozásnak azonban minden tételen belül következetesnek kell lennie. Ez azt jelenti, hogy minden tételen belül a SubItems számozásának az elejétől kell kezdődnie, és ugyanazokat a számozási szabályokat kell alkalmazni.
Példa SubItemsre
Az alábbi példa csak a „positions” elemet mutatja be, nem pedig egy teljes dokumentumot!
"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": []
}
]
},
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.