Pozycje z SubItems

SubItems umożliwiają utworzenie pozycji głównej na paragonie z wielu części. Typowym przykładem jest zestaw sprzedawany jako jedna pozycja, ale zawierający na przykład burgera, frytki i napój. Pozycja nadrzędna ma cenę całkowitą, a SubItems są rejestrowane wraz z własnymi cenami, stawkami podatkowymi i informacjami o zapasach.

1. Struktura techniczna i pola kluczowe

Pozycja nadrzędna

Pozycja nadrzędna to Position obiekt z Type: 0 (Pozycja). W przypadku SubItems wymagane są następujące pola:

Uwaga: NetValue, GrossValue oraz TaxValue pozycji nadrzędnej muszą być równe sumom pozycji podrzędnych.

SubItems

2. Przykład: Pełny payload

Poniższa storeDocument żądanie zawiera pozycję nadrzędną („Pozycja testowa 1 (Menu)”) z dwiema pozycjami podrzędnymi: 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 kontrolna

✓ Pozycja nadrzędna zawiera "subItems".

✓ "useSubItemVatCalculation": true jest ustawiony.

✓ VatIdentification oraz VatPercent elementu nadrzędnego to 0.

✓ Każda pozycja podrzędna posiada "type": "SubItem".

✓ SubItems mają własne informacje dotyczące podatku i ceny.

✓ Suma SubItems jest zgodna z wartościami elementu nadrzędnego.

Ten artykuł został przetłumaczony automatycznie.