Sign in
Use the gateway's admin key instead
For the operator on the gateway's own machine. On a new install the key is in admin-key.txt in the data folder.
New here?
Apply for an account
For a business that needs its sales fiscalised with MRA, or a POS company that looks after several. We check each application and email you an invitation once your account is ready.
Join
Terminals
Activate a terminal
Use the Terminal Activation Code MRA issued for this till or branch. A code works once.
Copy it into the POS now. It is not shown again; a lost key can be replaced from the terminal list.
Send a test sale
Recent sales
Products this site can sell
MRA sets each item's tax rate. Goods take it from their HS code; services take it from how they were registered in MRA's portal. To try a rate this site does not sell yet, add a product below, or register a service at that rate in MRA's portal and then sync the terminal.
Add a product to MRA
MRA files a new product in the business's warehouse with no stock. It can only be sold once stock has been added and approved by MRA, and moved to this site.
Warehouse stock
Stock
Each of these goes to MRA. Purchases and adjustments are requests: the stock changes once an MRA officer approves them.
Stock bought from a trader who is not on EIS. The supplier must be registered with MRA first.
For manufacturers: raw materials used up to make finished goods.
A CSV file with a header row and these columns: barcode, product_name, product_description, quantity_in_stock, cost_price, selling_price, and optionally reorder_level, over_quantity_stock_level. It is sent in batches of 50.
Daily sales
Sales count on their invoice date, Malawi time, including offline sales not yet at MRA. Credit and debit notes and cancellation requests count on the day they were made.
This month so far
Billing details
Statements
Issue statements
Bills every business on a plan for a month that has ended, once each, and emails the statements to their billing addresses. Running it again only catches businesses that were missed.
Billing settings
Plans
Applications
Businesses
Each business is one taxpayer, with its own terminals, sales and database. A suspended business keeps selling but cannot add terminals.
Vendors
POS software companies that look after several businesses.
People who can sign in
Or add someone with a password you choose
API keys
For software that connects to the gateway. A management key runs one business: terminals, stock, notes, reports. A vendor key does that for all of a vendor's businesses, naming one per request with the X-Business-Id header. An edge key links a shop's own gateway, which sells even when the internet is down, so its terminals and sales show here. Till keys come from activating a terminal.
Copy it now. It is not shown again.
Webhooks
Addresses the gateway calls when something happens to this business's sales: cleared, refused, sent offline, delivered after being offline, a cancellation decided, a terminal blocked. Each request is signed with the webhook's secret in the X-UltraEInvoicing-Signature header. Failed calls are retried for about two days.
Copy it now into the receiving system. It is not shown again.
API settings
The API for POS and ERP systems is under /v1. Its description, for programmers and code generators, is at /openapi/v1.json.
MRA connection
Data folder:
HTTPS for tills on other computers
With HTTPS on, other computers reach the gateway only over an encrypted connection, and plain HTTP answers this machine alone. Tills already using http:// from another computer must switch to the HTTPS address.
Email alerts and daily report
Alerts go out when a terminal is blocked, cannot sync or needs re-activating, when offline sales near MRA's limit, when MRA refuses an offline sale or a cancellation, and when an automatic backup fails. Each is sent once, then reminded daily while it lasts.
Link to a hosted gateway
For a gateway in a shop: it keeps selling here, online or offline, and sends its terminals and sales to your hosted gateway, where they show in the screens, reports and webhooks. Make an Edge key on the hosted gateway (Access → API keys) for this shop's business and paste it below.
Automatic backups
Once a day the gateway writes an encrypted backup to the folder below and keeps the newest ones. A network share works if this computer's account may write to it, because the gateway runs as Local System. Keep your own record of the password: it is what opens these files on another computer.
Backup and restore
A backup holds every terminal, sale, setting and MRA credential, encrypted with the password you choose. It can be restored on any computer. Without the password nobody can open it, so keep the password somewhere safe and separate from the file.
Restore
Only into a new installation that has no terminals yet, so nothing live is overwritten. The admin key stays this installation's own.