"SubItems" può essere utilizzato per rappresentare articoli in set, voci di menu o simili in RetailForce. Ad esempio, quando un prodotto viene venduto insieme a un servizio come unico prodotto, oppure un menu fisso a prezzo unico comprendente un antipasto, un piatto principale e un dessert.
Le rispettive voci secondarie sono sempre annidate all’interno della voce pertinente, nell’elemento «SubItems» del JSON payload, e sono identificate dal «type»: «[1] = SubItem» dell’elemento «positions».
La struttura dei singoli SubItems corrisponde a quella delle posizioni delle voci (“type”: “[0] = Item”), ma NON deve contenere la proprietà “UseSubItemVatCalculation”.
automaticVatCalculation
L’impostazione tramite la proprietà «automaticVatCalculation» si applica anche ai SubItems. A seconda del metodo di calcolo selezionato,
- "NoCalculation" = 0
- "NetValueCalculation" = 1
- "GrossValueCalculation" = 2
tutti gli elementi devono essere presenti oppure alcuni valori possono essere omessi. Gli elementi «VatPercent» (rispettivamente «VatPercent2») e «VatIdentification» devono essere sempre specificati.
| Tipo di calcolo | "NetValue" | "GrossValue" | "taxValue" ("taxValue2") |
| "NoCalculation" | Campo obbligatorio | Campo obbligatorio | Campo obbligatorio |
| "NetValueCalculation" | viene calcolato | Campo obbligatorio | viene calcolato |
| "GrossValueCalculation" | Campo obbligatorio | viene calcolato | viene calcolato |
Ulteriori dettagli relativi al calcolo dei valori per le voci secondarie sono disponibili nell’articolo «Proprietà "UseSubItemVatCalculation"».
Numerazione delle posizioni delle SubItems
Le posizioni delle SubItems possono essere numerate a piacere.
Esempi di schemi di numerazione consentiti per le sottovoci:
- la stessa numerazione utilizzata per le voci – numerazione consecutiva delle posizioni delle SubItems da 0 a n
- numerazione che inizia con {numero di posizione della voce}.{numero di sequenza del SubItem}: ad es. 0.1, 0.2, 0.3
Tuttavia, la numerazione deve essere coerente all’interno di ciascuna voce. Ciò significa che, all’interno di ciascuna voce, la numerazione delle SubItems deve iniziare dall’inizio e devono essere utilizzate le stesse convenzioni di numerazione.
Esempio di SubItems
L’esempio seguente mostra solo l’elemento «positions» e non un documento completo!
"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": []
}
]
},
Questo articolo è stato tradotto automaticamente.
Commenti
0 commenti
Accedi per aggiungere un commento.