Integrations / URA EFRIS
EFRIS integration for ERPNext in Uganda
URA supports direct system-to-system e-invoicing. We engineer that connection on ERPNext with the same real-time signing and retry patterns running in our Kenyan eTIMS module.
Why this matters now
EFRIS has been compulsory for VAT-registered businesses since June 2020, and Gazette Notice 2218 of 2025 extended it to 12 whole sectors from 1 July 2025, regardless of VAT registration. Expenses without EFRIS invoices are disallowed for income tax in those sectors, and each failure to issue attracts penal tax of UGX 6,000,000 or the tax due, whichever is higher.
ERPNext and compliance in UgandaWhat the integration covers
ERPNext talks to EFRIS directly through URA's integration channel, removing portal double entry and standalone EFD devices.
Sales invoices, credit notes and receipts issued and acknowledged through EFRIS, with the fiscal identifiers stored on the ERPNext document.
The retry-queue and circuit-breaker pattern from our KRA eTIMS module, applied to EFRIS availability windows.
Configuration mapped to the July 2025 sector expansion, for businesses newly in scope without VAT registration.
Supplier invoice capture keyed to EFRIS references, so your deductible expenses stay supported by compliant invoices.
How we deliver
From discovery to verified go-live
Discovery and compliance mapping
We map your document flows, branches and item catalogue to URA's EFRIS requirements, and confirm registration status and credentials with the authority.
Sandbox integration
ERPNext is connected to the EFRIS test environment. Sales invoices, credit notes and debit notes are generated and validated against the authority's schema before anything touches production.
Resilience engineering
Failed transmissions queue and retry automatically, with a circuit breaker for authority downtime. The pattern is proven in our KRA eTIMS module: zero lost receipts when the tax server is down.
Go-live and verification
Production credentials are registered, the first live documents are verified end to end, and your team is trained on exception handling and the EFRIS verification workflow.
Support and rate-change watch
We monitor authority notices and ship configuration updates when rules change, under a support agreement with defined response times.
Frequently asked questions
Is this a shipped product like your eTIMS module?
No, and we say so plainly. EFRIS integration is delivered as an engineering service on ERPNext, built by the team that ships real-time eTIMS fiscal signing in Kenya. The signing, queueing and reconciliation architecture transfers directly; the URA-specific schema work is scoped per project.
Which businesses fall under the July 2025 expansion?
Twelve sectors under Gazette Notice 2218 of 2025, including wholesale and retail fuel, mining, manufacturing, utilities, construction, transport, accommodation and food service, ICT, real estate, professional services, and arts and entertainment, regardless of VAT registration.
What does non-compliance cost?
Penal tax of UGX 6,000,000 per failure to issue an EFRIS invoice, or the tax due if higher. Buyers in mandated sectors also lose income-tax deductibility on expenses without EFRIS invoices, so non-compliant suppliers get dropped from supply chains.
Can compliance run through URA's portal instead?
Yes, URA offers a web portal and approved EFD devices, but portal entry duplicates work your ERP already does. Direct integration issues the fiscal document from the same action that posts the ledger entry, which is the point of running an ERP.
Scope your EFRIS integration
A discovery call covers your document flows, registration status with URA, and a delivery plan with verification criteria. We reply within one working day.