|
Field
|
Data Type
|
Mandatory
|
Comments
|
|
Authorization
|
string
|
-yes
|
|
|
invoiceHeader.invoiceNumber
|
string
|
-yes
|
|
|
invoiceHeader.invoiceDateTime
|
datetime
|
-yes
|
The date and time the invoice was issued
|
|
invoiceHeader.sellerTIN
|
string
|
-yes
|
The Taxpayer Identification Number of the seller
|
|
invoiceHeader.buyerTIN
|
string
|
-no
|
Needed if its a B2B transaction
|
|
invoiceHeader.buyerName
|
string
|
-no
|
|
|
invoiceHeader.buyerAuthorizationCode
|
string
|
-no
|
It is required when the TIN is protected. It is generated from the taxpayers portal
|
|
invoiceHeader.siteId
|
string
|
-yes
|
This is the site id where the terminal is operating
|
|
invoiceHeader.globalConfigVersion
|
integer
|
-yes
|
this is the configuration that will be received from the terminal activation response
|
|
invoiceHeader.taxpayerConfigVersion
|
integer
|
-yes
|
|
|
invoiceHeader.terminalConfigVersion
|
integer
|
-yes
|
|
|
invoiceHeader.isReliefSupply
|
boolean
|
-no
|
Marks whether the supply is relief exempt. It requires VAT 5 certificate using the Validate VAT 5 Certificate endpoint.
|
|
invoiceHeader.paymentMethod
|
string
|
-yes
|
The method of payment (e.g., Cash, Card, MobileMoney).
|
|
invoiceLineItems[].productCode
|
string
|
-yes
|
Unique product or service code.
|
|
invoiceLineItems[].description
|
string
|
-yes
|
description of the Product or service
|
|
invoiceLineItems[].unitPrice
|
decimal
|
-yes
|
Price per unit product or service.
|
|
invoiceLineItems[].quantity
|
decimal
|
-yes
|
Quantity of items sold
|
|
invoiceLineItems[].discount
|
decimal
|
-no
|
Any discount applied to the line item.
|
|
invoiceLineItems[].total
|
decimal
|
-yes
|
The net total (after discount, before VAT) for the line item.
|
|
invoiceLineItems[].totalVAT
|
decimal
|
-yes
|
VAT amount for this line item.
|
|
invoiceLineItems[].taxRateId
|
string
|
-yes
|
Identifier for the applied tax rate.
|
|
invoiceLineItems[].isProduct
|
boolean
|
-yes
|
True if item is a product, false if it is a service.
|
|
invoiceSummary.taxBreakDown[].rateId
|
string
|
-yes
|
Tax rate identifier (matches taxRateId in line items).
|
|
invoiceSummary.taxBreakDown[].taxableAmount
|
decimal
|
-yes
|
Sum of taxable amounts under this rate.
|
|
invoiceSummary.taxBreakDown[].taxAmount
|
decimal
|
-yes
|
Total tax calculated for this rate.
|
|
invoiceSummary.levyBreakDown.levyTypeId
|
string
|
-no
|
dentifier of the levy type (e.g., Environmental Levy, Tourism Levy). Required only if a levy applies.
|
|
invoiceSummary.levyBreakDown.levyRate
|
decimal
|
-no
|
Percentage rate (%) applied for this levy.
|
|
invoiceSummary.levyBreakDown.levyAmount
|
decimal
|
-no
|
Monetary value of the levy calculated from the levyRate.
|
|
invoiceSummary.totalVAT
|
decimal
|
-yes
|
Total VAT across all line items.
|
|
invoiceSummary.invoiceTotal
|
decimal
|
-yes
|
Final invoice total including VAT.
|
|
invoiceSummary.offlineSignature
|
string
|
-no
|
If the transaction was issued offline, the offline signature is included.
|
|
invoiceSummary.amountTendered
|
decimal
|
-yes
|
Amount paid by the customer before giving back any change.
|
