Nasledujúce príklady v formáte JSON ilustrujú obchodný prípad vkladu alebo nabitia zákazníckej karty („viacúčelový poukaz“) a následné uplatnenie tohto kreditu pri predaji.
1. Dobitie zákazníckej karty
Prvý doklad zobrazuje nabitie viacúčelového poukazu. Suma je zaplatená v hotovosti a zaznamenaná v pokladni ako príjem bez Vat. Pri tomto nabití ešte nedochádza k zdaniteľnej transakcii, keďže zatiaľ nie je určené, ako bude kredit použitý.
{
"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": {}
}
V tomto príklade je položka „Vklad prostredníctvom vernostnej karty“ označená ako viacúčelový poukaz. Platba sa uskutočňuje v hotovosti (100 EUR) a neuplatňuje sa žiadna sadzba Vat.
Kľúčové sú nasledujúce prvky:
| Prvok JSON | Význam |
| „BusinessTransactionType“: „[4] = MultiPurposeVoucher“ |
Označuje obchodnú transakciu ako predaj viacúčelového poukazu |
| „AdditionalFields“: { „VoucherId“: „MPV-0001“ } | Vytvára technické prepojenie s pôvodným procesom nabitia |
2. Uplatnenie prostredníctvom zákazníckej karty
Druhý doklad zobrazuje predaj tovaru (napr. kvetín), ktorý je teraz čiastočne uhradený pomocou predtým naloženého kreditu a čiastočne v hotovosti.
{
"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
}
]
}
Až v tomto momente, pri uplatnení prostredníctvom nákupu tovaru, dochádza k zdaniteľnej transakcii a vzniká povinnosť zaplatiť Vat. Platba sa uskutočňuje čiastočne prostredníctvom viacúčelového poukazu (zákazníckej karty) a čiastočne v hotovosti. V tomto scenári sa teraz skutočne využíva predtým nahratá suma (prvý príklad), čo sa stáva relevantným pre účely Vat v momente uplatnenia.
Kľúčové sú nasledujúce prvky:
| Prvok JSON | Význam |
| „PaymentType“: „[4] = „MultiPurposeVoucher“ | Identifikuje platbu ako uplatnenie viacúčelového poukazu (napr. zákazníckej karty) |
| „UniqueReadablePaymentIdentifier“: „MPV-0001“ | Jedinečný identifikátor platobnej metódy, ktorý v tomto prípade identifikuje viacúčelový poukaz |
| „VatIdentification“: 5 a „VatPercent“: 0,0 | Uvádza, že na samotné uplatnenie poukážky sa nevzťahuje Vat |
| „AdditionalFields“: { „VoucherId“: „MPV-0001“ } | Vytvára prepojenie s pôvodným procesom načítania |
Dôležité poznámky k implementácii
Pri implementácii viacúčelových poukážok alebo platieb zákazníckymi kartami v POS systéme je potrebné zohľadniť nasledujúce body:
- Pri dobíjaní zákazníckej karty:
- Obchodná transakcia musí byť označená ako viacúčelový poukaz (BusinessTransactionType = 4)
- ID poukážky musí byť uložené v poli „AdditionalFields“ s kľúčom „VoucherId“
- Pri uplatnení kreditu:
- V platbe sa musí v poliach „UniqueReadablePaymentIdentifier“ a „AdditionalFields“ použiť rovnaké ID poukážky
- Na predaný tovar sa uplatňuje sadzba Vat
- Uplatnenie je označené ako PaymentType: „[4] = MultiPurposeVoucher“
Tento článok bol preložený automaticky.
Príspevky
0 komentárov
Ak chcete napísať komentár, prihlásiť sa.