Overview

The MRA Webservice is a REST API built with ASP.NET Core 8.0. It serves as a high-level wrapper around the MRAAPI.dll, facilitating integration between local Point of Sale (POS) systems and the Malawi Revenue Authority (MRA) Electronic Invoice System.

Feature

Feature	Details
Version	1.1 (January 2026)
Base URL	http://localhost:5236
Format	JSON (REST)
Interactive Docs	Swagger UI

Architecture

get all items

Configuration

The service is controlled via a config.ini file located in the application root. This allows environment switching (Dev/Prod) without code changes.

MRA Server Configuration

Done in the Config.ini

MraServer = https://dev-eis-api.mra.mw

Global Response Schema

All endpoints return a consistent JSON wrapper to simplify client-side parsing.

Success Response

JSON

{
  "statusCode": 1,
  "remark": "Success message",
  "data": { "..." },
  "errors": null
}

Error Response

JSON

{
  "statusCode": 0,
  "remark": "Error description",
  "data": null,
  "errors": ["Specific error detail 1", "Specific error detail 2"]
}