Skip to content

paybillke/ura-efris-js-sdk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Paybill Kenya Logo

URA EFRIS System-to-System Integration SDK (JavaScript)

JavaScript Node.js License URA EFRIS NPM Production Ready

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-sdk

or via yarn:

yarn add ura-efris-sdk

Author

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

About

A Typescript/Javascript SDK for integrating with the Uganda Revenue Authority (URA) Electronic Fiscal Receipting and Invoicing System (efris) API

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

Contributors