Sljedeći JSON primjeri ilustriraju poslovni slučaj depozita ili punjenja kartice kupca ("višenamjenski bon") i naknadno iskorištavanje tog kredita tijekom prodaje.
1. Učitavanje kartice kupca
Prvi račun prikazuje punjenje višenamjenske vaučer-kartice. Iznos se plaća gotovinom i evidentira u blagajni kao prihod, bez PDV-a. Ovim punjenjem još ne nastaje oporeziva transakcija jer još nije određeno kako će se kredit iskoristiti.
{
"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": {}
}
U ovom primjeru stavka "Depozit putem kartice vjernosti" označena je kao višenamjenski vaučer. Plaćanje se vrši gotovinom (100 EUR) i ne primjenjuje se stopa PDV-a.
Sljedeći elementi su ključni:
| JSON element | Značenje |
| "BusinessTransactionType": "[4] = MultiPurposeVoucher" |
Označava poslovnu transakciju kao prodaju višenamjenske vaučerske kartice |
| "AdditionalFields": { "VoucherId": "MPV-0001" } | Uspostavlja tehničku vezu s izvornim postupkom punjenja |
2. Iskorištavanje putem kartice kupca
Drugi račun prikazuje prodaju robe (npr. cvijeća), koja je sada plaćena djelomično korištenjem prethodno učitane kreditne sredine, a djelomično gotovinom.
{
"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
}
]
}
Tek u tom trenutku, prilikom iskorištavanja kupnje robe, nastaje oporeziva transakcija i PDV postaje dospjeo. Plaćanje se vrši djelomično putem višenamjenskog kupona (kartice kupca), a djelomično u gotovini. U ovom scenariju sada se zapravo koristi prethodno uplaćeni iznos (prvi primjer), što postaje relevantno za PDV u trenutku iskorištenja.
Sljedeći elementi su ključni:
| JSON element | Značenje |
| "PaymentType": "[4] = "MultiPurposeVoucher" | Identificira plaćanje kao otkup višenamjenskog kupona (npr. kartice kupca) |
| "UniqueReadablePaymentIdentifier": "MPV-0001" | Jedinstveni identifikator načina plaćanja, koji u ovom slučaju identificira višenamjenski kupon |
| VatIdentification": 5 & "VatPercent": 0.0 | Navesti da se na isplatu vaučera ne primjenjuje PDV |
| "DodatnaPolja": { "IDVaučera": "MPV-0001" } | Uspostavlja vezu s izvornim postupkom učitavanja |
Važne napomene za implementaciju
Prilikom implementacije višenamjenskih kupona ili plaćanja karticama kupaca u POS sustavu, potrebno je uzeti u obzir sljedeće točke:
- Za učitavanje kartice kupca:
- Poslovna transakcija mora biti označena kao višenamjenski vaučer (BusinessTransactionType = 4)
- ID vaučera mora se pohraniti u polje "AdditionalFields" s ključem "VoucherId"
- Za iskorištavanje kredita:
- Isti ID vaučera mora se koristiti u plaćanju pod "UniqueReadablePaymentIdentifier" i AdditionalFields
- Stopa PDV-a primjenjuje se na prodanu robu
- Otkup je označen kao PaymentType: "[4] = MultiPurposeVoucher"
Ovaj je članak automatski preveden.
Komentari
0 komentara
Molimo Prijavite se kako bi ostavili komentar.