@paybilldev/ura-efris-sdk
v1.0.0
Published
A production-ready Node SDK for integrating with the URA Efris API
Downloads
43
Readme
URA EFRIS System-to-System Integration SDK (JavaScript)
A production-ready JavaScript SDK for integrating with the Uganda Revenue Authority (URA) EFRIS (Electronic Fiscal Receipting and Invoicing System) via the System-to-System (S2S) interface.
Built in accordance with official URA EFRIS technical specifications, encryption standards, device registration workflows, and Offline Mode Enabler requirements.
Official URA EFRIS Documentation
📄 Step-by-Step Guide – System-to-System Integration (v1.1)
https://efris.ura.go.ug/site/manualDownload/downloadManualById?id=569326253531712032&language=
📄 Offline-Mode Enabler – Hardware & Software Requirements
https://efris.ura.go.ug/site/manualDownload/downloadManualById?id=779571457750410225&language=
📄 Offline-Mode Enabler – Installation Guide
https://efris.ura.go.ug/site/manualDownload/downloadManualById?id=537308370255165978&language=
📄 Interface Requirements for Information Management and Fiscalisation
https://efris.ura.go.ug/site/manualDownload/downloadManualById?id=173517733139059055&language=
📄 EFRIS Thumbprint & Device Registration Guide
https://efris.ura.go.ug/site/manualDownload/downloadManualById?id=102729662704726203&language=
📄 EFRIS Interface Design v23.7 Guide
https://efris.ura.go.ug/site/manualDownload/downloadManualById?id=299638647648159087&language=
⚠️ Important Notice
This SDK implements the URA EFRIS System-to-System (S2S) integration model.
Proper onboarding, certificate provisioning, and device registration with URA are required before production use.
Features
✅ System-to-System (S2S) API integration
✅ AES/RSA payload encryption & digital signatures
✅ URA-compliant request/response handling
✅ Device & taxpayer authentication helpers
✅ Timezone-safe timestamp utilities (EAT / UTC)
✅ Offline Mode Enabler compatibility
✅ Axios / Fetch compatible HTTP layer
✅ Robust error handling & validation
Installation
Install via npm:
npm install ura-efris-sdkor via yarn:
yarn add ura-efris-sdkAuthor
Bartile Emmanuel 📧 [email protected] | 📱 +254 757 807 150 Lead Developer, Paybill Kenya
📘 URA EFRIS Documentation (Paybill): https://paybill.ke/docs/ura-efris
License
MIT © 2025–2026 Paybill Kenya Limited
🇺🇬 Supporting Digital Tax Compliance in Uganda 🇰🇪 Proudly engineered by Paybill Kenya Limited
