paybilldev/ura-efris-sdk

PHP SDK for Uganda Revenue Authority (URA) EFRIS System-to-System (S2S) API integration

1.0.1 2026-02-22 19:08 UTC

Requires

• php: ^8.0
• ext-curl: *
• ext-json: *
• ext-openssl: *
• guzzlehttp/guzzle: ^7.0
• psr/log: ^3.0
• respect/validation: ^2.4

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.0
• mockery/mockery: ^1.6
• phpstan/phpstan: ^1.10
• phpunit/phpunit: ^10.0

MIT

• Emmanuel Bartile

• api
• sdk
• tax
• fiscal
• Uganda
• einvoicing
• ura
• efris

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 📧 [e-mail] | 📱 [phone] 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