Poniższe przykłady w formacie JSON ilustrują przypadek biznesowy związany z wpłatą lub doładowaniem karty klienta („bon wielofunkcyjny”) oraz późniejszym wykorzystaniem tego środka podczas transakcji sprzedaży.

1. Doładowanie karty klienta

Pierwszy paragon przedstawia doładowanie bonu wielofunkcyjnego. Kwota jest wpłacana gotówką i rejestrowana w kasie jako przychód bez Vat. W przypadku tego doładowania nie dochodzi jeszcze do transakcji podlegającej opodatkowaniu, ponieważ nie ustalono jeszcze, w jaki sposób środki te zostaną wykorzystane.

{
  "ModelVersion": "1.4.0",
  "UniqueClientId": "2a296a14-f644-4f3f-9ea2-d3f00a3b587c",
  "fiscalDocumentNumber": "8",
  "fiscalDocumentStartTime": 1743161079,
  "fiscalDocumentRevision": 1,
  "AdditionalFields": {},
  "AutomaticVatCalculation": 0,
  "DocumentGuid": "a5f35b65-b5fc-45c8-9b8f-10543c19fa68",
  "DocumentId": "946398c5-d72c-450d-9cdd-8f4d49c5643d",
  "CreateDate": "2025-03-28T12:26:28.4312186+01:00",
  "BookDate": "2025-03-28T12:26:28.4322612+01:00",
  "DocumentType": "[0] = Receipt",
  "User": {
    "Id": "123",
    "Caption": "TestUser",
    "firstName": "Test",
    "lastName": "Test",
    "dateOfEntry": "2020-01-01T08:00:00+01:00"
  },
  "Positions": [
    {
      "Type": "[0] = Item",
      "ItemId": "MPV-0001",
      "ItemCaption": "Deposit via Loyalty Card (MultiPurposeVoucher)",
      "BusinessTransactionType": "[4] = MultiPurposeVoucher",
      "Quantity": 1,
      "VatIdentification": 5,
      "VatPercent": 0.0,
      "NetValue": 100.0,
      "GrossValue": 100.00,
      "TaxValue": 0.00,
      "PositionNumber": 0,
      "AdditionalFields": {
        "VoucherId": "MPV-0001"
      },
      "ExternalIdentifier": []
    }
  ],
  "Payments": [
    {
      "Amount": 100.00,
      "CurrencyIsoCode": "EUR",
      "UniqueReadablePaymentIdentifier": "CASH",
      "caption": "Cash+Euro",
      "AdditionalFields": {},
      "PaymentType": 0,
      "ExternalIdentifier": []
    }
  ],
  "FiscalAdditionalFields": {}
}

W tym przykładzie pozycja „Wpłata za pośrednictwem karty lojalnościowej” jest oznaczona jako bon wielofunkcyjny. Płatność dokonywana jest gotówką (100 EUR) i nie stosuje się stawki Vat.

Uwaga: Zgodnie z ogólną zasadą dotyczącą bonów wielofunkcyjnych w momencie doładowania nie dochodzi do transakcji podlegającej opodatkowaniu, ponieważ w momencie wystawienia bonu nie jest jeszcze ustalone, w jaki sposób środki zostaną później wykorzystane, jakie towary zostaną zakupione ani jaka stawka podatku będzie miała zastosowanie.

Kluczowe znaczenie mają następujące elementy:

Element JSON	Znaczenie
„BusinessTransactionType”: „[4] = MultiPurposeVoucher”	Oznacza transakcję handlową jako sprzedaż bonu wielofunkcyjnego
„AdditionalFields”: { „VoucherId”: „MPV-0001” }	Ustanawia techniczne powiązanie z pierwotnym procesem doładowania

2. Realizacja kuponu za pomocą karty klienta

Drugi paragon przedstawia sprzedaż towarów (np. kwiatów), za które płaci się obecnie częściowo przy użyciu wcześniej doładowanego salda, a częściowo gotówką.

{
  "UniqueClientId": "2a296a14-f644-4f3f-9ea2-d3f00a3b587c",
  "AdditionalFields": {},
  "DocumentGuid": "4dc6f469-4481-4ae3-9b7e-f9b729901698",
  "DocumentId": "4dc6f469-4481-4ae3-9b7e-f9b729901698",
  "CreateDate": "2025-03-28T12:32:28.4312186+01:00",
  "BookDate": "2025-03-28T12:32:28.4322612+01:00",
  "DocumentNumber": "001",
  "DocumentType": "[0] = Receipt",
  "User": {
    "Id": "123",
    "Caption": "TestUser"
  },
  "fiscalDocumentNumber": "9",
  "fiscalDocumentStartTime": 1743161104,
  "fiscalDocumentRevision": 1,
  "Positions": [
    {
      "ItemCaption": "Flower green",
      "ItemShortCaption": null,
      "Discounts": [],
      "Type": 0,
      "UseSubItemVatCalculation": true,
      "SubItems": null,
      "InHouse": false,
      "Quantity": 9.0,
      "QuantityUnit": null,
      "ItemId": "000714",
      "BaseNetValue": 32.52,
      "BaseGrossValue": 38.70,
      "BaseTaxValue": 6.18,
      "GTIN": null,
      "BusinessTransactionType": 0,
      "VatIdentification": 1,
      "VatPercent": 19.0,
      "NetValue": 32.52,
      "GrossValue": 38.70,
      "TaxValue": 6.18,
      "AccountingIdentifier": null,
      "PositionNumber": 0,
      "PositionReference": null,
      "CancellationPosition": false
    },
    {
      "ItemCaption": "Wedding bouquet",
      "ItemShortCaption": null,
      "Discounts": [],
      "Type": 0,
      "UseSubItemVatCalculation": true,
      "SubItems": null,
      "InHouse": false,
      "Quantity": 3.0,
      "QuantityUnit": null,
      "ItemId": "001180",
      "BaseNetValue": 57.48,
      "BaseGrossValue": 68.40,
      "BaseTaxValue": 10.92,
      "GTIN": "8718274490558",
      "BusinessTransactionType": 0,
      "VatIdentification": a1,
      "VatPercent": 19.0,
      "NetValue": 57.48,
      "GrossValue": 68.40,
      "TaxValue": 10.92,
      "AccountingIdentifier": null,
      "PositionNumber": 1,
      "PositionReference": null,
      "CancellationPosition": false
    }
  ],
  "Payments": [
    {
      "Amount": 100.00,
      "PaymentType": "MultiPurposeVoucher",
      "CurrencyIsoCode": "EUR",
      "Caption": "Loyalty Card",
      "UniqueReadablePaymentIdentifier": "MPV-0001",
      "VatIdentification": 5,
      "TaxValue": 0.0,
      "VatPercent": 0.0,
      "AdditionalFields": {
        "VoucherId": "MPV-0001"
      }
    },
    {
      "Amount": 7.10,
      "PaymentType": "cash",
      "CurrencyIsoCode": "EUR",
      "Caption": "Cash+Euro",
      "UniqueReadablePaymentIdentifier": "CASH",
      "ForeignAmount": 0.0,
      "ForeignAmountExchangeRate": 0.0
    }
  ]
}

Dopiero w tym momencie, podczas realizacji kuponu poprzez zakup towarów, ma miejsce transakcja podlegająca opodatkowaniu i powstaje obowiązek zapłaty podatku Vat. Płatność dokonywana jest częściowo za pomocą bonu wielofunkcyjnego (karty klienta), a częściowo gotówką. W tym scenariuszu faktycznie wykorzystywana jest kwota doładowana wcześniej (pierwszy przykład), co ma znaczenie dla celów podatku Vat w momencie realizacji kuponu.

Kluczowe znaczenie mają następujące elementy:

Element JSON	Znaczenie
„PaymentType”: „[4] = „MultiPurposeVoucher”	Określa płatność jako realizację kuponu wielofunkcyjnego (np. karty klienta)
„UniqueReadablePaymentIdentifier”: „MPV-0001”	Unikalny identyfikator metody płatności, który w tym przypadku identyfikuje bon wielofunkcyjny
„VatIdentification”: 5 oraz „VatPercent”: 0,0	Wskazuje, że sama realizacja kuponu nie podlega opodatkowaniu podatkiem Vat
„AdditionalFields”: { „VoucherId”: „MPV-0001” }	Ustanawia powiązanie z pierwotnym procesem doładowania

Ważne uwagi dotyczące wdrożenia

Podczas wdrażania kuponów wielofunkcyjnych lub płatności za pomocą kart klientów w systemie POS należy uwzględnić następujące kwestie:

W przypadku doładowania karty klienta:
- Transakcja biznesowa musi być oznaczona jako bon wielofunkcyjny (BusinessTransactionType = 4)
- Identyfikator kuponu należy zapisać w polu „AdditionalFields” przy użyciu klucza „VoucherId”
W przypadku wykorzystania środków:
- W płatności należy użyć tego samego ID kuponu w polu „UniqueReadablePaymentIdentifier” oraz w polu „AdditionalFields”
- Do sprzedanych towarów stosowana jest stawka Vat
- Realizacja jest oznaczona jako PaymentType: „[4] = MultiPurposeVoucher”

Ten artykuł został przetłumaczony automatycznie.

Realizacja wpłaty, płatności za pomocą karty lojalnościowej

1. Doładowanie karty klienta

2. Realizacja kuponu za pomocą karty klienta

Ważne uwagi dotyczące wdrożenia

Komentarze

1. Doładowanie karty klienta

2. Realizacja kuponu za pomocą karty klienta

Ważne uwagi dotyczące wdrożenia

Powiązane artykuły