Az alábbi JSON-példák egy ügyfélkártyára („többcélú utalvány”) történő befizetés vagy feltöltés, valamint az ezen hitelérték értékesítés során történő későbbi beváltásának üzleti esetét szemléltetik.
1. Az ügyfélkártya feltöltése
Az első nyugta a többcélú utalvány feltöltését mutatja. Az összeget készpénzben fizetik be, és a pénztárgépben bevételként rögzítik, Vat nélkül. Ezzel a feltöltéssel még nem jön létre adóköteles tranzakció, mivel még nem dőlt el, hogyan fogják felhasználni a jóváírást.
{
"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": {}
}
Ebben a példában a „Betét hűségkártyán keresztül” tétel többcélú utalványként van megjelölve. A fizetés készpénzben történik (100 EUR), és nem alkalmaznak Vat-kulcsot.
A következő elemek döntő fontosságúak:
| JSON-elem | Jelentés |
| „BusinessTransactionType”: „[4] = MultiPurposeVoucher” |
Az üzleti tranzakciót többcélú utalvány értékesítésének jelöli |
| "AdditionalFields": { "VoucherId": "MPV-0001" } | Létrehozza a technikai kapcsolatot az eredeti feltöltési folyamattal |
2. Beváltás az ügyfélkártyával
A második nyugta az áruk (pl. virágok) értékesítését mutatja, amelyekért a fizetés részben a korábban feltöltött egyenlegből, részben készpénzben történik.
{
"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
}
]
}
Csak ebben a pillanatban, az áruk vásárlásán keresztül történő beváltáskor jön létre az adóköteles tranzakció, és válik esedékessé az áfa. A fizetés részben a többcélú utalványon (ügyfélkártyán), részben készpénzben történik. Ebben a forgatókönyvben a korábban feltöltött összeg (első példa) most ténylegesen felhasználásra kerül, ami az áfa szempontjából a beváltás pillanatában válik relevánssá.
A következő elemek döntő fontosságúak:
| JSON-elem | Jelentés |
| „PaymentType”: „[4] = „MultiPurposeVoucher” | A fizetést többcélú utalvány (pl. ügyfélkártya) beváltásaként azonosítja |
| „UniqueReadablePaymentIdentifier”: „MPV-0001” | A fizetési mód egyedi azonosítója, amely ebben az esetben a többcélú utalványt azonosítja |
| „VatIdentification”: 5 és „VatPercent”: 0,0 | Jelzi, hogy az utalvány beváltására magára nem vonatkozik Vat |
| "AdditionalFields": { "VoucherId": "MPV-0001" } | Létrehozza a kapcsolatot az eredeti feltöltési folyamattal |
Fontos megvalósítási megjegyzések
A POS-rendszerben a többcélú utalványok vagy az ügyfélkártyás fizetések megvalósításakor a következő szempontokat kell figyelembe venni:
- Az ügyfélkártya feltöltéséhez:
- Az üzleti tranzakciót többcélú utalványként kell megjelölni (BusinessTransactionType = 4)
- Az utalvány ID-jét az „AdditionalFields” mezőben kell tárolni a „VoucherId” kulccsal
- A jóváírás beváltásához:
- Ugyanazt az utalványID-t kell használni a fizetés során az „UniqueReadablePaymentIdentifier” és az „AdditionalFields” mezőkben
- Az eladott árukra a Vat-kulcsot kell alkalmazni
- A beváltást PaymentType: „[4] = MultiPurposeVoucher”ként kell megjelölni
Ezt a cikket automatikusan lefordították.
Hozzászólások
0 hozzászólás
Hozzászólások írásához jelentkezzen be.