curl -X 'POST' \
'https://dev-eis-api.mra.mw/api/v1/sales/submit-sales-transaction' \
-H 'accept: text/plain' \
-H 'Content-Type: application/json' \
-H 'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1lIjoiMjAxNjI5MzkiLCJodHRwczovL21yYS5tdy9EZXZpY2VJZCI6IjNhNmQzNzAzLTFjMzktNDFlOC05OGNlLWIzOGQ5NTc0NTQwZCIsImh0dHBzOi8vbXJhLm13L1NlY3JldEtleSI6ImY3NTQyODE2YTA4ODMzMTRhMTQ2YTZkMTI3NjM0OWQ5ZTczNmEwMCIsImh0dHBzOi8vbXJhLm13L0FQSUtleSI6ImY3NTQyODE2YTA4ODMzMTRhMTQ2YTZkMTI3NjM0OWQ5ZTczNmEwMCIsImh0dHBzOi8vbXJhLm13L1RJTiI6IjIwMTYyOTM5IiwiZXhwIjoxNzI4OTI2NzI2LCJpc3MiOiJNUkEiLCJhdWQiOiJFSVNUZXJtaW5hbHMifQ.pg-jKtsxKh6L0pEbu4RdJaj_bMijXmUGRmoH9k6Mh4g'\
-d '{
"invoiceHeader": {
"invoiceNumber": "string",
"invoiceDateTime": "2024-05-17T10:02:47.214Z",
"sellerTIN": "string",
"buyerTIN": "string",
"buyerAuthorizationCode": "string",
"siteId": "string",
"globalConfigVersion": 0,
"taxpayerConfigVersion": 0,
"terminalConfigVersion": 0,
"isReliefSupply" :false
},
"invoiceLineItems": [
{
"id": 0,
"productCode": "string",
"description": "string",
"unitPrice": 0,
"quantity": 0,
"discount": 0,
"total": 0,
"totalVAT": 0,
"taxRateId": "string"
}
],
"invoiceSummary": {
"taxBreakDown": [
{
"rateId": "string",
"taxableAmount": 0,
"taxAmount": 0
}
],
"totalVAT": 0,
"offlineSignature": "string",
"invoiceTotal": 0
}
}'
|
The call to the submit sales transactions endpoint will be successful with the following parameters.
Json Path
|
Natural Name
|
Data Type
|
Restrictions
|
Comments
|
Authorization
|
Authorization Token
|
string
|
-mandatory
|
|
invoiceNumber
|
|
string
|
-mandatory
|
|
Notes
If the isReliefSupply field in the invoiceHeader of the request is set to true, it indicates that the transaction qualifies for relief under Malawi's VAT regulations, In such cases:
-
The taxpayer is eligible to exclude VAT for certain goods or services based on the relief rules.
-
The terminal must correctly calculate the taxable amount and ensure VAT is excluded where applicable.
-
Relief supply transactions require the VAT 5 certificate details to be validated using the Validate VAT 5 Certificate endpoint.
Additionally, if the buyerTIN is provided, this indicates a business-to-business transaction. On the taxpayer's portal, the taxpayer has the option to protect or not protect their TIN.
-
If the TIN is protected, business-to-business transactions will require a valid purchase authorization code, which can be generated on the MRA taxpayers portal before the transaction is processed.
-
If the TIN is not protected, no authorization code is required for B2B transactions.
|