The definitive field-by-field reference for every translation the middleware performs: Taxint → Chrilan invoices, Chrilan → Taxint responses, and Oracle → Chrilan products.
Taxint → Chrilan invoice
Taxint field
Chrilan field
Notes
BuyerInfo.BuyerTIN
tpin
Buyer/customer TPIN; empty string when not provided
FolioHeaderInfo.InvoiceCurrencyCode
currency
e.g. ZMW
FolioHeaderInfo.InvoiceCurrencyRate
rate
Exchange rate
FolioHeaderInfo.CashierNumber
auditNumber
Unique transaction identifier
SellerInfo.SellerContactDetails.Number
cell
Contact phone
(hardcoded "system")
user
API user identifier
(generated UUID)
localid
Unique local identifier
FolioHeaderInfo.FolioType
refund
true when a credit note
(lookup in fiscal_invoices)
refundNumber
Original ZRA receipt number
(lookup in fiscal_invoices)
refundReceiptSDC
Original SDC ID
(hardcoded "06")
refundResCode
Refund reason code
BuyerInfo.BuyerLpo
lpo
LPO number
BuyerInfo.BuyerLpo != null
isLpo
Boolean flag
TPIN direction
The Chrilan tpin is the buyer's TPIN (from BuyerInfo.BuyerTIN), not the seller's. The seller's TPIN comes from DocumentInfo.PropertyTaxNumber and is used for store resolution and records.
Taxint postings → Chrilan lines
Taxint field
Chrilan field
Notes
Postings[].TrxCode
lines[].plu
Product code
Postings[].Product
lines[].description
Product name
abs(Postings[].Quantity)
lines[].qty
Absolute value (handles credit notes)
abs(Postings[].GrossAmount)
lines[].lineTotal
Absolute value
Postings[].UnitPrice
lines[].recommendedRetail
Unit price
(mapped from TrxInfo)
lines[].vatCat
See VAT mapping below
VAT category mapping (invoices)
Taxint FiscalTrxCodeType
Chrilan vatCat
Description
A
STANDARD_RATED
Standard VAT rate (16%)
D
ZERO_RATED_BY_NATURE
Zero-rated (excluded)
E
EXEMPT
VAT exempt
T
STANDARD_RATED
Tourism levy, treated as standard
This mapping is configurable under conversion.fiscal-code-mapping in the application configuration.
Chrilan response → Taxint response
Chrilan field
Taxint output
Description
response.rcptNo
fiscalFolioNo (top level)
ZRA receipt number
response.sdcId
"sdcId"
Smart Device Controller ID
response.mrcNo
"mrcNo"
MRC number
response.qrCodeUrl
"QR_CODE_URL"
QR code URL
(fetched QR image → base64)
"QR_CODE" / BASE64_TO_IMAGE
QR code image for printing
response.rcptSign
"rcptSign"
Digital receipt signature
response.taxData
"COLL_TAX1" / "taxData"
JSON tax breakdown
response.intrlData
"intrlData"
Internal data
response.vsdcRcptPbctDate
"vsdcRcptPbctDate"
VSDC receipt publication date
(pass-through from BuyerInfo)
"BuyerHouseNo", "BuyerStreet", "BuyerProvince"
Buyer address for POS check printing
Oracle menu → Chrilan product
Oracle field
Chrilan field
Notes
menuItemId
plu
Product code (string)
name (resolved)
name
Product name
definitions[].prices[priceSequence=1].price
sellingIncl
Dine-in/standard price
(hardcoded)
type = singleItem
Product type
definitions[0].taxClassRef → tax map
vatCat
Resolved from live Oracle tax definitions; fallback STANDARD_RATED