« SubItems » peut être utilisé pour représenter des articles d’un ensemble, des plats de menu ou des éléments similaires dans RetailForce. Par exemple, lorsqu’un produit est vendu avec un service en tant que produit unique, ou un menu à prix unique comprenant une entrée, un plat principal et un dessert.
Les sous-articles correspondants sont toujours inclus au sein de l’article concerné, dans l’élément « SubItems » de la charge JSON, et sont définis par la propriété « type » : « [1] = SubItem » de l’élément « positions ».
La structure des SubItems individuels correspond à celle des positions d’élément (« type » : « [0] = Item »), mais ne doit PAS contenir la propriété « UseSubItemVatCalculation ».
automaticVatCalculation
Le paramétrage via la propriété « automaticVatCalculation » s’applique également aux SubItems. Selon la méthode de calcul sélectionnée,
- « NoCalculation » = 0
- « NetValueCalculation » = 1
- « GrossValueCalculation » = 2
soit tous les éléments doivent être présents, soit certaines valeurs peuvent être omises. Les éléments « VatPercent » (ou « VatPercent2 ») et « VatIdentification » doivent toujours être spécifiés.
| Type de calcul | « NetValue » | « GrossValue » | « TaxValue » (« TaxValue2 ») |
| « NoCalculation » | Champ obligatoire | Champ obligatoire | Champ obligatoire |
| « NetValueCalculation » | est calculée | Champ obligatoire | est calculé |
| « GrossValueCalculation » | Champ obligatoire | est calculé | est calculé |
Pour davantage de détails concernant le calcul des valeurs des sous-éléments, veuillez consulter l’article « Propriété "UseSubItemVatCalculation" ».
Numérotation des positions des SubItems
Les positions des SubItems peuvent être numérotées selon vos besoins.
Exemples de schémas de numérotation autorisés pour les sous-articles :
- la même numérotation que pour les articles — numérotation consécutive des positions des SubItems de 0 à n
- une numérotation commençant par {numéro de position de l'article}.{numéro de séquence du SubItem} : par exemple 0.1, 0.2, 0.3
Toutefois, la numérotation doit demeurer cohérente au sein de chaque élément. Cela signifie que, pour chaque élément, la numérotation des SubItems doit repartir de zéro et que les mêmes conventions de numérotation doivent être appliquées.
Exemple de SubItems
L’exemple suivant ne présente que l’élément « positions » et non 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": []
}
]
},
Cet article a été traduit automatiquement.
Commentaires
0 commentaire
Vous devez vous connecter pour laisser un commentaire.