Posizioni con SubItems

SubItems consentono di comporre una voce principale su uno scontrino a partire da più parti. Un esempio tipico è un menu venduto come un’unica voce ma contenente, ad esempio, un hamburger, patatine fritte e una bevanda. La voce principale ha un prezzo totale, mentre le voci secondarie vengono registrate con i propri prezzi, le aliquote fiscali e le informazioni di magazzino.

1. Struttura tecnica e campi chiave

Articolo principale

La voce principale è un Position oggetto di tipo Type: 0 (Articolo). Per le SubItems sono obbligatori i seguenti campi:

Nota: NetValue, GrossValue e TaxValue dell’elemento principale devono essere pari alla somma dei SubItems.

SubItems

2. Esempio: Payload completo

La seguente storeDocument richiesta contiene una voce principale (“Voce di prova 1 (Menu)”) con due 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 di controllo

✓ L’articolo principale contiene "subItems".

✓ "useSubItemVatCalculation": true è impostato.

✓ VatIdentification e VatPercent della voce principale sono 0.

✓ Ogni SubItem dispone "type": "SubItem".

✓ Ogni SubItem dispone di informazioni fiscali e di prezzo autonome.

✓ I totali delle SubItems corrispondono ai valori della voce principale.

Questo articolo è stato tradotto automaticamente.