Receipt Mapping
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
Every receipt is built from four JSON building blocks.
Header
ftReceiptCaseData
Merchant details, Tax ID (AFM), and POS info.
Line Items
cbChargeItems
Product names, quantities, and VAT.
Payments
cbPayItems
Payment method — cash, card, etc.
Receipt Case
ftReceiptCase
Sale, refund, or invoice.
Example 11.1: Standard Retail Sale
Below is a simplified example of a standard sale and how the data is structured.
How to read this
Think of every fiscalised transaction as three building blocks.
🟢 What was sold — cbChargeItems
- Products or services
- Quantity, price, VAT
🔵 How it was paid — cbPayItems
- Card, cash, etc.
- Payment amount
🟣 Transaction type — ftReceiptCase
- Sale
- Refund
- Invoice (Timologio)