«SubItems» pode ser utilizado para representar itens de conjuntos, itens de menu ou similares no RetailForce. Por exemplo, quando um produto é vendido em conjunto com um serviço como um único produto, ou um menu fixo a um preço único que inclui uma entrada, um prato principal e uma sobremesa.
Os respetivos subitens encontram-se sempre dentro do item relevante, no elemento «SubItems» do JSON payload, e são definidos pelo «type»: «[1] = SubItem» do elemento «positions».
A estrutura dos SubItems individuais corresponde à das posições dos itens («type»: «[0] = Item»), mas NÃO deve conter a propriedade «UseSubItemVatCalculation».
automaticVatCalculation
A configuração através da propriedade «automaticVatCalculation» aplica-se igualmente aos SubItems. Dependendo do método de cálculo selecionado,
- «NoCalculation» = 0
- «NetValueCalculation» = 1
- «GrossValueCalculation» = 2
ou todos os elementos têm de estar presentes, ou determinados valores podem ser omitidos. Os elementos «VatPercent» (ou «VatPercent2») e «VatIdentification» têm de ser sempre especificados.
| Tipo de cálculo | «NetValue» | «GrossValue» | «TaxValue» («TaxValue2») |
| «NoCalculation» | Campo obrigatório | Campo obrigatório | Campo obrigatório |
| «NetValueCalculation» | é calculado | Campo obrigatório | é calculado |
| «GrossValueCalculation» | Campo obrigatório | é calculado | é calculado |
Para mais detalhes sobre o cálculo dos valores dos subitens, consulte o artigo «Propriedade "UseSubItemVatCalculation"».
Numeração das posições dos SubItems
As posições dos SubItems podem ser numeradas conforme desejado.
Exemplos de esquemas de numeração permitidos para subitens:
- a mesma numeração que para os itens — numeração consecutiva das posições dos SubItems de 0 a n
- numeração que começa com {número da posição do item}.{número de sequência do SubItem}: por exemplo, 0.1, 0.2, 0.3
No entanto, a numeração deve ser consistente dentro de cada item. Isto significa que, dentro de cada item, a numeração dos SubItems deve começar do início e devem ser utilizadas as mesmas convenções de numeração.
Exemplo de SubItems
O exemplo seguinte mostra apenas o elemento «positions» e não um 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 artigo foi traduzido automaticamente.
Comentários
0 comentários
iniciar sessão para comentar.