„SubItems” poate fi utilizat pentru a descrie articole din seturi, articole din meniu sau elemente similare în RetailForce. De exemplu, atunci când un produs este vândut împreună cu un serviciu ca un singur produs sau un meniu fix la un preț unic, care cuprinde un aperitiv, un fel principal și un desert.
Subelementele respective se află întotdeauna în cadrul elementului relevant, în elementul „SubItems” al JSON payload, și sunt definite de „type”: „[1] = SubItem” al elementului „positions”.
Structura fiecărui SubItem corespunde cu cea a pozițiilor articolului („type”: „[0] = Item”), dar NU trebuie să conțină proprietatea „UseSubItemVatCalculation”.
automaticVatCalculation
Setarea prin intermediul proprietății „automaticVatCalculation” se aplică și SubItems-urilor. În funcție de metoda de calcul selectată,
- „NoCalculation” = 0
- „NetValueCalculation” = 1
- „GrossValueCalculation” = 2
fie toate elementele trebuie să fie prezente, fie anumite valori pot fi omise. Elementele „VatPercent” (respectiv „VatPercent2”) și „VatIdentification” trebuie specificate întotdeauna.
| Tipul de calcul | „NetValue” | „GrossValue” | „TaxValue” („TaxValue2”) |
| „NoCalculation” | Câmp obligatoriu | Câmp obligatoriu | Câmp obligatoriu |
| „NetValueCalculation” | este calculat | Câmp obligatoriu | este calculat |
| „GrossValueCalculation” | Câmp obligatoriu | este calculat | este calculat |
Detalii suplimentare privind calcularea valorilor pentru subelementele pot fi găsite în articolul Proprietatea „UseSubItemVatCalculation”.
Numerotarea pozițiilor SubItems
Pozițiile SubItems pot fi numerotate după cum doriți.
Exemple de scheme de numerotare permise pentru sub-articole:
- aceeași numerotare ca pentru articole – numerotarea consecutivă a pozițiilor SubItems de la 0 la n
- numerotare începând cu {numărul poziției articolului}.{numărul de ordine al SubItems-ului}: de exemplu, 0.1, 0.2, 0.3
Cu toate acestea, numerotarea trebuie să fie consecventă în cadrul fiecărui element. Aceasta înseamnă că, în cadrul fiecărui element, numerotarea SubItems trebuie să înceapă de la început și trebuie utilizate aceleași convenții de numerotare.
Exemplu de SubItems
Exemplul următor prezintă doar elementul „poziții” și nu un document complet!
"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": []
}
]
},
Acest articol a fost tradus automat.
Comentarii
0 comentarii
Vă rugăm să vă autentificați pentru a lăsa un comentariu.