Receipt Mapping
Visualizing the Fiscal Receipt
This guide shows how the core JSON objects in the Viva API map directly to the physical elements of a compliant fiscal receipt.
The Global Mapping
| Receipt Section | JSON Object | Description |
|---|---|---|
| Header | ftReceiptCaseData |
Merchant details, Tax ID (AFM), and POS info |
| Line Items | cbChargeItems |
Product names, quantities, VAT |
| Payments | cbPayItems |
Payment method (Cash, Card, etc.) |
| Receipt Case | ftReceiptCase |
Sale, Refund, Invoice |
Example 11.1: Standard Retail Sale
Below is a simplified example of a standard sale and how the data is structured.
The Payload (Simplified)
How to read this
Think of every fiscalised transaction as three core parts:
- 🟢 What was sold →
cbChargeItems- Products or services
- Quantity, price, VAT
- 🔵 How it was paid →
cbPayItems- Card, Cash, etc.
- Payment amount
- 🟣 What type of transaction →
ftReceiptCase- Sale
- Refund
- Invoice (Timologio)
Useful links
If you need detailed logic and full schemas, refer to the following guides:
- 👉 Understanding receipt types (ftReceiptCase)
- 👉 Mapping line items (cbChargeItems)
- 👉 Payment methods (cbPayItems)