EFRISConnect

🖨 Issue Receipt

Create a receipt on the spot — no Manager invoice needed. Fill in customer details and line items, then submit to EFRIS or print directly.

Customer

Customer Name

Currency

Line Items

Payment Method

▶ Bulk Submit to EFRIS

Enter Manager invoice IDs (one per line). Each will be loaded and submitted to EFRIS in sequence.

📋 EFRIS Status

Open an invoice to see its status

🕵 Verify Taxpayer TIN

TIN to verify (B2B customer lookup)

🌐 Global Integration Mode: Instantly configure items for Manager.io. For unique pricing categories (like Per Person, Per Couple, or Per Adult), type your custom text in the Package Unit box and select the green custom option row.

1Segment

2Family

3Class

4Commodity

5Details

Step 1 — Industry Segment

💡 Type at least 3 characters to search — e.g. "Tra" for Travel, "Hea" for Healthcare, "Fin" for Financial Services

Search segments

Step 5 — Product / Service Details

EFRIS Segment / Class Grouping

Target URA Commodity Code *

My Product Code (Internal Code) *

Item Description Name (Invoice Display Value) *

Currency *

Unit Price Rate (Tax Inclusive) *

Package Measure Unit *

EFRIS Unit Code (auto-detected · edit if needed · max 3 chars)

⚙ Item Profile Category

EFRIS Tax Designation

Excise Tax Regime

Remarks / Line Description Autofill

Code	Name	Commodity	UOM	Price	Cur	Type	VAT	Mgr	EFRIS	Actions
No items yet. Use Configure tab.

🔢 Document Number Series

Define how your invoice and receipt numbers are generated. Each series has its own prefix, division or project code, date component and auto-incrementing counter.

⚙ Initial Setup — Step by Step

1

Get your Manager.io Access Token

Open Manager.io in a new tab. Go to Settings → API Keys → Add API Key. Give it any name (e.g. "EFRISConnect"). Copy the long token that appears — you only see it once.
💡 If you don't see API Keys, you are on Manager Cloud. Go to your business → Settings → API → Add Key.

2

Get your Manager.io Endpoint URL

This is the address EFRISConnect uses to talk to Manager. Common values:
http://localhost:8080/api2 — Manager desktop (default port)
http://localhost:YOUR-PORT/api2 — Desktop/Docker with a custom port (use Auto-detect if unsure)
https://your-domain.com/api2 — Manager Server Edition (always use https: for remote servers — http will redirect and fail)
💡 Not sure of your port? Click Auto-detect in Settings — it will scan common ports and fill in the right one automatically.

3

Get your URA EFRIS credentials

TIN — your 10-digit URA Taxpayer Identification Number (on your URA registration certificate).
Device Number (DSN) — open efristest.ura.go.ug (sandbox) or efris.ura.go.ug (live) → log in → Device Management → My Devices. Your DSN looks like 1234567890_01.
Password — the same password you use to log into the EFRIS portal.

4

Add the EFRISConnect button in Manager

In Manager go to Settings → Custom Buttons → New Custom Button.
Set Name: EFRISConnect (or "Submit to EFRIS")
Set Placement: Sales Invoices (list) or Sales Invoice (single document)
Set URL: your EFRISConnect HTTPS address — e.g. https://YOUR-DOMAIN/extension
⚠ Manager requires HTTPS for custom buttons. If you see a sad-face icon, the URL is not HTTPS. Use your Cloudflare/domain URL, not http://localhost.

5

Create Manager Custom Fields for EFRIS data

These fields let EFRIS data (FDN, verification code, QR) be saved back into your Manager documents.
Go to Manager → Settings → Custom Fields → Sales Invoices → Add Custom Field. Create these fields (spelling must match exactly):
Fiscal Document Number — type: Text
Verification Code — type: Text
QR Code — type: QR Code (this renders as a scannable barcode on PDFs)
Submission Date — type: Text
Status — type: Text
💡 Repeat for Sales Receipts if you use receipts as well.

6

Run through First-Time Setup

Click Settings if you've already completed setup, or re-open EFRISConnect to run the setup wizard. Fill in all fields. Test the Manager connection — it should show ✓ Connected. Save & Start.

🔧 Troubleshooting

!

Sad face / broken icon in Manager panel

Manager only shows custom button content over HTTPS. The URL you entered must start with https:// — not http:// and not localhost. Use your Cloudflare Tunnel or domain URL. The correct URL is shown in Settings under "Extension URLs".

!

Authentication failed / rc:58 or similar

Check your TIN, Device Number (DSN), and EFRIS Password in Settings. The Device Number must match a device registered under your TIN on the EFRIS portal. Log into efristest.ura.go.ug → Device Management to confirm.

!

rc:2981 — wrong unit of measure

This means URA rejected the unit of measure for your item. For services the correct unit code is 101 (Unit). Go to Goods tab, edit the item, and re-sync it.

!

rc:41 — item code not in EFRIS registry

At least one item on the invoice has not been registered in EFRIS. Go to the Goods tab, find the item, enable Also register in EFRIS goods registry, and sync it. Then re-submit the invoice.

!

Manager not saving FDN / "Manager save failed"

Two things to check:
1. Access Token — verify it in Settings → System → Test Manager Connection.
2. Custom Fields — the fields Fiscal Document Number, Verification Code, QR Code, Status, and Submission Date must exist on Sales Invoices (and Sales Receipts) in Manager Settings → Custom Fields.

!

Invoice was already submitted (duplicate)

URA rejects a second submission for the same invoice. If you need to reverse a receipt, use the Credit Note button on the Status tab — this cancels the original with URA and records a reversal in Manager.

!

Switching from Sandbox to Production

Once you have tested at least 3–5 invoices successfully in sandbox, go to Settings and turn off Sandbox Mode. All submissions will then go to the live URA EFRIS system. Your TIN, Device Number and Password remain the same.

📋 Submission History

Loading…

🏢 Business

Legal Name

Trade Name

Address

Phone

Email

Logo (optional)

No logo

📷 Upload Image

Upload your business logo — shown on printed receipts.

Default "Issued by" name (optional)

Staff member name shown at the bottom of receipts.

🔐 EFRIS Credentials

TIN

Device Number (DSN)

EFRIS Password

BRN (optional)

🔗 System

Manager.io Endpoint

Access Token

Extension URLs:
🌐 Cloudflare (use this in Manager): https://YOUR-DOMAIN/extension
Local HTTP: http://localhost:3000/extension

Registered on EFRIS

Enable fiscal receipting & goods registry features

VAT Registered

18% VAT on sales

Sandbox Mode

EFRIS test environment

EFRISConnect

✓ Successfully submitted to URA EFRIS

Get your Manager.io Access Token

Get your Manager.io Endpoint URL

Get your URA EFRIS credentials

Add the EFRISConnect button in Manager

Create Manager Custom Fields for EFRIS data

Run through First-Time Setup

Open a Sales Invoice in Manager

Set the Customer Type

Foreign currency invoices

Preview, then Submit

You receive a Fiscal Document Number (FDN)

Print the professional receipt (optional)

Go to Goods tab → My Items

Add a new item

Search already-registered items (T131)

Sync to Manager.io

Set Customer Type permanently in Manager

B2B — Business customers

B2G — Government customers

Foreign / Tourist customers