README

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

A production-ready PHP 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 enablement requirements.

Official URA EFRIS Documentation

📄 Step-by-Step Guide – System-to-System Integration (v1.1) Issue Date: 19/07/2022 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 ✅ Payload encryption & digital signature support ✅ URA-compliant request/response handling ✅ Device & taxpayer authentication helpers ✅ Timezone-safe timestamp handling (EAT / UTC) ✅ Offline Mode Enabler compatibility ✅ PSR-compliant HTTP client support ✅ Production-grade error handling

Installation

Install via Composer:

composer require paybilldev/ura-efris-sdk

Author

Bartile Emmanuel 📧 support@paybill.dev | 📱 +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