«SubItems» puede utilizarse para representar artículos de un conjunto, platos de menú o similares en RetailForce. Por ejemplo, cuando un producto se vende junto con un servicio como un único producto, o un menú a un precio único que incluye un entrante, un plato principal y un postre.
Los subartículos correspondientes se encuentran siempre dentro del artículo pertinente, en el elemento «SubItems» del JSON payload, y se definen mediante el «type»: «[1] = SubItem» del elemento «positions».
La estructura de cada uno de los SubItems se corresponde con la de las posiciones de los artículos («type»: «[0] = Item»), pero NO debe contener la propiedad «UseSubItemVatCalculation».
automaticVatCalculation
La configuración mediante la propiedad «automaticVatCalculation» también se aplica a los SubItems. Dependiendo del método de cálculo seleccionado,
- «NoCalculation» = 0
- «NetValueCalculation» = 1
- «GrossValueCalculation» = 2
o bien deben estar presentes todos los elementos, o bien pueden omitirse determinados valores. Los elementos «VatPercent» (o «VatPercent2») y «VatIdentification» deben especificarse siempre.
| Tipo de cálculo | «NetValue» | «GrossValue» | «TaxValue» («TaxValue2») |
| «NoCalculation» | Campo obligatorio | Campo obligatorio | Campo obligatorio |
| «NetValueCalculation» | se calcula | Campo obligatorio | se calcula |
| «GrossValueCalculation» | Campo obligatorio | se calcula | Se calcula |
Se pueden consultar más detalles sobre el cálculo de los valores de los subelementos en el artículo «Propiedad "UseSubItemVatCalculation"».
Numeración de las posiciones de los SubItems
Las posiciones de los SubItems pueden numerarse según se desee.
Ejemplos de esquemas de numeración permitidos para las subpartidas:
- la misma numeración que para las partidas: numeración consecutiva de las posiciones de los SubItems del 0 al n
- numeración que comience con {número de posición de la partida}.{número de secuencia del SubItem}: p. ej., 0.1, 0.2, 0.3
No obstante, la numeración debe ser coherente dentro de cada elemento. Esto significa que, dentro de cada elemento, la numeración de los SubItems debe comenzar desde el principio y deben utilizarse las mismas convenciones de numeración.
Ejemplo de SubItems
El siguiente ejemplo muestra únicamente el elemento «positions» y no 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": []
}
]
},
Este artículo ha sido traducido automáticamente.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.