Weaf MRA EIS Api

Malawi Revenue Authority EIS Integration

🚀

Getting Started

These steps take you from a new account to your first fiscalised receipt. Steps 1 to 3 happen once per account, steps 4 to 6 once per terminal, and steps 7 and 8 are your day-to-day integration.

  1. 1

    Create a WEAF account

    Sign up on the WEAF platform. This gives you the email and password you will use to generate API tokens.

    Sign up ↗
  2. 2

    Register your company

    Inside the platform, add your company profile with its MRA TIN. That TIN is the {tin} in every MRA endpoint path.

  3. 3

    Generate an API access token

    Exchange your credentials for a token valid for 1 to 365 days. Pass it as the token query parameter and as a Bearer header.

    Generate token →
  4. 4

    Activate a terminal

    Use the terminal activation code issued by MRA, plus your device and POS details. The response contains the terminalId you will use from then on.

    Activate terminal →
  5. 5

    Confirm the activation

    Confirm the terminal with its terminalId to finish setup with MRA. List your terminals at any time to retrieve IDs and sites.

    Confirm activation →Get terminals →
  6. 6

    Sync configuration and check connectivity

    Pull the latest tax rates and taxpayer and terminal configuration from MRA, then ping the MRA server to confirm the terminal's credentials work.

    Sync configurations →Ping server →
  7. 7

    Set up products and stock

    Look up HS codes and units of measure, add your products, and bring stock in through informal purchases or adjustments.

    Get HS codes →Add product →Informal purchase →
  8. 8

    Issue tax receipts

    Submit sales and get back MRA-fiscalised receipts. Use credit or debit notes for corrections, and void requests to cancel a receipt.

    Generate tax receipt →Credit / debit note →Cancel receipt →

💡 Before you go live

  • Store terminalId and siteId for each till. Almost every MRA call needs them.
  • Use the DEBUG endpoints to check payloads and tax calculations without submitting anything to MRA.
  • Generate a unique referenceNo for every sale. Retrying with the same reference is safe, because duplicates are rejected rather than fiscalised twice.
  • If MRA returns 401 or statusCode -2, call Request New Terminal Token and retry.
  • Production access needs an active subscription and approved configuration. Contact services@weafcompany.com.