Electronic Invoicing System API v1
Developers Guide
×
Menu
Index

4.1.1.1. Request

 
 
To activate a terminal, the required information is provided within the request body as shown below.
 
curl -X 'POST' \
  'https://dev-eis-api.mra.mw/api/v1/onboarding/activate-terminal' \
  -H 'accept: text/plain' \
  -H 'Content-Type: application/json' \
  -d '{
  "terminalActivationCode": "ABCD-EFDC-GSHH-RT45",
  "environment": {
    "platform": {
      "osName": "Windows 11",
      "osVersion": "Windows 11",
      "osBuild": "11.901.2",
      "macAddress": "00-00-00-00-00-00"
    },
    "pos": {
      "productID": "MRA-desktop/{guid}",
      "productVersion": "1.0.0"
    }
  }
}'
 
In addition to the Terminal Activation Code passed as Terminal A ctivation Code, the request will also carry details of the environment and Point of Sale System being used.
 
Json Path
Natural Name
Data Type
Restrictions
Comments
$.terminalActivationCode
String
- Mandatory
- Max Length 50
Taxpayers will be given this code from MRA EIS Portal upon successful terminal acquisition process.
$.environment.platform.osName
OS Name
String
- Mandatory
- Max Length 50
 
$.environment.platform.osVersion
OS Version
String
- Mandatory
- Max Length 50
 
$.environment.platform.osBuild
OS Build
String
- Optional
- Max Length 50
 
$.environment.platform.macAddress
String
- Mandatory
- 17 Charecters
eg 01-23-45-67-89-AH
$.environment.pos.productID
Product ID
String
- Mandatory
- Max Length 50
Unique product identifier issued to POS Developers when their terminal software approved as compliance to MRA EIS API protocol. During development a test product ID can be requested from MRA.
$.environment.pos.productVersion
Product Version
String
- Mandatory
- Max Length 50
Terminal Software Version.