Getting Started
Product Overview
EFRIX is the simplest way to integrate with Uganda's Electronic Fiscal Receipting and Invoicing System (EFRIS)
What is EFRIX?
EFRIX is a developer-friendly REST API that abstracts the complexity of URA's EFRIS system. Instead of dealing with PKI cryptography, AES encryption, and complex XML payloads, you get clean JSON endpoints that "just work."
The Problem
Integrating directly with EFRIS requires:
- Understanding PKI (Public Key Infrastructure) and certificate management
- Implementing AES encryption/decryption for every request
- Handling complex multi-part JSON payloads with nested structures
- Managing device registration and daily key rotation
- Parsing cryptic error codes from URA
- Understanding EFRIS commodity codes and tax categories
- Supporting multiple currencies and units of measurement
This takes weeks or months for most development teams.
The EFRIX Solution
# Issue a fiscal invoice in seconds
curl -X POST https://gateway.tarifix.xtellar.app/efrix/v1/invoices \
-H "X-EFRIX-API-Key: efrix_live_abc123" \
-H "X-EFRIX-API-Secret: sk_live_xyz789" \
-H "Content-Type: application/json" \
-d '{
"buyer": {"tin": "1000000001", "legal_name": "Acme Corp"},
"items": [{"name": "Widget", "quantity": 10, "unit_price": 50000}]
}'
That's it. EFRIX handles all the cryptographic operations, certificate management, and URA communication behind the scenes.
Core Features
E-Invoicing & Receipts
| Feature | Description |
|---|---|
| Invoices & Receipts | Issue fiscal invoices, receipts, credit notes, and debit notes |
| QR Code & FDN | Automatic generation of Fiscal Document Numbers and verification QR codes |
| Antifake Codes | URA antifake codes included in every response |
| Item-level Discounts | Full support for line-item discounts and promotions |
| Payment Modes | Cash, Credit, Cheque, SWIFT, Mobile Money (MTN, Airtel) |
Goods & Inventory
| Feature | Description |
|---|---|
| Goods/Services Sync | Create and sync products with EFRIS automatically |
| Commodity Code Mapping | Automatic EFRIS commodity code assignment with tax rate inference |
| Stock Management | Stock-in via purchase, import, and stock adjustments |
| Multi-UOM Support | Multiple units of measure per product (e.g., KG for purchase, PKT for sales) |
Business Configuration
| Feature | Description |
|---|---|
| Multi-Company Support | Manage multiple EFRIS-registered businesses under one account |
| Company/Customer Lookup | Fetch business details from URA using TIN, BRN, or NIN |
| Tax Template Generation | Automatic tax templates for Standard (18%), Zero-rated, and Exempt goods |
| Multi-Currency | UGX, USD, EUR, GBP, CNY as supported by EFRIS |
Integration & Sync
| Feature | Description |
|---|---|
| 2-Way Synchronization | Sync invoices from EFD devices, EFRIS portal, and your systems |
| Real-time Webhooks | Get notified of invoice status changes |
| POS Integration | Designed for seamless POS and retail integration |
| Request/Response Logging | Comprehensive audit trails for troubleshooting |
Infrastructure
| Feature | Description |
|---|---|
| Simple REST API | Clean JSON requests and responses |
| Sandbox Environment | Full test environment mirroring production |
| Automatic Retries | Queue and retry when EFRIS is unavailable |
| Daily Key Rotation | Automatic handling of T104 key refresh |
Use Cases
Point of Sale (POS) Systems
Issue fiscal receipts in real-time as customers check out. Support for cash, mobile money, and card payments.
ERP/Accounting Software
Automatically sync invoices, credit notes, and stock adjustments with EFRIS for compliance.
E-Commerce Platforms
Generate fiscal invoices for online orders with automatic commodity code assignment.
Inventory Management
Keep stock levels synchronized with URA for goods received, stock adjustments, and imports.
Multi-Branch Retail
Manage multiple store locations or business entities under one integration.
Who It's For
- Software Companies building POS, ERP, or accounting solutions for Uganda
- Enterprises with custom internal systems needing EFRIS compliance
- E-commerce Businesses issuing electronic invoices
- System Integrators deploying solutions for multiple clients
- Retail Chains with multiple locations requiring unified compliance
Getting Started
- Sign up at tarifix.xtellar.app
- Get API keys from your dashboard
- Test in sandbox mode
- Go live when ready
See the Developer Guide for step-by-step instructions.
Support
- Documentation: tarifix.xtellar.app/docs
- Email: support@systems.xtellar.co
- Website: tarifix.xtellar.app
EFRIX is a product of Xtellar Systems Co. Limited, part of the Tarifix platform.