Business Case Samples for Italy
Business Case Samples for Italy
Important Notice: This page provides sample scenarios intended to illustrate typical business cases. However, these examples are not exhaustive and may not fully reflect your specific operational or legal obligations under the Italian fiscalisation framework. It is essential that your complete fiscalisation scenario is thoroughly prepared and validated by your team, in collaboration with a qualified tax consultant or accountant familiar with Italian tax law and requirements.
Given the complexity and legal significance of fiscal reporting in Italy, it is your responsibility to ensure that all scenarios are accurately implemented and fully compliant with current legislation.
Use these samples as guidelines only—not as a substitute for professional advice or a complete implementation strategy.
SAMPLES BY SCENARIOS
- Queue-Start-Receipt (Initial operations receipt)- 1. Standard sale with no tip
- 2. Sale and immediate card payment (tip on payment terminal)
- 3. Sale and immediate cash payment (tip left separately)
- 4. Table service, bill paid later by card (tip on payment terminal)
- 5. Table service, bill paid later in cash (tip left separately)
- 6. Percentage discount (card payment, tip on payment terminal)
- 7. Discount according to price list (cash payment, tip separately)
- 8. Staff discount (card payment, no tip)
- 9. Table service, multiple payment methods and discount
- 10. Free item (no payment)
- 11. Selling a gift card
- 12. Redeeming a gift card (full or partial)
- 13. Stamp / loyalty card for coffee
- 14. Redeeming a full stamp card (free coffee + pays for pastry)
- 15. Customer-specific price list activated by customer name
- 16. Automatically scheduled price list (e.g. Happy Hour)
- 17. Incorrect receipt corrected immediately
- 18. Receipt correction after a day or a week
- 19. Refund issued as a store-value card (money back as card credit)
QUEUE START RECEIPT
Example
Queue-Start-Receipt (Initial operations receipt)
{
"cbReceiptReference": "Start-receipt-time-13Aug-2025-11:30",
"cbReceiptMoment": "2025-08-13T11:30:04Z",
"cbChargeItems":
[],
"cbPayItems":
[],
"ftReceiptCase": 5283848262812450817, // Decimal value of 4954000000004001 (4954 is Country Code of Italy)
"currencyCode": "978"
}1. Standard sale with no tip
- Event: Customer orders a soft drink at the bar and pays immediately.
- POS: Enters the soft drink into the POS and initiates the chosen payment method.
- Payment Terminal: Processes the payment; tip prompt is disabled or customer skips the tip.
- Payment: Card or cash, no tip.
{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 100,
"description": "Book",
"position": 1,
"moment": "2025-10-08T16:11:06Z",
"quantity": 100,
"vatRate": 2400,
"vatAmount": 1240,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
}
],
"cbPayItems": [
{
"amount": 1240,
"description": "Card",
"position": 2,
"currencyCode": 978,
"moment": "2025-10-08T16:11:06Z",
"ftPayItemCase": 5283883447184523269
}
],
"cbReceiptMoment": "2025-10-08T16:11:06Z",
"cbReceiptReference": "order001",
"cbReceiptAmount": 1240,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn",
"AA": 1,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn-1-order001-2025-10-08T16:11:06Z-12.4"
}
}
}
}2. Sale and immediate card payment (tip on payment terminal)
- Event: Customer orders a beer at the bar counter.
- POS: Enters the beer into the POS and initiates the card payment.
- Payment Terminal: Displays the tip prompt; customer adds a tip.
- Payment: Card + tip.
{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 1240,
"description": "Book",
"position": 1,
"moment": "2025-10-08T16:11:06Z",
"quantity": 100,
"vatRate": 2400,
"vatAmount": 240,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
},
{
"amount": 200,
"description": "Tip",
"position": 2,
"moment": "2025-10-08T16:11:06Z",
"quantity": 1,
"vatRate": 0,
"vatAmount": 0,
"ftChargeItemCase": 5283883447184523320,
"currencyCode": 978
}
],
"cbPayItems": [
{
"amount": 1440,
"description": "Card",
"position": 2,
"currencyCode": 978,
"moment": "2025-10-08T16:11:06Z",
"ftPayItemCase": 5283883447184523268
}
],
"cbReceiptMoment": "2025-10-08T16:11:06Z",
"cbReceiptReference": "order001",
"cbReceiptAmount": 12400,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn",
"AA": 1,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn-1-order001-2025-10-08T16:11:06Z-14.4"
}
}
}
}3. Sale and immediate cash payment (tip left separately)
- Event: Customer orders a beer and pays immediately with cash at the counter.
- POS: Enters the beer into the POS and selects “Cash” as the payment method.
- Payment Terminal: Not used. Customer leaves tip in cash separately.
- Payment: Cash + tip in cash separately.
{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 500,
"description": "beer",
"position": 1,
"moment": "2025-10-08T16:11:06Z",
"quantity": 100,
"vatRate": 2400,
"vatAmount": 2400,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
},
{
"amount": 200,
"description": "Tip",
"position": 2,
"moment": "2025-10-08T16:11:06Z",
"quantity": 1,
"vatRate": 0,
"vatAmount": 0,
"ftChargeItemCase": 5283883447184523320,
"currencyCode": 978
}
],
"cbPayItems": [
{
"amount": 700,
"description": "Cash",
"position": 2,
"currencyCode": 978,
"moment": "2025-10-08T16:11:06Z",
"ftPayItemCase": 5283883447184523267
}
],
"cbReceiptMoment": "2025-10-08T16:11:06Z",
"cbReceiptReference": "order003",
"cbReceiptAmount": 700,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn1",
"AA": 100,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn1-100-order003-2025-10-08T16:11:06Z-7.0"
}
}
}
}4. Table service, bill paid later by card (tip on payment terminal)
- Event: Customer orders beer and food to the table.
- POS: Opens a table and records orders into an open tab.
- Payment Terminal: When the bill is closed, the payment terminal asks for a tip; customer adds a tip.
- Payment: Card + tip.
{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 500,
"description": "beer",
"position": 1,
"moment": "2025-10-08T16:11:06Z",
"quantity": 100,
"vatRate": 2400,
"vatAmount": 2400,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
}
],
"cbPayItems": [
],
"cbReceiptMoment": "2025-10-08T16:11:06Z",
"cbReceiptReference": "order003",
"cbArea": "table-1",
"cbReceiptAmount": 700,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn2",
"AA": 101,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn2-101-order003-2025-10-08T16:11:06Z-7.0"
}
}
}
}{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 1500,
"description": "food",
"position": 1,
"moment": "2025-10-08T16:11:06Z",
"quantity": 100,
"vatRate": 2400,
"vatAmount": 2400,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
}
],
"cbPayItems": [
],
"cbReceiptMoment": "2025-10-08T16:11:06Z",
"cbReceiptReference": "order004",
"cbArea": "table-1",
"cbReceiptAmount": 1500,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn3",
"AA": 102,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn3-102-order004-2025-10-08T16:11:06Z-15.0"
}
}
}
}{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 500,
"description": "beer",
"position": 1,
"moment": "2025-10-08T21:05:00Z",
"quantity": 100,
"vatRate": 2400,
"vatAmount": 97,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
},
{
"amount": 1500,
"description": "food",
"position": 2,
"moment": "2025-10-08T21:05:00Z",
"quantity": 100,
"vatRate": 2400,
"vatAmount": 290,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
},
{
"amount": 200,
"description": "Tip",
"position": 3,
"moment": "2025-10-08T21:05:02Z",
"quantity": 1,
"vatRate": 0,
"vatAmount": 0,
"ftChargeItemCase": 5283883447184523320,
"currencyCode": 978
}
],
"cbPayItems": [
{
"amount": 2200,
"description": "Card",
"position": 1,
"currencyCode": 978,
"moment": "2025-10-08T21:05:05Z",
"ftPayItemCase": 5283883447184523268
}
],
"cbReceiptMoment": "2025-10-08T21:05:06Z",
"cbReceiptReference": "order005",
"cbPreviousReceiptReference": ["order004","order003"],
"cbArea": "table-1",
"cbReceiptAmount": 2200,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn4",
"AA": 104,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn4-104-order005-2025-10-08T21:05:06Z-22.0"
}
}
}
}5. Table service, bill paid later in cash (tip left separately)
- Event: Customer orders beer and food to the table in several rounds.
- POS: Opens a table order.
- Payment Terminal: Not used. When the bill is closed, customer pays in cash and leaves a tip in cash.
- Payment: Cash + tip in cash separately.
{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 500,
"description": "beer",
"position": 1,
"moment": "2025-10-08T16:11:06Z",
"quantity": 100,
"vatRate": 2400,
"vatAmount": 2400,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
}
],
"cbPayItems": [
],
"cbReceiptMoment": "2025-10-08T16:11:06Z",
"cbReceiptReference": "order003",
"cbArea": "table-1",
"cbReceiptAmount": 700,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn2",
"AA": 101,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn2-101-order003-2025-10-08T16:11:06Z-7.0"
}
}
}
}{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 1500,
"description": "food",
"position": 1,
"moment": "2025-10-08T16:11:06Z",
"quantity": 100,
"vatRate": 2400,
"vatAmount": 2400,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
}
],
"cbPayItems": [
],
"cbReceiptMoment": "2025-10-08T16:11:06Z",
"cbReceiptReference": "order004",
"cbArea": "table-1",
"cbReceiptAmount": 1500,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn3",
"AA": 102,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn3-102-order004-2025-10-08T16:11:06Z-15.0"
}
}
}
}{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 500,
"description": "beer",
"position": 1,
"moment": "2025-10-08T21:05:00Z",
"quantity": 100,
"vatRate": 2400,
"vatAmount": 97,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
},
{
"amount": 1500,
"description": "food",
"position": 2,
"moment": "2025-10-08T21:05:00Z",
"quantity": 100,
"vatRate": 2400,
"vatAmount": 290,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
},
{
"amount": 200,
"description": "Tip",
"position": 3,
"moment": "2025-10-08T21:05:02Z",
"quantity": 1,
"vatRate": 0,
"vatAmount": 0,
"ftChargeItemCase": 5283883447184523320,
"currencyCode": 978
}
],
"cbPayItems": [
{
"amount": 2200,
"description": "cash",
"position": 1,
"currencyCode": 978,
"moment": "2025-10-08T21:05:05Z",
"ftPayItemCase": 5283883447184523267
}
],
"cbReceiptMoment": "2025-10-08T21:05:06Z",
"cbReceiptReference": "order005",
"cbPreviousReceiptReference": ["order004","order003"],
"cbArea": "table-1",
"cbReceiptAmount": 2200,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn4",
"AA": 104,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn4-104-order005-2025-10-08T21:05:06Z-22.0"
}
}
}
}6. Percentage discount (card payment, tip on payment terminal)
- Event: Customer orders a main course and is given a 20% loyalty discount.
- POS: Enters the product and applies the -20% discount. Initiates card payment.
- Payment Terminal: Customer adds a tip on the payment terminal.
- Payment: Card + tip.
{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 1800,
"description": "Main course",
"position": 1,
"moment": "2025-10-09T19:10:00Z",
"quantity": 100,
"vatRate": 2400,
"vatAmount": 348,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
},
{
"amount": -360,
"description": "Loyalty discount (-20%)",
"position": 2,
"moment": "2025-10-09T19:10:00Z",
"quantity": 1,
"vatRate": 2400,
"vatAmount": -69,
"ftChargeItemCase": 5283883447184785411,
"currencyCode": 978
},
{
"amount": 200,
"description": "Tip",
"position": 3,
"moment": "2025-10-09T19:10:05Z",
"quantity": 1,
"vatRate": 0,
"vatAmount": 0,
"ftChargeItemCase": 5283883447184523320,
"currencyCode": 978
}
],
"cbPayItems": [
{
"amount": 1640,
"description": "Card",
"position": 1,
"currencyCode": 978,
"moment": "2025-10-09T19:10:06Z",
"ftPayItemCase": 5283883447184523268
}
],
"cbReceiptMoment": "2025-10-09T19:10:07Z",
"cbReceiptReference": "order006",
"cbReceiptAmount": 1640,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn5",
"AA": 105,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn5-105-order006-2025-10-09T19:10:07Z-16.4"
}
}
}
}7. Discount according to price list (cash payment, tip separately)
- Event: Happy Hour price: beer €5 (normally €6). Customer pays immediately in cash at the counter.
- POS: Selects the reduced price according to the price list.
- Payment Terminal: Not used. Customer leaves tip in cash.
- Payment: Cash + tip in cash separately.
{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 500,
"description": "Beer (Happy Hour)",
"position": 1,
"moment": "2025-10-08T16:11:06Z",
"quantity": 100,
"vatRate": 2400,
"vatAmount": 97,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
},
{
"amount": 200,
"description": "Tip",
"position": 2,
"moment": "2025-10-08T16:11:06Z",
"quantity": 1,
"vatRate": 0,
"vatAmount": 0,
"ftChargeItemCase": 5283883447184523320,
"currencyCode": 978
}
],
"cbPayItems": [
{
"amount": 700,
"description": "Cash",
"position": 2,
"currencyCode": 978,
"moment": "2025-10-08T16:11:06Z",
"ftPayItemCase": 5283883447184523267
}
],
"cbReceiptMoment": "2025-10-08T16:11:06Z",
"cbReceiptReference": "order007",
"cbReceiptAmount": 700,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn9",
"AA": 101,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn9-101-order007-2025-10-08T16:11:06Z-7.0"
}
}
}
}8. Staff discount (card payment, no tip)
- Event: Employee buys food with a -50% staff discount.
- POS: Enters the product and applies the staff discount. Initiates card payment.
- Payment Terminal: No tip.
- Payment: Card.
{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 1000,
"description": "Main course",
"position": 1,
"moment": "2025-10-09T19:10:00Z",
"quantity": 100,
"vatRate": 2400,
"vatAmount": 194,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
},
{
"amount": -500,
"description": "Employee discount (-50%)",
"position": 2,
"moment": "2025-10-09T19:10:00Z",
"quantity": 1,
"vatRate": 2400,
"vatAmount": -97,
"ftChargeItemCase": 5283883447184785411,
"currencyCode": 978
}
],
"cbPayItems": [
{
"amount": 500,
"description": "Card",
"position": 1,
"currencyCode": 978,
"moment": "2025-10-09T19:10:06Z",
"ftPayItemCase": 5283883447184523268
}
],
"cbReceiptMoment": "2025-10-09T19:10:07Z",
"cbReceiptReference": "order006",
"cbReceiptAmount": 500,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn5",
"AA": 105,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn5-105-order006-2025-10-09T19:10:07Z-16.4"
}
}
}
}9. Table service, multiple payment methods and discount
- Event: A party of three orders several dishes at the table. A 10% discount is applied to the final bill.
- POS: Opens the table, records products, closes the bill, and applies -10% discount to the total.
- Payment Terminal: Each person pays their share with different payment methods; some add tips on the payment terminal, others leave tips in cash.
- Payment: Card + cash + tip in different ways.
{
"currencyCode": 978,
"cbChargeItems": [
],
"cbPayItems": [
{
"amount": 1200,
"description": "Card",
"position": 1,
"currencyCode": 978,
"moment": "2025-10-09T22:15:05Z",
"ftPayItemCase": 5283883447184523268
}
],
"cbReceiptMoment": "2025-10-09T22:15:08Z",
"cbReceiptReference": "",
"cbPreviousReceiptReference": "order100",
"cbArea": "table-1",
"cbReceiptAmount": 1000,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn01",
"AA": 904,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn01-904-order100-2025-10-09T22:15:08Z-10.0"
}
}
}
}{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 200,
"description": "Tip",
"position": 2,
"moment": "2025-10-08T16:11:06Z",
"quantity": 1,
"vatRate": 0,
"vatAmount": 0,
"ftChargeItemCase": 5283883447184523320,
"currencyCode": 978
}
],
"cbPayItems": [
{
"amount": 1200,
"description": "Card 2",
"position": 1,
"currencyCode": 978,
"moment": "2025-10-09T22:15:05Z",
"ftPayItemCase": 5283883447184523268
}
],
"cbReceiptMoment": "2025-10-09T22:15:08Z",
"cbReceiptReference": "",
"cbPreviousReceiptReference": "order101",
"cbArea": "table-1",
"cbReceiptAmount": 1200,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn02",
"AA": 905,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn02-905-order101-2025-10-09T22:15:08Z-12.0"
}
}
}
}{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 2200,
"description": "Pizza",
"position": 2,
"moment": "2025-10-09T22:50:00Z",
"quantity": 100,
"vatRate": 2400,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
},
{
"amount": 700,
"description": "beer",
"position": 1,
"moment": "2025-10-08T16:11:06Z",
"quantity": 100,
"vatRate": 2400,
"vatAmount": 2400,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
}
],
"cbPayItems": [
{
"amount": 1200,
"description": "first-card-payment",
"position": 1,
"currencyCode": 978,
"moment": "2025-10-09T22:50:10Z",
"ftPayItemCase": 5283883447184523268,
"transactionId": "31176cd7-0360-4453-b751-1d315b0905bd"
},
{
"amount": 1200,
"description": "second-card-payment",
"position": 2,
"currencyCode": 978,
"moment": "2025-10-09T22:50:12Z",
"ftPayItemCase": 5283883447184523268,
"transactionId": "0720dc7f-6e2f-4918-9386-fde27d65e1c2"
},
{
"amount": 700,
"description": "Cash",
"position": 2,
"currencyCode": 978,
"moment": "2025-10-08T16:11:06Z",
"ftPayItemCase": 5283883447184523267
}
],
"cbReceiptMoment": "2025-10-09T22:15:08Z",
"cbReceiptReference": "order101",
"cbArea": "table-1",
"cbReceiptAmount": 2400,
"ftReceiptCase": 5283883447185047553,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn023",
"AA": 906,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn023-906-order101-2025-10-09T22:15:08Z-24.0"
}
}
}
}10. Free item (no payment)
- Event: Customer is offered a free drink as compensation.
- POS: Records the product at €0 (or 100% discount).
- Payment Terminal: Not used.
- Payment: No payment, possible tip in cash separately.
{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 500,
"description": "Drink",
"position": 1,
"moment": "2025-10-09T19:05:00Z",
"quantity": 100,
"vatRate": 2400,
"vatAmount": 97,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
},
{
"amount": -500,
"description": "Discount (-100%)",
"position": 2,
"moment": "2025-10-09T19:05:00Z",
"quantity": 1,
"vatRate": 2400,
"vatAmount": -97,
"ftChargeItemCase": 5283883447184785411,
"currencyCode": 978
}
],
"cbPayItems": [],
"cbReceiptMoment": "2025-10-09T19:05:05Z",
"cbReceiptReference": "order011",
"cbReceiptAmount": 0,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn5",
"AA": 111,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn5-111-order011-2025-10-09T19:05:05Z-0.0"
}
}
}
}11. Selling a gift card
- Event: Customer buys a gift card for €50.
- POS: Enters the gift card as a product (e.g., “Gift Card €50”).
- Payment Terminal: Customer pays by card or cash.
- Payment: Card or cash.
{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 5000,
"description": "GiftCard 50",
"position": 1,
"moment": "2025-10-09T20:15:00Z",
"quantity": 100,
"vatRate": 0,
"vatAmount": 0,
"currencyCode": 978,
"ftChargeItemCase": 5283883447184523336
}
],
"cbPayItems": [
{
"amount": 5000,
"description": "card",
"position": 1,
"currencyCode": 978,
"moment": "2025-10-09T20:15:05Z",
"ftPayItemCase": 5283883447184523269
}
],
"cbReceiptMoment": "2025-10-09T20:15:06Z",
"cbReceiptReference": "giftcard-0050",
"cbReceiptAmount": 5000,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "GC",
"AA": 1001,
"HashAlg": "sha256",
"HashPayload": "099565361-GC-1001-giftcard-0050-2025-10-09T20:15:06Z-50.0"
}
}
}
}12. Redeeming a gift card (full or partial)
- Event: Customer pays a bill partly or fully with a gift card.
- POS: Selects “Gift Card” as payment method for the covered part, initiates card/cash payment for the remaining balance if needed.
- Payment Terminal: Customer pays any remaining balance and may add a tip.
- Payment: Gift card + card/cash + tip.
{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 6000,
"description": "Dinner Menu",
"position": 1,
"moment": "2025-10-09T21:00:00Z",
"quantity": 100,
"vatRate": 2200,
"vatAmount": 1082,
"currencyCode": 978,
"ftChargeItemCase": 5283883447184523283
},
{
"amount": 200,
"description": "Tip",
"position": 2,
"moment": "2025-10-08T16:11:06Z",
"quantity": 1,
"vatRate": 0,
"vatAmount": 0,
"ftChargeItemCase": 5283883447184523320,
"currencyCode": 978
}
],
"cbPayItems": [
{
"amount": 5000,
"description": "Gift Card redeem",
"position": 1,
"currencyCode": 978,
"moment": "2025-10-09T21:00:04Z",
"ftPayItemCase": 5283883447184523336
},
{
"amount": 1200,
"description": "Card payment (remaining balance)",
"position": 2,
"currencyCode": 978,
"moment": "2025-10-09T21:00:06Z",
"ftPayItemCase": 5283883447184523269
}
],
"cbReceiptMoment": "2025-10-09T21:00:08Z",
"cbReceiptReference": "redeem-giftcard-0050",
"cbReceiptAmount": 6200,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "GC",
"AA": 1002,
"HashAlg": "sha256",
"HashPayload": "099565361-GC-1002-redeem-giftcard-0050-2025-10-09T21:00:08Z-62.0"
}
}
}
}13. Stamp / loyalty card for coffee
- Event: Customer buys a coffee and gets a stamp on their card.
- POS: Records coffee as usual and adds “Stamp +1 / Pass 1/10” to the customer’s loyalty account or stamp card.
- Payment Terminal: Customer pays as usual (card/cash), tip as usual.
- Payment: Card or cash.
{
"currencyCode": 978,
"cbChargeItems": [
],
"cbPayItems": [
{
"amount": 1200,
"description": "Card",
"position": 1,
"currencyCode": 978,
"moment": "2025-10-09T22:15:05Z",
"ftPayItemCase": 5283883447184523268
}
],
"cbReceiptMoment": "2025-10-09T22:15:08Z",
"cbReceiptReference": "",
"cbPreviousReceiptReference": "order100",
"cbArea": "table-1",
"cbReceiptAmount": 1000,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn01",
"AA": 904,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn01-904-order100-2025-10-09T22:15:08Z-10.0"
}
}
}
}14. Redeeming a full stamp card (free coffee + pays for pastry)
- Event: Customer has a full stamp card (e.g., 10 stamps). They order a coffee and a pastry. The coffee is free; the pastry is paid normally.
- POS: Records coffee at €0 (or as a discount) and pastry at normal price.
- Payment Terminal: Customer pays only for the pastry (card or cash) and may add a tip.
- Payment: Card or cash for the pastry, coffee free.
{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 0,
"description": "Coffee (Free loyalty reward)",
"position": 1,
"moment": "2025-10-09T21:30:00Z",
"quantity": 100,
"vatRate": 0,
"vatAmount": 0,
"currencyCode": 978,
"ftChargeItemCase": 5283883447184523336
},
{
"amount": 300,
"description": "Pastry",
"position": 2,
"moment": "2025-10-09T21:30:00Z",
"quantity": 100,
"vatRate": 2200,
"vatAmount": 54,
"currencyCode": 978,
"ftChargeItemCase": 5283883447184523283
}
],
"cbPayItems": [
{
"amount": 300,
"description": "Card",
"position": 1,
"currencyCode": 978,
"moment": "2025-10-09T21:30:05Z",
"ftPayItemCase": 5283883447184523269
}
],
"cbReceiptMoment": "2025-10-09T21:30:06Z",
"cbReceiptReference": "order014",
"cbReceiptAmount": 300,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "CF",
"AA": 1401,
"HashAlg": "sha256",
"HashPayload": "099565361-CF-1401-order014-2025-10-09T21:30:06Z-3.0"
}
}
}
}{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 200,
"description": "Coffee",
"position": 1,
"moment": "2025-10-20T21:30:00Z",
"quantity": 100,
"vatRate": 2400,
"currencyCode": 978,
"ftChargeItemCase": 5283883447184523283
},
{
"amount": -200,
"description": "Loyalty discount (free coffee)",
"position": 2,
"moment": "2025-10-20T21:30:00Z",
"quantity": 100,
"vatRate": 2400,
"currencyCode": 978,
"ftChargeItemCase": 5283883447184785411
},
{
"amount": 300,
"description": "Pastry",
"position": 3,
"moment": "2025-10-20T21:30:00Z",
"quantity": 100,
"vatRate": 2200,
"vatAmount": 54,
"currencyCode": 978,
"ftChargeItemCase": 5283883447184523283
}
],
"cbPayItems": [
{
"amount": 300,
"description": "Card",
"position": 1,
"currencyCode": 978,
"moment": "2025-10-20T21:30:05Z",
"ftPayItemCase": 5283883447184523269
}
],
"cbReceiptMoment": "2025-10-20T21:30:06Z",
"cbReceiptReference": "order014",
"cbReceiptAmount": 300,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "CF",
"AA": 1401,
"HashAlg": "sha256",
"HashPayload": "099565361-CF-1401-order014-2025-10-20T21:30:06Z-3.0"
}
}
}
}15. Customer-specific price list activated by customer name
- Event: A regular customer with a negotiated price list comes to the counter. The system recognizes the customer by name (or loyalty ID).
- POS: Automatically applies the customer-specific price list to products when the customer is selected.
- Payment Terminal: Customer pays with the usual method and may add a tip.
- Payment: Card or cash at the discounted/negotiated prices.
{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 2200,
"description": "Pizza",
"position": 2,
"moment": "2025-10-09T22:50:00Z",
"quantity": 100,
"vatRate": 2400,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
},
{
"amount": 700,
"description": "beer",
"position": 1,
"moment": "2025-10-08T16:11:06Z",
"quantity": 100,
"vatRate": 2400,
"vatAmount": 2400,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
}
],
"cbPayItems": [
{
"amount": 1200,
"description": "first-card-payment",
"position": 1,
"currencyCode": 978,
"moment": "2025-10-09T22:50:10Z",
"ftPayItemCase": 5283883447184523268,
"transactionId": "31176cd7-0360-4453-b751-1d315b0905bd"
},
{
"amount": 1200,
"description": "second-card-payment",
"position": 2,
"currencyCode": 978,
"moment": "2025-10-09T22:50:12Z",
"ftPayItemCase": 5283883447184523268,
"transactionId": "0720dc7f-6e2f-4918-9386-fde27d65e1c2"
},
{
"amount": 700,
"description": "Cash",
"position": 2,
"currencyCode": 978,
"moment": "2025-10-08T16:11:06Z",
"ftPayItemCase": 5283883447184523267
}
],
"cbReceiptMoment": "2025-10-09T22:15:08Z",
"cbReceiptReference": "order101",
"cbArea": "table-1",
"cbReceiptAmount": 2400,
"ftReceiptCase": 5283883447185047553,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn023",
"AA": 906,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn023-906-order101-2025-10-09T22:15:08Z-24.0"
}
}
}
}16. Automatically scheduled price list (e.g. Happy Hour)
- Event: It’s 5 pm, Happy Hour starts automatically. All drinks are at reduced prices until 7 pm.
- POS: The system switches to the scheduled price list automatically at the configured time.
- Payment Terminal: Customers pay normally and may add tips.
- Payment: Card or cash at the automatic time-based prices.
{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 500,
"description": "Drink",
"position": 1,
"moment": "2025-10-09T19:05:00Z",
"quantity": 100,
"vatRate": 2400,
"vatAmount": 97,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
},
{
"amount": -500,
"description": "Discount (-100%)",
"position": 2,
"moment": "2025-10-09T19:05:00Z",
"quantity": 1,
"vatRate": 2400,
"vatAmount": -97,
"ftChargeItemCase": 5283883447184785411,
"currencyCode": 978
}
],
"cbPayItems": [],
"cbReceiptMoment": "2025-10-09T19:05:05Z",
"cbReceiptReference": "order011",
"cbReceiptAmount": 0,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn5",
"AA": 111,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn5-111-order011-2025-10-09T19:05:05Z-0.0"
}
}
}
}17. Incorrect receipt corrected immediately
- Event: Customer notices on the spot that too many products were charged on the receipt.
- POS: Staff issues a receipt correction or cancellation/refund immediately and re-enters the correct items.
- Payment Terminal: Processes the refund or reversal for the overcharged amount; new payment for the correct amount if needed.
- Payment: Refund + new payment if applicable; tip handled according to policy.
{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 200,
"description": "Coffee",
"position": 1,
"moment": "2025-10-21T21:31:00Z",
"quantity": 100,
"vatRate": 2200,
"currencyCode": 978,
"ftChargeItemCase": 5283883447184523283
},
{
"amount": 300,
"description": "Pastry",
"position": 2,
"moment": "2025-10-21T21:31:00Z",
"quantity": 100,
"vatRate": 2200,
"vatAmount": 54,
"currencyCode": 978,
"ftChargeItemCase": 5283883447184523283
},
{
"amount": 300,
"description": "Pastry (extra by mistake)",
"position": 3,
"moment": "2025-10-21T21:31:00Z",
"quantity": 100,
"vatRate": 2200,
"vatAmount": 54,
"currencyCode": 978,
"ftChargeItemCase": 5283883447184523283
}
],
"cbPayItems": [
{
"amount": 800,
"description": "Card",
"position": 1,
"currencyCode": 978,
"moment": "2025-10-09T21:31:05Z",
"ftPayItemCase": 5283883447184523269
}
],
"cbReceiptMoment": "2025-10-21T21:31:06Z",
"cbReceiptReference": "receipt-INC-001",
"cbReceiptAmount": 800,
"ftReceiptCase": 5283848262812434433,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "IT-A",
"AA": 1001,
"HashAlg": "sha256",
"HashPayload": "099565361-IT-A-1001-receipt-INC-001-2025-10-21T21:31:06Z-8.0"
}
}
}
}{
"currencyCode": 978,
"cbChargeItems": [
{
"amount": 200,
"description": "Coffee",
"position": 1,
"moment": "2025-10-09T21:32:00Z",
"quantity": 100,
"vatRate": 2200,
"vatAmount": 36,
"currencyCode": 978,
"ftChargeItemCase": 5283883447184588819
},
{
"amount": 300,
"description": "Pastry",
"position": 2,
"moment": "2025-10-09T21:32:00Z",
"quantity": 100,
"vatRate": 2200,
"vatAmount": 54,
"currencyCode": 978,
"ftChargeItemCase": 5283883447184588819
},
{
"amount": 300,
"description": "Pastry (extra by mistake)",
"position": 3,
"moment": "2025-10-09T21:32:00Z",
"quantity": 100,
"vatRate": 2200,
"vatAmount": 54,
"currencyCode": 978,
"ftChargeItemCase": 5283883447184588819
}
],
"cbPayItems": [
{
"amount": 800,
"description": "Card (void)",
"position": 1,
"currencyCode": 978,
"moment": "2025-10-09T21:32:05Z",
"ftPayItemCase": 5283883447184588805
}
],
"cbReceiptMoment": "2025-10-09T21:32:06Z",
"cbReceiptReference": "receipt-INC-001-VOID",
"cbPreviousReceiptReference": "receipt-INC-001",
"cbReceiptAmount": 800,
"ftReceiptCase": 5283883447184785409,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "IT-A",
"AA": 1002,
"HashAlg": "sha256",
"HashPayload": "099565361-IT-A-1002-receipt-INC-001-VOID-2025-10-09T21:32:06Z-8.0"
}
}
}
}18. Receipt correction after a day or a week
- Event: Customer comes back a day or a week later with a receipt showing an overcharge.
- POS: Staff issues a receipt correction or cancellation/refund immediately and re-enters the correct items.
- Payment Terminal: Processes the refund back to the original card or as cash, depending on policy.
- Payment: Refund to card or cash. If a new corrected sale is needed, enters the correct items as a new sale.
{
"currencyCode": 978,
"ftReceiptCase": 5283883447184523265,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn023",
"AA": 906,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn023-906-order108-2025-10-09T22:15:08Z-34.0"
}
},
"cbReceiptReference": "order108",
"cbReceiptMoment": "2025-10-09T22:15:08Z",
"cbChargeItems": [
{
"amount": 2000,
"description": "Pizza",
"position": 1,
"moment": "2025-10-09T22:15:08Z",
"quantity": 100,
"vatRate": 2200,
"vatAmount": 360,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
},
{
"amount": 1400,
"description": "Drink",
"position": 2,
"moment": "2025-10-09T22:15:08Z",
"quantity": 100,
"vatRate": 2200,
"vatAmount": 252,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
}
],
"cbPayItems": [
{
"amount": 3400,
"description": "Card",
"position": 1,
"ftPayItemCase": 5283883447184523268,
"moment": "2025-10-09T22:15:10Z",
"currencyCode": 978
}
]
}
}{
"ftReceiptCase": 5283883447184523267,
"cbPreviousReceiptReference": "order101",
"cbReceiptReference": "order101-refund",
"currencyCode": 978,
"cbReceiptMoment": "2025-10-09T22:20:00Z",
"cbChargeItems": [
{
"amount": -600,
"description": "Refund for overcharge - 1 extra drink",
"position": 1,
"moment": "2025-10-09T22:20:00Z",
"quantity": -100,
"vatRate": 2200,
"vatAmount": -108,
"ftChargeItemCase": 5283883447184523283,
"currencyCode": 978
}
],
"cbPayItems": [
{
"amount": -600,
"description": "Card Refund",
"position": 1,
"ftPayItemCase": 5283883447184523268,
"moment": "2025-10-09T22:20:05Z",
"currencyCode": 978
}
],
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn023",
"AA": 907,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn023-907-order101-refund-2025-10-09T22:20:00Z--6.0"
}
}
}
}19. Refund issued as a store-value card (money back as card credit)
- Event: Customer returns an item or is entitled to a refund. Instead of cash back, the restaurant gives a store credit/gift card.
- POS: Selects “Refund to gift card/store credit” and creates/loads the store-credit card equal to the refund amount.
- Payment Terminal: Not used for the refund itself; customer receives the store-value card instead.
- Payment: Customer receives a gift card/store-credit card for the refund amount, no cash is paid out.
{
"cbChargeItems": [
{
"amount": 6000,
"description": "Book",
"position": 1,
"moment": "2025-10-08T16:11:06Z",
"quantity": 100,
"vatRate": 2400,
"vatAmount": 2400,
"ftChargeItemCase": 5139205309155246099,
"currencyCode": 978
}
],
"cbPayItems": [
{
"amount": 6000,
"description": "Card",
"position": 2,
"currencyCode": 978,
"moment": "2025-10-08T16:11:06Z",
"ftPayItemCase": 5139205309155246084
}
],
"cbReceiptMoment": "2025-10-08T16:11:06Z",
"cbReceiptReference": "order0991",
"cbReceiptAmount": 6000,
"ftReceiptCase": 5139205309155246081,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn123",
"AA": 11234,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn123-11234-order0991-2025-10-08T16:11:06Z-60.0"
}
}
}
}{
"currencyCode": 978,
"cbReceiptMoment": "2025-10-27T16:20:00Z",
"cbReceiptReference": "order0991-R1",
"cbPreviousReceiptReference": "order0991",
"cbReceiptAmount": 2000,
"cbChargeItems": [
{
"amount": 2000,
"description": "Partial refund for order0991",
"position": 1,
"moment": "2025-10-27T16:20:00Z",
"quantity": 100,
"vatRate": 2400,
"ftChargeItemCase": 5139205309155246099,
"currencyCode": 978
}
],
"cbPayItems": [
{
"amount": 2000,
"description": "Store credit / gift card (refund)",
"position": 1,
"currencyCode": 978,
"moment": "2025-10-27T16:20:05Z",
"ftPayItemCase": 5139205309155246086,
}
],
"ftReceiptCase": 5139205309155246081,
"ftReceiptCaseData": {
"IT": {
"MerchantVATID": "099565361",
"Series": "ABn123",
"AA": 11235,
"HashAlg": "sha256",
"HashPayload": "099565361-ABn123-11235-order0991-R1-2025-10-27T16:20:00Z-20.0"
}
}
}
}Get Support
If you would like to integrate with Viva, or if you have any queries about our products and solutions, please see our Contact & Support page to see how we can help!