The SubItems allow composing a main item on a receipt from multiple parts. A typical example is a menu sold as a single item, but that contains, for example, a hamburger, French fries, and a drink. The main item has a total price, and the SubItems are recorded with their own prices, tax rates, and inventory information.
1. Estrutura técnica e campos-chave
Item principal
O item principal é um Position objeto com Type: 0 (Item). Para os SubItems, são obrigatórios os seguintes campos:
| Propriedade | Tipo | Descrição |
|---|---|---|
| UseSubItemVatCalculation | boolean | (Obrigatório) Deve ser definido como true para que os valores dos impostos sejam calculados a partir dos SubItems. |
| VatIdentification | inteiro | (Obrigatório) Deve ser 0 quando o «UseSubItemVatCalculation» estiver ativo. |
| VatPercent | decimal | (Obrigatório) Deve ser 0 quando UseSubItemVatCalculation estiver ativo. |
| SubItems | Array<SUBITEM> | (Obrigatório) Contém os SubItems com as respetivas informações de preço e impostos. |
Nota: NetValue, GrossValue e TaxValue do item pai devem ser iguais às somas dos SubItems.
SubItems
| Propriedade | Tipo | Descrição |
|---|---|---|
| tipo | string | (Obrigatório) Deve ser «SubItem ». |
| Quantidade | decimal | (Obrigatório) Quantidade do subitem. |
| VatIdentification | inteiro | (Obrigatório) Número de ID fiscal do subartigo. |
| VatPercent | decimal | (Obrigatório) Taxa de imposto do subitem. |
| NetValue , TaxValue , GrossValue | decimal | (Obrigatório) Informações sobre o preço por SubItem. GrossValue = NetValue + TaxValue . |
2. Exemplo: Payload completo
A seguinte storeDocument contém um item principal («Item de teste 1 (Menu)») com dois SubItems:
{
"fiscalDocumentNumber": "2",
"fiscalDocumentStartTime": 1755507048,
"FiscalDocumentRevision": 1,
"ModelVersion": "1.4.0",
"UniqueClientId": "8ccedd62-9f72-4cda-b101-7e5e62fb37dc",
"AutomaticVatCalculation": 1,
"DocumentGuid": "08679cec-0df2-4ee0-a138-7ddf55ed2372",
"DocumentId": "08679cec-0df2-4ee0-a138-7ddf55ed2372",
"documentNumber": "08679cec-0df2-4ee0-a138-7ddf55ed2372",
"AllowedVatDeviation": 0.01,
"isTraining": true,
"CreateDate": "2025-08-18T08:52:37Z",
"BookDate": "2025-08-18T08:52:37Z",
"DocumentType": 0,
"positionCount": 2,
"User": {
"Id": "test",
"Caption": "test"
},
"Positions": [
{
"PositionNumber": 0,
"ItemCaption": "Testartikel 1 (Menü)",
"Type": 0,
"InHouse": false,
"Quantity": 1,
"ItemId": "Artikel1",
"VatIdentification": 0,
"VatPercent": 0,
"BusinessTransactionType": 0,
"BaseNetValue": 0.84,
"BaseGrossValue": 1,
"BaseTaxValue": 0.16,
"Discounts": [],
"NetValue": 0.84,
"GrossValue": 1,
"TaxValue": 0.16,
"useSubItemVatCalculation": true,
"subItems": [
{
"type": "SubItem",
"positionNumber": 1,
"ItemCaption": "Unterposition 1.1",
"ItemId": "SubArtikel1-1",
"Quantity": 1,
"VatIdentification": "1",
"VatPercent": 19,
"BusinessTransactionType": 0,
"NetValue": 0.50,
"GrossValue": 0.60,
"TaxValue": 0.10
},
{
"type": "SubItem",
"positionNumber": 2,
"ItemCaption": "Unterposition 1.2",
"ItemId": "SubArtikel1-2",
"Quantity": 1,
"VatIdentification": "1",
"VatPercent": 19,
"BusinessTransactionType": 0,
"NetValue": 0.34,
"GrossValue": 0.40,
"TaxValue": 0.06
}
]
},
{
"PositionNumber": 1,
"ItemCaption": "Testartikel 2",
"Type": 0,
"InHouse": false,
"Quantity": 1,
"ItemId": "Artikel2",
"VatIdentification": "1",
"VatPercent": 19,
"BusinessTransactionType": 0,
"BaseNetValue": 0.84,
"BaseGrossValue": 1,
"BaseTaxValue": 0.16,
"Discounts": [],
"NetValue": 0.84,
"GrossValue": 1,
"TaxValue": 0.16
}
],
"Payments": [
{
"Amount": 2,
"CurrencyIsoCode": "EUR",
"paymentType": "cash",
"caption": "Barzahlung",
"uniqueReadablePaymentIdentifier": "CASH/EUR",
"ExternalIdentifier": []
}
]
}
3. Lista de verificação
✓ O item principal contém "subItems".
✓ "useSubItemVatCalculation": true está definido.
✓ VatIdentification e VatPercent do item principal são 0.
✓ Cada SubItem tem "type": "SubItem".
✓ Os SubItems têm as suas próprias informações sobre impostos e preços.
✓ Os totais dos SubItems correspondem aos valores do item principal.
Este artigo foi traduzido automaticamente.
Comentários
0 comentários
iniciar sessão para comentar.