Следните примери в JSON илюстрират бизнес случая на депозит или зареждане на клиентска карта („многофункционален ваучер“) и последващото използване на този кредит при продажба.
1. Зареждане на клиентската карта
Първата разписка показва зареждането на многофункционалния ваучер. Сумата се плаща в брой и се записва в касовия апарат като приход, без Vat. При това зареждане все още не се извършва облагаема транзакция, тъй като все още не е определено как ще бъде използван кредитът.
{
"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": {}
}
В този пример позицията „Депозит чрез карта за лоялност“ е отбелязана като многофункционален ваучер. Плащането се извършва в брой (100 EUR) и не се прилага ставка на Vat.
Следните елементи са от решаващо значение:
| JSON елемент | Значение |
| „BusinessTransactionType“: „[4] = MultiPurposeVoucher“ |
Обозначава бизнес транзакцията като продажба на многофункционален ваучер |
| "AdditionalFields": { "VoucherId": "MPV-0001" } | Установява техническата връзка с първоначалния процес на зареждане |
2. Използване чрез клиентската карта
Вторият касов бон показва продажбата на стоки (например цветя), които сега се заплащат частично с предварително заредения кредит и частично в брой.
{
"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
}
]
}
Едва в този момент, при използването чрез закупуване на стоки, възниква облагаемата транзакция и Vat става дължим. Плащането се извършва частично чрез многофункционалния ваучер (карта на клиента) и частично в брой. В този сценарий предварително заредената сума (първи пример) сега се използва действително, което става от значение за целите на Vat в момента на използването.
Следните елементи са от решаващо значение:
| JSON елемент | Значение |
| "PaymentType": "[4] = "MultiPurposeVoucher" | Идентифицира плащането като използване на многофункционален ваучер (например клиентска карта) |
| "UniqueReadablePaymentIdentifier": "MPV-0001" | Уникален идентификатор за начина на плащане, който в този случай идентифицира многофункционалния ваучер |
| „VatIdentification”: 5 & „VatPercent”: 0.0 | Посочва, че за самото осребряване на ваучера не се начислява Vat |
| "AdditionalFields": { "VoucherId": "MPV-0001" } | Установява връзката с първоначалния процес на зареждане |
Важни бележки за внедряването
При внедряването на многофункционални ваучери или плащания с клиентски карти в POS системата трябва да се имат предвид следните точки:
- За зареждане на клиентската карта:
- Търговската транзакция трябва да бъде маркирана като многофункционален ваучер (BusinessTransactionType = 4)
- Идентификационният номер на ваучера трябва да бъде съхранен в полето „AdditionalFields“ с ключ „VoucherId“
- За използване на кредита:
- Същият ID на ваучера трябва да се използва при плащането в „UniqueReadablePaymentIdentifier“ и „AdditionalFields“
- Ставката на Vat се прилага към продадените стоки
- Използването на ваучера се маркира като PaymentType: „[4] = MultiPurposeVoucher“
Тази статия е преведена автоматично.
Коментари
0 коментара
Влезте в услугата, за да оставите коментар.