Configuration
Manage terminal settings, tax rates, and global configuration from MRA.
Sync after activation and whenever MRA changes tax rates or your taxpayer profile. Receipts carry globalConfigVersion, taxpayerConfigVersion and terminalConfigVersion, and these should match what the sync returned.
Endpoints in this section
Sync latest configurations
POST
/api/v1/{tin}/sync-latest-configurations🔒 token requiredSynchronize the latest terminal configurations from Malawi Revenue Authority (MRA) EIS system. This updates tax rates, terminal settings, and taxpayer configuration. Requires an activated terminal.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
tin | path | Yes | Taxpayer Identification Number (e.g., 20154457) |
deploymentEnvironment | query | Yes | MRA deployment environment - 'Sandbox' for testing or 'Production' for live One of: Sandbox, Production |
token | query | Yes | API access token for authentication |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
terminalId | string | Yes | Terminal ID from activation (used to fetch JWT token) 193760fb-cddc-40ed-b0fb-f08f8720f86c |
Responses
- 200Configurations synced successfully
- 400Bad request - invalid parameters or missing terminal
- 403Forbidden - Company inactive, license expired, or environment mismatch
- 404Terminal not found - Please activate the terminal first